Modbus2MQTT 项目教程

Modbus2MQTT 项目教程

modbus2mqttModbus master which publishes via MQTT项目地址:https://gitcode.com/gh_mirrors/mo/modbus2mqtt

1. 项目的目录结构及介绍

Modbus2MQTT 项目的目录结构如下：

modbus2mqtt/
├── LICENSE
├── README.md
├── example_register_definition.csv
├── modbus2mqtt.py

• LICENSE: 项目的许可证文件，采用 MIT 许可证。
• README.md: 项目的说明文档，包含项目的基本信息和使用方法。
• example_register_definition.csv: 示例注册表定义文件，用于配置 Modbus 设备的注册表。
• modbus2mqtt.py: 项目的启动文件，包含主程序逻辑。

2. 项目的启动文件介绍

modbus2mqtt.py 是项目的启动文件，主要负责以下功能：

• 初始化 MQTT 客户端和 Modbus 主设备。
• 读取配置文件并根据配置进行连接和数据交换。
• 持续轮询 Modbus 从设备并发布注册值到 MQTT 主题。

启动文件的关键代码片段如下：

# 初始化 MQTT 客户端
client = mqtt.Client(client_id=config['mqtt']['client_id'])
client.on_connect = on_connect
client.on_message = on_message
client.connect(config['mqtt']['host'], config['mqtt']['port'], 60)

# 初始化 Modbus 主设备
master = modbus_tk.modbus_rtu.RtuMaster(serial.Serial(config['modbus']['port']))
master.set_timeout(5.0)
master.set_verbose(True)

# 主循环
client.loop_forever()

3. 项目的配置文件介绍

Modbus2MQTT 项目的配置文件通常是一个 YAML 文件，位于 data 文件夹中，名为 configuration.yaml。以下是一个最小配置示例：

mqtt:
  base_topic: modbus2mqtt
  server: 'mqtt://localhost'
modbus:
  port: /dev/tty

• mqtt: MQTT 配置部分，包含 base_topic 和 server 两个参数。
  • base_topic: MQTT 主题前缀，用于订阅和发布消息。
  • server: MQTT 服务器地址，默认为 mqtt://localhost。
• modbus: Modbus 配置部分，包含 port 参数。
  • port: Modbus 串行端口路径，例如 /dev/tty。

配置文件的具体参数可以根据实际需求进行调整。

---

以上是 Modbus2MQTT 项目的目录结构、启动文件和配置文件的详细介绍。希望这份教程能帮助你更好地理解和使用该项目。

modbus2mqttModbus master which publishes via MQTT项目地址:https://gitcode.com/gh_mirrors/mo/modbus2mqtt