# modbus.py 函数文档 Modbus协议实现模块，用于与温度传感器和流量计等设备通信。 ## Modbus功能码常量 - READ_COILS (0x01): 读线圈寄存器
- READ_DISCRETE_INPUTS (0x02): 读离散输入寄存器
- READ_HOLDING_REGISTERS (0x03): 读保持寄存器
- READ_INPUT_REGISTER (0x04): 读输入寄存器
- H05 (0x05): 写单个线圈寄存器
- WRITE_MULTIPLE_COILS (0x0F): 写多个线圈寄存器
- WRITE_SINGLE_REGISTER (0x06): 写单个保持寄存器
- WRITE_MULTIPLE_REGISTERS (0x10): 写多个保持寄存器 ## modbus_host 类 ### 初始化
python
def __init__(self, port=2, baudrate=9600)

- 功能: 初始化Modbus主机
- 参数:
- port: 串口号（默认2）
- baudrate: 波特率（默认9600） ### 读取功能 #### H01_read_coils
python
def H01_read_coils(self, slave_addr, starting_address, coil_quantity)

- 功能: 读取线圈状态
- 参数:
- slave_addr: 从机地址
- starting_address: 起始地址
- coil_quantity: 线圈数量（最少8个）
- 返回值: 线圈状态列表 #### H02_read_discrete_input
python
def H02_read_discrete_input(self, slave_addr, starting_address, input_quantity)

- 功能: 读取离散输入状态
- 参数:
- slave_addr: 从机地址
- starting_address: 起始地址
- input_quantity: 输入点数量
- 返回值: 输入状态列表 #### H03_read_hold_register
python
def H03_read_hold_register(self, slave_addr, starting_address, register_quantity, signed=True)

- 功能: 读取保持寄存器
- 参数:
- slave_addr: 从机地址
- starting_address: 起始地址
- register_quantity: 寄存器数量
- signed: 是否有符号（默认True）
- 返回值: 寄存器值列表 #### H04_read_input_register
python
def H04_read_input_register(self, slave_addr, starting_address, register_quantity, signed=True)

- 功能: 读取输入寄存器
- 参数:
- slave_addr: 从机地址
- starting_address: 起始地址
- register_quantity: 寄存器数量
- signed: 是否有符号（默认True）
- 返回值: 寄存器值列表 ### 写入功能 #### H05_write_coil
python
def H05_write_coil(self, slave_addr, output_address, output_value)

- 功能: 写入单个线圈
- 参数:
- slave_addr: 从机地址
- output_address: 输出地址
- output_value: 输出值
- 返回值: 操作结果 #### H06_write_single_register
python
def H06_write_single_register(self, slave_addr, register_address, register_value, signed=True)

- 功能: 写入单个寄存器
- 参数:
- slave_addr: 从机地址
- register_address: 寄存器地址
- register_value: 寄存器值
- signed: 是否有符号（默认True）
- 返回值: 操作结果 #### H0F_write_multi_coils
python
def H0F_write_multi_coils(self, slave_addr, starting_address, output_values)

- 功能: 写入多个线圈
- 参数:
- slave_addr: 从机地址
- starting_address: 起始地址
- output_values: 输出值列表
- 返回值: 操作结果 #### H10_write_multi_registers
python
def H10_write_multi_registers(self, slave_addr, register_address, register_values, signed=True)

- 功能: 写入多个寄存器
- 参数:
- slave_addr: 从机地址
- register_address: 寄存器地址
- register_values: 寄存器值列表
- signed: 是否有符号（默认True）
- 返回值: 操作结果 ## 使用示例 ### 温度传感器读取
python
modbus_485 = modbus_host(2, 9600)
# 读取4路温度传感器数据
temperatures = modbus_485.H04_read_input_register(2, 0, 4)
### 流量计控制
python
modbus_485 = modbus_host(2, 9600)
# 读取12路流量计设定值
flow_settings = modbus_485.H03_read_hold_register(1, 400, 12)

# 设置12路流量值
flow_values = [1000, 100, 200, 300, 400, 500, 600, 500, 500, 500, 0, 0]
modbus_485.H10_write_multi_registers(1, 400, flow_values)

# 读取12路实际流量值
actual_flows = modbus_485.H04_read_input_register(1, 0, 12)
## 设备地址映射 ### 温度传感器 (从机地址: 2)
- 功能: 4路温度AI值读取
- 寄存器类型: 输入寄存器
- 起始地址: 0
- 数量: 4 ### 流量计 (从机地址: 1)
1. 设定值
- 功能: 12路流量控制
- 寄存器类型: 保持寄存器
- 起始地址: 400
- 数量: 12 2. 实际值
- 功能: 12路流量读取
- 寄存器类型: 输入寄存器
- 起始地址: 0
- 数量: 12 ## 注意事项 1. 波特率默认9600，确保与设备匹配
2. 读取线圈时数量至少需要8个
3. 有符号数默认开启，根据设备要求设置
4. 温度传感器和流量计使用不同的从机地址
5. 写入操作前建议先读取当前值
6. 多寄存器操作时注意地址连续性
7. 错误处理需要在应用层实现