?前 言

本文檔主要介紹基于TLT113-EVM評估板的物聯(lián)網(wǎng)模塊開發(fā)案例，適用開發(fā)環(huán)境：

Windows開發(fā)環(huán)境：Windows 7 64bit、Windows 10 64bit

虛擬機：VMware15.5.5

Linux開發(fā)環(huán)境：Ubuntu18.04.4 64bit

U-Boot：U-Boot-2018.07

Kernel：Linux-5.4.61、Linux-RT-5.4.61

LinuxSDK：T113_Tina5.0-V1.0(Linux)

無特殊說明情況下，本文默認(rèn)使用USB TO UART0作為調(diào)試串口，使用Linux系統(tǒng)啟動卡（Micro SD方式）啟動系統(tǒng)。

本文檔對應(yīng)案例的測試接口、測試結(jié)果說明如下表所示。

表 1

NB-IoT模塊案例

案例說明

案例功能：評估板通過串口發(fā)送AT指令至NB-IoT模塊，創(chuàng)建通信實例，實現(xiàn)NB-IoT模塊與NB-IoT物聯(lián)網(wǎng)平臺通信。

案例使用的NB-IoT模塊型號為：億佰特EA01-D，詳細(xì)參考資料請查看產(chǎn)品資料“6-開發(fā)參考資料其他參考文檔”目錄下的《EA01-D_Usermanual_CN_v1.1》文檔。

硬件連接

請將NB-IoT物聯(lián)網(wǎng)卡插至NB-IoT模塊Micro SIM卡槽，將2.4G天線連接至模塊天線接口。請按照下表，使用杜邦線將NB-IoT模塊與評估板的TTL UART4接口、EXPORT接口進(jìn)行連接，具體如下圖所示。

備注：EXPORT接口的pin1引腳為NB-IoT模塊提供5V電源，pin16用于NB-IoT模塊復(fù)位。"/"表示引腳無需連接。

圖?1

表?2?引腳連接關(guān)系

圖?2?NB-IoT模塊機械尺寸

圖?3?NB-IoT模塊引腳定義

圖?4?TTL UART4接口引腳定義

圖?5?EXPORT接口引腳定義

案例測試

獲取IMEI和IMSI

評估板上電啟動，進(jìn)入評估板文件系統(tǒng)，執(zhí)行如下命令配置串口，等待接收模塊信息。

Target# stty -F /dev/ttyS4 ispeed 9600 ospeed 9600 cs8 -echo

Target# cat /dev/ttyS4 &

圖?6

執(zhí)行如下命令，獲取IMEI碼和IMSI碼。

Target# echo "AT+CGSN=1" > /dev/ttyS4 //獲取IMEI碼

Target# echo "AT+CIMI" > /dev/ttyS4 //獲取IMSI碼

圖?7

本次獲取的IMEI碼為"864624050086604"，獲取的IMSI碼為"460085855508110"。

創(chuàng)建云端NB-IoT設(shè)備

本次測試以中國移動NB-IoT物聯(lián)網(wǎng)解決方案OneNET為例進(jìn)行演示。請登錄官方網(wǎng)站：open.iot.10086.cn，通過手機號進(jìn)行注冊賬號并登錄。

賬號登錄成功，進(jìn)入如下界面，點擊右上角“開發(fā)者中心”。

圖 8

進(jìn)入如下界面，點擊“創(chuàng)建產(chǎn)品”。

圖 9

進(jìn)入如下界面，根據(jù)實際情況選擇產(chǎn)品品類，選擇智能化方式為“設(shè)備接入”，填寫“產(chǎn)品名稱”，節(jié)點類型選擇“直連設(shè)備”，接入?yún)f(xié)議選擇"LwM2M"，數(shù)據(jù)協(xié)議選擇"IPSO"，聯(lián)網(wǎng)方式選擇"NB"，自動發(fā)現(xiàn)資源選擇“開啟”。

圖 10

成功創(chuàng)建產(chǎn)品后，點擊設(shè)備管理，再點擊添加設(shè)備，然后在彈出界面填寫所屬產(chǎn)品、設(shè)備名稱、IMEI碼和IMSI碼等相關(guān)信息。

圖 11

圖 12

添加設(shè)備完成后，可看到目前設(shè)備處于未激活狀態(tài)。點擊“詳情”，可查看設(shè)備PSK碼，在彈出的窗口中輸入自定義Auth_Code：Tronlong。至此，云端NB-loT設(shè)備創(chuàng)建完成。

圖 13

圖 14

至此云端設(shè)備準(zhǔn)備就緒，測試完成后，可刪除設(shè)備綁定信息，以便后續(xù)其他設(shè)備測試。

圖?15

創(chuàng)建通信套件實例

本小節(jié)主要演示NB-IoT模塊的通信實例，詳細(xì)參考資料請查看產(chǎn)品資料“6-開發(fā)參考資料其他參考文檔”目錄下的《EA01-S+3GPP和運營商云平臺標(biāo)準(zhǔn)指令手冊》文件。

1.生成配置參數(shù)

將產(chǎn)品資料“4-軟件資料ToolsWindows”目錄下的cfg_tool.zip和Sublime-Text-Build-3211_x64.zip壓縮包拷貝至Windows非中文目錄下并解壓。

圖?16

進(jìn)入Sublime-Text-Build-3211_x64目錄，雙擊sublime_text.exe程序進(jìn)行安裝。

圖?17

進(jìn)入cfg_tool目錄，使用文本工具打開test.xml文件。

圖?18

根據(jù)前文獲取的信息，修改AuthCode為Tronlong，修改PSK為UQ4lMgNGTQRzgszS，如下圖所示。

圖?19?修改前

圖?20?修改后

打開Windows命令行CMD，輸入如下命令進(jìn)入ctg_tool目錄，生成配置文件。

CMD# cd /d E:Toolscfg_tool

CMD# cis_cgtool.exe test.xml out.bin

圖?21

執(zhí)行完成后，將會在ctg_tool目錄下生成新的out.bin文件。

圖?22

使用Sublime Text軟件打開out.bin文件，可看到設(shè)備配置參數(shù)以16進(jìn)制顯示。同時鼠標(biāo)右擊點擊out.bin文件可查看該文件大小為93Byte。

圖?23

圖?24

2.創(chuàng)建實例

（1）創(chuàng)建OneNET通信套件實例

測試命令為：echo AT+MIPLCREATE=,,,, > /dev/ttyS4

參數(shù)解析：

：配置文件的總長度。即out.bin文件大小，本次測試文件為93Byte。

：配置文件內(nèi)容，16進(jìn)制數(shù)的形式。

：配置文件的序號?？紤]到AT指令長度有限，一個完整的配置文件未必能在一條AT指令中發(fā)送完成，可將內(nèi)容切分成多段。比如分為N段，則從前到后按照降序依次分配序號為N-1~0，按照從大到小序號的順序每段調(diào)用一次AT指令。如當(dāng)index為0時，意味著該條指令為最后一條配置消息。

：當(dāng)前命令所包含的配置文件長度。本次測試為93Byte。

：消息標(biāo)識，1：第一條消息，2：中間消息，0：最后一條消息。

進(jìn)入評估板文件系統(tǒng)，執(zhí)行如下命令，返回OK表示創(chuàng)建成功。

Target# echo "AT+MIPLCREATE=93,13005df10003f2004f040011800005434d494f540000000000123138332e3233302e34302e33393a35363833002741757468436f64653a54726f6e6c6f6e673b50534b3a5551346c4d674e475451527a67737a533bf30008e400c80000,0,93,0" >/dev/ttyS4

圖?25

（2）創(chuàng)建LwM2M協(xié)議實例

測試命令為：echo AT+MIPLADDOBJ=,,,,, > /dev/ttyS4

參數(shù)解析：

：基礎(chǔ)通信套件的一個實例標(biāo)識，類型為一個無符號整數(shù)。

：對象ID。

：實例個數(shù)。

：實例位圖，字符串格式，每一個字符表示為一個實例，其中1表示可用，0表示不可用。例如添加的Object有5個實例，其中1、3可用，則實例位圖為00101。

：屬性個數(shù)。

：操作個數(shù)。

執(zhí)行如下命令，返回OK表示創(chuàng)建成功。

Target# echo AT+MIPLADDOBJ=0,3311,1,1,1,4 > /dev/ttyS4

圖?26

（3）發(fā)起注冊請求

測試命令為：ehco AT+MIPLOPEN=,, > /dev/ttyS4

：基礎(chǔ)通信套件的一個實例標(biāo)識，類型為一個無符號整數(shù)。

：生命周期，單位為秒。

：注冊的超時時長，單位為秒。

執(zhí)行如下命令，當(dāng)通信無誤時，將會返回OK，模塊接下來開始上報狀態(tài)事件，如下圖所示。

Target# echo AT+MIPLOPEN=0,3000,30 > /dev/ttyS4

圖?27

狀態(tài)事件信息說明如下。

+MIPLEVENT:0,1 //bootstrap啟動

+MIPLEVENT:0,2 //bootstrap啟動成功

+MIPLEVENT:0,4 //連接成功

+MIPLEVENT:0,6 //注冊成功

（4）0驗證Observe請求

實例注冊成功后，NB-IoT模塊將會上報Observe請求，其中上報請求中第二個參數(shù)為消息的ID，如下圖所示。

圖?28

每當(dāng)模塊上報一次Observe請求，請務(wù)必在5秒內(nèi)執(zhí)行如下命令進(jìn)行驗證，驗證成功后，將會返回OK。如模塊繼續(xù)上報Observe請求，需繼續(xù)執(zhí)行命令驗證，直至實例訂閱成功，如下圖所示。

Target# echo AT+MIPLOBSERVERSP=0, 88824,1 > /dev/ttyS4

圖?29

同時，在云端設(shè)備管理界面，可觀察到對應(yīng)設(shè)備呈現(xiàn)自動訂閱成功狀態(tài)，至此，創(chuàng)建實例完成。

圖?30

（5）注銷實例

在注冊實例的過程中超時回復(fù)將會導(dǎo)致訂閱失敗，可通過執(zhí)行如下命令注銷實例并重新注冊。若出現(xiàn)如下圖所示打印信息，表示注銷成功。

Target# echo "AT+MIPLCLOSE=0" > /dev/ttyS4

圖?31

由于篇幅過長等原因，部分內(nèi)容均不逐一展示，如需獲取完整版詳細(xì)資料，請關(guān)注創(chuàng)龍科技微信公眾號或官網(wǎng)，或者評論區(qū)留言，感謝您的支持！

?審核編輯 黃宇