前言

本文主要介紹N700模塊如何訪問(wèn)電信天空云平臺(tái)。

AT指令請(qǐng)參考TianyiCloud AT手冊(cè)；

天翼云平臺(tái)概述

NB-IOT 主要包括NB設(shè)備、NB-IOT網(wǎng)絡(luò)、中國(guó)電信物聯(lián)網(wǎng)平臺(tái)、垂直行業(yè)應(yīng)用：

NB-IOT設(shè)備：通過(guò)無(wú)線網(wǎng)絡(luò)連接到中國(guó)電信物聯(lián)網(wǎng)開發(fā)平臺(tái)，采用COAP協(xié)議接入，水表、電表、氣表等。

NB-IOT網(wǎng)絡(luò)：實(shí)現(xiàn)對(duì)NB-IOT終端的移動(dòng)性管理和會(huì)話管理：為NB-IOT終端建立用戶面承載，傳遞上下行業(yè)務(wù)數(shù)據(jù)。

中國(guó)電信物聯(lián)網(wǎng)開發(fā)平臺(tái)：實(shí)現(xiàn)對(duì)各種NB-IOT設(shè)備的數(shù)據(jù)統(tǒng)一管理，同時(shí)向第三方應(yīng)用系統(tǒng)開放接口，讓各種應(yīng)用能快速構(gòu)建自己的物聯(lián)網(wǎng)業(yè)務(wù)。

垂直行業(yè)應(yīng)用：實(shí)現(xiàn)對(duì)NB設(shè)備的業(yè)務(wù)管理，包括業(yè)務(wù)發(fā)放、關(guān)務(wù)控制和呈現(xiàn)等，由第三方基于中國(guó)電信物聯(lián)網(wǎng)開放接口進(jìn)行開發(fā)。

天翼云平臺(tái)業(yè)務(wù)示意圖

參考文檔

《FIBOCOM N 700 AT Commands User Manual_TianyiCloud》

《FIBOCOM N 700 電信天翼云平臺(tái)對(duì)接向?qū)А?/p>

使用說(shuō)明和AT指令

平臺(tái)端操作

功能使用前的狀態(tài)檢查

獲取模塊的IMEI號(hào)用于在云平臺(tái)新建產(chǎn)品。

平臺(tái)注冊(cè)

方法一：微信關(guān)注“天翼物聯(lián)產(chǎn)業(yè)聯(lián)盟”公眾號(hào)填寫開放平臺(tái)測(cè)試賬號(hào)申請(qǐng)。

方法二：網(wǎng)頁(yè)登錄“天翼物聯(lián)產(chǎn)業(yè)聯(lián)盟”網(wǎng)站（www.）填寫開放平臺(tái)測(cè)試賬號(hào)申請(qǐng)。

申請(qǐng)成功后，會(huì)在郵箱中收到賬號(hào)密碼等登錄信息。

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

1）登錄 中國(guó)電信物聯(lián)網(wǎng)平臺(tái)。

在上圖位置點(diǎn)擊添加項(xiàng)目，項(xiàng)目名稱可以根據(jù)實(shí)情情況填寫，添加成功后進(jìn)入項(xiàng)目。

在新建項(xiàng)目的視圖里點(diǎn)擊產(chǎn)品開發(fā)，在產(chǎn)品開發(fā)視圖里點(diǎn)擊新建產(chǎn)品。

在新建產(chǎn)品的視圖里，可以根據(jù)已有的產(chǎn)品模板新建產(chǎn)品，或者完全由自定義創(chuàng)建，在本例子中，我們以自定義來(lái)創(chuàng)建產(chǎn)品。按照實(shí)際信息填寫產(chǎn)品信息，接入應(yīng)用層協(xié)議類型選擇CoAP。產(chǎn)品創(chuàng)建成功后進(jìn)入Profile定義界面。

點(diǎn)擊新建服務(wù)，如上圖增加兩個(gè)服務(wù)，在Uplink服務(wù)中添加屬性，模塊將用這個(gè)屬性來(lái)上報(bào)信息；在Downlink服務(wù)中添加命令，平臺(tái)將用這個(gè)服務(wù)來(lái)下發(fā)信息到模塊。

完成后保存并進(jìn)入編解碼插件開發(fā)。
點(diǎn)擊新增消息，新增如下圖一條模塊上行信息，注意要選擇數(shù)據(jù)上報(bào)。

完成后添加數(shù)據(jù)上報(bào)字段，勾選標(biāo)記為地址域，如下圖。

2）點(diǎn)擊右上角的創(chuàng)建產(chǎn)品

根據(jù)提示填寫相應(yīng)信息，如下圖所示：

完成后再此添加數(shù)據(jù)上報(bào)字段，如下圖，此字段是用于放置之前創(chuàng)建的Vaule屬性。

完成后回到編輯器界面，將右方設(shè)備模型下Uplink的參數(shù)Value拖動(dòng)至左邊消息模型的Value處，如下圖。

類似的，再添加一條下行信息，并添加下行命令，如下圖。

至此，完成兩種類型的消息創(chuàng)建，保存并部署此插件，待頁(yè)面顯示在線插件部署成功，即可進(jìn)入下一環(huán)節(jié)，在線調(diào)測(cè)。

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

點(diǎn)擊在線調(diào)測(cè)，先進(jìn)行虛擬設(shè)備調(diào)試，點(diǎn)擊沒(méi)有真實(shí)的物理設(shè)備，創(chuàng)建一個(gè)虛擬設(shè)備?？梢钥吹饺缦陆缑?/p>

在這個(gè)頁(yè)面上分別模擬了服務(wù)器端應(yīng)用和模塊設(shè)備端。我們可以在這個(gè)頁(yè)面驗(yàn)證創(chuàng)建的插件和消息是否能滿足需求。如下操作：

1. 設(shè)備上報(bào)信息：在設(shè)備模擬器碼流輸入窗口中輸入0064（00為地址域，64為Value的值），點(diǎn)擊發(fā)送，即可在應(yīng)用模擬器中看到上報(bào)的值。

2. 服務(wù)器端命令下發(fā)：在應(yīng)用模擬器中選擇合適的服務(wù)，在輸入窗口輸入0，點(diǎn)擊立即發(fā)送，即可在設(shè)備模擬器中看到接收到的0100（01為地址域，00為Switch的值）的數(shù)據(jù)。

在此驗(yàn)證成功后我們就可以新建真實(shí)設(shè)備，在N700模塊端進(jìn)行操作了。

在設(shè)備管理界面添加真實(shí)設(shè)備，此處要填入模塊的真實(shí)信息，如下圖。

添加成功后就可以使用PC連接模塊進(jìn)行操作

設(shè)備端命令操作

功能相關(guān)的AT命令

說(shuō)明

1、模塊本身有Flash，直接斷電影響數(shù)據(jù)存儲(chǔ)和下次開啟時(shí)初始化，建議相鄰兩次斷電建議間隔大于300秒。

2、模塊默認(rèn)UART1波特率是115200。推薦用115200。如果需要改串口波特率比如9600，把第一條指令A(yù)T換成AT+IPR=9600，連續(xù)發(fā)給模塊直到返回OK。用串口調(diào)試工具也要選擇對(duì)應(yīng)的波特率。模塊支持哪些波特率請(qǐng)查看AT手冊(cè)里IPR命令。如果是Linux系統(tǒng)則先發(fā)ATE0。

3、AT+MSTART=0,0 回復(fù)“OK” 1 默認(rèn)1,1,，分別對(duì)應(yīng)啟用AT commad ready和+SIM ready上報(bào)。AT+MSTART=0,0回復(fù)OK后關(guān)閉這兩個(gè)上報(bào)。

創(chuàng)建連接

AT+MIPCALL=1,”CTNET”

使用上面的命令激活PDP。

AT+GTLWCTOPEN="180.101.147.115",5683,"867070030099977",90

使用上面的命令連接到天翼云，連接信息在平臺(tái)的“對(duì)接信息”頁(yè)面可以查詢到，不要使用加密連接。第三個(gè)參數(shù)IMEI是必須帶的，這個(gè)參數(shù)是上一步在平臺(tái)登記的IMEI號(hào)，必須經(jīng)過(guò)登記的設(shè)備才可以連接，否則會(huì)出現(xiàn)報(bào)錯(cuò)的情況。

發(fā)送數(shù)據(jù)

與使用模擬設(shè)備時(shí)類似的，使用以下AT命令發(fā)送數(shù)據(jù)。

AT+GTLWCTSEND="0064"

接收數(shù)據(jù)

數(shù)據(jù)接收功能模塊是被動(dòng)的一側(cè)，只需要在平臺(tái)側(cè)下發(fā)數(shù)據(jù)，模塊收到后就會(huì)通過(guò)串口上報(bào)。在設(shè)備管理界面選擇正確的模塊設(shè)備，點(diǎn)擊調(diào)試產(chǎn)品，如下圖，即可下發(fā)數(shù)據(jù)。

操作指導(dǎo)

工具名稱：串口調(diào)試助手（最好帶時(shí)間戳功能，方便確認(rèn)超時(shí)時(shí)間）

適用范圍：Windows系統(tǒng)（包括Windows XP/Windows 7/Windows 10）

測(cè)試時(shí)可以先用萬(wàn)用表測(cè)量模塊的開機(jī)指示管腳確認(rèn)關(guān)機(jī)。

AT+MIPCALL=1 //激活PDP

OK

+MIPCALL: 1,10.34.174.70

AT+GTLWCTOPEN="180.101.147.115",5683,"867070030099977",90 //激活天翼云連接

OK

+GTLWCTNOTIFY: register success //注冊(cè)成功

+GTLWCTNOTIFY: observe success //資源發(fā)現(xiàn)成功

AT+GTLWCTSEND="0064" //發(fā)送數(shù)據(jù)

OK

+GTLWCTNOTIFY: notify success //發(fā)送成功

+GTLWCTRECV: 0101 //收到數(shù)據(jù)

使用注意事項(xiàng)

1. 平臺(tái)下發(fā)通知后，需要在3-5s內(nèi)回復(fù)，否則會(huì)超時(shí)。超時(shí)后需要重新執(zhí)行上一步的操作，如重新MIPLOPEN或重新在平臺(tái)上下發(fā)通知。

2. 平臺(tái)下發(fā)通知的msgid與模塊端上報(bào)的msgid是要對(duì)應(yīng)的。

FAQ

模塊不響應(yīng)AT命令？

（1）確保模塊正常開機(jī)，檢查模塊的供電（300mV以內(nèi)紋波）和開機(jī)關(guān)機(jī)管腳、模塊的復(fù)位管腳穩(wěn)定。

模塊串口、USB通信正常，串口電平匹配，如果用了流控注意流控沒(méi)有接反。

（2）AT指令需要加 “\r\n”結(jié)束

AT命令返回ERROR如何處理？

模塊上電后，初始化、讀卡、聯(lián)網(wǎng)都需要時(shí)間，和設(shè)備的射頻性能以及當(dāng)前的網(wǎng)絡(luò)環(huán)境有關(guān)。調(diào)試時(shí)可以先執(zhí)行AT+CMEE=2，模塊回復(fù)OK，再執(zhí)行該AT命令，大多數(shù)的AT命令都會(huì)回復(fù)錯(cuò)誤詳情。如果改成AT+CMEE=1，大多數(shù)的AT命令都會(huì)回復(fù)錯(cuò)誤碼，在AT手冊(cè)里搜索ERROR CODE查看。

如果一直無(wú)法收發(fā)無(wú)法識(shí)別SIM卡，建議檢查

AT+MIPCALL一直ERROR或者失敗？

（1）請(qǐng)先確保SIM卡沒(méi)有欠費(fèi)、使用了2G/4G模塊天線而且連接牢固，當(dāng)前運(yùn)營(yíng)商的信號(hào)質(zhì)量比較良好。可以用上面提到的狀態(tài)相關(guān)的AT命令來(lái)確認(rèn)。

（2）注意“AT+MIPCALL= ” 這樣的異步命令是不能中斷的。如果已經(jīng)存在再次發(fā)也會(huì)報(bào)錯(cuò)。必須等到+MIPCALL上報(bào)或者指令超時(shí)，才能做下一步操作。

例1：運(yùn)營(yíng)商給模塊分配的IP還在，重復(fù)執(zhí)行AT+MIPCALL設(shè)置命令無(wú)法再次獲取。報(bào)ERROR

AT+MIPCALL?

+MIPCALL: 1,10.231.201.248

OK

AT+MIPCALL=1,"cmnet"

ERROR

例2：AT+MIPCALL設(shè)置命令正在執(zhí)行，假如立即再發(fā)一條AT+MIPCALL，第二條指令不會(huì)執(zhí)行而且返回ERROR

AT+MIPCALL=1,"cmnet"

OK

AT+MIPCALL=1,"cmnet"

ERROR

+MIPCALL: 10.79.6.77

術(shù)語(yǔ)

APN Access Point Name,接入點(diǎn)接入點(diǎn),決定接入網(wǎng)絡(luò)的方式和網(wǎng)絡(luò)

CE Consumer Electronics，消費(fèi)電子

DTMF 雙音多頻dual-tone multifrequency

FTP File Transfer Protocol，文件傳輸協(xié)議

HS測(cè)試 有害物質(zhì)測(cè)試

HTTP Hyper Text Transport Protocol，超文本傳輸協(xié)議

HTTPS Hyper Text Transfer Protocol over Secure Socket Layer,超文本傳輸安全協(xié)議

IoT Internet of Things，物聯(lián)網(wǎng)

LBS Locationbasedservice，基于位置的服務(wù)

LPWA 低功耗廣覆蓋

M2M模塊 Machine to Machine，物聯(lián)網(wǎng)模塊

MQTT Message Queuing Telemetry Transport，消息隊(duì)列遙測(cè)傳輸

NB-IoT Narrow Band Internet of Things，基于蜂窩的窄帶物聯(lián)網(wǎng)
NTP Network Time Protocol，網(wǎng)絡(luò)時(shí)間協(xié)議

SFTP Secure File Transfer Protocol，安全文件傳送協(xié)議

SMT Surface Mount Technology，表面組裝技

SSL Secure Sockets Layer，安全套接層協(xié)議

TCP Transmission Control Protocol，一種面向連接的傳輸方式

TLS Transport Layer Security，傳輸層安全

TTS Text To Speech，從文本到語(yǔ)音，語(yǔ)音播報(bào)

UDP User Datagram Protocol，一種面向非連接的傳輸方式