ocervinka/plccoms-mqtt-bridge

plccoms-mqtt-bridge 镜像文档

概述

plccoms-mqtt-bridge 是一个轻量级Docker镜像，提供Teco PLCComS协议与MQTT消息代理之间的双向通信桥接功能。该镜像旨在解决工业自动化场景中，PLC设备与基于MQTT的物联网平台间的数据互通问题，支持数据的实时采集与远程控制指令的下发。

核心功能与特性

• 双向数据传输：实现PLCComS设备数据向MQTT broker的实时推送，以及MQTT消息向PLC设备的指令下发
• 协议转换：自动处理PLCComS协议与MQTT消息格式的转换，无需手动编码
• 灵活配置：支持通过环境变量配置连接参数、数据映射规则等
• 连接可靠性：内置连接状态监控与自动重连机制，确保通信稳定性
• 轻量级设计：基于精简基础镜像构建，资源占用低，适合边缘计算环境部署

使用场景

• 工业自动化系统中PLC设备数据采集与监控
• 基于MQTT的物联网平台与PLC设备的集成
• 远程控制PLC设备的场景（如通过MQTT消息下发控制指令）
• 工业数据中台的数据接入层组件

使用方法

基本部署（docker run）

bash
docker run -d \
  --name plccoms-mqtt-bridge \
  -e PLCCOM_HOST=192.168.1.100 \  # PLCComS服务器IP地址
  -e PLCCOM_PORT=502 \             # PLCComS通信端口
  -e PLCCOM_DEVICE=1 \             # PLC设备地址（默认1）
  -e MQTT_BROKER=mqtt.example.com \ # MQTT代理地址
  -e MQTT_PORT=1883 \              # MQTT端口（默认1883，SSL为8883）
  -e MQTT_USER=mqtt_user \         # MQTT认证用户名（可选）
  -e MQTT_PASSWORD=mqtt_pass \     # MQTT认证密码（可选）
  -e TOPIC_MAPPINGS='{"plc/data":"mqtt/plc/data", "mqtt/plc/control":"plc/control"}' \ # 主题映射关系
  ocervinka/plccoms-mqtt-bridge

Docker Compose部署

yaml
version: '3.8'
services:
  plccoms-mqtt-bridge:
    image: ocervinka/plccoms-mqtt-bridge
    container_name: plccoms-mqtt-bridge
    restart: unless-stopped
    environment:
      - PLCCOM_HOST=192.168.1.100
      - PLCCOM_PORT=502
      - PLCCOM_DEVICE=1
      - MQTT_BROKER=mqtt.example.com
      - MQTT_PORT=1883
      - MQTT_USER=admin
      - MQTT_PASSWORD=secure_password
      - MQTT_CLIENT_ID=plc-bridge-001  # 可选，MQTT客户端ID
      - TOPIC_MAPPINGS='{
          "plc/temperature":"iot/plc/temp",
          "plc/pressure":"iot/plc/pressure",
          "iot/plc/setpoint":"plc/setpoint"
        }'
      - LOG_LEVEL=info  # 日志级别：debug/info/warn/error（默认info）

配置参数说明

环境变量配置

主题映射规则

TOPIC_MAPPINGS 环境变量需提供JSON格式的键值对，定义PLC数据点与MQTT主题的映射关系：

• 键：PLC数据点标识（如"plc/temperature"）
• 值：对应的MQTT主题（如"iot/plc/temp"）

示例：

json
{
  "plc/temp": "factory/floor1/plc/temp",
  "plc/pressure": "factory/floor1/plc/pressure",
  "factory/floor1/plc/setpoint": "plc/setpoint"
}

• 左侧为PLC数据点时，数据将从PLC推送至右侧MQTT主题
• 左侧为MQTT主题时，消息将从MQTT转发至右侧PLC数据点

日志与故障排查

容器日志可通过 docker logs plccoms-mqtt-bridge 查看，推荐设置 LOG_LEVEL=debug 进行故障排查。常见问题：

• 连接失败：检查PLCComS和MQTT服务地址、端口是否可达
• 数据未传输：检查主题映射配置是否正确，PLC设备是否正常运行
• 认证失败：检查MQTT用户名密码是否正确