操作场景
MQTT.fx 是目前主流的 MQTT 桌面客户端，它支持 Windows、 Mac、Linux 操作系统，可以快速验证是否可与 IoT Cloud 进行连接，并发布或订阅消息。更多 MQTT 协议介绍请参见 MQTT 协议介绍。本文档主要介绍 MQTT.fx 如何与腾讯云 IoT Cloud 交互。本文以 MQTT.fx 1.7.0 for Mac 版本为例。
操作步骤
连接 IoT Cloud
- 打开 MQTT.fx 下载页面，找到适合的版本，下载并安装 MQTT.fx 客户端。
- 打开 MQTT.fx 客户端程序，单击【设置】。
- 进入设置页面，并单击【+】，创建一个新的配置文件。
- 填写 Connection Profile 相关信息和 General 信息。
参数说明
| 参数 | 说明 |
|---|---|
| Profile Name | 配置文件保存为的名称。 |
| Broker Address | MQTT 服务器连接地址，广州域设备填入：PRODUCT_ID.iotcloud.tencentdevices.com，这里 PRODUCT_ID 为变量参数，用户需填入创建产品时自动生成的产品 ID，例如 9****ZW2EZ.iotcloud.tencentdevices.com |
| Broker Port | MQTT 服务器连接端口，证书认证型端口：8883；密钥认证型：1883 |
| Client ID | MQTT 协议字段，按照物联网通信约束填入：产品 ID + 设备名，例如："9****ZW2EZgate_dev01 "，9****ZW2EZ 是产品 ID，gate_dev01 是设备名。 |
| Connection Timeout | 连接超时时间秒。 |
| Keep Alive Interval | 心跳间隔时间秒。 |
| Auto Reconnect | 断网自动重连。 |
填写 User Credentials 信息。
- User Name ：MQTT 协议字段，按照物联网通信约束填入：产品 ID + 设备名 + SDKAppID + connid。（创建完产品即可在产品列表页和产品详情页查看 ProductID）如："9****ZW2EZgate_dev01;12010126;12345"，仅替换示例中的产品 ID + 设备名即可，后面的两个参数本身由物联网通信接入 SDK 自动生成，所以这里填写固定测试值。
- Password ：Password 必须填写。
- 证书认证：由于 mqtt.fx 默认将密码标志位设为 true，所以需要填写一个任意的非空字符串作为密码，否则无法连接到物联云通信后台。而实际接入物联云后台时，鉴权是根据证书认证，此处随机填写的密码不会作为接入凭证。
- 密钥认证：用户可进入 Hub 相应设备列表查看获取（具体页面见下方密钥认证步骤），也可以按照文档 手动生成Password。
- （可选）证书认证： 选择开启 SSL/TLS，勾选 Self signed Certificates，上传相关内容。
文件说明
| 文件 | 说明 |
|---|---|
| CA File | 根证书，单击 ca.crt 链接下载文件。 |
| Client Certificate File | 客户端证书文件，即设备证书，在证书认证产品中创建设备时下载，详情请查看 设备接入准备。 |
| Client Key File | 客户端密钥文件，即设备密钥，在证书认证产品中创建设备时下载，详情请查看 设备接入准备。 |
| PEM Formatted | 由于物联网通信根证书、设备证书、设备密钥均由 openssl 生成使用 PEM 格式，而 MQTT.fx 是 Java 客户端，所以不识别 PEM 证书，这里需要勾选由该客户端自动转换为 Java 识别的 JKS 格式。 |
- （可选）密钥认证：
用户可进入控制台获取对应设备的 username，password：
- 完成以上步骤设置后，单击【Apply】和【OK】进行保存，并在配置文件框中选择刚才创建的文件名，单击【Connect】。
- 当右上角圆形图标为绿色时，说明已连接 IoT Cloud 成功，可进行发布和订阅操作。
发布消息
选择客户端 Publish Tab，输入主题名称、Qos 等级，单击【Publish】进行发布。发布结果可通过 云日志 查询。
订阅主题
选择客户端 Subscribe Tab，输入主题名称、Qos 等级，单击【Subscribe】进行主题订阅，订阅结果可通过 云日志 查询。
