mqtt.fx工具模拟mqtt终端接入
1. 注册设备型号
在开发者中心注册终端或网关设备,接入方式选择MQTT,注册成功会有型号设备接入的配置详情。认证标签下提供四种组合方式,由用户选择:
1.1. 型号基本信息
1.1.1 接入方式
接入方式选择MQTT
1.1.2 证书认证
平台分配证书给终端,终端接入要携带证书;
1.1.3 密码认证
平台分配用户名密码给终端,终端接入要携带;
1.1.4 设备级
认证粒度,一个设备对应一个用户名密码或证书,即一机一密;
1.1.5 型号级
认证粒度,一个型号下的所有设备共用一个用户名密码或证书,即一型一密。
基本信息填写完成,点击确定平台会根据选择为型号生成对应的密钥及证书并提供下载。
1.2 功能信息配置
为型号配置功能信息,选择“属性”创建设备上报信息,选择“指令”创建设备下行配置信息。 新增“属性”:
新增“指令”:
1.3 消息模板配置
为型号配置消息模板,配置“上行报文”和“下行指令”两条消息模板。 上行消息模板配置:
其中,地址域偏移为0-1,配置msgType为0x01
为上行消息模板绑定“开合状态属性”,偏移为2-4:
完成了消息模板配置可以开始添加设备进行验证。
2. 场所新增设备
型号注册完成,点击绿洲主页,创建场所,点击“管理”进入场所,点击“终端管理”。点击“添加终端”,选择创建的“MQTT_virtual”型号:
点击“下一步”完成终端创建,即可在终端列表中看到新增的设备,此时平台所有准备工作完成,接下来打开MQTT.fx模拟工具模拟终端接入。
3. 用mqtt.fx模拟设备用户名密码接入
Broker Address,User Name,和Password 为型号下的接入配置详情所示。 clientId为productKey&deviceId。设置好后点ok,然后点connect。
4. 用mqtt.fx模拟设备证书认证接入
注册型号认证方式为证书认证,在接入配置信息页面有该型号的Broker Address,User Name,Password和证书,证书需要下载,解压。在mqtt接入时,填写对应的用户名密码,和ca.pem,client.pem和client.key路径。
5. 数据上行
设备建立连接后,就可以订阅和发布topic进行属性上报和接收指令。属性上报和指令下发的前提是在型号下面的功能信息里有添加属性和指令。以上面用户名密码认证的型号和终端为例。
型号里配置了属性/指令功能信息
查看该终端下面的消息主题,进行订阅或发布,该终端只能对自己的topic订阅发布。
向属性上报的topic里发布属性消息
查看终端页面的运行状态,更新了即上报成功,如下图所示:
6. 指令下行
订阅指令下发的topic,在页面上的在线调试标签下配置指令,点确定下发
终端收到指令
终端需回复指令应答,云端根据回复判断指令是否下发成功,code200,message success表示下发成功。