MQTT.fx是一款基于Eclipse Paho，使用Java语言编写的MQTT客户端工具，支持通过Topic订阅和发布消息。下面以MQTT.fx为例，介绍使用第三方软件以MQTT协议接入物联网平台。

前提条件

已在物联网平台控制台创建产品和设备，并获取设备证书信息（ProductKey、DeviceName和DeviceSerect）。创建产品和设备具体操作细节，请参考创建产品、单个创建设备或批量创建设备。

使用MQTT.fx接入

  1. 下载并安装MQTT.fx软件。请访问MQTT.fx官网。
  2. 打开MQTT.fx软件，单击设置图标。
    MQTT.fx
  3. 设置连接参数。物联网平台目前支持两种连接模式，不同模式设置参数不同：
    • TCP直连：Client ID中securemode=3，无需设置SSL/TLS信息。
    • TLS直连：Client ID中securemode=2，需要设置SSL/TLS信息。
    说明 设置参数时，请确保参数值中或参数值的前后均没有空格。
    1. 设置基本信息。
      MQTT.fx
      参数 说明
      Profile Name 输入您的自定义名称。
      Profile Type 选择为MQTT Broker。
      MQTT Broker Profile Settings
      Broker Address 连接域名。

      格式：${YourProductKey}.iot-as-mqtt.${region}.aliyuncs.com。

      其中，${region}需替换为您物联网平台服务所在地域的代码。地域代码，请参见地域和可用区。如：alxxxxxxxxx.iot-as-mqtt.cn-shanghai.aliyuncs.com。

      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。
      MQTT.fx
      参数 说明
      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确定的加密方法一致。
      • 手动生成方法如下：
        1. 拼接参数。

          提交给服务器的clientId、deviceName、productKey和timestamp（timestamp为非必选参数）参数及参数值依次拼接。

          本例中，clientId值为12345，deviceName值为device，productKey值为alxxxxxxxxx，拼接结果为：clientId12345deviceNamedeviceproductKeyalxxxxxxxxx。

        2. 加密。

          通过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信息，直接进入下一步。
      MQTT.fx
  4. 设置完成后，单击右下角的OK。
  5. 单击Connect进行连接。
    MQTT.fx

下行通信测试

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

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

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

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

上行通信测试

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

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

查看日志

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

MQTT.fx