本教程主要介紹RAK WisBlock 天氣監(jiān)測(cè)傳感器模塊從組裝到連接至騰訊云物聯(lián)網(wǎng)平臺(tái)的應(yīng)用示例。

#前期準(zhǔn)備

#硬件

• WisBlock Base（本示例使用RAK5005-O）
• WisBlock Core（本示例使用RAK4631）
• WisBlock Sensor（本示例使用RAK1901、RAK1902、RAK1903）
• LoRa天線（本示例使用CN470頻段）
• USB連接線
• 網(wǎng)關(guān)（網(wǎng)關(guān)頻段需與傳感器模塊頻段一致，本示例使用RAK7258網(wǎng)關(guān)，頻段CN470）

#軟件

ArduinoIDE

#硬件安裝

本章節(jié)介紹WisBlock 模塊的組裝過(guò)程。

#LoRa天線安裝

1、將LoRa天線接口對(duì)準(zhǔn)并放置在RAK4631模塊的LoRa天線接口搭接處。

Figure 1: 安裝LoRa天線

2、輕輕按壓LoRa天線接口，將LoRa天線安裝到RAK4631上。

#WisBlock Core安裝

1、將RAK4631模塊上的連接器插頭對(duì)準(zhǔn)RAK5005-O CUP插槽上的連接器插座。保持連接器間平行，將其輕放在插座連接器相應(yīng)的搭接處。

Figure 2: 安裝RAK4631

2、平行按壓均勻施力，聽(tīng)到扣合聲音后，扣壓完成。

3、完成后，使用螺釘將模塊固定在RAK5005-O上。

#WisBlock Sensor安裝

1、將傳感器模塊（RAK1901、RAK1902、RAK1903）分別分配在RAK5005-O的插槽A~D上。本示例中只占據(jù)了插槽A~C。

2、將傳感器模塊上的連接器插頭對(duì)準(zhǔn)RAK5005-O插槽的連接器插座。保持連接器間平行，將其輕放在插座連接器相應(yīng)的搭接處。

3、平行按壓均勻施力，聽(tīng)到扣合聲音后，扣壓完成。

Figure 3: 安裝各傳感器模塊

4、完成后，使用螺釘將模塊固定在RAK5005-O上。

#軟件配置

本章節(jié)介紹WisBlock 傳感器模塊的軟件配置。

#Arduino IDE中安裝板支持包

#Arduino IDE的下載

使用Arduino IDE對(duì)WisBlock進(jìn)行編碼和編程。如果您還未安裝Arduino IDE，可在Arduino官網(wǎng)中下載。

---

?? 警告

如果您所使用的操作系統(tǒng)為Windows 10：
請(qǐng)勿從Microsoft應(yīng)用商店中安裝Arduino IDE。請(qǐng)從Arduino官網(wǎng)中安裝原始的Arduino IDE。Microsoft應(yīng)用商店中的Arduino應(yīng)用在使用第三方板支持包時(shí)存在問(wèn)題。

如下圖所示，可以看到Arduino IDE當(dāng)前版本為V1.8.16。Windows、Linux和Mac OS X都有多個(gè)可用版本，選擇正確的Arduino IDE版本并下載。

Figure 4: Arduino IDE 版本示意圖

#Arduino IDE的安裝

#Windows中的安裝

在Windows PC中安裝已下載的Arduino IDE。

1、單擊“I Agree”。

Figure 5: Arduino安裝許可協(xié)議

2、單擊“Next”。

Figure 6: Arduino安裝選項(xiàng)

3、單擊“Install”。

Figure 7: Arduino IDE安裝路徑

Figure 8: Arduino IDE安裝中

進(jìn)度為100%后，Arduino IDE已成功安裝，單擊“Close”，退出安裝過(guò)程。

Figure 9: 成功安裝

#Linux中的安裝

在Linux中，沒(méi)有安裝過(guò)程。只是一個(gè)解壓過(guò)程，然后就能夠成功打開(kāi)Arduino IDE 。

#Mac OS X中的安裝

在Mac OS X中，與Linux相同，沒(méi)有安裝過(guò)程。只是一個(gè)解壓過(guò)程，然后就能夠成功打開(kāi)Arduino IDE 。

#Arduino IDE上的配置

Arduino IDE安裝成功后。需要對(duì)Arduino IDE進(jìn)行一些配置以便后續(xù)對(duì)WisBlock組裝模塊進(jìn)行相關(guān)配置。

1、打開(kāi)Arduino IDE。

2、進(jìn)入“文件 > 首選項(xiàng)”。

Figure 10: 首選項(xiàng)

3、單擊圖中圖標(biāo)，編輯“附加開(kāi)發(fā)板管理器網(wǎng)址”，將WisBlock Core添加到Arduino板列表中。

Figure 11: 修改附加開(kāi)發(fā)板管理器網(wǎng)址

4、復(fù)制此URLhttps://raw.githubusercontent.com/RAKwireless/RAKwireless-Arduino-BSP-Index/main/package_rakwireless_index.json并粘貼至下圖所示區(qū)域。如果已存在其他鏈接，將上述鏈接粘貼至新的一行。完成后，單擊“好”。

Figure 12: 添加RAKwireless WisBlock Core BSP

???? 注意：如果您使用的是Linux，需要通過(guò)“pip”安裝“adafruit-nrfutil”。

sudo pip3 install adafruit-nrfutil 或 pip3 install --user adafruit-nrfutil

5、重啟Arduino IDE。

6、在“工具”菜單中打開(kāi)“開(kāi)發(fā)板管理”。

Figure 13: 打開(kāi)開(kāi)發(fā)板管理

7、如下圖所示，在搜索欄中鍵入“RAK”。將會(huì)顯示出可添加到Arduino板列表中的可用RAKwireless WisBlock Core。選擇以下板支持包以及相應(yīng)的版本，并單擊“安裝”板支持包。

Figure 14: 安裝WisBlock Core

#燒錄程序

1、將組裝的WisBlock傳感器模塊使用USB連接線連接到PC上。

2、在Arduino IDE中，根據(jù)下圖所示，選擇WisBlock Core RAK4631板。

Figure 15: 選擇WisBlock Core RAK4631板

3、根據(jù)下圖所示，選擇示例項(xiàng)目。

Figure 16: 選擇示例代碼

4、打開(kāi)示例代碼后，雙擊圖中鏈接，安裝示例代碼中所需的代碼庫(kù)。

Figure 17: 安裝所需代碼庫(kù)

5、修改示例代碼中的頻段區(qū)域，本示例使用的為CN470。

Figure 18: 修改頻段

6、完成后，如下圖所示，選擇正確的串口并單擊圖中上傳圖標(biāo)上傳代碼。

Figure 19: 選擇端口號(hào)

#連接到騰訊云物聯(lián)網(wǎng)平臺(tái)

#前提條件

• 已在騰訊云物聯(lián)網(wǎng)開(kāi)發(fā)平臺(tái)上注冊(cè)帳號(hào)
• LoRaWAN?網(wǎng)關(guān)已添加到騰訊云物聯(lián)網(wǎng)開(kāi)發(fā)平臺(tái)并且處于在線狀態(tài)，若未添加，可參考連接網(wǎng)關(guān)至騰訊云物聯(lián)網(wǎng)平臺(tái)。
• 傳感器模塊在LoRaWAN?網(wǎng)關(guān)覆蓋范圍之內(nèi)
• 傳感器模塊保持連接在PC

#創(chuàng)建項(xiàng)目和產(chǎn)品

1、登錄騰訊云物聯(lián)網(wǎng)開(kāi)發(fā)平臺(tái)，選擇“公共實(shí)例”或您購(gòu)買的“標(biāo)準(zhǔn)企業(yè)實(shí)例”。

2、進(jìn)入項(xiàng)目列表，單擊“新建項(xiàng)目”。

• 項(xiàng)目名稱：根據(jù)實(shí)際業(yè)務(wù)輸入便于識(shí)別的項(xiàng)目名稱。
• 項(xiàng)目描述：輸入項(xiàng)目的備注信息。

Figure 20: 新建項(xiàng)目

3、單擊“保存”，項(xiàng)目創(chuàng)建成功。

4、單擊創(chuàng)建的項(xiàng)目進(jìn)入產(chǎn)品開(kāi)發(fā)中心，單擊“新建產(chǎn)品”，定義您的產(chǎn)品。

5、根據(jù)頁(yè)面提示填寫(xiě)產(chǎn)品基本信息，然后單擊“保存”。

Figure 21: 新建產(chǎn)品

• 產(chǎn)品名稱：根據(jù)需要自定義名稱。
• 產(chǎn)品類型：選擇“用戶自定義”。
• 設(shè)備類型：選擇“設(shè)備”。
• 認(rèn)證方式：選擇“密鑰認(rèn)證”。
• 通信方式：選擇“LoRaWAN”。
• 描述：根據(jù)需要選填，輸入產(chǎn)品的描述信息。

#添加節(jié)點(diǎn)

1、單擊新創(chuàng)建好的產(chǎn)品，進(jìn)入“物模型”頁(yè)簽。

2、單擊“導(dǎo)入物模型”。

Figure 22: 導(dǎo)入物模型

3、將以下代碼復(fù)制到彈出的對(duì)話框中，單擊“導(dǎo)入”。

???? 注意：

示例JSON中的參數(shù)取值可根據(jù)實(shí)際修改，此示例根據(jù)所使用傳感器模塊進(jìn)行配置的。

JSON代碼：

{

 "version": "1.0",

 "properties": [

 {

 "id": "barometric",

 "name": "大氣壓",

 "desc": "",

 "mode": "r",

 "define": {

 "type": "float",

 "min": "0",

 "max": "200",

 "start": "0",

 "step": "1",

 "unit": "KPa"

 },

 "required": false

 },

 {

 "id": "light_intensity",

 "name": "光強(qiáng)度",

 "desc": "",

 "mode": "r",

 "define": {

 "type": "float",

 "min": "0",

 "max": "500",

 "start": "0",

 "step": "1",

 "unit": "lux"

 },

 "required": false

 },

 {

 "id": "humidity",

 "name": "濕度值",

 "desc": "",

 "mode": "r",

 "define": {

 "type": "float",

 "min": "0",

 "max": "100",

 "start": "0",

 "step": "0.01",

 "unit": "%"

 },

 "required": false

 },

 {

 "id": "temperature",

 "name": "溫度值",

 "desc": "",

 "mode": "r",

 "define": {

 "type": "float",

 "min": "-100",

 "max": "100",

 "start": "0",

 "step": "0.01",

 "unit": "℃"

 },

 "required": false

 }

 ],

 "events": [],

 "actions": [],

 "profile": {

 "ProductId": "ZRBWPIA0KV",

 "CategoryId": "1"

 }

}

4、單擊“下一步”，進(jìn)入設(shè)備開(kāi)發(fā)。

Figure 23: 設(shè)備開(kāi)發(fā)頁(yè)簽

5、單擊進(jìn)入“云端解析”頁(yè)簽。將以下解析腳本復(fù)制到上行數(shù)據(jù)解析對(duì)話框中。

上行數(shù)據(jù)解析腳本：

function RawToProtocol(fPort, bytes) {
	var data = {
		"method": "report",
		"clientToken" : new Date(),
		"params" : {}
	};

	if(bytes.length == 11 && bytes[0] == 0x02) {
		data.params.temperature = roundFun((bytes[1] << 8 | bytes[2]) * 0.01, 2);
		data.params.humidity = roundFun((bytes[3] << 8 | bytes[4]) * 0.01, 2);
		data.params.barometric = roundFun((bytes[5] << 24 | bytes[6] << 16 | bytes[7] << 8 | bytes[8]) * 0.01, 2);
		data.params.light_intensity = roundFun((bytes[9] << 8 | bytes[10]) * 0.01, 2);
	}

	return data;
}

function roundFun(value, n) {
  return Math.round(value*Math.pow(10,n))/Math.pow(10,n);
}

Figure 24: 上行數(shù)據(jù)解析腳本

6、單擊“提交”。

7、單擊“下一步”，進(jìn)入“交互開(kāi)發(fā)”，若產(chǎn)品需要接入騰訊連連官方小程序，可在本選項(xiàng)中進(jìn)行配置。

Figure 25: 上行數(shù)據(jù)解析腳本

• 默認(rèn)開(kāi)啟接入騰訊連連官方小程序。
• 在配置小程序頁(yè)簽，單擊每個(gè)配置項(xiàng)右側(cè)的“配置”按鈕，可以對(duì)產(chǎn)品各個(gè)配置項(xiàng)根據(jù)需求進(jìn)行配置。

8、單擊“下一步”進(jìn)入“設(shè)備調(diào)試”。

9、在“設(shè)備調(diào)試”頁(yè)面，單擊“新建設(shè)備”。

Figure 26: 新建設(shè)備

10、在新建設(shè)備頁(yè)面，配置以下參數(shù)。

• 設(shè)備名稱：自定義設(shè)備名稱。
• DevEUI：在傳感器示例代碼中獲取，切記需要?jiǎng)h除各個(gè)數(shù)字前的“0x”以及“，”。
• AppKey：在傳感器示例代碼中獲取，切記需要?jiǎng)h除各個(gè)數(shù)字前的“0x”以及“，”。

???? 注意：

示例中使用的是OTAA加網(wǎng)方式，所以選用的是"OTAA keys"相關(guān)參數(shù)，根據(jù)實(shí)際選擇“OTAA”或“ABP”參數(shù)。

Figure 27: 配置新設(shè)備參數(shù)

Figure 28: 獲取DevEUI和AppKey

11、完成后，單擊“保存”，新建設(shè)備激活。騰訊云物聯(lián)網(wǎng)平臺(tái)配置完成后，傳感器模塊會(huì)自動(dòng)加入LoRaWAN網(wǎng)絡(luò)（前提是LoRa網(wǎng)關(guān)已經(jīng)在物聯(lián)網(wǎng)平臺(tái)添加并處于在線狀態(tài)），且每間隔1秒鐘會(huì)發(fā)送上行檢測(cè)數(shù)據(jù)。在騰訊云物聯(lián)網(wǎng)平臺(tái)創(chuàng)建的新設(shè)備，接收到傳感器模塊的上行數(shù)據(jù)后，將自動(dòng)激活設(shè)備。

Figure 29: 新建設(shè)備激活

12、單擊新建設(shè)備名稱，進(jìn)入設(shè)備信息頁(yè)面后，單擊“在線調(diào)試”。在設(shè)備在線調(diào)試頁(yè)面可以看到傳感器模塊在實(shí)時(shí)發(fā)送上行數(shù)據(jù)。

Figure 30: 設(shè)備在線調(diào)試

#連接到騰訊連連小程序

#連接到小程序

、在“設(shè)備調(diào)試”界面，在創(chuàng)建設(shè)備的”操作“列，單擊“二維碼”。

Figure 31: 騰訊連連小程序二維碼

2、在手機(jī)端微信中搜索小程序“騰訊連連”，并單擊小程序進(jìn)入。

Figure 32: 搜索小程序

3、根據(jù)手機(jī)端提示進(jìn)行授權(quán)確認(rèn)。

4、進(jìn)入小程序中，單擊圖中添加設(shè)備圖標(biāo)。

Figure 33: 添加設(shè)備按鈕

5、單擊圖中“掃一掃”圖標(biāo)，對(duì)準(zhǔn)步驟1中已打開(kāi)的設(shè)備二維碼。

Figure 34: 掃描二維碼

6、掃碼成功后，設(shè)備將自動(dòng)添加成功，待小程序界面刷新后，可看到如下已添加的小程序。

Figure 35: 新增設(shè)備

7、單擊新增設(shè)備“wisblock”圖標(biāo)，可看到如下界面，表示已成功連接至小程序騰訊連連。

Figure 36: 傳感器模塊數(shù)據(jù)匯總

#(可選)設(shè)置告警推送

若需要對(duì)所檢測(cè)的數(shù)據(jù)設(shè)置告警信息，可參考以下步驟。設(shè)置后，可在手機(jī)端實(shí)時(shí)接收告警信息。

1、在左側(cè)導(dǎo)航樹(shù)中，單擊”數(shù)據(jù)開(kāi)發(fā)“，進(jìn)入數(shù)據(jù)開(kāi)發(fā)頁(yè)面。

2、在數(shù)據(jù)開(kāi)發(fā)頁(yè)面中，單擊“新建數(shù)據(jù)流”。

Figure 37: 新建數(shù)據(jù)流

3、配置需要告警的參數(shù)，本示例選擇的為壓力，可根據(jù)實(shí)際需求進(jìn)行配置。

Figure 38: 配置數(shù)據(jù)流參數(shù)

4、在數(shù)據(jù)流列表中，單擊所創(chuàng)建的數(shù)據(jù)流名稱。

Figure 39: 進(jìn)入數(shù)據(jù)流配置

5、在數(shù)據(jù)流配置界面，將左側(cè)列的以下頁(yè)簽，選中標(biāo)簽，拖入至右側(cè)空白處，如下圖所示。

Figure 40: 選擇配置項(xiàng)

6、將各個(gè)標(biāo)簽連接在一起。

Figure 41: 連接配置項(xiàng)

7、單擊“設(shè)備數(shù)據(jù)”標(biāo)簽，配置參數(shù)，如下圖所示，完成后，單擊”確定“。

Figure 42: 配置設(shè)備數(shù)據(jù)

8、單擊“數(shù)據(jù)過(guò)濾”標(biāo)簽，配置參數(shù)，如下圖所示，完成后，單擊”確定“。

Figure 43: 配置數(shù)據(jù)過(guò)濾

9、單擊“公眾號(hào)推送”標(biāo)簽，配置參數(shù)，如下圖所示，完成后，單擊”確定“。

Figure 44: 配置公眾號(hào)推送

10、完成所有配置項(xiàng)設(shè)置后，在左上角單擊“保存”后，在單擊“啟用”。

啟用配置項(xiàng)后，可在數(shù)據(jù)流列表中看到，創(chuàng)建的數(shù)據(jù)流，生效狀態(tài)已變?yōu)殚_(kāi)啟狀態(tài)。

Figure 45: 數(shù)據(jù)流生效

11、在手機(jī)端微信搜索公眾號(hào)“騰訊連連”，進(jìn)入并關(guān)注該公眾號(hào)。

12、當(dāng)配置告警項(xiàng)，超過(guò)閾值時(shí)，在手機(jī)端騰訊連連公眾號(hào)將會(huì)推送設(shè)備告警提醒。

Figure 46: 設(shè)備告警提醒

???? 注意：

也可以在騰訊連連小程序的“我的>我的消息”中的“告警”頁(yè)簽，查看告警信息。