MQTT客户端使用指南
更新时间:2020-01-15
MQTT.fx
MQTT.fx 是目前主流的mqtt客户端,可以快速验证是否可以与IoT Hub 服务交流发布或订阅消息。设备将当前所处的状态作为MQTT主题发送给IoT Hub,每个MQTT主题topic具有不同等级的名称,如“建筑/楼层/温度。” MQTT代理服务器将接收到的主题topic发送给给所有订阅的客户端。
连接IoT Hub服务
登录MQTT.fx下载页面,找到适合的版本下载并安装MQTT.fx客户端。
-
打开MQTT客户端的设置页面,点击“+”按键,创建一个新的配置文件。
- 填写Connection profile相关信息:
参数名称 | 说明 |
---|---|
profile name | 配置文件名称 |
Broker Address | 创建endpoint后返回的hostname |
Broker Port | ssl加密连接方式,端口使用1884;tcp不加密连接,端口使用1883。 |
Client ID | 客户端ID,支持“a-z”,“0-9”,“_”,“-”字符,且不能大于128bytes,UTF8编码。在同一个实例下,每个实体设备需要有一个唯一的ID,不同实体设备使用同一个client id建立连接会导致其它连接下线 |
- 选择User Credential,输入创建 IoT Hub 服务返回的username/password。
-
如果您选择SSL安全认证方式连接IoT Hub 服务,需要配置SSL/TLS安全认证,勾选
Enable SSL/TLS
,选择CA signed server certificate
认证。如您选择TCP连接,无需配置SSL安全认证,执行第4步骤即可。
- 点击“Apply”按键,完成客户端配置。
- 返回MQTT客户端界面,选择新创建的配置文件,点击“connect”按键连接服务。
订阅消息
注意:
IoT Hub一个主题支持的层级最多是9层(也就是最多只能出现8个斜线"/")。
成功连接IoT Hub 服务后,即可开始订阅消息。
打开Subscribe标签,填写主题topic,例如building-b/floor-5/temperature-1
,选择默认的QoS 0,点击“Subscribe”进行订阅操作。
发布消息
打开Publish标签,填写主题topic,例如building-b/floor-5/temperature-1
,选择默认的QoS 0,点击“Publish”进行发布操作。
返回Subscribe界面,即可看到已接收的订阅消息,参见下图。