MODBUS通讯：libmodbus库使用方法

秒速五厘米 2022-12-21 03:13 528阅读 0赞

## MODBUS通讯：libmodbus库使用方法 ##

libmodbus是一个快速、跨平台的Modbus库，目前支持Linux, Mac OS X, FreeBSD, QNX和Windows系统。libmodbus版本号：v3.0.8(已加入v3.1.6版本补充)。

libmodbus是可以与使用Modbus协议的设备进行数据发送/接收的库。该库包含各种后端（backends）以支持通过不同网络进行通信（例如，RTU模式下的串口或TCP / IPv6中的以太网）。

[http://www.modbus.org][http_www.modbus.org]网站提供了协议规范文档[http://www.modbus.org/specs.php][http_www.modbus.org_specs.php]。

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

### 环境(contexts) ###

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

后端也是满足其他要求（例如实时操作）的便捷方法。每个后端都提供了一个特定的函数来创建一个新的*modbus\_t环境。*

modbus\_t环境是一个不透明的结构，包含根据所选变体与其他Modbus设备建立连接的所有必要信息。

你可以选择以下最适合你需要的环境：

**RTU环境**

RTU后端（远程终端单元）用于串口通信，并使用用于协议通信的数据紧凑二进制表示形式。

RTU格式遵循命令/数据和CRC（cyclic redundancy check，循环冗余校验）作为错误检查机制，以确保数据的可靠性。

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

Modbus RTU框架包含一个处理Modbus请求的设备/服务器（从站），以及一个发送请求的客户端（主站）。通信始终由主站服务端发起。

许多Modbus设备可以在同一个的物理链路上连接在一起（总线结构），因此在发送消息之前，**必须使用modbus\_set\_slave设置从站（接收设备 ）ID**。如果您正在运行一个从站，则其从站号将用于过滤接收的消息。

RTU的libmodbus实现不像最初的Modbus规范中所述的那样基于时间，相反，所有字节都被尽可能快地发送，当收到所有预期的字符时，一个响应或指示被认为是完成的。

这个实现提供了非常快的通信，但是您必须注意将从服务器的响应超时设置为小于主服务器的响应超时(否则，当其中一个从服务器没有响应时，其他从服务器可能会忽略主服务器请求)。

相关函数如下：

创建一个Modbus TCP环境：[modbus\_new\_tcp\_pi(3)][modbus_new_tcp_pi_3]

**通用函数：**

在使用任何libmodbus函数之前，调用者必须分配和初始化一个modbus\_t上下文，然后提供以下函数来修改和释放上下文：

释放libmodbus上下文：[modbus\_free(3)][modbus_free_3]

设置从站ID：[modbus\_set\_slave(3)][modbus_set_slave_3]

启用调试模式：[modbus\_set\_debug(3)][modbus_set_debug_3]

超时时间设置：[modbus\_get\_byte\_timeout(3)][modbus_get_byte_timeout_3] [modbus\_set\_byte\_timeout(3)][modbus_set_byte_timeout_3] [modbus\_get\_response\_timeout(3)][modbus_get_response_timeout_3] [modbus\_set\_response\_timeout(3)][modbus_set_response_timeout_3] [modbus\_get\_indication\_timeout(3)][modbus_get_indication_timeout_3] [modbus\_set\_indication\_timeout(3)][modbus_set_indication_timeout_3]

错误恢复模式：[modbus\_set\_error\_recovery(3)][modbus_set_error_recovery_3]

内部套接字的Setter/getter方法：[modbus\_set\_socket(3)][modbus_set_socket_3] [modbus\_get\_socket(3)][modbus_get_socket_3]

头信息：[modbus\_get\_header\_length(3)][modbus_get_header_length_3]

用于数据操作的宏：

1.  MODBUS\_GET\_HIGH\_BYTE(data), extracts the high byte from a byte
2.  MODBUS\_GET\_LOW\_BYTE(data), extracts the low byte from a byte
3.  MODBUS\_GET\_INT64\_FROM\_INT16(tab\_int16, index), builds an int64 from the four first int16 starting at tab\_int16\[index\]
4.  MODBUS\_GET\_INT32\_FROM\_INT16(tab\_int16, index), builds an int32 from the two first int16 starting at tab\_int16\[index\]
5.  MODBUS\_GET\_INT16\_FROM\_INT8(tab\_int8, index), builds an int16 from the two first int8 starting at tab\_int8\[index\]
6.  MODBUS\_SET\_INT16\_TO\_INT8(tab\_int8, index, value), set an int16 value into the two first bytes starting at tab\_int8\[index\]
7.  MODBUS\_SET\_INT32\_TO\_INT16(tab\_int16, index, value), set an int32 value into the two first int16 starting at tab\_int16\[index\]
8.  MODBUS\_SET\_INT64\_TO\_INT16(tab\_int16, index, value), set an int64 value into the four first int16 starting at tab\_int16\[index\]

位和字节的处理：[modbus\_set\_bits\_from\_byte(3)][modbus_set_bits_from_byte_3] [modbus\_set\_bits\_from\_bytes(3)][modbus_set_bits_from_bytes_3] [modbus\_get\_byte\_from\_bits(3)][modbus_get_byte_from_bits_3]

设置或获取浮点数：

[modbus\_get\_float\_abcd(3)][modbus_get_float_abcd_3] [modbus\_set\_float\_abcd(3)][modbus_set_float_abcd_3]

[modbus\_get\_float\_badc(3)][modbus_get_float_badc_3] [modbus\_set\_float\_badc(3)][modbus_set_float_badc_3]

[modbus\_get\_float\_cdab(3)][modbus_get_float_cdab_3] [modbus\_set\_float\_cdab(3)][modbus_set_float_cdab_3]

[modbus\_get\_float\_dcba(3)][modbus_get_float_dcba_3] [modbus\_set\_float\_dcba(3)][modbus_set_float_dcba_3]

[modbus\_get\_float(3)][modbus_get_float_3] (弃用) [modbus\_set\_float(3)][modbus_set_float_3] (弃用)

### **连接** ###

提供以下功能来建立和关闭与Modbus设备的连接。

建立连接：[modbus\_connect(3)][modbus_connect_3]

关闭连接：[modbus\_close(3)][modbus_close_3]

Flush连接：[modbus\_flush(3)][modbus_flush_3]

### **客户端** ###

Modbus协议定义了不同的数据类型和函数来从远程设备读取和写入数据。下面的函数被客户端用来发送Modbus请求。

读取数据：[modbus\_read\_bits(3)][modbus_read_bits_3] [modbus\_read\_input\_bits(3)][modbus_read_input_bits_3] [modbus\_read\_registers(3)][modbus_read_registers_3] [modbus\_read\_input\_registers(3)][modbus_read_input_registers_3] [modbus\_report\_slave\_id(3)][modbus_report_slave_id_3]

写入数据：[modbus\_write\_bit(3)][modbus_write_bit_3] [modbus\_write\_register(3)][modbus_write_register_3] [modbus\_write\_bits(3)][modbus_write_bits_3] [modbus\_write\_registers(3)][modbus_write_registers_3]

读写数据：[modbus\_write\_and\_read\_registers(3)][modbus_write_and_read_registers_3]

原始请求：[modbus\_send\_raw\_request(3)][modbus_send_raw_request_3] [modbus\_receive\_confirmation(3)][modbus_receive_confirmation_3]

回复例外：[modbus\_reply\_exception(3)][modbus_reply_exception_3]

### **服务器** ###

服务器在等待来自客户端的请求，并且必须在与请求相关时做出回应。

在TCP模式下，您不能使用通常的[modbus\_connect(3)][modbus_connect_3]来建立连接，而是使用一对accept/listen调用[modbus\_tcp\_listen(3)][modbus_tcp_listen_3] [modbus\_tcp\_accept(3)][modbus_tcp_accept_3] [modbus\_tcp\_pi\_listen(3)][modbus_tcp_pi_listen_3] [modbus\_tcp\_pi\_accept(3)][modbus_tcp_pi_accept_3].

然后就可以使用[modbus\_receive(3)][modbus_receive_3]接收数据了，响应可以用[modbus\_reply(3)][modbus_reply_3] [modbus\_reply\_exception(3)][modbus_reply_exception_3]发送。

为了处理你的Modbus数据的映射，你必须使用：[modbus\_mapping\_new(3)][modbus_mapping_new_3] [modbus\_mapping\_free(3)][modbus_mapping_free_3]。

### 错误处理 ###

libmodbus函数使用POSIX系统上的标准约定处理错误。

通常，这意味着在失败时，libmodbus函数要么返回NULL值(如果返回指针)，要么返回负值(如果返回整数)，而实际的错误代码将存储在errno变量中。

库提供了modbus\_strerror()函数来将libmodbus特定的错误代码转换成错误消息字符串；详情请参考modbus\_strerror(3)。

### 杂项 ###

LIBMODBUS\_VERSION\_STRING常量表示程序编译时所针对的libmodbus版本。

变量libmodbus\_version\_major, libmodbus\_version\_minor, libmodbus\_version\_micro给出程序链接的版本。

### 作者 ###

libmodbus文档由Stephane Raimbault < stephane.raimbault@gmail.com >编写

### 资源 ###

主要网站：[http://www.libmodbus.org/][http_www.libmodbus.org]

错误报告：[http://github.com/stephane/libmodbus/issues][http_github.com_stephane_libmodbus_issues].

### 版权 ###

本软件的免费使用是在GNU Lesser General Public License (LGPL v2.1+)的条款下授予的。有关详细信息，请参阅包含在libmodbus发行版中的文件 `COPYING.LESSER` 。

[http_www.modbus.org]: http://www.modbus.org/
[http_www.modbus.org_specs.php]: https://link.jianshu.com/?t=http://www.modbus.org/specs.php
[modbus_new_rtu_3]: https://libmodbus.org/docs/v3.1.6/modbus_new_rtu.html
[modbus_rtu_get_serial_mode_3]: https://libmodbus.org/docs/v3.1.6/modbus_rtu_get_serial_mode.html
[modbus_rtu_set_serial_mode_3]: https://libmodbus.org/docs/v3.1.6/modbus_rtu_set_serial_mode.html
[modbus_rtu_get_rts_3]: https://libmodbus.org/docs/v3.1.6/modbus_rtu_get_rts.html
[modbus_rtu_set_rts_3]: https://libmodbus.org/docs/v3.1.6/modbus_rtu_set_rts.html
[modbus_rtu_set_custom_rts_3]: https://libmodbus.org/docs/v3.1.6/modbus_rtu_set_custom_rts.html
[modbus_rtu_get_rts_delay_3]: https://libmodbus.org/docs/v3.1.6/modbus_rtu_get_rts_delay.html
[modbus_rtu_set_rts_delay_3]: https://libmodbus.org/docs/v3.1.6/modbus_rtu_set_rts_delay.html
[modbus_new_tcp_3]: https://libmodbus.org/docs/v3.1.6/modbus_new_tcp.html
[modbus_new_tcp_pi_3]: https://libmodbus.org/docs/v3.1.6/modbus_new_tcp_pi.html
[modbus_free_3]: https://libmodbus.org/docs/v3.1.6/modbus_free.html
[modbus_set_slave_3]: https://libmodbus.org/docs/v3.1.6/modbus_set_slave.html
[modbus_set_debug_3]: https://libmodbus.org/docs/v3.1.6/modbus_set_debug.html
[modbus_get_byte_timeout_3]: https://libmodbus.org/docs/v3.1.6/modbus_get_byte_timeout.html
[modbus_set_byte_timeout_3]: https://libmodbus.org/docs/v3.1.6/modbus_set_byte_timeout.html
[modbus_get_response_timeout_3]: https://libmodbus.org/docs/v3.1.6/modbus_get_response_timeout.html
[modbus_set_response_timeout_3]: https://libmodbus.org/docs/v3.1.6/modbus_set_response_timeout.html
[modbus_get_indication_timeout_3]: https://libmodbus.org/docs/v3.1.6/modbus_get_indication_timeout.html
[modbus_set_indication_timeout_3]: https://libmodbus.org/docs/v3.1.6/modbus_set_indication_timeout.html
[modbus_set_error_recovery_3]: https://libmodbus.org/docs/v3.1.6/modbus_set_error_recovery.html
[modbus_set_socket_3]: https://libmodbus.org/docs/v3.1.6/modbus_set_socket.html
[modbus_get_socket_3]: https://libmodbus.org/docs/v3.1.6/modbus_get_socket.html
[modbus_get_header_length_3]: https://libmodbus.org/docs/v3.1.6/modbus_get_header_length.html
[modbus_set_bits_from_byte_3]: https://libmodbus.org/docs/v3.1.6/modbus_set_bits_from_byte.html
[modbus_set_bits_from_bytes_3]: https://libmodbus.org/docs/v3.1.6/modbus_set_bits_from_bytes.html
[modbus_get_byte_from_bits_3]: https://libmodbus.org/docs/v3.1.6/modbus_get_byte_from_bits.html
[modbus_get_float_abcd_3]: https://libmodbus.org/docs/v3.1.6/modbus_get_float_abcd.html
[modbus_set_float_abcd_3]: https://libmodbus.org/docs/v3.1.6/modbus_set_float_abcd.html
[modbus_get_float_badc_3]: https://libmodbus.org/docs/v3.1.6/modbus_get_float_badc.html
[modbus_set_float_badc_3]: https://libmodbus.org/docs/v3.1.6/modbus_set_float_badc.html
[modbus_get_float_cdab_3]: https://libmodbus.org/docs/v3.1.6/modbus_get_float_cdab.html
[modbus_set_float_cdab_3]: https://libmodbus.org/docs/v3.1.6/modbus_set_float_cdab.html
[modbus_get_float_dcba_3]: https://libmodbus.org/docs/v3.1.6/modbus_get_float_dcba.html
[modbus_set_float_dcba_3]: https://libmodbus.org/docs/v3.1.6/modbus_set_float_dcba.html
[modbus_get_float_3]: https://libmodbus.org/docs/v3.1.6/modbus_get_float.html
[modbus_set_float_3]: https://libmodbus.org/docs/v3.1.6/modbus_set_float.html
[modbus_connect_3]: https://libmodbus.org/docs/v3.1.6/modbus_connect.html
[modbus_close_3]: https://libmodbus.org/docs/v3.1.6/modbus_close.html
[modbus_flush_3]: https://libmodbus.org/docs/v3.1.6/modbus_flush.html
[modbus_read_bits_3]: https://libmodbus.org/docs/v3.1.6/modbus_read_bits.html
[modbus_read_input_bits_3]: https://libmodbus.org/docs/v3.1.6/modbus_read_input_bits.html
[modbus_read_registers_3]: https://libmodbus.org/docs/v3.1.6/modbus_read_registers.html
[modbus_read_input_registers_3]: https://libmodbus.org/docs/v3.1.6/modbus_read_input_registers.html
[modbus_report_slave_id_3]: https://libmodbus.org/docs/v3.1.6/modbus_report_slave_id.html
[modbus_write_bit_3]: https://libmodbus.org/docs/v3.1.6/modbus_write_bit.html
[modbus_write_register_3]: https://libmodbus.org/docs/v3.1.6/modbus_write_register.html
[modbus_write_bits_3]: https://libmodbus.org/docs/v3.1.6/modbus_write_bits.html
[modbus_write_registers_3]: https://libmodbus.org/docs/v3.1.6/modbus_write_registers.html
[modbus_write_and_read_registers_3]: https://libmodbus.org/docs/v3.1.6/modbus_write_and_read_registers.html
[modbus_send_raw_request_3]: https://libmodbus.org/docs/v3.1.6/modbus_send_raw_request.html
[modbus_receive_confirmation_3]: https://libmodbus.org/docs/v3.1.6/modbus_receive_confirmation.html
[modbus_reply_exception_3]: https://libmodbus.org/docs/v3.1.6/modbus_reply_exception.html
[modbus_tcp_listen_3]: https://libmodbus.org/docs/v3.1.6/modbus_tcp_listen.html
[modbus_tcp_accept_3]: https://libmodbus.org/docs/v3.1.6/modbus_tcp_accept.html
[modbus_tcp_pi_listen_3]: https://libmodbus.org/docs/v3.1.6/modbus_tcp_pi_listen.html
[modbus_tcp_pi_accept_3]: https://libmodbus.org/docs/v3.1.6/modbus_tcp_pi_accept.html
[modbus_receive_3]: https://libmodbus.org/docs/v3.1.6/modbus_receive.html
[modbus_reply_3]: https://libmodbus.org/docs/v3.1.6/modbus_reply.html
[modbus_mapping_new_3]: https://libmodbus.org/docs/v3.1.6/modbus_mapping_new.html
[modbus_mapping_free_3]: https://libmodbus.org/docs/v3.1.6/modbus_mapping_free.html
[http_www.libmodbus.org]: http://www.libmodbus.org/
[http_github.com_stephane_libmodbus_issues]: http://github.com/stephane/libmodbus/issues