thingsboard/tb-modbus-pool-emulator

泳池过滤系统ModBus模拟器（ThingsBoard解决方案模板专用）

镜像概述

本Docker镜像提供了一个针对ThingsBoard解决方案模板的泳池过滤系统ModBus模拟器。该模拟器能够模拟泳池过滤系统的ModBus协议通信行为，为ThingsBoard平台提供虚拟的设备数据，支持开发、测试及演示场景中对泳池过滤设备的远程监控与管理功能验证。

核心功能与特性

• ModBus协议模拟：支持ModBus RTU/ASCII协议，模拟泳池过滤系统的标准ModBus通信流程
• 设备参数模拟：可模拟泳池过滤系统关键运行参数，如水流速、过滤器压力、水温、pH值等
• ThingsBoard集成：与ThingsBoard解决方案模板无缝对接，支持设备注册、数据上报及命令响应
• 可配置性：支持通过环境变量自定义模拟参数范围、数据更新频率及ModBus通信参数

使用场景

• ThingsBoard平台泳池监控解决方案的开发与测试
• 演示环境中模拟真实泳池过滤设备的数据采集与控制流程
• 培训场景下展示ModBus协议设备与IoT平台的集成方法
• 离线环境中验证泳池过滤系统远程监控功能的逻辑正确性

使用方法

基本运行命令

bash
docker run -d --name pool-filter-modbus-emulator -p 502:502 docker.xuanyuan.run/thingsboard/pool-filter-modbus-emulator

Docker Compose配置示例

yaml
version: '3'
services:
  pool-emulator:
    image: docker.xuanyuan.run/thingsboard/pool-filter-modbus-emulator
    container_name: pool-filter-emulator
    ports:
      - "502:502"  # ModBus默认端口
    environment:
      - MODBUS_SLAVE_ID=1  # ModBus从站地址
      - UPDATE_INTERVAL=5000  # 数据更新间隔（毫秒）
      - WATER_TEMP_MIN=25  # 水温最小值（℃）
      - WATER_TEMP_MAX=30  # 水温最大值（℃）
      - PRESSURE_MIN=1.0  # 过滤器压力最小值（bar）
      - PRESSURE_MAX=2.5  # 过滤器压力最大值（bar）
    restart: unless-stopped

配置参数

与ThingsBoard集成

1. 在ThingsBoard平台中导入泳池过滤系统解决方案模板
2. 添加ModBus类型设备，配置配从站地址与本模拟器一致
3. 配置ModBus数据点映射，对应模拟器提供的寄存器地址
4. 启动模拟器后，平台将自动接收模拟的设备运行数据

注意事项

• 确保宿主机端口502未被其他服务占用
• 调整模拟参数时需重启容器使配置生效
• 生产环境中仅用于测试与演示，不建议用于实际设备监控