使用MQTT.fx接入物联网平台

使用MQTT.fx接入

1. 下载并安装MQTT.fx软件。请访问MQTT.fx官网。
2. 打开MQTT.fx软件，单击设置图标。
   
3. 设置连接参数。物联网平台目前支持两种连接模式，不同模式设置参数不同：
   • TCP直连：Client ID中securemode=3，无需设置SSL/TLS信息。
   • TLS直连：Client ID中securemode=2，需要设置SSL/TLS信息。

   说明 设置参数时，请确保参数值中或参数值的前后均没有空格。
   1. 设置基本信息。
      

      参数	说明
      Profile Name	输入您的自定义名称。
      Profile Type	选择为MQTT Broker。
      MQTT Broker Profile Settings
      Broker Address	接入域名。 您购买的实例的接入域名，请在物联网平台控制台实例管理页面，单击实例对应的查看，进入实例详情页查看。 公共实例的接入域名：${YourProductKey}.iot-as-mqtt.${YourRegionId}.aliyuncs.com。其中： ${YourProductKey}：请替换为设备所属产品的的ProductKey。可从物联网平台控制台设备详情页获取。 ${YourRegionId}：请参见地域和可用区，替换为您的Region ID。
      Broker Port	设置为1883。
      Client ID	填写mqttClientId，用于MQTT的底层协议报文。 格式固定：${clientId}|securemode=3,signmethod=hmacsha1|。 完整示例：12345|securemode=3,signmethod=hmacsha1|。 其中： ${clientId}为设备的ID信息。可取任意值，长度在64字符以内。建议使用设备的MAC地址或SN码。 securemode为安全模式，TCP直连模式设置为securemode=3，TLS直连为securemode=2。 signmethod为算法类型，支持hmacmd5和hmacsha1。 说明 输入Client ID信息后，请勿单击Generate。
      General General栏目下的设置项可保持系统默认，也可以根据您的具体需求设置。

   2. 单击User Credentials，设置User Name和Password。
      

      参数	说明
      User Name	由设备名DeviceName、符号（&）和产品ProductKey组成。 固定格式：${YourDeviceName}&${YourProductKey}。 完整示例如：device&alxxxxxxxxx。
      Password	密码由参数值拼接加密而成。 说明 如果您使用的MQTT.fx版本，在粘贴Password后不显示具体的字符串，只要光标已从输入框的前部移至了后部，则表示粘贴成功，请勿重复粘贴。 您可以使用物联网平台提供的生成工具自动生成Password，也可以手动生成Password。 单击下载Password生成小工具。解压缩下载包后，双击sign文件，即可使用。 使用Password生成小工具的输入参数： productKey：设备所属产品Key。可在控制台设备详情页查看。 deviceName：设备名称。可在控制台设备详情页查看。 deviceSecret：设备密钥。可在控制台设备详情页查看。 timestamp：（可选）时间戳。 clientId：设备的ID信息，与Client ID中${clientId}一致。 method：选择签名算法类型，与Client ID中signmethod确定的加密方法一致。 手动生成方法如下： 拼接参数。 提交给服务器的clientId、deviceName、productKey和timestamp（timestamp为非必选参数）参数及参数值依次拼接。 本例中，clientId值为12345，deviceName值为device，productKey值为alxxxxxxxxx，拼接结果为：clientId12345deviceNamedeviceproductKeyalxxxxxxxxx。 加密。 通过Client ID中确定的加密方法，使用设备deviceSecret，将拼接结果加密。 假设设备的deviceSecret值为abc123，加密计算格式为hmacsha1(abc123,clientId12345deviceNamedeviceproductKeyalxxxxxxxxx)。

   3. （可选）TLS直连模式（即securemode=2）下，需要选择SSL/TLS，勾选Enable SSL/TLS，设置Protocol。建议Protocol选择为TLSv1.2。
      说明 TCP直连模式（即securemode=3）下，无需设置SSL/TLS信息，直接进入下一步。

      
4. 设置完成后，单击右下角的OK。
5. 单击Connect进行连接。
   

下行通信测试

从物联网平台发送消息，在MQTT.fx上接收消息，测试MQTT.fx与物联网平台连接是否成功 。

1. 在MQTT.fx上，单击Subscribe。
2. 输入一个设备具有订阅权限的自定义Topic，单击Subscribe，订阅这个自定义Topic。
   

   订阅成功后，该Topic将显示在列表中。

   
3. 在物联网平台控制台中，该设备的设备详情页，Topic列表页签下，单击已订阅的Topic对应的发布消息。
4. 输入消息内容，单击确认。
   
5. 回到MQTT.fx上，查看是否接收到消息。
   

上行通信测试

在MQTT.fx上发送消息，通过查看设备日志，测试MQTT.fx与物联网平台连接是否成功 。

1. 在MQTT.fx上，单击Publish。
2. 输入一个设备具有发布权限的Topic，和要发送的消息内容，单击Publish，向这个Topic推送一条消息。
   
3. 在物联网平台控制台，选择监控运维 > 日志服务 > 云端运行日志，查看该设备的设备到云消息。

查看日志

在MQTT.fx上，单击Log查看操作日志和错误提示日志。