1.1 Modbus RTU 主站指令库
西门子在 Micro/WIN V4.0 SP5 中正式推出 Modbus RTU 主站协议库（西门子标准库指令）。
图 1. 西门子标准指令库（Micro/WIN V4.0 SP5）
Modbus指令库
注意
●1. Modbus RTU 主站指令库的功能是通过在用户程序中调用预先编好的程序功能块实现的，该库对 Port 0 和 Port 1 有效。该指令库将设置通信口工作在自由口模式下。
●2. Modbus RTU 主站指令库使用了一些用户中断功能，编其他程序时不能在用户程序中禁止中断。
●3. Modbus RTU 主站库对CPU的版本有要求。CPU 的版本必须为 2.00 或者 2.01（即订货号为 6ES721*－***23-0BA*），1.22版本之前（包括1.22版本）的 S7-200 CPU 不支持。
使用 Modbus RTU 主站指令库，可以读写 Modbus RTU 从站的数字量、模拟量 I/O 以及保持寄存器。
要使用 Modbus RTU 主站指令库，须遵循下列步骤：
●1.安装西门子标准指令库
●2.按照要求编写用户程序调用 Modubs RTU 主站指令库
1.2 Modbus RTU 主站功能编程
1. 调用 Modbus RTU 主站初始化和控制子程序
使用 SM0.0 调用 MBUS_CTRL 完成主站的初始化，并启动其功能控制：
图 2. 用 SM0.0 调用 Modbus RTU 主站初始化与控制子程序
各参数意义如下:
| a. | EN | 使能： | 必须保证每一扫描周期都被使能（使用 SM0.0） |
| b. | Mode | 模式： | 为 1 时，使能 Modbus 协议功能；为 0 时恢复为系统 PPI 协议 |
| c. | Baud | 波特率： | 支持的通讯波特率为1200，2400，4800，9600，19200，38400，57600，115200。 |
| d. | Parity | 校验： | 校验方式选择 |
| 0＝无校验 | |||
| 1＝奇较验 | |||
| 2＝偶较验 | |||
| e. | Timeout | 超时： | 主站等待从站响应的时间，以毫秒为单位，典型的设置值为 1000 毫秒（1 秒），允许设置的范围为 1 - 32767。 |
| 注意： 这个值必须设置足够大以保证从站有时间响应。 | |||
| f. | Done | 完成位： | 初始化完成，此位会自动置1。可以用该位启动 MBUS_MSG 读写操作（见例程） |
| g. | Error | 初始化错误代码（只有在 Done 位为1时有效）： | |
| 0＝ 无错误 | |||
| 1＝ 校验选择非法 | |||
| 2＝ 波特率选择非法 | |||
| 3＝ 模式选择非法 | |||
图 3. 调用Modbus RTU 主站读写子程序
各参数意义如下:
| a. | EN | 使能： | 同一时刻只能有一个读写功能（即 MBUS_MSG）使能 |
| 注意：建议每一个读写功能（即 MBUS_MSG）都用上一个 MBUS_MSG 指令的 Done 完成位来激活，以保证所有读写指令循环进行（见例程）。 | |||
| b. | First | 读写请求位： | 每一个新的读写请求必须使用脉冲触发 |
| c. | Slave | 从站地址： | 可选择的范围 1 - 247 |
| d. | RW | 从站地址： | 0 ＝ 读， 1 ＝ 写 |
| 注意： | |||
| 1. 开关量输出和保持寄存器支持读和写功能 | |||
| 2. 开关量输入和模拟量输入只支持读功能 | |||
| e. | Addr | 读写从站的数据地址： | |
| 选择读写的数据类型 | |||
| 00001 至 0xxxx - 开关量输出 | |||
| 10001 至 1xxxx - 开关量输入 | |||
| 30001 至 3xxxx - 模拟量输入 | |||
| 40001 至 4xxxx - 保持寄存器 | |||
| f. | Count | 数据个数 | 通讯的数据个数（位或字的个数） |
| 注意： Modbus主站可读/写的最大数据量为120个字（是指每一个 MBUS_MSG 指令） | |||
| g. | DataPtr | 数据指针： | 1. 如果是读指令，读回的数据放到这个数据区中 |
| 2. 如果是写指令，要写出的数据放到这个数据区中 | |||
| h. | Done | 完成位 | 读写功能完成位 |
| i. | Error | 错误代码： | 只有在 Done 位为1时，错误代码才有效 |
| 0 ＝ 无错误 | |||
| 1 ＝ 响应校验错误 | |||
| 2 ＝ 未用 | |||
| 3 ＝ 接收超时（从站无响应） | |||
| 4 ＝ 请求参数错误（slave address, Modbus address, count, RW） | |||
| 5 ＝ Modbus/自由口未使能 | |||
| 6 ＝ Modbus正在忙于其它请求 | |||
| 7 ＝ 响应错误（响应不是请求的操作） | |||
| 8 ＝ 响应CRC校验和错误 | |||
| - | |||
| 101 ＝ 从站不支持请求的功能 | |||
| 102 ＝ 从站不支持数据地址 | |||
| 103 ＝ 从站不支持此种数据类型 | |||
| 104 ＝ 从站设备故障 | |||
| 105 ＝ 从站接受了信息，但是响应被延迟 | |||
| 106 ＝ 从站忙，拒绝了该信息 | |||
| 107 ＝ 从站拒绝了信息 | |||
| 108 ＝ 从站存储器奇偶错误 | |||
●如果多个 MBUS_MSG 指令同时使能会造成 6 号错误
●库存储区被程序其它地方复用，有时也会造成6 号错误
●从站 delay 参数设的时间过长会造成主站 3 号错误
●从站掉电或不运行，网络故障都会造成主站 3 号错误
3. 在 CPU 的 V 数据区中为库指令分配存储区（Library Memory）
Modbus Master 指令库需要一个284个字节的全局 V 存储区。
1.3 关于 Modbus RTU 主站协议及地址
此为西门子正式推出的标准库指令说明资料。
在 Modbus RTU Master 协议和 PPI 协议之间切换：
Modbus RTU Master 协议指令库使通信口工作在自由口模式下，此时不能与 Micro/WIN 软件通信。要在切换回 PPI 协议，可以：
●将 MBUS_CTRL 指令的 Mode 输入端设置为逻辑"0"
●将 CPU 的允许模式选择开关置为 STOP 位置
Modbus RTU Master 协议库的执行时间：
Modbus RTU Master 协议库的 MBUS_CTRL 指令不需要很长的执行时间。MBUS_需要 1.11 ms 用于初始化，在后续的每个扫描周期中只占用 0.41 ms。
调用 MBUS_MSG 子程序会加长处理时间。大部分时间都用于 CRC 校验的计算。每读、写一个字的数据就需要 1.85 ms 扫描时间。数据最多的情况下（读、写 120 字的数据），扫描时间大概会扩增加 222 ms。读操作的时间主要消耗在接收数据上；写操作的时间主要消耗在发送数据上。
Modbus 地址
通常 Modbus 地址由 5 位数字组成，包括起始的数据类型代号，以及后面的偏移地址。Modbus Master 协议库把标准的 Modbus 地址映射为所谓 Modbus 功能号，读写从站的数据。Modbus Master 协议库支持如下地址：
●00001 - 09999：数字量输出（ 线圈）
●10001 - 19999：数字量输入（触点）
●30001 - 39999：输入数据寄存器（通常为模拟量输入）
●40001 - 49999：数据保持寄存器
Modbus Master 协议库支持的功能
为了支持上述 Modbus 地址的读写，Modbus Master 协议库需要从站支持下列功能：
表 1. 需要从站支持的功能
| Modbus 地址 | 读/写 | Modbus 从站须支持的功能 |
| 00001 - 09999 数字量输出 | 读 | 功能 1 |
| 写 | 功能 5：写单输出点 功能 15：写多输出点 | |
| 10001 - 19999 数字量输入 | 读 | 功能 2 |
| 写 | － | |
| 30001 - 39999 输入寄存器 | 读 | 功能 4 |
| 写 | － | |
| 40001 - 49999 保持寄存器 | 读 | 功能 3 |
| 写 | 功能 6：写单寄存器单元 功能 16：写多寄存器单元 |
S7-200 通过 Modbus Master 和 Slave 协议库通信时，Modbus 地址和 S7-200 内存储区地址的 映射关系都类似。
Modbus 保持寄存器地址映射举例：
Modbus 数字量地址映射举例：
位地址（0xxxx 和 1xxxx）数据总是以字节为单位打包读写。第一个字节中的最低有效位对应 Modbus 地址的起始地址。如下图所示：
图 4. 数字量地址映射举例
1.4 Modbus RTU 主站常问问题
Modbus RTU 主站库对 CPU 的版本是否有要求，为什么编译例子程序时，会遇到 4 个错误？
Modbus RTU 主站库对 CPU 的版本确实有要求，CPU 的版本必须为 2.00 或者 2.01(即订货号为6ES721*－***23-0BA*)，1.22 版本之前（包括 1.22 版本）的 S7-200 CPU 不支持。
Modbus 指令库启动后，如何通过同一个通信端口进行 CPU 监控？
Modbus 指令库使用的是 CPU 的自由口通信功能，工作在自由口模式下的通讯口不能使用 Micro/WIN 的 PPI 编程通信监控。如果通信口都已经被占用，可以考虑：
●加一个通信模块（如 EM 277、CP 243-1、EM 241 等）扩展出一个编程通信口
●中止自由口模式，可以将 CPU 上的模式开关从 RUN 拨到 STOP；或者保持处于 RUN 状态，用程序停止指令库的 Modbus 模式（参见指令库应用）
如何理解 Modbus 地址与功能码的区别？
Modbus 地址与 Modbus 的功能码是两个层次的概念。
根据 Modbus 通信协议，Modbus 数据的地址使用 0xxxx、1xxxx、3xxxx 和 4xxxx 的形式，分别表示数字量输出、数字量输入、模拟量输入等数据地址。在使用 S7-200 的指令库时，Modbus 数据地址与 S7-200 的 I/O 和数据存储区地址间有特定的对应关系。
有些设备表明它支持 Modbus RTU 通信协议，但也详细提供了读写数据的详细通信帧格式，其中包括如何指定 Modbus 站的地址，需要读写数据类型、长度等等。数据帧有特定字节指出此指令读写的数据类型和地址，此字节的数据内容即所谓"功能码"，如功能 1 指定读取单个/多个数字量输出点的值。
支持 Modbus 协议的设备或软件，使用时用户直接设置或看到的应当是 Modbus 数据地址。Modbus 地址所访问的数据，是通过各种"功能"读写而来。功能码是 Modbus 地址的底层。如果 Modbus 通信的一方提供的所谓 Modbus 协议只有功能码，则需要注意了解此功能号与 Modbus 地址间的对应关系。
如何访问大于 9999 的保持寄存器地址？
通常 Modbus 协议的保持寄存器地址范围在 40001 - 49999 之间。对于多数应用来说已经够了。但有些 Modbus 从站把地址映射到保持寄存器区的地址超过 9999 的部分。
Modbus Master 协议库支持超过 9999 的保持寄存器地址。地址范围为 400001 - 465536。只需在调用 MBUS_MSG 子程序时给 Addr 参数赋相应的值即可，如 416768。
Modubs Master 扩展地址模式仅支持保持寄存器区，不支持其他地址类型。
S7-200 作为 Modbus 主站方接收上来的数据格式与第三方设备不一样怎么办？
西门子PLC数据的存储格式为高位低存方式。举例：VD200中包含VW200和VW202，其中VW202是低字，VW200是高字。若第三方设备与西门子数据存储格式不同，是低位低存的方式，那么通信上来的数据就会存在错误，需要进行转换才能使用。编程的方式比较多样，针对双字中高低字的交换可以使用SWAP(字交换）指令，若是字节交换可以考虑循环移位指令。
S7-200 是否支持如 Modbus TCP 等其它协议？
不支持。S7-200自身的通信端口或其通信扩展模块均不支持 Modbus TCP、CANopen、DeviceNet 以及 BACnet 通信协议。
为什么 S7-200 作 Modbus 主站时 MBUS_MSG 指令报6号错误？
引起6号错误主要有两方面的原因：1.多个 MBUS_MSG 指令同时使能执行；2. Modbus库存储区中分配的建议地址区与编程中已使用的V存储区有重叠。
1.5 Modbus RTU主站例程
2.Modbus RTU从站
2.1 CPU 上的通信口（Port0）支持 Modbus RTU 从站通信协议
S7-200 CPU上的通信口Port0可以支持Modbus RTU协议，成为Modbus RTU从站。此功能是通过S7-200的自由口通信模式实现，因此可以通过无线数据电台等慢速通信设备传输。
详情请参考《S7-200系统手册》之相关章节。
要实现Modbus RTU通信，需要STEP 7-Micro/WIN32 V3.2以上版本的编程软件，而且须安装STEP 7-Micro/WIN32 V3.2 Instruction Library（指令库）。Modbus RTU功能是通过指令库中预先编好的程序功能块实现的。
Modbus RTU从站指令库只支持CPU上的通信0口（Port0）。
2.2 编程基本步骤：
检查Micro/WIN的软件版本，应当是STEP 7-Micro/WIN V3.2以上版本。
检查Micro/WIN的指令树中是否存在Modbus RTU从站指令库（图1），库中应当包括MBUS_INIT和MBUS_SLAVE两个子程序。如果没有，须安装Micro/WIN32 V3.2的Instruction Library（指令库）软件包；
图1. 指令树中的库指令
编程时使用SM0.1调用子程序MBUS_INIT进行初始化，使用SM0.0调用MBUS_SLAVE，并指定相应参数。关于参数的详细说明，可在子程序的局部变量表中找到；
图2. 调用Modbus RTU通信指令库
图中参数意义如下：
a-模式选择：启动/停止Modbus，1=启动；0=停止
b-从站地址：Modbus从站地址，取值1~247
c-波特率：可选1200，2400，4800，9600，19200，38400，57600，115200
d-奇偶校验：0=无校验；1=奇校验；2=偶校验
e-延时：附加字符间延时，缺省值为0
f-最大I/Q位：参与通信的最大I/O点数，S7-200的I/O映像区为128/128，缺省值为128
g-最大AI字数：参与通信的最大AI通道数，可为16或32
h-最大保持寄存器区：参与通信的V存储区字（VW）
i-保持寄存器区起始地址：以&VBx指定（间接寻址方式）
j-初始化完成标志：成功初始化后置1
k-初始化错误代码
l-Modbus执行：通信中时置1，无 Modbus 通信活动时为 0。
m-错误代码：0=无错误
表 1. 从站错误代码
| 错误代码 | 描述 |
| 0 | 无错误 |
| 1 | 存储区范围错误 |
| 2 | 非法波特率或校验 |
| 3 | 非法从站地址 |
| 4 | Modbus 参数的非法值 |
| 5 | 保持寄存器与Modbus从站符号地址重复 |
| 6 | 接收校验错误 |
| 7 | 接收CRC错误 |
| 8 | 非法功能请求/不支持的功能 |
| 9 | 请求中有非法存储区地址 |
| 10 | 从站功能未使能 |
在图2的例子中，规定了 Modbus 保持寄存器区从 VB0 开始（HoldStart ＝ VB0），并且保持寄存器为1000个字（MaxHold＝1000），因保持寄存器以字（两个字节）为单位，实际上这个通信缓冲区占用了VB0～VB1999共2000个字节。因此分配库指令保留数据区时至少要从VB2000开始。当然保持区不一定要从VB0开始。
注意：你选用的CPU的V存储区大小！CPU型号不同V数据存储区大小不同。应根据需要选择Modbus保持寄存器区域的大小。
包含 Modbus RTU 从站指令库的项目编译、下载到CPU中后，在编程计算机（PG/PC）上运行一些 Modbus 测试软件可以检验S7-200的Modbus RTU通信是否正常，这对查找故障点很有用。测试软件通过计算机串口（RS-232）和PC/PPI电缆连接CPU。如果必要，须将PC/PPI电缆设置在自由口通信方式。
可到一些软件下载网站寻找类似软件，如 ModScan32 等。
2.3 Modbus RTU 从站地址与S7-200的地址对应
Modbus地址总是以00001、30004之类的形式出现。S7-200内部的数据存储区与Modbus的0、1、3、4共4类地址的对应关系如下：
表2. Modbus地址对应表
| Modbus地址 | S7-200数据区 |
| 00001 ~ 00128 | Q0.0 ~ Q15.7 |
| 10001 ~ 10128 | I0.0 ~ I15.7 |
| 30001 ~ 30032 | AIW0 ~ AIW62 |
| 40001 ~ 4xxxx | T ~ T + 2 * (xxxx -1) |
如果已知S7-200中的V存储区地址，推算Modbus地址的公式如下：
Modbus地址 = 40000 + (T/2+1) ; T为偶数
2.4 Modbus RTU 从站指令库支持的功能码
Modbus RTU 从站指令库支持特定的 Modbus 功能。访问使用此指令库的主站必须遵循这个指令库的要求。
表 3. Modbus RTU 从站功能码
| 功能码 | 主站使用相应功能码作用于此从站的效用 |
| 1 | 读取单个/多个线圈（离散量输出点）状态。 功能 1 返回任意个数输出点（Q）的 ON/OFF 状态。 |
| 2 | 读取单个/多个触点（离散量输入点）状态。 功能 2 返回任意个数输入点（I）的 ON/OFF 状态。 |
| 3 | 读取单个/多个保持寄存器。功能 3 返回 V 存储区的内容。在 Modbus 协议下保持寄存器都是"字"值，在一次请求中可以读取最多 120 个字的数据。 |
| 4 | 读取单个/多个输入寄存器。功能 4 返回 S7-200 的模拟量数据值。 |
| 5 | 写单个线圈（离散量输出点）。功能 5 用于将离散量输出点设置为指定的值。这个点不是被强制的，用户程序可以覆盖 Modbus 通信请求写入的值。 |
| 6 | 写单个保持寄存器。功能 6 写一个值到 S7-200 的 V 存储区的保持寄存器中。 |
| 15 | 写多个线圈（离散量输出点）。功能 15 把多个离散量输出点的值写到 S7-200 的输出映像寄存器（Q 区）。输出点的地址必须以字节边界起始（如 Q0.0 或 Q2.0），并且输出点的数目必须是 8 的整数倍。这是此 Modbus RTU 从站指令库的。些点不是被强制的，用户程序可以覆盖 Modbus 通信请求写入的值。 |
| 16 | 些多个保持寄存器。功能 16 写多个值到 S7-200 的 V 存储区的保持寄存器中。在一次请求中可以写最多 120 个字的数据。 |
2.7 Modbus RTU 从站常见问题
Modbus 从站的网络地址与 S7-200 的 CPU 网络地址有什么关系？
没有关系。支持网络通信的通信协议必须有其自己的网络寻址规定。 Modbus 从站的地址只是它在 Modbus 网络上的地址，而通常所说的 S7-200 CPU 地址是 CPU 在西门子的 PPI 网络上的站地址。S7-200 CPU 的大部分通信功能都通过 PPI 网络完成，例如编程、网络读写通信等。
如何理解 Modbus 地址与功能码的区别？
Modbus 地址与 Modbus 的功能码是两个层次的概念。
根据 Modbus 通信协议，Modbus 数据的地址使用 00xxx、10xxx、30xxx 和 40xxx 的形式，分别表示数字量输出、数字量输入、模拟量输入等数据地址。在使用 S7-200 的指令库时，Modbus 数据地址与 S7-200 的 I/O 和数据存储区地址间有特定的对应关系。
有些设备表明它支持 Modbus RTU 通信协议，但也详细提供了读写数据的详细通信帧格式，其中包括如何指定 Modbus 站的地址，需要读写数据类型、长度等等。数据帧有特定字节指出此指令读写的数据类型和地址，此字节的数据内容即所谓"功能码"，如功能 1 指定读取单个/多个数字量输出点的值。
支持 Modbus 协议的设备或软件，使用时用户直接设置或看到的应当是 Modbus 数据地址。Modbus 地址所访问的数据，是通过各种"功能"读写而来。功能码是 Modbus 地址的底层。如果 Modbus 通信的一方提供的所谓 Modbus 协议只有功能码，则需要注意了解此功能号与 Modbus 地址间的对应关系。
Modbus 指令库启动后，如何通过同一个通信端口进行 CPU 监控？
Modbus 指令库使用的是 CPU 的自由口通信功能，工作在自由口模式下的通讯口不能使用 Micro/WIN 的 PPI 编程通信监控。如果通信口都已经被占用，可以考虑：
●加一个通信模块（如 EM 277、CP 243-1、EM 241 等）扩展出一个编程通信口
●中止自由口模式，可以将 CPU 上的模式开关从 RUN 拨到 STOP；或者保持处于 RUN 状态，用程序停止指令库的 Modbus 模式（参见指令库应用）
为何有些 HMI 软件使用 Modbus RTU 读取S7-200中的实数会出现错误？
有些HMI软件使用Modbus RTU通信协议时，处理存储在数据保持寄存器中的实数（浮点数）的方式与西门子的实数保存格式不同。西门子的PLC遵循"高字节低地址、低字节高地址"的规律。
Modbus RTU的保持寄存器总是以"字（双字节）"为单位，而一个实数需要4个字节（双字）表示。HMI软件在处理时可能会把保持寄存器的两个"字"互换位置，造成不能识别以西门子格式表示的实数。如果HMI软件一方无法处理这种实数，则可在S7-200 CPU中编程将存入数据缓冲区（保持寄存器区）的实数的高字和低字互换。
为何有的HMI软件用Modbus RTU可以读取作为从站的S7-200的内容，但不能写入？
可能此软件使用了Modbus功能15（写多个离散量）或类似功能（功能 16）。S7-200从站协议遵守"以整字节地址边界（如Q0.0、Q2.0）开始、以8的整数倍为位个数"的规约。如果HMI软件未严格执行此规律就可能发生写入错误的情况。
S7-200是否支持 Modbus ASCII 模式？
S7-200可以支持上述模式，但是没有现成的指令库，需要用户自己编程。
项目编译后为何出现很多错误？
使用指令库时，若编译后出现很多错误，一般是因为未指定库指令数据存储区。请参考相关条目。
S7-200 CPU的Port1是否可以支持Modbus RTU协议？
可以。用户可以自己编程实现。
在S7-200的"Tips and Tricks"帮助文档中，Tip041是Modbus RTU从站程序，用户可以参考。
S7-200是否可以组成Modbus RTU通信网络？如何组网？
S7-200可以组成RS-485基础上的Modbus RTU网络。如果通信对象是不同标准的通信口，可能还需要转换。
3.STEP 7-Micro/WIN 的标准指令库
STEP 7-Micro/WIN V4.0 以上版内部已经带有新的指令库，但在未安装西门子 Instruction Library 软件包的情况下，不能显示出来使用。
3.1 分配库指令数据区
调用STEP 7 - Mciro/WIN32 V3.2 Instruction Library（指令库）需要分配库指令数据区（Library Memory）。库指令数据区是相应库的子程序和中断程序所要用到的变量存储空间。
如果在编程时不分配库指令数据区，编译时会产生许多相同的错误（错误18）。
操作步骤（以Modbus RTU库指令为例）：
在指令树的Project（项目）中，以鼠标右键单击Program Block（程序块），在弹出的快捷菜单中选择Library Memory。如图2所示：
图2
在弹出的选项卡中设置库指令数据区，如图2所示：
图3.缺省情况下是从VB0开始，但因为与Modbus的保持寄存区冲突，所以手动改为VB2000。按"Suggest Address"按钮也可以自动分配。
可以使用Suggest Address（推荐地址）设置数据区，但要注意编程软件设置的数据区地址，只考虑到了其他一般寻址，而未考虑到诸如Modbus数据保持寄存器区等的设置。应当确保不与其他任何已使用的数据区重叠、冲突。不应重复按Suggest Address按钮，否则也会造成混乱。
在STEP 7-Micro/WIN32 V3.1中，有分配库指令数据区时有不同的操作方法，需要在Symbol Table（符号表）中设置一个首地址。我们强烈建议使用当时最新的编程版本。下载本文
