前文介紹了通過MQTT協(xié)議接入OneNet平臺(tái)教程1：OneNet平臺(tái)配置，通過第一段步驟教程，成功創(chuàng)建OneNet產(chǎn)品后，準(zhǔn)備MQTT連接通訊所需的三要素及訂閱發(fā)布主題。
使用標(biāo)準(zhǔn)的MQTT三要素通訊，需要了解產(chǎn)品的連接地址、端口、ClientID、UserName、Password。連接地址、端口在產(chǎn)品相關(guān)手冊(cè)中可以找到。在產(chǎn)品文檔中搜索“MQTT地址”即可快速定位到接入地址及端口。
連接協(xié)議 | 證書 | 地址 |
MQTT | — | mqtts.heclouds.com:1883 |
MQTTS | 證書下載 | mqttstls.heclouds.com:8883 |
注意??：
MQTT接入地址可能發(fā)生變化，實(shí)際接入地址請(qǐng)以實(shí)際文檔說(shuō)明為準(zhǔn)。
ClientID、UserName在設(shè)備詳情中可以直接得到，password需要經(jīng)過key計(jì)算得到token。
參數(shù) | 是否必須 | 參數(shù)說(shuō)明 |
clientId | 是 | 設(shè)備名稱 |
username | 是 | 平臺(tái)分配的產(chǎn)品ID |
password | 是 | 填寫經(jīng)過key 計(jì)算的 token |
具體的Token算法可以通過產(chǎn)品手冊(cè)了解。這里使用官方提供的工具進(jìn)行計(jì)算。
官方下載地址：https://open.iot.10086.cn/college/video/onenet-portal/2024-04-19/17134946071850.exe
鏡像下載地址：17134946071850.exe
軟件中的「res」在手冊(cè)中闡述了相關(guān)參數(shù)。「et」為時(shí)間戳：
名稱 | 類型 | 是否必須 | 參數(shù)說(shuō)明 | 參數(shù)示例 |
version | string | 是 | 參數(shù)組版本號(hào)，日期格式，目前僅支持"2018-10-31" | 2018-10-31 |
res | string | 是 | 訪問資源resource | products/123123 |
et | int | 是 | 訪問過期時(shí)間expirationTime，unix時(shí)間 | 1537255523 |
method | string | 是 | 簽名方法signatureMethod | sha256（代表使用hmacsha1算法） |
sign | string | 是 | 簽名結(jié)果字符串signature | rBYeJXTp2q4V3C2aj4DBzjaydcw%3D |
根據(jù)手冊(cè)中的介紹格式：products/{產(chǎn)品ID}/devices/{設(shè)備名稱}，將產(chǎn)品ID與設(shè)備名稱進(jìn)行修改，即可得到res值。
et為時(shí)間戳，填寫過期時(shí)間。這里為了演示，直接填寫「9999999999」。
注意：et是unix時(shí)間，通常不建議直接設(shè)置為9999999999。
key是設(shè)備密鑰，將對(duì)應(yīng)的值填入即可。確認(rèn)填入信息無(wú)誤后，即可生成MQTT連接需要的Password。
到這里我們就準(zhǔn)備好了MQTT連接的所有要素連接地址、端口、ClientID，UserName，Password。
接下來(lái)，還需要獲取上報(bào)與接受的訂閱發(fā)布主題。同樣，這里我們通過手冊(cè)也可以找到官方發(fā)布的訂閱與發(fā)布主題屬性。
這里需要根據(jù)實(shí)際的使用情況選用適合的訂閱與發(fā)布。這里找到我們需要的訂閱與發(fā)布主題。這里演示使用訂閱全部主題以及上報(bào)數(shù)據(jù)點(diǎn)這兩個(gè)訂閱與發(fā)布主題。
訂閱全部物模型相關(guān)主題：$sys/{pid}/{device-name}/#
設(shè)備上傳數(shù)據(jù)點(diǎn)請(qǐng)求：$sys/{pid}/{device-name}/dp/post/json
根據(jù)手冊(cè)中的要求，將「設(shè)備名稱」以及「產(chǎn)品ID」填入即可。
確認(rèn)連接地址與訂閱發(fā)布主題后，了解發(fā)布消息時(shí)使用的格式。這里演示使用數(shù)據(jù)流payload格式進(jìn)行發(fā)布。payload示例如下：
{
"id": 123,
"dp": {
"數(shù)據(jù)流名稱": [{
"v": #值
}],
"數(shù)據(jù)流名稱": [{
"v": #值
}]
}
}
這里演示上報(bào)的是溫度與濕度，將準(zhǔn)備的溫度與濕度名稱填入即可。
以上就是全部的通過MQTT協(xié)議接入OneNet平臺(tái)教程第二步：準(zhǔn)備MQTT連接通訊所需的三要素及訂閱發(fā)布主題。下文我們將介紹通過MQTT協(xié)議接入OneNet平臺(tái)鏈接通訊測(cè)試配置教程。
今天的分享就到這里啦，EBYTE每一天都致力于更好的助力物聯(lián)化、智能化、自動(dòng)化的發(fā)展，提升資源利用率，更多產(chǎn)品更多資料，感興趣的小伙伴可以登錄我們的億佰特官網(wǎng)和企業(yè)公眾號(hào)（微信號(hào)：cdebyte）進(jìn)行了解，也可以直接撥打400電話咨詢技術(shù)專員！
相關(guān)閱讀：
2、串口服務(wù)器快速接入MQTT3.1協(xié)議服務(wù)器鏈接配置教程
3、MQTT協(xié)議詳解及物聯(lián)網(wǎng)應(yīng)用特點(diǎn)
