libmodbus官方手册中文翻译.pdf

1

libmodbus 官方手册中文翻译

3、设置从站 ID

4、读取保持寄存器/读取输入寄存器/读取位

5、写单寄存器/写多寄存器/写多位数据

6、关闭连接

2

目录

libmodbus 官方手册中文翻译 ................................................................................................................................................. 1

一、libmodbus .......................................................................................................................................................................... 4

特点 ................................................................................................................................................................................... 4

概要 ................................................................................................................................................................................... 4

4、TCP PI（IPv4 和 IPv6）环境 .................................................................................................................................... 9

三、通用函数： ..................................................................................................................................................................... 11

1、modbus_free .............................................................................................................................................................. 11

2、modbus_set_slave ...................................................................................................................................................... 11

1）若为 RTU 模式 ................................................................................................................................................. 12

2）若为 TCP 模式 .................................................................................................................................................. 12

3、modbus_set_debug .................................................................................................................................................... 12

4、超时设置： ............................................................................................................................................................... 12

1）modbus_get_byte_timeout ................................................................................................................................. 13

2）modbus_set_byte_timeout ................................................................................................................................. 13

5、用于数据操作的宏 ................................................................................................................................................... 16

6、设置或获取浮点数 ................................................................................................................................................... 18

1）modbus_get_float_abcd ..................................................................................................................................... 18

2）modbus_set_float_abcd ..................................................................................................................................... 18

3）modbus_get_float_badc ..................................................................................................................................... 18

4）modbus_set_float_badc ..................................................................................................................................... 18

5）modbus_get_float_cdab ..................................................................................................................................... 18

6）modbus_set_float_cdab ..................................................................................................................................... 19

7）modbus_get_float_dcba ..................................................................................................................................... 19

8）modbus_set_float_dcba ..................................................................................................................................... 19

1）读取位（读取线圈状态） ............................................................................................................................... 22

2）读取输入位（读取输入状态） ....................................................................................................................... 22

3）读取保持寄存器 ............................................................................................................................................... 22

3

4）读取输入寄存器 ............................................................................................................................................... 23

5）读取控制器（controller） ................................................................................................................................ 24

2、写数据 ....................................................................................................................................................................... 25

1）写一位数据（强置单线圈） ........................................................................................................................... 25

2）写单寄存器（预置单寄存器） ....................................................................................................................... 25

3）写多位数据（强置多线圈） ........................................................................................................................... 25

六、从机（服务器 server） .................................................................................................................................................. 29

1、数据映射 ................................................................................................................................................................... 29

1）分配位（线圈）和寄存器的数组 ................................................................................................................... 29

2）释放 modbus_mapping_t 结构......................................................................................................................... 29

2、接收 ........................................................................................................................................................................... 30

3、回复 ........................................................................................................................................................................... 30

4、发送异常响应 ........................................................................................................................................................... 30

5、错误处理 ................................................................................................................................................................... 31

七、杂项 ................................................................................................................................................................................. 32

4

一、libmodbus

版本号：V3.0.6(已加入 3.1.4 版本补充)

libmodbus 是一个与使用 Modbus 协议的设备进行数据发送/接收的库。该库包含各种后端（backends）通过不

同网络进行通信（例如，RTU 模式下的串口或 TCP / IPv6 中的以太网）。

http://www.modbus.org 网站提供了协议规范文档

http://www.modbus.org/specs.php。

libmodbus 提供了较低通信层的抽象，并在所有支持的平台上提供相同的 API。

本文档介绍了了 libmodbus 概念，介绍了 libmodbus 如何从在不同的硬件和平台中实现 Modbus 通信，并为

libmodbus 库提供的函数提供了参考手册。

环境(contexts)

Modbus 协议包含许多变体（例如串行 RTU 或 Ehternet TCP），为了简化变体的实现，该库被设计成为每个变体

使用后端（backends）。后端也是满足其他要求（例如实时操作）的便捷方法。每个后端都提供了一个特定的函数

5

二、RTU 环境

RTU 是可用于 Modbus 的最常用的实现方式。Modbus RTU 消息必须连续发送，不能有字符间隔（摘自 Wikipedia，

Modbus， http://en.wikipedia.org/wiki/Modbus 截至 2011 年 3 月 13 日，格林尼治时间 20:51）。

Modbus RTU 框架调用一个从站，一个处理 Modbus 请求的设备/服务器，以及一个发送请求的客户端（主站）。

通信始终由主站服务端发起。

许多 Modbus 设备可以在同一个的物理链路上连接在一起（总线结构），因此在发送消息之前，必须使用

modbus_set_slave 设置从站（接收设备 ）ID。如果您正在运行一个从站，则其从站号将用于过滤接收的消息。

1、创建 modbus RTU 环境

初试化 RTU 环境指针 modbus_t *modbus_new_rtu(const char *device, int baud, char parity, int data_bit,

int stop_bit)

ctx = modbus_new_rtu("/dev/ttyUSB0", 115200, 'N', 8, 1);

if (ctx == NULL) {

fprintf(stderr, "Unable to create the libmodbus context\n");

return -1;

}

这个 modbus_new_rtu()函数会生成并初始化一个 modbus 的结构体来在串行线路中使用 RTU 模式进行通讯。

device 指定 OS 处理的串行端口的名称，比如 /dev/ttyS0 or /dev/ttyUSB0，在 windows 系统上，如果 COM

编 号 大 于 9 ， 必 须 要 在 COM 前 加 上 \\.\ ， 比 如 \\\\.\\COM10. ， 参 照

http://msdn.microsoft.com/en-us/library/aa365247(v=vs.85).aspx

baud ：指定连接的波特率，比如 9600, 19200, 57600, 115200 等。