FB_ModbusRtuSlave

一句话：让本 PLC 当 Modbus RTU 从站，上位机（DCS / 触摸屏 / 另一台 PLC / 上位软件） 用 FC03 读、FC06/FC16 写本站数据。所有脏活（端口初始化、重试、状态分类、诊断计数） 都封在块里，外面只要给一个硬件标识符。

硬件要求

• S7-1200：CM 1241 RS485（6ES7241-1CH32-0XB0）或 CB 1241 RS485 通信板
• S7-1500：CM PtP RS422/485 系列
• 项目里要有 Modbus RTU 指令库（Modbus_Comm_Load / Modbus_Slave；老库叫 MB_COMM_LOAD / MB_SLAVE）

一、文件清单

本块不依赖 CRC16 辅助 FC——CRC 校验由库指令内部完成，所以下载包里只有 1 个 FB，导一次就完事。 （对比：自由口版需要自己算 CRC，所以要额外导一个共享 FC。）

二、上手三步

第 1 步：导入

项目树 → 外部源文件 → 添加新的外部源文件 → 选中 .scl → 从源生成块

• 不要先手动新建同名块，会冲突。本文件只含 1 个 FB。
• 中文注释用 _GB2312.scl；怕编码出问题用 _EN.scl。

导入后 30 秒自检（重要）：双击生成的 FB，看接口表 —— Input / Output / InOut / Static 四栏都必须有变量。 如果全是空的、代码区一堆 #xxx 划红线，说明声明段没被解析， 生成的块是残废的，删掉重新来。

（踩过一次：源码里写了老 S7-SCL 的 VAR_CONSTANT ... END_CONST， TIA 只认 ... END_VAR 结尾，结果接口整个没建起来。现在这份源码已改用 VAR 段放常量，不会再踩。）

第 2 步：确认「非优化访问」（最容易漏的一步）

源码里已写死属性 { S7_Optimized_Access := 'FALSE' }，导入后还是再看一眼： 右键 FB → 属性 → 取消勾选「优化的块访问」。

这一步不做，MB_HOLD_REG 会直接报 16#818C，一条都不通。 手册原文：保持寄存器数据块必须支持绝对地址访问，优化访问没有绝对地址。

第 3 步：在 OB1（或循环中断 OB）里无条件调用一次

"FB_ModbusRtuSlave_DB"(
    bEnable   := TRUE,
    uPortHwId := 269,          // ← 改成你的模块硬件标识符
    uBaud     := 9600,
    uParity   := 2,            // Modbus RTU 常用偶校验
    uSlaveAddr:= 1             // ← 本站站号
);

调用频率有硬要求：手册规定主站的响应超时内，Modbus_Slave 至少要被执行 2 次。 上位机 RESP_TO 设 1000 ms，本块的调用周期就不能大于 500 ms。 放 OB1 里一般没问题；OB1 周期长（> 200 ms）就丢进循环中断 OB（OB30 之类）。

不能塞进条件分支。必须每周期无条件调用一次，缺调用就等于从站不在线。

三、数据在哪：背景 DB 里的 aHoldReg

导入后打开自动生成的背景 DB（例如 FB_ModbusRtuSlave_DB），里面有个 aHoldReg：

PLC 自己读写数据就是直接操作这个数组：

// 主站块采集的第 3、4 个字 → 交给上位机的 40001、40002
"FB_ModbusRtuSlave_DB".aHoldReg[0] := "FB_ModbusRtuCycle_DB".aData[2];
"FB_ModbusRtuSlave_DB".aHoldReg[1] := "FB_ModbusRtuCycle_DB".aData[3];

// 上位机写下来的设定值 → 取出来用
#rSetValue := WORD_TO_INT("FB_ModbusRtuSlave_DB".aHoldReg[10]);   // 40011

主站侧一律按 40001 起算，对应下标 0，不是 1。差一位是这个坑的高发区。
FC03 一次最多读 125 个，FC16 一次最多写 123 个；超了从站回异常码。 FC01/05/15 线圈类不进这个数组——那是直接映射到 CPU 的过程映像区（Q0.0 起），与本块无关。

四、引脚速查

输入

端口 MODE：485 半双工必须写 4（不改就是一帧不通）

MODE 不是 Modbus_Comm_Load 的引脚，是它背景数据块里的 Static 变量。 西门子官方文档（Entry ID 47756141）原文：MODE 默认 0，需「通过起始值」改成 4。

不改的后果：波特率、校验、站号全都对，bReady 也是 TRUE，但一帧都不通， STATUS 常挂 818B / 80C8。这是 485 调试最隐蔽的一个坑 —— 因为它不会报「参数错」，只是静默不通。

本块的处理：在 FB 内部每拍把 uModeEff 写进 #instLoad.MODE， 且在 REQ 上升沿之前写 —— 指令只在 REQ 触发时才把配置刷进模块，写晚了就白写。

输出 · 健康度

输出 · 故障码与分类（本块的重点）

输出 · 计数器与追踪

wReqTotal / wCrcErr / wExcCnt / wSuccCnt 是西门子系统手册（Table 13-85）明列的公开静态变量， 本块把它们引出来，不用自己解析报文就能看总线质量。

五、排错表：看一眼就知道查什么

状态码分类速查（西门子官方码）

六、退路方案（编译报错时看这里）

源码里 MB_DB 写成 #instSlave.MB_DB（多重实例静态量）， 诊断计数器写成 #instSlave.Bad_CRC_Count 等。 个别 TIA 版本不允许从多重实例访问静态变量，编译会报「无法访问该元素」。遇到就把从站指令改成独立实例：

1. 在 FB 外面（比如 OB1 里）拖一个 Modbus_Slave，让它生成自己的背景 DB，例如 DB_MbSlave。
2. 在 DB_MbSlave 里加一个数组 aHoldReg : ARRAY[0..999] OF Word（该 DB 设为标准访问）。
3. 把 FB 里这几处改掉：

   // 状态机 STEP 5
   MB_DB := "DB_MbSlave".MB_DB,
   
   // 状态机 STEP 10
   MB_HOLD_REG := "DB_MbSlave".aHoldReg,
   
   // 诊断计数器段
   #wReqTotal := "DB_MbSlave".Request_Count;
   #wCrcErr   := "DB_MbSlave".Bad_CRC_Count;
   #wExcCnt   := "DB_MbSlave".Exception_Count;
   #wSuccCnt  := "DB_MbSlave".Success_Count;

4. 数据追踪那段也要跟着改成扫 "DB_MbSlave".aHoldReg。

另一条退路：如果你的库是老版本（指令叫 MB_COMM_LOAD / MB_SLAVE）， 把 VAR 里两个类型名换掉即可，不要两个版本混用（手册明令禁止）。

七、和自由口从站怎么选

典型网关架构（两个块一起用）

[现场仪表 1..N] --485--> CM1241 --主站轮询块--> aData[]
                                                    |
                                         （拷贝，自己写一行赋值）
                                                    v
[上位机 DCS] <--485-- CB1241 <--FB_ModbusRtuSlave-- aHoldReg[40001..41000]

两个块各占一个口、各用一个实例，互不干扰。中间的拷贝就一行赋值，别在拷贝里做复杂运算。

八、容易踩的坑（按现场出现频率排序）

1. 背景 DB 被顺手设成优化访问 → 818C，一条不通。
2. uPortHwId 填了槽位号 → 0001。要去设备组态抄「硬件标识符」。
3. 端口 MODE 没设成 4 → 参数全对却静默不通，STATUS 挂 818B。
4. 调用周期太长 → 上位机超时。手册要求 RESP_TO 内至少执行 2 次。
5. 主站地址差 1 → 40001 是下标 0，不是 1。
6. 上位机用 FC01/FC05/FC15 读「线圈」 → 那些走 CPU 过程映像（Q0.0 起），跟 aHoldReg 没关系。
7. 同一口上跑了两个实例 → 抢线，两边都不通。一个 485 口只能有一个本块实例。
8. 改了波特率没给 bReload → 改动不生效，要上升沿重新初始化一次。
9. PLC 自己改 aHoldReg 也会触发 bDataChanged → 以为是主站写的，其实是自己写的。

_最后更新：2026-10-10_