概述

設(shè)備接入服務(wù)（IoTDA）是華為云的物聯(lián)網(wǎng)平臺(tái)，提供海量設(shè)備連接上云、設(shè)備和云端雙向消息通信、批量設(shè)備管理、遠(yuǎn)程控制和監(jiān)控、OTA升級(jí)、設(shè)備聯(lián)動(dòng)規(guī)則等能力，并可將設(shè)備數(shù)據(jù)靈活流轉(zhuǎn)到華為云其他服務(wù)。本文檔主要介紹如何將星縱物聯(lián)LoRaWAN®網(wǎng)關(guān)通過MQTT方式對(duì)接到華為云IoTDA，并且通過MQTT主題將傳感器數(shù)據(jù)發(fā)布到平臺(tái)。

準(zhǔn)備

• 星縱物聯(lián)LoRaWAN^®網(wǎng)關(guān)
• 星縱物聯(lián)LoRaWAN^®終端節(jié)點(diǎn)
• 華為云物聯(lián)網(wǎng)平臺(tái)（IoTDA）

步驟

1. 華為云IoTDA平臺(tái)配置

華為云IoTDA：

• 點(diǎn)擊“免費(fèi)試用”，并登錄到控制臺(tái)；
• 在IoTDA實(shí)例頁面，找到對(duì)應(yīng)的實(shí)例，單擊實(shí)例進(jìn)入實(shí)例詳情頁面。

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

在左側(cè)導(dǎo)航欄，選擇“產(chǎn)品 ”，單擊創(chuàng)建產(chǎn)品。產(chǎn)品名稱、協(xié)議類型、數(shù)據(jù)格式等參照下圖進(jìn)行設(shè)置。

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

1. 在左側(cè)導(dǎo)航欄，選擇“設(shè)備> 所有設(shè)備”，點(diǎn)擊注冊(cè)設(shè)備，在單設(shè)備注冊(cè)的對(duì)話框中，參照下圖進(jìn)行設(shè)置。

2. 設(shè)備創(chuàng)建完成后為未激活，需要在網(wǎng)關(guān)上完成相關(guān)配置后，才能激活。

1.3 獲取平臺(tái)連接信息

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

1. 進(jìn)入對(duì)應(yīng)設(shè)備的詳情頁，點(diǎn)擊MQTT連接參數(shù)，即可獲取接入信息。

注意：8883為MQTTS的連接端口，若是MQTT連接端口請(qǐng)配置1883。

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

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

2. 添加數(shù)據(jù)傳輸。

3. 選擇數(shù)據(jù)傳輸類型為MQTT。根據(jù)華為云IoTDA要求配置MQTT連接信息。點(diǎn)擊保存后，重新進(jìn)入可以看到狀態(tài)為已連接。

4. 華為云平臺(tái)端查看網(wǎng)關(guān)狀態(tài)為在線。

注意：若未連接成功，請(qǐng)先確認(rèn)網(wǎng)關(guān)的網(wǎng)絡(luò)狀態(tài)及連接信息是否填寫正確。網(wǎng)關(guān)上MQTT服務(wù)器端口請(qǐng)?zhí)顚?883。

3. 數(shù)據(jù)上報(bào)

如下介紹網(wǎng)關(guān)如何通過發(fā)布Topic將傳感器數(shù)據(jù)上報(bào)到華為云IoTDA。傳感器以AM103為例。

3.1 Topic定義

1. 進(jìn)入產(chǎn)品詳情頁，選擇“Topic管理”查看系統(tǒng)預(yù)置Topic，或者自定義配置Topic，可直接使用系統(tǒng)預(yù)置Topic。華為云IoTDA Topic定義詳見：/usermanual-iothub/iot_01_0045_2.html

2. 可根據(jù)是否使用物模型，選擇不同的上報(bào)主題。

3.2 透傳上報(bào)

1. 參考，在網(wǎng)關(guān)添加并激活一個(gè)傳感器設(shè)備。
2. 進(jìn)入網(wǎng)關(guān)頁面，選擇“Network Server>應(yīng)用”，在對(duì)應(yīng)的MQTT應(yīng)用中將設(shè)備消息上報(bào)主題 $oc/devices/milesight/sys/messages/up 配置在Uplink data主題，點(diǎn)擊保存。

3. 進(jìn)入華為云IoTDA設(shè)備詳情頁，在“云端運(yùn)行日志”查看設(shè)備消息。

3.3 物模型上報(bào)

3.3.1 平臺(tái)配置

進(jìn)入產(chǎn)品詳情頁，選擇“模型定義”開發(fā)產(chǎn)品模型。單擊“自定義模型”，配置產(chǎn)品的服務(wù)。

1. 在“添加服務(wù)”頁面，填寫“服務(wù)ID”、“服務(wù)類型”和“服務(wù)描述”，單擊“確定”。

• “服務(wù)ID”：BasicData
• “服務(wù)類型”：建議和服務(wù)ID保持一致
• “服務(wù)描述”：室內(nèi)空氣質(zhì)量數(shù)據(jù)

2. 在“BasicData”服務(wù)右側(cè)區(qū)域，單擊“添加屬性”，填寫相關(guān)信息后，單擊“確定”。

• “屬性名稱”：temperature
• “屬性描述”：溫度
• “數(shù)據(jù)類型”：int(整型)
• “訪問權(quán)限”：可讀、可寫
• “取值范圍”：0~100
• “步長”：0
• “單位”：不填寫

3. 根據(jù)AM103傳感器所上報(bào)的數(shù)據(jù)共增加4個(gè)物模型屬性。

4. 如下為該物模型所能夠識(shí)別的數(shù)據(jù)格式，需在網(wǎng)關(guān)將上報(bào)數(shù)據(jù)解析為如下格式。

{

"services": [

{

"service_id": "BasicData", //服務(wù)ID

"properties": {

"battery": xx, //屬性名稱

"co2": xx,

"humidity": xx,

"temperature": xx

}

}

]

}

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

1. 參考，同時(shí)根據(jù)華為云IotDA物模型格式要求，自定義創(chuàng)建一個(gè)用于將傳感器數(shù)據(jù)解析為平臺(tái)要求的格式再進(jìn)行上報(bào)。

AM103物模型解碼函數(shù)：

function Decode(fPort, bytes) {

var decoded = {

services: [

{

service_id: "BasicData",

properties: {}

}

]

};

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.services[0].properties.battery = bytes[i];

i += 1;

}

// TEMPERATURE

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

decoded.services[0].properties.temperature = readInt16LE(bytes.slice(i, i + 2)) / 10;

i += 2;

}

// HUMIDITY

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

decoded.services[0].properties.humidity = bytes[i] / 2;

i += 1;

}

// PIR ACTIVITY

else if (channel_id === 0x05 && channel_type === 0x6A || channel_id === 0x0A && channel_type === 0x6A) {

decoded.services[0].properties.activity = readUInt16LE(bytes.slice(i, i + 2));

i += 2;

}

// LIGHT

else if (channel_id === 0x06 && channel_type === 0x65) {

decoded.services[0].properties.illumination = readUInt16LE(bytes.slice(i, i + 2));

decoded.services[0].properties.infrared_and_visible = readUInt16LE(bytes.slice(i + 2, i + 4));

decoded.services[0].properties.infrared = readUInt16LE(bytes.slice(i + 4, i + 6));

i += 6;

}

// CO2

else if (channel_id === 0x07 && channel_type === 0x7D) {

decoded.services[0].properties.co2 = readUInt16LE(bytes.slice(i, i + 2));

i += 2;

}

// TVOC

else if (channel_id === 0x08 && channel_type === 0x7D) {

decoded.services[0].properties.tvoc = readUInt16LE(bytes.slice(i, i + 2));

i += 2;

}

// PRESSURE

else if (channel_id === 0x09 && channel_type === 0x73) {

decoded.services[0].properties.pressure = readUInt16LE(bytes.slice(i, i + 2)) / 10;

i += 2;

} else {

break;

}

}

return decoded;

}

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

* bytes to number

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

function readUInt16LE(bytes) {

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

return value & 0xffff;

}

function readInt16LE(bytes) {

var ref = readUInt16LE(bytes);

return ref > 0x7fff ? ref - 0x10000 : ref;

}

2. 參考，在網(wǎng)關(guān)添加并激活一個(gè)傳感器設(shè)備。添加傳感器時(shí)需選擇上一步創(chuàng)建的載荷。

3. 選擇“Network Server>應(yīng)用”，在對(duì)應(yīng)的MQTT應(yīng)用中將設(shè)備上報(bào)屬性主題 $oc/devices/milesight/sys/properties/report 配置在Uplink data主題，點(diǎn)擊保存。

4. 進(jìn)入華為云IoTDA設(shè)備詳情頁，可以看到上報(bào)的物模型數(shù)據(jù)。