概述

本文檔主要介紹如何將星縱物聯(lián)網(wǎng)關(guān)通過MQTT方式對接到阿里云的物聯(lián)網(wǎng)平臺，并且通過MQTT主題將傳感器數(shù)據(jù)發(fā)布到平臺。在進(jìn)行本文檔操作之前，需要先參考用戶手冊將LoRaWAN^®節(jié)點(diǎn)添加至網(wǎng)關(guān)內(nèi)置網(wǎng)絡(luò)服務(wù)器中并成功令節(jié)點(diǎn)設(shè)備上線及數(shù)據(jù)正常上報(bào)。

準(zhǔn)備

• 星縱物聯(lián)LoRaWAN^®網(wǎng)關(guān)
• 星縱物聯(lián)LoRaWAN^®終端節(jié)點(diǎn)
• 阿里云企業(yè)物聯(lián)網(wǎng)平臺

步驟

1. 阿里云物聯(lián)網(wǎng)平臺配置

阿里云企業(yè)物聯(lián)網(wǎng)平臺地址：

• 登錄
• 在實(shí)例概覽頁面，找到對應(yīng)的實(shí)例，單擊實(shí)例進(jìn)入實(shí)例詳情頁面。

1.1 創(chuàng)建產(chǎn)品

在左側(cè)導(dǎo)航欄，選擇“設(shè)備管理 > 產(chǎn)品”，單擊創(chuàng)建產(chǎn)品。所屬品類、節(jié)點(diǎn)類型、數(shù)據(jù)格式參照下圖設(shè)置，其他根據(jù)實(shí)際需求填寫。

1.2 創(chuàng)建設(shè)備

設(shè)備歸屬于某個產(chǎn)品下的具體設(shè)備。阿里云物聯(lián)網(wǎng)平臺為設(shè)備頒發(fā)產(chǎn)品內(nèi)的證書 DeviceName。

1. 在左側(cè)導(dǎo)航欄，選擇“設(shè)備管理> 設(shè)備”。
2. 單擊添加設(shè)備，在添加設(shè)備對話框中，選擇剛剛創(chuàng)建的產(chǎn)品，DeviceName需要綁定上傳的LoRaWAN^®傳感器設(shè)備EUI，備注名稱自定義，填寫完成后單擊確認(rèn)完成設(shè)備添加。
3. 例如：下圖是網(wǎng)關(guān)上目前添加的設(shè)備信息，添加設(shè)備時DeviceName填寫對應(yīng)設(shè)備EUI

4. 創(chuàng)建設(shè)備成功后，將自動彈出添加完成對話框?？梢渣c(diǎn)擊查看對創(chuàng)建的產(chǎn)品信息進(jìn)行查看。
5. 設(shè)備創(chuàng)建完成后為未激活，需要將設(shè)備接入物聯(lián)網(wǎng)平臺，使其激活。

1.3 獲取連接信息

網(wǎng)關(guān)MQTT接入物聯(lián)網(wǎng)平臺前需要提前獲取MQTT接入信息（MQTT服務(wù)器地址、MQTT服務(wù)端口、客戶端ID、用戶名/密碼）。

選擇“設(shè)備管理 > 設(shè)備”，查看對應(yīng)設(shè)備，點(diǎn)擊MQTT連接參數(shù)，即可獲取接入信息。

2. 網(wǎng)關(guān)配置

1. 確定傳感器所屬的應(yīng)用，在網(wǎng)關(guān)配置頁面選擇“Network Server>應(yīng)用”，選擇對應(yīng)應(yīng)用點(diǎn)擊進(jìn)入應(yīng)用編輯界面。

2. 點(diǎn)擊進(jìn)行數(shù)據(jù)傳輸添加。

3. 應(yīng)用創(chuàng)建完成之后，重新點(diǎn)擊編輯選擇數(shù)據(jù)傳輸類型為MQTT。根據(jù)阿里云物聯(lián)網(wǎng)平臺要求配置MQTT連接信息。點(diǎn)擊保存后，重新進(jìn)入可以看到狀態(tài)為已連接。

注意：阿里云平臺采用一機(jī)一密制度，如果網(wǎng)關(guān)上需要添加新的傳感器設(shè)備，需要先創(chuàng)建新的應(yīng)用及MQTT連接，并使新添加的設(shè)備綁定新創(chuàng)建的應(yīng)用，該應(yīng)用使用阿里云上新的設(shè)備MQTT連接信息進(jìn)行連接。

4. 物聯(lián)網(wǎng)平臺查看設(shè)備狀態(tài)為在線。

注意：若未連接成功MQTT至阿里云，請先確認(rèn)網(wǎng)關(guān)的網(wǎng)絡(luò)狀態(tài)及連接信息是否填寫正確。

3. 數(shù)據(jù)上行

網(wǎng)關(guān)作為MQTT客戶端接入物聯(lián)網(wǎng)平臺，可以發(fā)布和訂閱Topic，如下介紹網(wǎng)關(guān)如何通過發(fā)布Topic將傳感器數(shù)據(jù)上報(bào)到物聯(lián)網(wǎng)平臺。

1. 在網(wǎng)關(guān)Network Server添加并激活一個傳感器設(shè)備。在“Network Server >數(shù)據(jù)流”確認(rèn)傳感器數(shù)據(jù)能夠正常上報(bào)。
2. 物聯(lián)網(wǎng)平臺配置：在對應(yīng)的產(chǎn)品頁，單擊“Topic類列表> 自定義Topic”。阿里云物聯(lián)網(wǎng)平臺Topic的前三個類目已經(jīng)固定好，只需定義后面的類目，即可拼接成一個完整的Topic，操作權(quán)限為發(fā)布，本示例：

//gp5olLRZ1dO/24E124983C521736/user/update

3. 網(wǎng)關(guān)配置：在對應(yīng)的MQTT應(yīng)用中將/gp5olLRZ1dO/24E124983C521736/user/uplink配置在Uplink data對應(yīng)的主題上，點(diǎn)擊保存。

4. 回到物聯(lián)網(wǎng)平臺，點(diǎn)擊“監(jiān)控運(yùn)維>日志服務(wù)”，查看設(shè)備到云消息。點(diǎn)擊查看可以看到網(wǎng)關(guān)發(fā)布的信息，其中“data”為傳感器數(shù)據(jù)。此時的傳感器數(shù)據(jù)是未解析過的。可以選擇以下方式進(jìn)行解碼。

在網(wǎng)關(guān)的內(nèi)置NS解析

點(diǎn)擊“Network Srever>載荷編碼器”，填寫對應(yīng)的解碼函數(shù)后點(diǎn)擊保存。

在對應(yīng)的的傳感器中選擇上一步創(chuàng)建的載荷。

解析后數(shù)據(jù)上報(bào)如下

4. 數(shù)據(jù)下行

如下介紹網(wǎng)關(guān)如何通過在物聯(lián)網(wǎng)平臺上推送MQTT至設(shè)備終端。

1. 在物聯(lián)網(wǎng)平臺產(chǎn)品Topic列表中可以看到多組類型，可以選擇其中的自定義topic來進(jìn)行服務(wù)調(diào)用下發(fā)。本示例下行自定義topic：/gp5olLRZ1dO/${deviceName}/user/get

2. 網(wǎng)關(guān)配置：在對應(yīng)的MQTT應(yīng)用中先將對應(yīng)Topic配置在downlink data對應(yīng)的主題上后，點(diǎn)擊保存。本示例：/gp5olLRZ1dO/24E124983C521736/user/get

3. 物聯(lián)網(wǎng)平臺配置：進(jìn)行上一步操作后，在對應(yīng)設(shè)備的Topic列表中會出現(xiàn)對應(yīng)topic。

4. 返回到網(wǎng)關(guān)應(yīng)用中，在對應(yīng)的MQTT應(yīng)用中將downlink data的主題改為以下內(nèi)容保存。

/gp5olLRZ1dO/$deveui/user/get

其中$deveui字段代替原有的設(shè)備名稱字段

5. 下發(fā)操作：回到物聯(lián)網(wǎng)平臺設(shè)備的topic界面，點(diǎn)擊發(fā)布消息

消息內(nèi)容示例

{“confirmed”: true,”fport”: 85,”data”: “CQEA/w==”}

內(nèi)容解析：下發(fā)端口為 85，內(nèi)容為 CQEA/w==，啟用確認(rèn)包

注意：下發(fā)內(nèi)容只能使用 Base 64 格式，可以通過 Hex 轉(zhuǎn) Base64 進(jìn)行數(shù)據(jù)轉(zhuǎn)換。

6. 網(wǎng)關(guān)數(shù)據(jù)流中觀察是否有對應(yīng)下行包

5. 阿里云物模型示例

如下介紹如何通在物聯(lián)網(wǎng)平臺快速創(chuàng)建物模型并完成物模型測試。

1. 物聯(lián)網(wǎng)平臺配置：在物聯(lián)網(wǎng)平臺產(chǎn)品功能定義列表中可以通過點(diǎn)擊“編輯草稿>添加自定義功能”，創(chuàng)建一個物模型。

示例：如圖創(chuàng)建一個距離物模型，其中標(biāo)識符為distance。確認(rèn)完成后點(diǎn)擊左下角的發(fā)布上線并確定，完成自定義功能的物模型添加。

2. 發(fā)布成功后，“設(shè)備>物模型數(shù)據(jù)”中會有上一步添加的物模型模塊

3. 如需使用物模型，則需要將MQTT消息推送至物模型的對應(yīng)topic中。

示例topic為：/sys/gp5olLRZ1dO/24E124983C521736/thing/event/property/post

4. 網(wǎng)關(guān)配置：確定網(wǎng)關(guān)中Uplink data的主題是否為對應(yīng)物模型主題。

5. 物模型匹配數(shù)據(jù)需要有特定的數(shù)據(jù)格式，具體參考

6. 在網(wǎng)關(guān)“Network Server>載荷編碼器”中將該設(shè)備綁定的decodec修改成特定格式數(shù)據(jù)上報(bào)。

注意：上報(bào)格式中參數(shù)的標(biāo)識需要與阿里云平臺創(chuàng)建物模型時的標(biāo)識符一致。

7. 等待設(shè)備上報(bào)成功后，平臺端物模型也會顯示對應(yīng)數(shù)據(jù)。

8. 參考網(wǎng)關(guān)端配置decodec解析代碼，如需其他開發(fā)可參考。

function Decode(fPort, bytes) {

var decoded = {};

for (var i = 0; i < bytes.length; ) {

var channel_id = bytes[i++];

var channel_type = bytes[i++];

// BATTERY

if (channel_id === 0x01 && channel_type === 0x75) {

decoded.battery = bytes[i];

i += 1;

}

// DISTANCE

else if (channel_id === 0x03 && channel_type === 0x82) {

decoded.distance = readUInt16LE(bytes.slice(i, i + 2));

i += 2;

}

// REMAINING AMOUNT

else if (channel_id === 0x04 && channel_type === 0xd6) {

decoded.remaining = bytes[i];

i += 1;

} else {

break;

}

}

var result = {

"id": "123",

"version": "1.0",

"sys":{

"ack":0

},

"params": {

"distance": {

"value": decoded.distance,

}

},

"method": "thing.event.property.post"

};

return result;

}

/* ******************************************

* bytes to number

********************************************/

function readUInt16LE(bytes) {

var value = (bytes[1] << 8) + bytes[0];

return value & 0xffff;

}