【行空板K10】利用Nanomq的桥接转发能力实现接入任意的MQTT服务器
目录
引言
K10程序的编写
运行Nanomq
设置Nanomq的桥接到巴法云
结语
引言
行空板K10作为一块物联网开发板,内置了MQTT的支持,不过它的MQTT有限制,只支持阿里云、OneNet、EasyIoT和SIoT4种MQTT服务器。这对想使用其他MQTT服务器的用户来说不太方便。本文就尝试使用Nanmq轻量化MQTT代理的桥接转发功能实现行空板K10访问任意的MQTT服务器。
K10程序的编写
K10的程序仍然使用Mind+编写。程序的基本功能是读取并显示温度信息,然后连接WiFi热点,成功后在连接MQTT服务器,然后发送温度信息到device004主题。
其中在MQTT参数设置部分选择SIoT,因为它是K10所支持的4种服务器中可以部署在局域网的唯一一种,其他三种服务器的IP或域名都是写死的,不能修改。SIoT是DFRobot提供的免费MQTT服务器,但是前面的评测已经说了(【行空板K10】MQTT服务器SIoT V2-CSDN博客),感觉很一般。Mind+的MQTT组件会自动生成clientid,以确保不同开发板产生的id不同,但是不支持自己设置clientid,这使得像巴法云、华为云IoTDA这样的平台就不能直接接入。我们在本地部署EMQ(杭州映云科技有限公司)Nanomq,把它的服务器地址作为SIoT服务器的地址,具体参数设置如下:
在自动生成窗口,可以看到如下的程序:
/*!
* MindPlus
* esp32s3bit
*
*/
#include <DFRobot_Iot.h>
#include "unihiker_k10.h"
// 动态变量
String mind_s_my_string_variable;
volatile float mind_n_temp;
// 静态常量
const String topics[5] = {"device004","","","",""};
// 创建对象
UNIHIKER_K10 k10;
AHT20 aht20;
uint8_t screen_dir=2;
DFRobot_Iot myIot;
// 主程序开始
void setup() {
k10.begin();
k10.initScreen(screen_dir);
k10.creatCanvas();
mind_n_temp = aht20.getData(AHT20::eAHT20TempC);
mind_n_temp = (mind_n_temp - 8);
k10.setScreenBackground(0x000000);
mind_s_my_string_variable = (String("温度:") + String((String(mind_n_temp))));
k10.canvas->canvasText(mind_s_my_string_variable, 3, 0xFFFFFF);
k10.canvas->updateCanvas();
myIot.wifiConnect("CU_fjGX", "12345678");
while (!myIot.wifiStatus()) {}
k10.rgb->write(0, 0x0000FF);
k10.canvas->canvasText(myIot.getWiFiSoftIP(), 5, 0xFFFF00);
k10.canvas->updateCanvas();
myIot.init("192.168.1.216","admin","2741576345294361","public", topics, 1883);
myIot.connect();
while (!myIot.connected()) {}
k10.rgb->write(1, 0x0000FF);
}
void loop() {
myIot.publish("device004", mind_n_temp);
delay(5000);
}
运行Nanomq
NanoMQ 是于 2021 年初发布的边缘计算开源项目,是面向物联网边缘计算场景的下一代轻量级高性能 MQTT 消息服务器。这个服务器下载后直接在本地解压就可以了。然后,使用如下命令启动服务器:
nanomq.exe start --conf=../nanomq.conf
我在另外一台电脑上运行MQTTX,然后订阅Nanomq的device004消息。K10开发板启动成功后,连接MQTT服务器,就可以在MQTTX客户端每隔5秒就可以收到消息推送。
设置Nanomq的桥接到巴法云
不是所有MQTT平台都能使用上面的方法进行连接,对于无法连接的平台可以使用Nanomq进行桥接转发数据。桥接是一种连接多个 MQTT 消息中间件的策略。在桥接模式下,节点之间不进行主题树或路由表的复制操作。桥接模式的核心职能包括:根据预定的规则,将消息转发至指定的桥接节点;对桥接节点上的特定主题进行订阅,并在接收到消息后在本地节点或集群内进行传递和转发。
下面以巴法云为例,说明如何利用桥接功能使K10开发板接入MQTT服务器。
Nanomq提供了一个nanomq_bridge.conf文件,我在此基础上进行修改:
首先加入巴法云的登录信息:
# #====================================================================
# # MQTT Broker Bridge
# #====================================================================
bridges.mqtt.emqx1 {
# # Bridge address: host:port .
# #
# # Value: String
# # Example: mqtt-tcp://127.0.0.1:1883
# # tls+mqtt-tcp://127.0.0.1:8883
# # mqtt-quic://54.75.171.11:14567
server = "mqtt-tcp://bemfa.com:9501"
# # Protocol version of the bridge.
# #
# # Value: Enum
# # - 5: mqttv5
# # - 4: mqttv311
# # - 3: mqttv31
proto_ver = 4
# # The ClientId of a remote bridge.
# # Default random string.
# #
# # Value: String
clientid="xxxxxxxxxxxxxxx"
巴法云默认是用clientid作为登录服务器的标识,所以这里一定要填写。另外,巴法云不支持MQTT 5,所以MQTT版本一定要选MQTT v3.11。
forwards部分是转发到远端 MQTT 服务器的主题数组,应包括消息主题(remote_topic)、(local_topic)和 QoS (qos)。remote_topic和local_topic可以不同。
# # Topics that need to be forward to IoTHUB
# #
# # Value: String
# # Example: topic1/#,topic2/#
forwards = [
{
# # Need to forward to remote broker topics
# #
# # Value: String
remote_topic = "device004"
# # topic reflection with remote_topic
# #
# # Value: String
local_topic = "device004"
}
{
remote_topic = "fwd/topic2"
local_topic = "topic2"
}
]
然后执行下面的命令:
nanomq.exe start --conf=../nanomq_bridge.conf
然后在巴法云的后台就可以看到发布者已经登录并发布数据:
使用MQTTX也可以接收到巴法云转发的数据。至此完美实现了功能。
结语
本文的方法实现了K10开发板接入到任意的MQTT服务器。不过这个方法仍然比较麻烦,因为需要安装一个本地的Nanomq。后面将研究如何写个第三方库,使得K10能够直接接入MQTT服务器。