USR-DR504 V3T的MQTT模式連接阿里云示例
備注：USR-DR504需要插SIM卡聯網。
一、資料下載
USR-DR504 軟件設計手冊http://m.bbxnc.com/Download/903.html
USR-DR504/DR514說明書（完整版）http://m.bbxnc.com/Download/1046.html
USR-DR504 規格書http://m.bbxnc.com/Download/904.html
USR-DR504/514 標準AT指令集http://m.bbxnc.com/Download/1048.html
USR-DR504設置軟件在這個壓縮包內，USR-DR504/514 邊緣計算+MQTT使用資料包http://m.bbxnc.com/Download/990.html
【PC端調試工具】網絡調試助手 串口調試助手二合一http://m.bbxnc.com/Download/27.html
二、硬件連接
1、所需物品
USR-DR504 產品 1臺
12V端子電源適配器 1個
USB-RS485串口線 1條
筆記本電腦 1臺
2、硬件連接
USR-RS485 的485串口接USB-RS485串口線到電腦USB口，接好4G天線，然后產品接12V端子電源適配器上電。
3、查看端口號
電腦鼠標點擊計算機管理，右擊，點開設備管理器，點擊端口，查看接USR-DR504的USB-RS485串口線COM口號，COM10。
三、阿里云設置
1、登陸阿里云平臺，找到物聯網平臺，這里用的連接公共實例
（1）登陸阿里云平臺
（2）找到物聯網平臺
（3）開通連接公共實例
2、創建產品
（1）點擊產品，點擊創建產品
（2）新建產品信息，依次填寫：
產品名稱舉例test——所屬品類選擇自定義品類——節點類型選擇直連設備——聯網與數據聯網方式選擇蜂窩（2G/3G/4G/5G）——數據格式選擇透傳/自定義——認證方式選擇設備秘鑰——點擊確定，完成創建產品。
3、添加設備
（1）產品創建成功后，添加設備。點擊設備，點擊添加設備，產品名舉例填test,DeviceName填USR-DR504，備注名稱填MQTT，點擊確認。
（2）添加完設備，如下圖展示，設備狀態是未激活，等設置完USR-DR504的MQTT連接阿里云參數之后，設備狀態才顯示在線。
4、查看產品Topic
（1）點擊產品，點擊查看
（2）點擊Topic類列表，點擊自定義Topic,找到訂閱和發布
設置USR-DR504的MQTT參數，需要按照以下方法設置訂閱和A 發布主題。
數據訂閱測試：將訂閱的主題/i4u4VIKvRXf/USR-DR504/user/get填寫到USR-DR504訂閱的主題配置中去（注意將原主題中的${deviceName}替換為USR-DR504(本產品的DeviceName)）；
數據發布測試：將發布的主題/i4u4VIKvRXf/USR-DR504/user/update填寫到USR-DR504的A主題發布主題的配置中去（注意將原主題中的${deviceName}替換為USR-DR504(本產品的DeviceName)）；
5、查看設備證書內容，生成USR-DR504連接阿里云的用戶名
（1）點擊設備，點擊查看，再點擊DeviceSecret后面的查看。
展示設備證書：
ProductKey: i4u4VIKvRXf
DeviceName: USR-DR504
DeviceSecret: fe175c8dbbc7a5a15f5a2fbb918bc6ac
（2）轉換USR-DR504連接阿里云的用戶名：
用戶名： 由設備名 DeviceName、符號（&）和產品 ProductKey 組成。
固定格式：${YourDeviceName}&${YourPrductKey}。
完整示例如：device&alxxxxxxxxxx。
USR-DR504連接阿里云的用戶名：USR-DR504&i4u4VIKvRXf
6、查看賬號和地域，生成USR-DR504連接阿里云的服務器地址
（1）查看使用的阿里云賬號aliyun9810869345
（2）根據地域名稱華東2（上海）查詢地域ID：cn-shanghai
（3）轉換USR-DR504連接阿里云的服務器地址：
格式：${YourProductKey}.iot-as-mqtt.${region}.aliyuncs.com。
其中，${region}需替換為您物聯網平臺服務所在地域的代碼。地域代碼，請參見地域和可用區。如：
alxxxxxxxxxx.iot-as-mqtt.cn-shanghai.aliyuncs.com。
USR-DR504連接阿里云的服務器地；aliyun9810869345.iot-as-mqtt.cn-shanghai.aliyuncs.com
USR-DR504連接阿里云的端口用1883
7、使用MQTT簽名工具，生成USR-DR504連接阿里云的密碼
（1）打開MQTT簽名工具
下載USR-DR504/514 邊緣計算+MQTT使用資料包，解壓縮，找到MQTT簽名工具
（2）密碼由參數值拼接加密而成
可以使用物聯網平臺提供的生成工具自動生成 Password，也可以手動生成 Password。
單擊下載 Password 生成小工具。解壓縮下載包后，雙擊 sign 文件，即可使用。
? 使用 Password 生成小工具的輸入參數：
? productKey：設備所屬產品 Key。可在控制臺設備詳情頁查看。
? deviceName：設備名稱。可在控制臺設備詳情頁查看。
? deviceSecret：設備密鑰。可在控制臺設備詳情頁查看。
? timestamp：（可選）時間戳。
? clientId：設備的 ID 信息，與 Client ID 中${clientId}一致。
? method：選擇簽名算法類型，與 Client ID 中 signmethod 確定的加密方法一致。
（3）轉換USR-DR504連接阿里云的密碼
填入設備信息：
? productKey設備所屬產品 Key：i4u4VIKvRXf
? deviceName設備名稱：USR-DR504
? deviceSecret設備密鑰：fe175c8dbbc7a5a15f5a2fbb918bc6ac
? timestamp（可選）時間戳：
? clientId設備的 ID 信息：12345678
? method選擇簽名算法類型：hmacsha1
簽名結果：98B38A6687E3D68C0CCEAECBC20ECDA37459B061
USR-DR504連接阿里云的的密碼：98B38A6687E3D68C0CCEAECBC20ECDA37459B061
8、生成USR-DR504連接阿里云的客戶端ID
（1）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。
（2）轉換USR-DR504連接阿里云的Client ID
客戶端ID：12345678|securemode=3,signmethod=hmacsha1|
四、USR-DR504參數設置
1、打開USR-DR504設置軟件V1.0.7
2、打開串口，點擊進入配置狀態
3、點擊獲取當前參數
4、設置MQTT模式參數
（1）選擇MQTT模式
（2）MQTT Client連接
地址：aliyun9810869345.iot-as-mqtt.cn-shanghai.aliyuncs.com
端口：1883
用戶名：USR-DR504&i4u4VIKvRXf
密碼：98B38A6687E3D68C0CCEAECBC20ECDA37459B061
數據格式：格式化輸出
客戶端ID：12345678|securemode=3,signmethod=hmacsha1|
（3）MQTT主題訂閱
主題1設置/i4u4VIKvRXf/USR-DR504/user/get
（4）A主題
發布主題：/i4u4VIKvRXf/USR-DR504/user/update
5、設置軟件點擊設置所有參數，點擊設備重啟
6、設置軟件點擊關閉串口
五、MQTT連接阿里云功能調試
1、查看阿里云設備狀態在線
USR-DR504 設置完MQTT連接阿里云參數，聯網正常，在阿里云平臺可以看到設備狀態是在線。
2、數據訂閱測試(格式化輸出)
（1）點擊設備，點擊查看
（2）點擊Topic列表，點擊發布消息
（3）使用阿里云平臺發布的消息m.bbxnc.com，被USR-DR504訂閱到，并通過USR-DR504串口發給串口端，數據格式是格式化輸出，串口助手接收的數據/i4u4VIKvRXf/USR-DR504/user/get,m.bbxnc.com
3、數據發布測試
（1）點擊設備，點擊日志服務
（2）發布消息格式
通過串口向發服務器更新設備狀態時，需遵循如下數據格式：
主題名(最多100字節) | , | 服務等級 | , | 數據 |
示例：/i4u4VIKvRXf/USR-DR504/user/update,0,1234567890
（注：“,”為英文輸入法下的格式）
（3）USR-DR504使用串口助手發送數據/i4u4VIKvRXf/USR-DR504/user/update,0,1234567890，發送完成之后，我們在阿里云平臺可以通過日志服務，點擊查看，看到USR-DR504串口發到阿里云的數據1234567890。
4、數據訂閱測試(透傳)
（1）USR-DR504，點擊進入配置狀態，點擊獲取當前參數，數據格式設置透傳，點擊設置所有參數，點擊設備重啟，最后關閉串口。
（2）登陸阿里云平臺，點擊設備，點擊查看
（3）點擊Topic列表，點擊發布消息
（4）使用阿里云平臺發布的消息m.bbxnc.com，被USR-DR504訂閱到，并通過USR-DR504串口發給串口端，數據格式是透傳，串口助手接收的數據m.bbxnc.com
編寫人：金志方 編寫日期：2024-03-14
審核人：金志方 審核日期：2024-03-14
訂正版本：V1.0 訂正內容：初稿
-20250623144437.png)
