企业官网建设流程全解析

简介：本资源是力士乐（Bosch Rexroth）行走机械控制器BODAS平台的官方级编程指令集中文整理文档，专为初学者及现场工程师设计，用于快速掌握BODAS运行时系统（Runtime System）中核心函数的语法、参数约束与目标系统兼容性。文档覆盖MC6、RC2-1、RC6-9、RC12-18等主流控制器型号，系统梳理了注解规范、输入处理（如in_initAna/in_getPoti系列）、输出控制（out_initProp/out_setProp）、系统函数（sys_getSupply/sys_setCycle）等四大模块，并明确标注各函数在不同ECU上的适用性（如in_setVirtual不支持RC2-1），显著降低跨型号开发试错成本。资源为单文件Word文档（.doc），大小1.53MB，结构清晰、术语统一，便于查阅与嵌入开发流程。目前已有1523人学习下载，是理解BODAS底层逻辑、编写可移植控制程序及开展故障诊断的重要技术参考。

1. 这不是一本“英文说明书”，而是一份能让你在RC12-18上把电位器读准、让伺服电机停稳、避免EEPROM写崩的BODAS Runtime函数操作手册

你手头刚拿到一台力士乐RC12-18控制器，接好电位器，写完in_getPoti(1)，结果PLC监控里数值乱跳——不是0就是65535；或者调用stm_doStop()后电机还在惯性滑行半秒，客户在现场拍桌子问“这算哪门子硬停止”；又或者改完参数一ee_doSavePage()，重启后全变回出厂值……这时候翻遍BODAS安装包里的Help文档，发现全是图形化配置向导，没有一行C风格函数的调用逻辑。别急——这份《Runtime System for MC6 / RC2-1 / RC6-9 / RC12-18 / 10BODAS》（Version 10.0 / 03.02）根本就不是给你“看”的，它是给你“抄”的：里面72个带签名的C函数、14类目标系统兼容性标注、5类内存页管理规则，全按真实工程场景组织。它专为已经装好BODAS IDE、能编译下载但总在运行时栽跟头的现场工程师准备——不讲IDE怎么点菜单，只告诉你in_initAna()第2个参数填ANA_MODE2_SPS时，为什么RC12-18的ANA_B2通道必须悬空、而ANA_A2却要接±10V参考地。如果你正卡在“函数能编译但行为不可控”这个玄学阶段，这份指令集就是你的后悔药。

2. 输入信号初始化：从in_initAna()到in_getPotiStatus()，为什么RC12-18的模拟通道必须分板A/板B初始化？

BODAS Runtime的输入函数不是“统一初始化+统一读取”的傻瓜模式。它强制你面对一个物理事实：RC12-18是双板ECU（Board A + Board B），而模拟输入引脚在两块板上的电气特性、参考地路径、ADC校准系数完全不同。这意味着——哪怕你只用ANA_A1一个通道，也必须先调in_initAna()声明它的供电模式和量程，否则in_getPoti()返回的就是未校准原始码值（raw ADC count），不是0–100%的工程量。

2.1in_initAna()：RC12-18上唯一能激活±10V量程的入口

这是RC12-18区别于RC2-1的核心能力。RC2-1只有0–5V单极性输入，而RC12-18通过iMode2 = ANA_MODE2_SPS启用双极性采样。但注意：该模式仅对ANA_A2和ANA_B2有效（文档Page 73明确标注），且必须满足硬件约束：

提示：ANA_A2/ANA_B2接入±10V信号时，其对应板的GND端子（如ANA_A2_GND）必须与信号源共地；若悬空或接错，ADC基准漂移会导致全量程读数偏移±15%以上。

// RC12-18正确初始化ANA_A2为±10V输入（Board A） INT ret = in_initAna( 2, // iChnl: ANA_A2通道号（注意：A板通道1-2，B板通道3-4） ANA_MODE1_PVR, // iMode1: 参考电压2.5V（决定零点偏置） ANA_MODE2_SPS // iMode2: ±10V量程（仅此模式支持负压） ); if (ret != 0) { // 返回非0表示初始化失败：常见原因包括通道号越界（填3会失败）、 // 或当前板未供电（如只插了Board A，却对ANA_B2初始化） }

参数说明：

• iChnl=2→ 对应Board A的ANA_A2（不是“第2个通道”，而是硬件固定映射）
• ANA_MODE1_PVR→ 启用2.5V内部参考，使0V输入对应ADC中点（32768），支撑负压采样
• ANA_MODE2_SPS→ 切换ADC为双极性模式，此时in_getPoti(2)返回值范围为-32768 ~ +32767

2.2in_getPoti()系列：校准值≠原始值，电位器状态必须主动轮询

很多新手以为调一次in_initAna()就能一劳永逸读电位器。错。BODAS的电位器读取是三段式：

1. 硬件初始化（in_initAna()）→ 配置ADC通道
2. 校准加载（BODEM/BB-3工具写入EEPROM）→ 存储Min/Max/Mid三点标定系数
3. 运行时计算（in_getPoti()）→ 用当前ADC码值套用校准公式

所以in_getPoti(1)返回的永远是0–100%工程值（如0.00–100.00），而in_getPotiMin()返回的是EEPROM里存的原始校准码（如1205），二者单位、量纲、用途完全不同。

// 正确读取电位器当前值（已校准，单位%） REAL poti_value = in_getPoti(1); // 返回REAL型，如42.75 // 检查电位器是否断线（关键！避免误判为0%） BOOL status_ok = in_getPotiStatus(1); // TRUE=正常，FALSE=开路/短路 if (!status_ok) { // 立即触发安全逻辑：停伺服、报E012错误 stm_doStop(); sys_setErrorLed(TRUE); } // 调试用：读取校准基点（仅用于验证BODEM写入是否成功） INT min_code = in_getPotiMin(1); // 如1180，非百分比 INT max_code = in_getPotiMax(1); // 如32150

逻辑说明：

• in_getPotiStatus()必须在每次读取前调用——它不缓存，是实时检测ADC输入阻抗变化
• 若电位器滑臂接触不良，in_getPoti()可能返回0或满码，但in_getPotiStatus()会立刻变FALSE，这是你唯一的硬件故障捕获窗口

2.3in()通用读取函数：MC6/RC2-1/RC12-18三版本参数表与陷阱

in()是BODAS最易误用的函数。表面看它“自动适配型号”，实则每个版本签名不同，传错参数直接导致栈溢出或静默失败：

// RC12-18正确读取板B的数字输入通道5（对应硬件DI_B5） BOOL di_val = in(5, 1, 0); // 参数顺序：通道号、板号(B=1)、类型(DI=0) // 错误示范：RC12-18上写成MC6风格（漏iBoard） // BOOL bad = in(5, 0); // 编译器不报错，但实际读取的是板A的DI_A5！

参数说明：

• iBoard参数是RC12-18的生命线——它决定CPU访问哪块FPGA的寄存器组
• 所有in()变体均不检查通道物理存在性，传入不存在的通道号（如RC12-18传iChnl=10）将返回0且不报错，需靠in_getPotiStatus()等状态函数反向验证

3. 输出与伺服控制：out_setProp()的PWM占空比陷阱与stm_doStop()的硬停止真相

输出函数常被当成“设置值就完事”的黑匣子。但BODAS的out_setProp()实际控制的是比例阀线圈电流，而stm_doStop()的停止方式取决于伺服驱动器的硬件响应能力——这两者都绕不开一个核心：时间尺度不匹配。你在PLC周期里调用函数，但执行机构的物理响应滞后几十毫秒。这份Runtime文档里藏着所有时间参数的原始定义，我们来把它抠出来。

3.1out_setProp()：占空比≠电压，必须配合out_initPropFreq()设定载波频率

out_setProp()看似简单：out_setProp(1, 75.0)设75%占空比。但RC12-18的PROPORTIONAL输出是电流环，其有效占空比受out_initPropFreq()设定的PWM载波频率制约：

• 若out_initPropFreq(1, 100)（100Hz），则75%占空比对应平均电流稳定，但动态响应慢（阶跃上升时间≈20ms）
• 若out_initPropFreq(1, 1000)（1kHz），则75%占空比下电流纹波大，可能触发伺服驱动器过流保护

// RC12-18上驱动比例阀的黄金组合（经某工程机械液压台架实测） out_initPropFreq(1, 500); // 设定通道1载波频率500Hz（平衡响应与纹波） out_initProp(1); // 初始化通道1（必须在setProp前调用） out_setProp(1, 62.5); // 设62.5%占空比 → 对应1250mA线圈电流（按阀规格书） // 验证：读取当前实际输出值（非设定值！） REAL actual_curr = out_getProp(1); // 返回REAL，单位mA，典型误差±3%

关键参数逻辑：

• out_initPropFreq()的第二个参数是载波频率（Hz），不是“刷新率”。它直接写入PWM定时器寄存器，影响IGBT开关损耗
• out_getProp()返回的是AD采样得到的实际输出电流，不是你设的百分比——这是你判断阀是否卡滞的唯一依据（如设定62.5%但实测<10mA，说明阀芯堵塞）

3.2stm_doStop()：软停、斜坡停、硬停？文档没说清，硬件手册才告诉你

stm_doStop()在Runtime文档里只有一行：“Stops the servomotor”。但RC12-18对接的伺服驱动器（如力士乐SMS系列）有三种停止模式，而stm_doStop()默认触发的是斜坡停止（Ramp Stop），其减速时间由驱动器参数P101设定（默认500ms）。这不是你想要的“急停”。

注意：真正的硬停止（Hardware Stop）需同时满足：

1. 调用stm_doStop()
2. 将驱动器的STO（Safe Torque Off）信号置低（通过out()函数控制独立DO点）
3. 等待stm_getStat()返回STM_STAT_STOPPED（非STM_STAT_RAMPING）

// 实现真正硬停的四步法（RC12-18 + SMS驱动器） stm_doStop(); // 1. 发送软件停止命令 out(3, 0); // 2. 强制关闭STO使能（假设DO3接STO输入） while (stm_getStat() != STM_STAT_STOPPED) { // 3. 轮询状态 sys_setCycle(1); // 强制最小扫描周期1ms } out_setProp(1, 0.0); // 4. 清零输出（双重保险）

状态机解读：

• stm_getStat()返回值是枚举型：STM_STAT_RUNNING/STM_STAT_RAMPING/STM_STAT_STOPPED/STM_STAT_FAULT
• 若轮询超时（如>1000ms仍为RAMPING），说明驱动器未响应，需检查CAN通讯或STO接线

3.3out_getStatus()：别再用out()返回值判断输出是否生效

新手常犯错误：if (out(1, 1)) { /* 认为输出成功 */ }。错！out()函数返回的是写入寄存器的操作结果（0=成功，非0=总线错误），不是输出通道的物理状态。真正反映物理状态的是out_getStatus()：

// 正确做法：先写，再读物理状态 out(1, 1); // 启动DO1 sys_setCycle(10); // 等10ms让继电器吸合 BOOL is_on = out_getStatus(1); // TRUE=触点已闭合，FALSE=开路/过载 // 如果is_on为FALSE，检查： // - DO1负载是否超限（RC12-18单点最大2A） // - 是否触发了电子熔断（需调用sys_getErrorLed()查错误码）

底层逻辑：

• out_getStatus()读取的是输出驱动芯片（如Infineon BTS7960）的诊断引脚，能检测开路、短路到VCC、短路到GND
• 它与out()完全异步——out()写寄存器瞬间完成，out_getStatus()读芯片状态需10μs以上传播延迟

4. 避坑：RC12-18上最常踩的5个Runtime函数雷区与血泪排查记录

这些坑我都在某大型矿用自卸车项目里实打实踩过，轻则参数丢失，重则烧毁IO模块。文档里没写，但Runtime系统的行为边界就藏在参数组合的缝隙里。

4.1 现象：ee_doSavePage()后重启，EEPROM里参数全变0

原因：RC12-18的EEPROM分页管理严格。ee_doSavePage(1)只保存Page 1，但BODAS默认将用户参数分散在Page 0（系统参数）、Page 1（应用参数）、Page 2（校准数据）。只存Page 1，其他页仍是出厂值。
解决：必须按ee_getPageStatus()确认各页状态，再用ee_doSaveMem()全页保存：

// 正确保存全部用户参数 for (INT page = 0; page <= 2; page++) { if (ee_getPageStatus(page) == EE_PAGE_VALID) { ee_doSavePage(page); } } ee_doSaveMem(); // 强制刷写整个EEPROM缓存区

4.2 现象：can_sendData()发送CAN帧后，can_getStatus()显示TX_OK，但接收方收不到

原因：RC12-18的CAN控制器要求发送前必须调用can_initTraDatabox()初始化发送缓冲区。漏掉此步，数据写入无效地址，硬件静默丢弃。
解决：发送前必做三件事：

1. can_init()→ 初始化CAN控制器
2. can_initTraDatabox()→ 分配发送缓冲区（文档Page 86强调“must be called before any send operation”）
3. can_sendData()→ 发送

4.3 现象：sys_setPassword("1234")后，BODEM连接被拒绝

原因：密码长度必须为6位。"1234"会被自动补空格成"1234 "（6字节），但BODEM实际校验的是ASCII码值，空格（0x20）参与CRC计算，导致密钥不匹配。
解决：密码必须严格6字符，用sys_setPassword("123456")，禁止用短密码。

4.4 现象：in_getPoti(1)在RC12-18上返回值跳变±5%，但万用表测电位器电压稳定

原因：in_initAna()未指定iMode1。RC12-18默认ANA_MODE1_PV（0V参考），但实际电位器供电是24V，导致ADC零点漂移。
解决：必须显式设iMode1 = ANA_MODE1_PVR（2.5V参考），让ADC以2.5V为0点，适配0–24V电位器输出。

4.5 现象：stm_init()返回0（成功），但stm_getIst()始终为0

原因：伺服电机编码器未接或A/B相接反。stm_init()只检查CAN通讯链路，不验证编码器信号质量。
解决：用示波器测编码器A/B相信号，确认：

• 幅值≥2.5Vpp（TTL电平）
• 相位差90°±10°
• 无毛刺（高频干扰会导致stm_getStat()返回STM_STAT_FAULT）

5. 系统级调试技巧：用sys_getRTSRevision()锁定Runtime版本，用ssc_getStatus()揪出CAN隐性故障

当你面对一台陌生的RC12-18设备，第一件事不是写代码，而是确认它的Runtime系统版本和底层通讯健康度。因为BODAS的函数行为会随Runtime版本微调——比如in_doFreqStop()在Version 8.0后增加了去抖时间参数，而旧版固件忽略该参数。盲目套用新版文档，必然翻车。

5.1sys_getRTSRevision()：三行代码确认你面对的是哪个“世界”

这个函数返回一个整型版本号，需转换为文档中的Version字符串。转换规则在文档Page 47脚注：RTSRevision = (Major << 16) | (Minor << 8) | Patch。例如返回0x0A0002→ Major=10, Minor=0, Patch=2 → 对应Version 10.0/02。

// 获取并解析Runtime版本（RC12-18实测） INT rev = sys_getRTSRevision(); INT major = (rev >> 16) & 0xFF; // 高8位：主版本 INT minor = (rev >> 8) & 0xFF; // 中8位：次版本 INT patch = rev & 0xFF; // 低8位：修订号 // 打印到HMI或串口（调试必备） // "RTS v%d.%d/%02d", major, minor, patch → "RTS v10.0/02"

为什么重要：

• Version 9.0起，out_initPropFreq()支持10–2000Hz连续可调；Version 8.0仅支持100/500/1000Hz三档
• Version 10.0修复了ee_doSaveArray()在Page 2写入时的地址越界BUG（此前版本需手动偏移）
• 不确认版本就按最新文档编程，等于在雷区蒙眼走路

5.2ssc_getStatus()：CAN通讯的“心电图”，比can_getStatus()更早发现隐性故障

can_getStatus()只报告CAN控制器的硬错误（BUS_OFF、ERROR_PASSIVE），而ssc_getStatus()（Serial Synchronization Channel）监控的是BODAS Runtime与底层MCU固件的同步状态。当CAN物理层出现间歇性干扰（如线缆屏蔽不良），can_getStatus()仍显示OK，但ssc_getStatus()会率先报警：

// 在主循环中嵌入同步状态监控（RC12-18推荐） if (ssc_getStatus() != SSC_OK) { // 触发深度诊断：记录时间戳、保存`can_getStatus()`快照、强制进入安全模式 log_error("SSC fault: %d at %d ms", ssc_getStatus(), sys_getTime()); safe_mode_enter(); // 自定义安全模式函数 }

实战价值：

• 某次矿山现场，车辆颠簸时ssc_getStatus()频繁返回SSC_BUFFER_OVERRUN，但CAN总线分析仪显示无错误帧。最终发现是CAN线缆在车架弯折处屏蔽层断裂，高频振动耦合噪声导致MCU接收中断响应延迟，缓冲区溢出。更换线缆后问题消失。
• 这种故障can_getStatus()永远抓不到，因为物理层没出错，错在固件与Runtime的协同节奏被打乱。

5.3sys_isMemChanged()：参数修改的“公证员”，避免误判EEPROM写入失败

当你调用ee_doSavePage()后不确定是否真写入，别急着重启。sys_isMemChanged()是Runtime系统内置的变更标记，它在每次ee_doSave*()成功后自动置位，且不会因断电清除（靠后备电池维持）。

// 安全写入流程（工业级容错） ee_doSavePage(1); if (sys_isMemChanged()) { // 标记已变更，可安全重启 sys_setPowOff(); // 断电重启 } else { // 写入失败！立即触发告警 alarm_trigger(ALARM_EEPROM_WRITE_FAIL); }

底层机制：

• sys_isMemChanged()读取的是MCU内部一个标志位（非EEPROM地址），该位由Runtime固件在ee_doSave*()确认写入完成后置1
• 即使EEPROM物理损坏，只要Runtime固件能执行完写入流程，此标志位就会置位——它是你判断“软件层是否尽力”的唯一凭证

从那以后我每次在现场调试RC12-18，都会在工程开头加一段版本校验和SSC状态监控，就像给程序装上心跳监测仪。不是信不过代码，而是信不过现场的电缆、振动、温漂和那些永远不写进文档的硬件小脾气。希望帮到你。

本文还有配套的精品资源，点击获取