MQTT 工控上云实战EMQX 本地部署、设备数据上报、云端下发控制指令工控设备上云就像给工厂里的哑巴设备装了张嘴——它终于能说话了而且说的是MQTT。一、MQTT协议物联网的普通话MQTTMessage Queuing Telemetry Transport是IBM在1999年发明的一种轻量级消息协议专门为带宽有限、网络不稳定的环境设计。说白了它就是物联网设备之间交流的普通话。为什么工控上云首选MQTT轻量级协议头部最小仅2字节比HTTP那动辄几百字节的头部瘦身了几个量级发布/订阅模式设备不需要知道对方是谁只管往Topic里扔数据或取数据多级QoS从发完就不管到必须确认收到灵活适配不同场景长连接不像HTTP每次都要握手MQTT保持TCP长连接实时性更好1.1 MQTT核心概念概念说明工控类比Broker消息中间服务器所有消息的中转站工厂调度中心Topic消息主题类似频道地址产线编号/设备编号QoS 0At most once发一次不管结果广播喊一声听见算听见QoS 1At least once至少送达一次发快递可能重复收到QoS 2Exactly once恰好送达一次挂号信签收确认Retain保留消息新订阅者立即收到最后一条黑板上的最后通知Will遗嘱消息设备异常断线时自动发布设备挂了留遗言Topic的层级设计很重要。工控场景建议采用这样的层级结构工厂/产线/设备/数据类型 例如: factoryA/line1/sensor01/temperature factoryA/line1/device02/controlQoS选择建议传感器数据上报用QoS 0丢了无所谓下一秒又来一条控制指令下发用QoS 1或2开关继电器的指令不能丢。二、EMQX Broker本地部署EMQX是目前最流行的开源MQTT Broker单节点可支撑百万级连接。工控场景用它绰绰有余。2.1 Docker部署推荐一条命令搞定dockerrun-d\--nameemqx\-p1883:1883\-p8083:8083\-p18083:18083\emqx/emqx:5.0端口说明端口协议用途1883MQTT TCP设备连接端口8083MQTT WebSocketWeb端连接18083HTTP管理面板Dashboard2.2 二进制部署如果工控板跑不了Docker就用二进制方式# 下载解压wgethttps://www.emqx.com/downloads/broker/5.0/emqx-5.0-centos7-amd64.tar.gztar-zxvfemqx-5.0-centos7-amd64.tar.gz# 启动./emqx/bin/emqx start# 查看状态./emqx/bin/emqx_ctl status2.3 Web管理面板浏览器打开http://IP:18083默认账号admin / public。Dashboard能看到当前连接数、主题数、消息流量客户端列表谁连着、订阅了什么主题树可视化认证与ACL配置入口2.4 认证配置裸奔的Broker谁都能连工控环境必须加认证。EMQX内置多种认证方式# 在Dashboard → Authentication 中配置# 方式1内置用户名密码数据库# 添加用户: device01 / password123# 方式2MySQL/PostgreSQL外部数据库认证# 方式3JWT令牌认证推荐工控场景用内置数据库认证简单够用。每个设备分配独立账号ACL限制它只能订阅和发布自己的Topic。三、Paho MQTT C库使用Eclipse Paho是MQTT官方推荐的客户端库C语言版本适合嵌入式/工控设备。3.1 安装gitclone https://github.com/eclipse/paho.mqtt.c.gitcdpaho.mqtt.cmakesudomakeinstall3.2 核心API一览#includeMQTTClient.h// 创建客户端MQTTClient_create(client,tcp://broker:1883,client_id,MQTTCLIENT_PERSISTENCE_NONE,NULL);// 设置回调消息到达、连接丢失MQTTClient_setCallbacks(client,NULL,connlost,msgarrvd,delivered);// 连接MQTTClient_connect(client,opts);// 发布MQTTClient_publishMessage(client,topic,msg,token);// 订阅MQTTClient_subscribe(client,topic,QOS);四、实战1设备端定时上报传感器数据这是工控上云最典型的场景——设备每秒把温度、湿度、压力等数据往云端Topic扔。#includestdio.h#includestdlib.h#includestring.h#includeunistd.h#includetime.h#includeMQTTClient.h#defineBROKER_ADDRtcp://192.168.1.100:1883#defineCLIENT_IDfactoryA_line1_sensor01#defineTOPIC_UPLOADfactoryA/line1/sensor01/data#defineQOS_UPLOAD0/* 传感器数据丢了无所谓 */volatileMQTTClient_deliveryCompleted delivered0;voidconnlost(void*context,char*cause){printf(连接丢失: %s\n,cause);/* 自动重连逻辑可在此实现 */}intmsgarrvd(void*context,char*topicName,inttopicLen,MQTTClient_message*msg){printf(收到消息: %s\n,(char*)msg-payload);MQTTClient_freeMessage(msg);MQTTClient_free(topicName);return1;}voiddelivered(void*context,MQTTClient_deliveryToken dt){delivered1;}/* 模拟传感器采集 */floatread_temperature(void){return25.0f(rand()%100)/10.0f;}floatread_humidity(void){return50.0f(rand()%100)/10.0f;}intmain(void){MQTTClient client;MQTTClient_connectOptions optsMQTTClient_connectOptions_initializer;MQTTClient_create(client,BROKER_ADDR,CLIENT_ID,MQTTCLIENT_PERSISTENCE_NONE,NULL);opts.keepAliveInterval20;opts.cleansession1;opts.usernamedevice01;opts.passwordpassword123;MQTTClient_setCallbacks(client,NULL,connlost,msgarrvd,delivered);if(MQTTClient_connect(client,opts)!MQTTCLIENT_SUCCESS){printf(连接Broker失败!\n);return-1;}/* 定时上报循环 */while(1){charpayload[256];time_tnowtime(NULL);/* JSON格式封装数据必须包含时间戳 */snprintf(payload,sizeof(payload),{\ts\:%ld,\temp\:%.1f,\humi\:%.1f,\dev\:\sensor01\},(long)now,read_temperature(),read_humidity());MQTTClient_message msgMQTTClient_message_initializer;msg.payloadpayload;msg.payloadlenstrlen(payload);msg.qosQOS_UPLOAD;msg.retained0;MQTTClient_publishMessage(client,TOPIC_UPLOAD,msg,NULL);printf(上报: %s\n,payload);sleep(5);/* 每5秒上报一次 */}MQTTClient_disconnect(client,10000);MQTTClient_destroy(client);return0;}关键设计要点JSON编码统一格式ts字段带时间戳方便云端对时排序Topic层级包含设备标识云端可按Topic过滤特定设备。五、实战2云端下发控制指令设备不仅要说话还要能听话——云端下发开关继电器、修改采集参数的指令。设备端订阅控制Topic收到指令后执行动作#defineTOPIC_CONTROLfactoryA/line1/sensor01/control#defineQOS_CONTROL1/* 控制指令不能丢 *//* 在连接成功后订阅 */MQTTClient_subscribe(client,TOPIC_CONTROL,QOS_CONTROL);/* msgarrvd回调中解析控制指令 */intmsgarrvd(void*context,char*topicName,inttopicLen,MQTTClient_message*msg){char*payload(char*)msg-payload;/* 简单JSON解析生产环境建议用cJSON库 */if(strstr(payload,\cmd\:\relay_on\)){printf(执行: 开启继电器\n);/* 调用GPIO操作函数 */}elseif(strstr(payload,\cmd\:\relay_off\)){printf(执行: 关闭继电器\n);}elseif(strstr(payload,\cmd\:\set_interval\)){printf(修改采集间隔\n);}MQTTClient_freeMessage(msg);MQTTClient_free(topicName);return1;}云端下发示例Python脚本importpaho.mqtt.clientasmqttimportjson clientmqtt.Client(cloud_controller)client.username_pw_set(admin,admin123)client.connect(192.168.1.100,1883)# 开启继电器cmd{cmd:relay_on,relay_id:1,ts:int(time.time())}client.publish(factoryA/line1/sensor01/control,json.dumps(cmd),qos1)# 修改采集间隔cmd{cmd:set_interval,interval_sec:10}client.publish(factoryA/line1/sensor01/control,json.dumps(cmd),qos1)六、MQTT安全配置工控上云安全是底线。裸跑MQTT等于把工厂大门敞开。6.1 TLS加密传输# 生成证书测试用自签名openssl genrsa-outca.key2048openssl req-new-x509-days365-keyca.key-outca.crt# EMQX配置TLS监听# Dashboard →Listeners → 添加 8883 端口 SSL Listener# 绑定 ca.crt 和 server证书C客户端连接TLS端口#defineBROKER_SSLssl://broker:8883MQTTClient_create(client,BROKER_SSL,CLIENT_ID,...);opts.sslsslopts;sslopts.trustStore/etc/ssl/certs/ca.crt;6.2 用户名密码认证前面已介绍每个设备独立账号配合ACL限制Topic权限# ACL规则示例 user device01 topic write factoryA/line1/sensor01/data topic read factoryA/line1/sensor01/control # 其他Topic一律禁止七、数据格式建议工控数据上云格式统一是团队协作的基础{ts:1700000000,/* Unix时间戳秒级 */dev:sensor01,/* 设备ID */temp:25.3,/* 温度 */humi:52.1,/* 湿度 */press:1013.25,/* 压力 */status:normal/* 设备状态 */}原则时间戳必带云端不做时间推测字段名统一短命名省带宽数值类型一致别一会儿string一会儿number。MQTT把工控设备从孤岛拉进了互联网从数据上报到指令下发形成闭环。协议简洁、部署轻快、安全可控——这三个词放在工控场景就是靠谱。
MQTT 工控上云实战EMQX 本地部署、设备数据上报、云端下发控制指令工控设备上云就像给工厂里的哑巴设备装了张嘴——它终于能说话了而且说的是MQTT。一、MQTT协议物联网的普通话MQTTMessage Queuing Telemetry Transport是IBM在1999年发明的一种轻量级消息协议专门为带宽有限、网络不稳定的环境设计。说白了它就是物联网设备之间交流的普通话。为什么工控上云首选MQTT轻量级协议头部最小仅2字节比HTTP那动辄几百字节的头部瘦身了几个量级发布/订阅模式设备不需要知道对方是谁只管往Topic里扔数据或取数据多级QoS从发完就不管到必须确认收到灵活适配不同场景长连接不像HTTP每次都要握手MQTT保持TCP长连接实时性更好1.1 MQTT核心概念概念说明工控类比Broker消息中间服务器所有消息的中转站工厂调度中心Topic消息主题类似频道地址产线编号/设备编号QoS 0At most once发一次不管结果广播喊一声听见算听见QoS 1At least once至少送达一次发快递可能重复收到QoS 2Exactly once恰好送达一次挂号信签收确认Retain保留消息新订阅者立即收到最后一条黑板上的最后通知Will遗嘱消息设备异常断线时自动发布设备挂了留遗言Topic的层级设计很重要。工控场景建议采用这样的层级结构工厂/产线/设备/数据类型 例如: factoryA/line1/sensor01/temperature factoryA/line1/device02/controlQoS选择建议传感器数据上报用QoS 0丢了无所谓下一秒又来一条控制指令下发用QoS 1或2开关继电器的指令不能丢。二、EMQX Broker本地部署EMQX是目前最流行的开源MQTT Broker单节点可支撑百万级连接。工控场景用它绰绰有余。2.1 Docker部署推荐一条命令搞定dockerrun-d\--nameemqx\-p1883:1883\-p8083:8083\-p18083:18083\emqx/emqx:5.0端口说明端口协议用途1883MQTT TCP设备连接端口8083MQTT WebSocketWeb端连接18083HTTP管理面板Dashboard2.2 二进制部署如果工控板跑不了Docker就用二进制方式# 下载解压wgethttps://www.emqx.com/downloads/broker/5.0/emqx-5.0-centos7-amd64.tar.gztar-zxvfemqx-5.0-centos7-amd64.tar.gz# 启动./emqx/bin/emqx start# 查看状态./emqx/bin/emqx_ctl status2.3 Web管理面板浏览器打开http://IP:18083默认账号admin / public。Dashboard能看到当前连接数、主题数、消息流量客户端列表谁连着、订阅了什么主题树可视化认证与ACL配置入口2.4 认证配置裸奔的Broker谁都能连工控环境必须加认证。EMQX内置多种认证方式# 在Dashboard → Authentication 中配置# 方式1内置用户名密码数据库# 添加用户: device01 / password123# 方式2MySQL/PostgreSQL外部数据库认证# 方式3JWT令牌认证推荐工控场景用内置数据库认证简单够用。每个设备分配独立账号ACL限制它只能订阅和发布自己的Topic。三、Paho MQTT C库使用Eclipse Paho是MQTT官方推荐的客户端库C语言版本适合嵌入式/工控设备。3.1 安装gitclone https://github.com/eclipse/paho.mqtt.c.gitcdpaho.mqtt.cmakesudomakeinstall3.2 核心API一览#includeMQTTClient.h// 创建客户端MQTTClient_create(client,tcp://broker:1883,client_id,MQTTCLIENT_PERSISTENCE_NONE,NULL);// 设置回调消息到达、连接丢失MQTTClient_setCallbacks(client,NULL,connlost,msgarrvd,delivered);// 连接MQTTClient_connect(client,opts);// 发布MQTTClient_publishMessage(client,topic,msg,token);// 订阅MQTTClient_subscribe(client,topic,QOS);四、实战1设备端定时上报传感器数据这是工控上云最典型的场景——设备每秒把温度、湿度、压力等数据往云端Topic扔。#includestdio.h#includestdlib.h#includestring.h#includeunistd.h#includetime.h#includeMQTTClient.h#defineBROKER_ADDRtcp://192.168.1.100:1883#defineCLIENT_IDfactoryA_line1_sensor01#defineTOPIC_UPLOADfactoryA/line1/sensor01/data#defineQOS_UPLOAD0/* 传感器数据丢了无所谓 */volatileMQTTClient_deliveryCompleted delivered0;voidconnlost(void*context,char*cause){printf(连接丢失: %s\n,cause);/* 自动重连逻辑可在此实现 */}intmsgarrvd(void*context,char*topicName,inttopicLen,MQTTClient_message*msg){printf(收到消息: %s\n,(char*)msg-payload);MQTTClient_freeMessage(msg);MQTTClient_free(topicName);return1;}voiddelivered(void*context,MQTTClient_deliveryToken dt){delivered1;}/* 模拟传感器采集 */floatread_temperature(void){return25.0f(rand()%100)/10.0f;}floatread_humidity(void){return50.0f(rand()%100)/10.0f;}intmain(void){MQTTClient client;MQTTClient_connectOptions optsMQTTClient_connectOptions_initializer;MQTTClient_create(client,BROKER_ADDR,CLIENT_ID,MQTTCLIENT_PERSISTENCE_NONE,NULL);opts.keepAliveInterval20;opts.cleansession1;opts.usernamedevice01;opts.passwordpassword123;MQTTClient_setCallbacks(client,NULL,connlost,msgarrvd,delivered);if(MQTTClient_connect(client,opts)!MQTTCLIENT_SUCCESS){printf(连接Broker失败!\n);return-1;}/* 定时上报循环 */while(1){charpayload[256];time_tnowtime(NULL);/* JSON格式封装数据必须包含时间戳 */snprintf(payload,sizeof(payload),{\ts\:%ld,\temp\:%.1f,\humi\:%.1f,\dev\:\sensor01\},(long)now,read_temperature(),read_humidity());MQTTClient_message msgMQTTClient_message_initializer;msg.payloadpayload;msg.payloadlenstrlen(payload);msg.qosQOS_UPLOAD;msg.retained0;MQTTClient_publishMessage(client,TOPIC_UPLOAD,msg,NULL);printf(上报: %s\n,payload);sleep(5);/* 每5秒上报一次 */}MQTTClient_disconnect(client,10000);MQTTClient_destroy(client);return0;}关键设计要点JSON编码统一格式ts字段带时间戳方便云端对时排序Topic层级包含设备标识云端可按Topic过滤特定设备。五、实战2云端下发控制指令设备不仅要说话还要能听话——云端下发开关继电器、修改采集参数的指令。设备端订阅控制Topic收到指令后执行动作#defineTOPIC_CONTROLfactoryA/line1/sensor01/control#defineQOS_CONTROL1/* 控制指令不能丢 *//* 在连接成功后订阅 */MQTTClient_subscribe(client,TOPIC_CONTROL,QOS_CONTROL);/* msgarrvd回调中解析控制指令 */intmsgarrvd(void*context,char*topicName,inttopicLen,MQTTClient_message*msg){char*payload(char*)msg-payload;/* 简单JSON解析生产环境建议用cJSON库 */if(strstr(payload,\cmd\:\relay_on\)){printf(执行: 开启继电器\n);/* 调用GPIO操作函数 */}elseif(strstr(payload,\cmd\:\relay_off\)){printf(执行: 关闭继电器\n);}elseif(strstr(payload,\cmd\:\set_interval\)){printf(修改采集间隔\n);}MQTTClient_freeMessage(msg);MQTTClient_free(topicName);return1;}云端下发示例Python脚本importpaho.mqtt.clientasmqttimportjson clientmqtt.Client(cloud_controller)client.username_pw_set(admin,admin123)client.connect(192.168.1.100,1883)# 开启继电器cmd{cmd:relay_on,relay_id:1,ts:int(time.time())}client.publish(factoryA/line1/sensor01/control,json.dumps(cmd),qos1)# 修改采集间隔cmd{cmd:set_interval,interval_sec:10}client.publish(factoryA/line1/sensor01/control,json.dumps(cmd),qos1)六、MQTT安全配置工控上云安全是底线。裸跑MQTT等于把工厂大门敞开。6.1 TLS加密传输# 生成证书测试用自签名openssl genrsa-outca.key2048openssl req-new-x509-days365-keyca.key-outca.crt# EMQX配置TLS监听# Dashboard →Listeners → 添加 8883 端口 SSL Listener# 绑定 ca.crt 和 server证书C客户端连接TLS端口#defineBROKER_SSLssl://broker:8883MQTTClient_create(client,BROKER_SSL,CLIENT_ID,...);opts.sslsslopts;sslopts.trustStore/etc/ssl/certs/ca.crt;6.2 用户名密码认证前面已介绍每个设备独立账号配合ACL限制Topic权限# ACL规则示例 user device01 topic write factoryA/line1/sensor01/data topic read factoryA/line1/sensor01/control # 其他Topic一律禁止七、数据格式建议工控数据上云格式统一是团队协作的基础{ts:1700000000,/* Unix时间戳秒级 */dev:sensor01,/* 设备ID */temp:25.3,/* 温度 */humi:52.1,/* 湿度 */press:1013.25,/* 压力 */status:normal/* 设备状态 */}原则时间戳必带云端不做时间推测字段名统一短命名省带宽数值类型一致别一会儿string一会儿number。MQTT把工控设备从孤岛拉进了互联网从数据上报到指令下发形成闭环。协议简洁、部署轻快、安全可控——这三个词放在工控场景就是靠谱。
