libmodbus 3.0.6翻译

原地址： http://libmodbus.org/docs/v3.0.6/

描述

libmodbus 是一个和遵从modbus协议的设备之间收发数据的库。库中包含了多样的遵从网络模式的后端通讯（串口和TCP）。

背景

Modbus 协议有多种实现变体，为了缓解实现变量的困难，在库中，每一个变量有一个后台。每一个后台都指定一个独特的功能来new一个modbus_t 。modbus_t 是一个不开放的结构体，包含了所有的建立与其他设备通信的信息。有如下三种：

RTU Context、

TCP (IPv4) Context

TCP PI (IPv4 and IPv6) Context

TCP (IPv4)这里不需要校验，创建TCP (IPv4)环境需要 modbus_new_tcp(3)。

共同（commn）

在使用任何libmodbus功能之前，调用者必须使用以下的功能分配和初始化modbus_t环境。以下功能是用来修改和释放环境的。

Free libmodbus context

modbus_free(3)

Context setters and getters

modbus_get_byte_timeout(3)

 modbus_set_byte_timeout(3) 

modbus_set_debug(3) 

modbus_set_error_recovery(3) 

modbus_get_header_length(3)

modbus_get_response_timeout(3) 

modbus_set_response_timeout(3) 

modbus_set_slave(3)

 modbus_set_socket(3) 

modbus_get_socket(3)

libmodbus是线程安全的。能在各个应用的线程中随意使用

数据操作的宏命令

MODBUS_GET_HIGH_BYTE(data), extracts the high byte from a byte 提取高字节

MODBUS_GET_LOW_BYTE(data), extracts the low byte from a byte提取低字节MODBUS_GET_INT32_FROM_INT16(tab_int16, index), builds an int32 from the two first int16 starting at tab_int16[index]  在tabint16索引中构建一个int32

MODBUS_GET_INT16_FROM_INT8(tab_int8, index), builds an int16 from the two first int8 starting at tab_int8[index] 

MODBUS_SET_INT16_TO_INT8(tab_int8, index, value), set an int16 value into the two first bytes starting at tab_int8[index] 将一个int16值设置为两个字节

数据操作的功能

modbus_set_bits_from_byte(3) 

modbus_set_bits_from_bytes(3) 

modbus_get_byte_from_bits(3) 

modbus_get_float(3) 

modbus_set_float(3)

连接

Establish a connection 建立连接

modbus_connect(3)

Close a connection 关闭连接

modbus_close(3)

Flush a connection 清除连接

modbus_flush(3)

客户端 Client

modbus定义了不同的数据类型和功能来读写远端设备，一下功能是客户端发送modbus请求

Read data 读取数据

modbus_read_bits(3) 

modbus_read_input_bits(3) 

modbus_read_registers(3) 

modbus_read_input_registers(3) 

modbus_report_slave_id(3)

Write data 写入数据

modbus_write_bit(3) 

modbus_write_register(3) 

modbus_write_bits(3) 

modbus_write_registers(3)

Write and read data 读写数据

modbus_write_and_read_registers(3)

Raw requests 原始请求

modbus_send_raw_request(3) 

modbus_receive_confirmation(3)

Reply an exception 回复例外

modbus_reply_exception(3)

服务器

服务器等地客户端的请求，当收到请求之后，必须回复。以下功能处理请求

Data mapping:数据映射

 modbus_mapping_new(3) 

modbus_mapping_free(3)

Receive 接收

modbus_receive(3)

Reply 响应

modbus_reply(3) 

modbus_reply_exception(3)

错误处理

libmod功能按照标准的惯例，遵从 POSIX 系统来处理错误。

这意味着，根据失败的种类，libmodbus 要返回

Null（返回指针）

负值（返回整数）

错误码要存储到errno 中。

modbus_strerror()功能转换libmodbus特殊信息错误码成为错误信息字符串，详见 modbus_strerror(3)。