# MQTTX 接入指南

MQTTX 桌面客户端，支持 Windows、 Mac、Linux 操作系统，可以快速验证是否可与 IoT Cloud 进行连接，并发布或订阅消息。

# 下载、并安装MQTTX客户端

# 创建连接

打开客户端，点击“+”，新建连接或直接点击新建连接
连接参数

参数	说明
名称	自定义连接名称
服务器地址	MQTT 服务器连接地址，例:broker.aiqianqiu.com
客户端ID	设备名\|安全模式=3,签名算法=hmacmd5,时间戳例:WG20230704001\|securemode=3,signMethod=hmacmd5,timestamp=1689729194339
用户名	产品ID
密码	产品ID + 设备名 + 当前时间戳 +设备秘钥、使用ASCII码排序后加密得到密码；例:productId+deviceName+timestamp+deviceSecret

参与计算参数

参数	说明
productId	产品ID，设备所属产品的productId，即物联网平台为产品颁发的全局唯一标识符。
deviceName	设备名称，设备在产品内的唯一标识符。DeviceName与设备所属产品的ProductId组合，作为设备标识，用来与物联网平台进行连接认证和通信。
deviceSecret	设备key，物联网平台为设备颁发的设备密钥，用于认证加密。需与DeviceId成对使用。
timestamp	时间戳，当前时间毫秒值，有效时间2分钟
signMethod	加密算法，支持hmacmd5和hmacsha1
securemode	安全模式，需要设置SSL/TLS选2，TCP(无需设置SSL/TLS信息)直连模式选3

输入正确信息，点击右上角连接按钮
左侧连接名变绿说明已连接成功，可进行发布和订阅等操作。

# 发布消息

Qos:PUBLISH报文的服务质量等级
Retain:PUBLISH报文的保留标志
输入正确的数据上行topic，例：iotlink/thing/up/productId/deviceName。
输入代理子设备上线topic，例：iotlink/gateway/operation/productId/deviceName。

# 订阅主题

点击添加订阅!
输入数据下行topic，点击确定。例：iotlink/thing/down/productId/deviceName

# 查看日志

点击图中所示图标，查看日志信息