?前 言

本文檔主要介紹基于TLT113-EVM評估板的物聯網模塊開發案例，適用開發環境：

Windows開發環境：Windows 7 64bit、Windows 10 64bit

虛擬機：VMware15.5.5

Linux開發環境：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)

無特殊說明情況下，本文默認使用USB TO UART0作為調試串口，使用Linux系統啟動卡（Micro SD方式）啟動系統。

本文檔對應案例的測試接口、測試結果說明如下表所示。

表 1

NB-IoT模塊案例

案例說明

案例功能：評估板通過串口發送AT指令至NB-IoT模塊，創建通信實例，實現NB-IoT模塊與NB-IoT物聯網平臺通信。

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

硬件連接

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

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

圖?1

表?2?引腳連接關系

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

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

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

圖?5?EXPORT接口引腳定義

案例測試

獲取IMEI和IMSI

評估板上電啟動，進入評估板文件系統，執行如下命令配置串口，等待接收模塊信息。

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

Target# cat /dev/ttyS4 &

圖?6

執行如下命令，獲取IMEI碼和IMSI碼。

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

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

圖?7

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

創建云端NB-IoT設備

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

賬號登錄成功，進入如下界面，點擊右上角“開發者中心”。

圖 8

進入如下界面，點擊“創建產品”。

圖 9

進入如下界面，根據實際情況選擇產品品類，選擇智能化方式為“設備接入”，填寫“產品名稱”，節點類型選擇“直連設備”，接入協議選擇"LwM2M"，數據協議選擇"IPSO"，聯網方式選擇"NB"，自動發現資源選擇“開啟”。

圖 10

成功創建產品后，點擊設備管理，再點擊添加設備，然后在彈出界面填寫所屬產品、設備名稱、IMEI碼和IMSI碼等相關信息。

圖 11

圖 12

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

圖 13

圖 14

至此云端設備準備就緒，測試完成后，可刪除設備綁定信息，以便后續其他設備測試。

圖?15

創建通信套件實例

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

1.生成配置參數

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

圖?16

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

圖?17

進入cfg_tool目錄，使用文本工具打開test.xml文件。

圖?18

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

圖?19?修改前

圖?20?修改后

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

CMD# cd /d E:Toolscfg_tool

CMD# cis_cgtool.exe test.xml out.bin

圖?21

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

圖?22

使用Sublime Text軟件打開out.bin文件，可看到設備配置參數以16進制顯示。同時鼠標右擊點擊out.bin文件可查看該文件大小為93Byte。

圖?23

圖?24

2.創建實例

（1）創建OneNET通信套件實例

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

參數解析：

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

：配置文件內容，16進制數的形式。

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

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

：消息標識，1：第一條消息，2：中間消息，0：最后一條消息。

進入評估板文件系統，執行如下命令，返回OK表示創建成功。

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

圖?25

（2）創建LwM2M協議實例

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

參數解析：

：基礎通信套件的一個實例標識，類型為一個無符號整數。

：對象ID。

：實例個數。

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

：屬性個數。

：操作個數。

執行如下命令，返回OK表示創建成功。

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

圖?26

（3）發起注冊請求

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

：基礎通信套件的一個實例標識，類型為一個無符號整數。

：生命周期，單位為秒。

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

執行如下命令，當通信無誤時，將會返回OK，模塊接下來開始上報狀態事件，如下圖所示。

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

圖?27

狀態事件信息說明如下。

+MIPLEVENT:0,1 //bootstrap啟動

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

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

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

（4）0驗證Observe請求

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

圖?28

每當模塊上報一次Observe請求，請務必在5秒內執行如下命令進行驗證，驗證成功后，將會返回OK。如模塊繼續上報Observe請求，需繼續執行命令驗證，直至實例訂閱成功，如下圖所示。

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

圖?29

同時，在云端設備管理界面，可觀察到對應設備呈現自動訂閱成功狀態，至此，創建實例完成。

圖?30

（5）注銷實例

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

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

圖?31

由于篇幅過長等原因，部分內容均不逐一展示，如需獲取完整版詳細資料，請關注創龍科技微信公眾號或官網，或者評論區留言，感謝您的支持！

?審核編輯 黃宇