電信物聯(lián)網(wǎng)開放平臺-nb-iot業(yè)務(wù)lwm2m場景對接指導(dǎo)書

1、中國電信物聯(lián)網(wǎng)開放_NB-IoT 業(yè)務(wù) LWM2M場景對接指導(dǎo)書（V1.0）二二一年八月編制：修訂：版本號日期描述012017/11/06中國電信物聯(lián)網(wǎng)開放_NB-IoT 業(yè)務(wù) LWM2M 場景對接指導(dǎo)書編制中國電信物聯(lián)網(wǎng)運營部前言目錄概述本文檔針對 NB-IoT 業(yè)務(wù)的 LWM2M 場景，從準備工作、自定義設(shè)備模型、編插件開發(fā)、設(shè)備接入及消息上下行等方法流程進行了介紹。本文檔提供了 NB-IoT 業(yè)務(wù)中 LWM2M 場景下設(shè)備接入的指導(dǎo)。讀者對象本文檔主要適用于以下工程師：開發(fā)工程師技術(shù)支持工程師工程師符號約定在本文中可能出現(xiàn)下列標志，它們所代表的含義如下。符號說明用于警示緊急的情形，若不避

2、免，將會導(dǎo)致或嚴重的人身。用于警示潛在的情形，若不避免，可能會導(dǎo)致死亡或嚴重的人身。用于警示潛在的情形，若不避免，可能會導(dǎo)致中度或輕微的人身。用于傳遞設(shè)備或環(huán)境安全警示信息，若不避免，可能會導(dǎo)致設(shè)備損壞、數(shù)據(jù)丟失、設(shè)備性能降低或其它不可預(yù)知的結(jié)果。“注意”不涉及人身 。符號說明用于突出重要/關(guān)鍵信息、最佳實踐和小竅門等?！罢f明”不是安全警示信息，不涉及人身、設(shè)備及環(huán)境傷害信息。目 錄前 言iii目 錄1概述1功能組網(wǎng)介紹1整體業(yè)務(wù)介紹1準備工作3獲取測試環(huán)境賬號3創(chuàng)建 APP 應(yīng)用5NB-IoT 參數(shù)設(shè)置6定義設(shè)備模型8設(shè)備模型介紹8定義產(chǎn)品的設(shè)備模型8新增服務(wù)模板9新增服務(wù)屬性10新增服務(wù)命

3、令11新增設(shè)備模板12新增自定義產(chǎn)品13導(dǎo)入模型15開發(fā)編開發(fā)編插件并安裝16插件16對插件包進行離線簽名16上傳公鑰及簽名后的插件包18設(shè)備接入19登陸應(yīng)用195.2 訂閱205.3設(shè)備20設(shè)置設(shè)備信息21設(shè)備接入215.5.1 接入端口與協(xié)議215.5.2接口225.5.3 更新接口225.5.4 設(shè)備注銷接口235.6 設(shè)備上線23業(yè)務(wù)數(shù)據(jù)上報和業(yè)務(wù)消息下發(fā)25接收設(shè)備上報的數(shù)據(jù)25向設(shè)備發(fā)送消息28命令下發(fā)1命令立即下發(fā)2命令緩存下發(fā)38功能5測試環(huán)境測試5測試申請59.2 開放測試5生產(chǎn)環(huán)境接入6賬號申請6生產(chǎn)環(huán)境接入611 參考文檔7中國電信物聯(lián)網(wǎng)開放中國電信物聯(lián)網(wǎng)開放中國電信物聯(lián)

4、網(wǎng)開放中國電信物聯(lián)網(wǎng)開放_設(shè)備能力描述文件profile 開發(fā)指南7V100R001C30 編庫開發(fā)與升級指南7北向應(yīng)用 QuickStart7API 參考 1.3.171概述1.1 功能組網(wǎng)介紹在設(shè)備側(cè)，智能設(shè)備采用了 NB-IOT，它和中國電信物聯(lián)網(wǎng)開放之間通過CoAP 協(xié)議通訊。CoAP 報文的 payload 里是設(shè)備的應(yīng)用數(shù)據(jù)。應(yīng)用 server 通過 http/https 協(xié)議和通訊，通過調(diào)用的開放 API 來控制設(shè)備，平臺把設(shè)備上報的數(shù)據(jù)推送給應(yīng)用服務(wù)器。格式數(shù)據(jù)。可以支持對設(shè)備數(shù)據(jù)轉(zhuǎn)換成標準的 json圖1-1 組網(wǎng)圖1.2 整體業(yè)務(wù)介紹NB-IOT 業(yè)務(wù)主要包含 NB-IOT

5、 設(shè)備、NB-IOT 控制器、中國電信物聯(lián)網(wǎng)開放直行業(yè)應(yīng)用等：、垂NB-IOT 設(shè)備：通過無線網(wǎng)絡(luò)連接到中國電信物聯(lián)網(wǎng)開放表、燃氣表等。，采用 CoAP 協(xié)議接入。NB-IOT 網(wǎng)絡(luò)：為 NB-IoT 終端建立網(wǎng)絡(luò)承載，傳下行業(yè)務(wù)數(shù)據(jù)。中國電信物聯(lián)網(wǎng)開放：實現(xiàn)對 NB-IoT 設(shè)備的管理，同時向第口，讓各種應(yīng)用能快速構(gòu)建自己的物聯(lián)網(wǎng)業(yè)務(wù)。應(yīng)用系統(tǒng)開放接垂直行業(yè)應(yīng)用：實現(xiàn)對 NB 設(shè)備的業(yè)務(wù)管理，包括業(yè)務(wù)、業(yè)務(wù)控制和呈現(xiàn)等，由第基于中國電信物聯(lián)網(wǎng)開放開放接口進行開發(fā)。2準備工作2.1 獲取測試環(huán)境賬號客戶或電信政企經(jīng)理登錄“天翼物聯(lián)請?！碧顚戦_放測試賬號申圖2-1 查找并進入圖2-2 點擊服務(wù)選

6、擇實驗服務(wù)申請圖2-3 完成表格填寫并提交圖2-4 賬號申請通過后，收到賬號和初始-結(jié)束2.2 創(chuàng)建 APP 應(yīng)用登錄中國電信物聯(lián)網(wǎng)開放初次登錄需要修改初始對接測試環(huán)境 SP Portal（。）。圖2-5 SP Portal選擇【應(yīng)用管理】-【應(yīng)用】點擊右上角“+創(chuàng)建應(yīng)用”。典型的 NB-IoT 應(yīng)用的參數(shù)設(shè)置可參考如下設(shè)置：所屬行業(yè)：公用事業(yè)(NB-IoT)關(guān)聯(lián) API 包：基礎(chǔ) API 包和公用事業(yè)(NB-IoT) API 包能力：規(guī)則引擎數(shù)據(jù)時間：7。當超過了數(shù)據(jù)時間以后，應(yīng)用將不能再獲取到已上報的數(shù)據(jù)。服務(wù)器：使用戶可以通過服務(wù)器實現(xiàn)與工程師的緊密聯(lián)絡(luò)。服務(wù)器可以選擇經(jīng)支持的服務(wù)器之一

7、，也可以選擇第服務(wù)器。郵件服務(wù)器：使用戶可以通過郵件服務(wù)器實現(xiàn)與工程師的緊密聯(lián)絡(luò)。服務(wù)器可以選擇經(jīng)支持的服務(wù)器之一，也可以選擇第服務(wù)器。CA：第應(yīng)用通過 HTTPS 對接中國電信物聯(lián)網(wǎng)開放服務(wù)器下發(fā)的證書，用于識別和電子信息加密，實現(xiàn)雙向認證。文件限制為不超過 1M 的PEM 格式文件。當?shù)趹?yīng)用通過 HTTP 對接中國電信物聯(lián)網(wǎng)開放，不需要上傳 CA。圖2-6 創(chuàng)建應(yīng)用創(chuàng)建 APP 成功后，得到應(yīng)用 ID 和應(yīng)用密鑰，請保存。-結(jié)束2.3 NB-IoT 參數(shù)設(shè)置點擊已經(jīng)創(chuàng)建好的應(yīng)用，并對 NB-IoT 參數(shù)進行設(shè)置。圖2-7 已創(chuàng)建應(yīng)用圖2-8 NB-IoT 設(shè)置目前支持設(shè)置如下三種模式：PS

8、M 模式：er saving mode，省電模式。對下行業(yè)務(wù)時延無要求，對于下行業(yè)務(wù)消息，可等待設(shè)備發(fā)送上行數(shù)據(jù)進入連接態(tài)后再發(fā)送，可進一步節(jié)省終端功耗。如智能水表。DRX 模式：discontinuous reception，不連續(xù)接收模式。對下行業(yè)務(wù)時延要求高，可認為設(shè)備一直，消息能夠立即下發(fā)。如路燈。eDRX 模式：Extended idle mode DRX，擴展不連續(xù)接收模式。DRX 的擴展模式，對下行業(yè)務(wù)時延有較高要求，可根據(jù)系統(tǒng)配置立即下發(fā)消息或者緩存消息。如智能穿戴設(shè)備。當省電模式設(shè)置為 PSM 模式時，ACTIVE TIMER 可以不設(shè)置，無影響；當省電模式設(shè)置為 eDRX

9、模式時，eDRX 周期的設(shè)置需要與網(wǎng)絡(luò)側(cè)的一致，請聯(lián)系中國電信物聯(lián)網(wǎng)開放支持獲取參數(shù)配置數(shù)據(jù)。3 定義設(shè)備模型Profile 定義設(shè)備模型有兩種方式：方式一：從 Portal方式二：參制作 Profile 文件，請參考章節(jié) 3.13.7國電信物聯(lián)網(wǎng)開放_設(shè)備能力描述文件 profile 開發(fā)指南離線制作 Profile，然后再參考章節(jié) 3.8 上傳離線 Profile 文件3.1 設(shè)備模型介紹設(shè)備模型是指中國電信物聯(lián)網(wǎng)開放支持新的設(shè)備模型，并支持對設(shè)備模型進行管理。設(shè)備模型包括:產(chǎn)品、設(shè)備模板和服務(wù)模板。產(chǎn)品由設(shè)備模板、制造廠商、型號、協(xié)議等的具體實例。SP Portal 支持用戶根據(jù)需求自定

10、義產(chǎn)品。設(shè)備模板通過設(shè)備服務(wù)定義設(shè)備基本特性和能力。設(shè)備模板由多個服務(wù)模板組成。SP Portal 支持用戶使用預(yù)置設(shè)備模板，也支持用戶根據(jù)需求自定義設(shè)備模板。服務(wù)模板定義設(shè)備能 力，包括屬性、命令、事件等。SP Portal 支持用戶使用預(yù)置服務(wù)模板，也支持用戶根據(jù)需求自定義服務(wù)模板。圖3-1 產(chǎn)品、設(shè)備模板和服務(wù)模板關(guān)系圖:3.2 定義產(chǎn)品的設(shè)備模型設(shè)備模型定義了一個類型的設(shè)備具備哪些服務(wù)能力，每個服務(wù)有哪些屬性（即上報的數(shù)據(jù)有哪些字段），有哪些命令以及命令的參數(shù)。每個廠家在接入 NB-IoT 之前必須先定義自己的產(chǎn)品的設(shè)備模型。下面通過一個例子介紹一下如何定義產(chǎn)品設(shè)備模型。例如:某產(chǎn)品設(shè)

11、備的制造信息如下：廠商 ID：廠商名字：設(shè)備類型：SmartDevice設(shè)備型號：NBIoTDevice該設(shè)備具有三個服務(wù)能力：分別為亮度（Brightness）、溫度（Temperature）、電力（Electricity）。其中，亮度（Brightness）服務(wù)擁有一個亮度屬性及設(shè)置該屬性值令方法；溫度（Temperature）服務(wù)具有一個溫度（temperature）屬性及一個設(shè)置溫度的方法命令；電力（Electricity）具有四個屬性，分別為：電壓（votage），電力當前值（current），頻率（frequency）及功率因數(shù)（erfactor）。下面通過在 SP portal

12、設(shè)置該設(shè)備能力到。圖3-2 產(chǎn)品設(shè)備示例圖3.3 新增服務(wù)模板使用瀏覽器錯誤!超無效。；單擊左側(cè)，打開“設(shè)備管理”頁面；單擊“模型”下拉選項，單擊“服務(wù)模板”，打開“服務(wù)模板”頁面；單擊界面右上角“+新增服務(wù)模板按鈕”。例如，增加溫度（Temperature）服務(wù)。圖3-3 新增服務(wù)模板單擊確定后即可，溫度服務(wù)模板創(chuàng)建完畢。服務(wù)電力（Electricity）創(chuàng)建過程類似，不再贅述。服務(wù)亮度（Brightness）已經(jīng)預(yù)置，不用再創(chuàng)建。3.4 新增服務(wù)屬性以溫度服務(wù)為例，該服務(wù)具有一個屬性即溫度（temperature），現(xiàn)新增該屬性。點擊剛新增的溫度服務(wù)。圖3-4 Temperature 服務(wù)

13、單擊“屬性”，單擊“新增屬性”，彈出“新增屬性”頁面。根據(jù)實際情況設(shè)置下列參數(shù)。名稱：屬性名稱，且系統(tǒng)唯一。屬性類型：包括、long、decimal、string、DateTime、jsonObject。：當屬性類型為、long 和decimal 時，才會出現(xiàn)。最小、最大、步長、長度：當選擇屬性類型為 string、jsonObject 或 DateTime 時，才會出現(xiàn)。模式：屬性能夠的模式。是否必選：屬性是否必選。圖3-5 新增服務(wù)屬性點擊，即可完成對溫度屬性的設(shè)置。其他服務(wù)屬性值設(shè)置類似，不再贅述。3.5 新增服務(wù)命令以溫度服務(wù)為例，該服務(wù)具有一個命令即一個設(shè)置溫度令（SET_TEMPE

14、RATURE）現(xiàn)新增該服務(wù)命令。點擊剛剛新增的溫度服務(wù)，單擊“命令”，單擊“新增命令”，彈出“新增命令”頁面。圖3-6 新增服務(wù)命令單擊確定 即可在命令欄看到新增令。3.6 新增設(shè)備模板使用瀏覽器錯誤!超無效。；單擊左側(cè)，打開“設(shè)備管理”頁面；單擊“模型”下拉選項，選擇“關(guān)于模型”，打開“關(guān)于模型”頁面；單擊“自定義設(shè)備模板”，打開“設(shè)備模板”頁面。單擊右上角“新增設(shè)備模板”，彈出“新增設(shè)備模板”頁面。根據(jù)實際情況設(shè)置下列參數(shù)：設(shè)備模板：設(shè)備模板名稱，且系統(tǒng)唯一，這里填寫 SmartDevice。描述（可選）：設(shè)備模板描述內(nèi)容。圖3-7 新增設(shè)備模板3.7 新增自定義產(chǎn)品使用瀏覽器錯誤!超無效

15、。；單擊左側(cè)，打開“設(shè)備管理”頁面；單擊“模型”下拉選項，選擇“關(guān)于模型”，打開“關(guān)于模型”頁面；單擊“自定義產(chǎn)品”，打開“產(chǎn)品”頁面。單擊右上角“新增設(shè)備”按鈕，彈出“添加設(shè)備產(chǎn)品”頁面。根據(jù)實際情況設(shè)置下列參數(shù)：設(shè)備類型：產(chǎn)品所屬的設(shè)備類型。作為例子，這里填寫 3.6 節(jié)設(shè)備模板名稱。型號：產(chǎn)品所屬的型號。廠商 ID：產(chǎn)品所屬的廠商 ID。廠商：產(chǎn)品所屬的廠商名稱。協(xié)議：產(chǎn)品所屬的協(xié)議類型。NB-IoT 目前僅有 CoAP 和 LWM2M 兩種協(xié)議，請正確選擇接入?yún)f(xié)議。單擊“點擊上傳文件”上傳產(chǎn)品圖像。（可選）描述：產(chǎn)品描述內(nèi)容。圖3-8 添加設(shè)備產(chǎn)品單擊，完成自定義設(shè)備產(chǎn)品創(chuàng)建。創(chuàng)建完設(shè)

16、備后，設(shè)備產(chǎn)品模型中的服務(wù)項還是空的，需要將溫度（Temperature）、電力（Electricity）兩個已創(chuàng)建好的服務(wù)添加。另外還需要添加預(yù)置服務(wù)亮度（Brightness）。單擊已創(chuàng)建好的設(shè)備產(chǎn)品, 單擊服務(wù)列表中的“添加服務(wù)”，打開“添加服務(wù)類型”頁面，選定需要加入的服務(wù)能力。單擊即可完成。圖3-9 向產(chǎn)品中添加服務(wù)3.8 導(dǎo)入模型此章節(jié)針對方式二使用中國電信物聯(lián)網(wǎng)開放V100R001C30 編庫開發(fā)與升級指南離線制作 Profile 文件后再導(dǎo)入到中國電信物聯(lián)網(wǎng)開放的場景圖3-10 將離線制作的Profile 文件導(dǎo)入圖3-11 導(dǎo)入成功4開發(fā)編插件并安裝4.1 開發(fā)編插件設(shè)備模型

17、是設(shè)備的抽象模型，把設(shè)備的功能抽象為服務(wù)，對編庫插件而言，其定義了 decode 接口的輸出，encode 接口的輸入格式。編插件開發(fā)可參國電信物聯(lián)網(wǎng)開放V100R001C30 編庫開發(fā)與升級指南文檔。4.2 對插件包進行離線簽名當編插件開發(fā)完后，在安裝到之前，需要先對插件包進行簽名。此時需要下載離線簽名工具并進行簽名操作。操作步驟如下：步驟 1 使用瀏覽器登錄 SP Portal。步驟 2離線簽名工具。1.2.單擊左側(cè)圖標，打開管理頁面。單擊左側(cè)導(dǎo)航欄“工具”，在右側(cè)區(qū)域單擊“”，離線簽名工具。步驟 3在路徑找到壓縮包“signtool.zip”，右鍵菜單中選擇“Extract to sig

18、ntool”解壓縮至文件夾“signtool”。步驟 4進入 signtool 文件夾，運行“signtool.exe”。操作界面如下所示。圖4-1 離線簽名工具步驟 5生成數(shù)字簽名公私鑰對。3.根據(jù)實際情況選擇簽名算法。目前提供兩種簽名算法：ECDSA_256K1+SHA256RSA2048+SHA256設(shè)置“私鑰加密口令”?？诹顝?fù)雜度說明：口令長度至少為 6 個字符口令必須包含如下至少兩種字符的組合：至少一個小寫字母至少一個大寫字母至少一個數(shù)字至少一個特殊字符：!#$%&*()-_=+|;:,/？和空格4.5.單擊“生成公私密鑰”，在彈出的窗口中選擇需要保存的目錄，單擊“確定”?？稍诒４娴?/p>

19、目錄下查看生成的公私密鑰文件。公鑰文件：public.pem私鑰文件：private.pem步驟 6對包進行數(shù)字簽名。離線簽名工具只能對.zip 格式的壓縮包進行數(shù)字簽名。包數(shù)字簽名”區(qū)域，單擊“導(dǎo)入私鑰文件”，選擇步驟 5.3 中生成的私鑰6.在“文件，單擊“打開”。在彈出的框中，輸入步驟 5.2 中設(shè)置的口令，單擊“確定”。7.8.在“需要數(shù)字簽名的開”。包”區(qū)域，選擇需要進行數(shù)字簽名的包。單擊“打9.單擊“進行數(shù)字簽名”。簽名成功后，在原包。包所在目錄生成名為“_signed.”的帶簽名的步驟 7包簽名驗證。10.在“包簽名驗證”區(qū)域，單擊“導(dǎo)入公鑰文件”，選擇步驟 5.3 中生成的公鑰

20、文件，單擊“打開”。11.在“需要驗簽的包”區(qū)域，選擇步驟 6 中生成的名為“_signed.”的帶簽名的包。單擊“打開”。12.單擊“進行包驗簽”。驗證成功則彈出“驗證簽名成功！”提示框。驗證失敗則彈出“驗簽異常！”提示框。-結(jié)束4.3 上傳公鑰及簽名后的插件包編插件化能夠動態(tài)的新增編庫，這樣新增設(shè)備接入時，只需要把對應(yīng)的編解碼庫動態(tài)導(dǎo)入到，就能夠兼容新增的設(shè)備。請將公鑰以及簽名后的插件包發(fā)送給中國電信物聯(lián)網(wǎng)開放置。支持，由中國電信完成公鑰和簽名后的插件包的上傳配5 設(shè)備接入5.1 登陸應(yīng)用應(yīng)用中國電信物聯(lián)網(wǎng)開放必須首先進行登陸，登陸成功后獲取令牌（acsToken）。這一步消息中的 ap和

21、 secret 就是在“創(chuàng)建 APP 應(yīng)用”步驟里獲取的信息。消息示例：注意：如果多次獲取令牌，則之前的令牌失效,獲取令牌。最后一次獲取的令牌才有效。并發(fā)這一步獲取 token 后，接下來所有接口必須在 https 消息頭里攜帶以下字段。圖5-1 攜帶字段字段描述app_key填寫 apAuthorizatio n填寫 Bearer acsToken （注意中間有空格）Method：T request：(非 JSON 格式)Content-Type:application/x-www-form-urlencoded Body:ap=*&secret=* response：S us Code:

22、200 OKContent-Type: application/json Body:acsToken: *, tokenType: *, expiresIn: *, refreshToken: *, scope: *5.2 訂閱為了能接受設(shè)備上報的數(shù)據(jù)，NA 需要向中國電信物聯(lián)網(wǎng)開放訂閱通知消息。訂閱設(shè)備數(shù)據(jù)上報通知：訂閱成功后，設(shè)備上報數(shù)據(jù)時，中國電信物聯(lián)網(wǎng)開放上。會將數(shù)據(jù)推送到 callbackurl5.3設(shè)備所有設(shè)備必須先在北向進行，才允許連接到。通過設(shè)備，會為每個設(shè)備分配一個唯一的標識 deviceId，后續(xù)應(yīng)用操作這個設(shè)備時都通過 deviceId 來指定設(shè)備。另外，還返回 psk

23、參數(shù)（如果用戶未指定 psk 參數(shù)，會隨機分配一個參數(shù)），南向設(shè)備綁定時，如果設(shè)備與之間走 DTLS 加密通道，則須用到該參數(shù)，請保存。在 SP portal 上也可以通過 deviceId 來找到設(shè)備。Method：T request：Header： app_key: *Authorization:Bearer * Content-Type:application/json Body:verifyCode:447769804451095, nodeId:447769804451095, psk: 12345678,timeout:0response：S us Code: 201 CREATE

24、DContent-Type: application/json Body:deviceId: *, verifyCode: *, psk: 12345678,timeout: 0THeader： app_key: *Authorization:Bearer * Content-Type:application/json Body:notifyType: deviceDhanged, callbackurl: verifyCode 和 nodeId 需要填寫為設(shè)備唯一標識，請聯(lián)系模組廠商確認唯一標識；nodeId 需與章節(jié) 5.5.2 中的 endponame 一致。timeout 建議填寫為

25、0。5.4 設(shè)置設(shè)備信息這一步是為了把設(shè)備的廠商、型號、設(shè)備類型等信息設(shè)置到需要這些信息。，在處理過程中上述例子中的 5 個字段都必須進行設(shè)置。設(shè)備接入接入端口與協(xié)議目前中國電信物聯(lián)網(wǎng)開放支持加密與非加密兩種接入設(shè)備接入方式，其中加密業(yè)務(wù)數(shù)據(jù)交互端口是 5684 端口。5684 端口走 DTLS+CoAP 協(xié)議通道接入，非加密端口為 5683，接入?yún)f(xié)議為 CoAP。NB-IOT 設(shè)備端使用加密端口接入時提供必要的數(shù)據(jù)憑證，并支持標準 DTLS 協(xié)議。設(shè)備在登錄前，需將設(shè)備對接的端口設(shè)置為 5684（即走 DTLS 加密通道）。建議將設(shè)備出廠前的 PSK 秘鑰預(yù)置到中國電信物聯(lián)網(wǎng)開放中，PSK

26、秘鑰的數(shù)據(jù)類型為String 型，長度范圍為 8-32 位。調(diào)用 5.3設(shè)備接口，即可將設(shè)備 PSK 設(shè)置到。使用用非加密端口接入時，只需要使用原生的 CoAP 協(xié)議進行傳輸，同時將對接即可。設(shè)置為 5683Method：PUT request：deviceIdHeader： app_key: *Authorization:Bearer * Content-Type:application/jsonBody:manufacturerId: *, manufacturerName : *, deviceType: *, protocolType: CoAP,m: *response：S us C

27、ode: 200 OK5.5.2無論是可能有: ep =接口還是非C，設(shè)備都只需使用標準 OMA 接口進行，CoAP url 里帶的參數(shù)Endpont Name<=Lifetime&sms=MSISDN&lwm2m=ver&b=bindingmode&ObjectLinks,為兼容舊協(xié)議，除 ep 外其余均為可選。接口示例如下：操作Register（設(shè)備消息）lwm2m-URIaddress/rd?ep=endponame<=lifetime&sms=smsNumber &lwm2m=ver&b=binding&ObjectLinkslwm2m參數(shù)說明endponame：必選，即為的e

28、ndponame（endponame 字段包含兩部分內(nèi)容，前面字符為UE的IMEI號碼，后面為UE的IMSI的號碼，兩部分內(nèi)容由特殊的分隔符分開，比如“；”）；章節(jié)5.3中的nodeId需與endponame一致。lifetime：可選，默認值為86400 s（24小時）ver：可選，默認為1.0binding：可選，默認為U（即UDP）ObjectLinks ：必選，如, , 。CoAP-MethodTCoAP-OptionOption 1：Uri-Path（11）：rd，說明：括號里面的為Option Option 2：Content-Format（12）：application/link

29、-format Option 3：Uri-Query（15）：bindingOption 4：Uri-Query（15）：lifetimeOption 5：Uri-Query（15）：endponameCoAP-payloadlwm2m協(xié)議相關(guān)參數(shù)加上ObjectLinks，例如;rt=oma.lwm2m, Sucs2.01 CreatedFailure4.00 Bad Request, 4.03 Forbidden(1)需要處理 ep，要求設(shè)備攜帶 imei 作為ep，與北向時攜帶的 nodeId 必須一致。(2) 設(shè)備成功將會返回 registeration Id 以用于后續(xù)的更新與設(shè)備去

30、。注：暫時不會處理 LifeTime，及當 LifeTime 超時，設(shè)備訂閱信息也不會被刪除。5.5.3 更新接口根據(jù)協(xié)議設(shè)備可以使用mode）等。接口示例如下：更新接口進行設(shè)備信息更新，包括 LifeTime 以及綁定模式（binding操作Update(設(shè)備更新)lwm2m-URIaddress/registerationId ？lt=lifetime&b=binding參數(shù)說明 registerationId ：必選，需要更新的設(shè)備；lifetime：可選，默認值為86400 s（24小時）；binding：可選，默認為U（即UDP）CoAP-MethodTCoAP-OptionOpti

31、on 1：Location-Path（8）： registerationId Option 3：Uri-Query（15）：binding Option 4：Uri-Query（15）：lifetimeCoAP-payload Sucs2.04 ChangedFailure4.00 Bad Request, 4.01 Unauthorized設(shè)備更新使用 OMA 標準的接口，設(shè)備需要攜帶的 registeration Id，進行更新，將會校驗 registeration Id，如果校驗通過將會按照協(xié)議返回 2.04 Change 響應(yīng)，同時發(fā)送設(shè)備上線消息。否則返回 4.01 Unauthor

32、ized.5.5.4 設(shè)備注銷接口設(shè)備可以使用 De-register 接口進行設(shè)備注銷并使設(shè)備離線，其接口示例如下：操作De-register（設(shè)備注銷消息）lwm2m-URIaddress/ registerationId CoAP-MethodDELETECoAP-OptionOption 1：location-Path（8）： registerationId CoAP-payloadlocation：必選，需要注銷的設(shè)備；參數(shù)說明 Sucs2.02 DeletedFailure4.00 Bad Request, 4.04 Not Found5.6 設(shè)備上線完成這一步時，設(shè)備已經(jīng)可以接入

33、到。配置好網(wǎng)絡(luò)，開啟設(shè)備，觀察設(shè)備是否成功接入到。登陸 SP Portal 的設(shè)備管理頁面，查看設(shè)備列表，字段 ID 即為在第三步里設(shè)備時生成的 deviceId，sus 字段表示設(shè)備的狀態(tài)，如果狀態(tài)是（online）表示設(shè)備已經(jīng)成功的接入到，接著就可以接收設(shè)備的數(shù)據(jù)。圖5-2 查看設(shè)備列表6 業(yè)務(wù)數(shù)據(jù)上報和業(yè)務(wù)消息下發(fā)6.1 接收設(shè)備上報的數(shù)據(jù)時中國電信物聯(lián)網(wǎng)開放會主動訂閱 Binary Application Data 對象設(shè)備（19/0/0），設(shè)備按照協(xié)議使用訂閱時的 token 來上報業(yè)務(wù)臺將會根據(jù)設(shè)備的廠商 ID 和設(shè)備型號查找對應(yīng)的編電信物聯(lián)網(wǎng)開放平（編信息參見第 4 章），在后會

34、將數(shù)據(jù)通知到北向應(yīng)用。設(shè)備上報數(shù)據(jù)示例如下：操作Notify（數(shù)據(jù)上報）CoAP-TokenObserve tokenCoAP-MethodAsynchronous ResponseCoAP-OptionOption 1：Observe（6）：2（數(shù)據(jù)上報）Option 2：Content-Format（12），即為Observe Accept Option中設(shè)置的數(shù)據(jù)格式CoAP-payloadnewValue：上報的數(shù)據(jù)值Sucs2.05 Content （with Values）Failure圖6-1 上行消息處理流程上面消息里的 servi的 Brightness, Electrici

35、ty 及 Temperature 服務(wù)數(shù)據(jù)就是經(jīng)過編插件出來的，其為標準 json 格式的數(shù)據(jù)，字段和產(chǎn)品設(shè)備模型定義的一致?？梢栽?SP portal 的設(shè)備管理頁面里選擇“數(shù)據(jù)”觀察設(shè)備上報的數(shù)據(jù)。frequency: 50.1,erfactor: 0.98,eventTime: 20170214T170220Z,serviceId: Temperature, serviceType: Temperature, data: temperature: 25, eventTime: 20170214T170220Z圖6-2 設(shè)備上報數(shù)據(jù)查看：6.2 向設(shè)備發(fā)送消息圖6-3 下行消息處理流程向設(shè)

36、備下發(fā)上文模型中對 Temperature 服務(wù)設(shè)置定義令 SET_TEMPERATURE可以在 SP portal 的設(shè)備管理頁面里選擇“命令”命令下發(fā)的情況，下圖顯示該命令已發(fā)送。圖6-4 命令下發(fā)狀態(tài)查看當設(shè)備回一個 ACK（2.04 Changed）命令應(yīng)答時，命令的狀態(tài)由“已發(fā)送”狀態(tài)變?yōu)?“已送達”狀態(tài)。圖6-5 命令已送達TdeviceId/dsapp_key: * Authorization:Bearer * Content-Type:application/json Body:d: serviceId: Temperature, / Temperature 服務(wù)名 metho

37、d: SET_TEMPERATURE ,/ Temperature 服務(wù)命令名 paras: value:30/命令參數(shù)response：S us Code: 200 OKContent-Type: application/json Body:requestId: de651c90331c4d11ba94b8cef3810efe,dId: 76553ad00df34a88974fbcefda42d510, dS us: SENT當設(shè)備上報命令執(zhí)行成功結(jié)果后，命令狀態(tài)由“已送達”變?yōu)椤俺晒Α薄D6-6 命令執(zhí)行成功7命令下發(fā)提供兩種命令下發(fā)機制：立即下發(fā)：立即發(fā)送收到令，如果設(shè)備不或者設(shè)備沒收到指令則下發(fā)失敗。立即下發(fā)適合對命令實時性有要求的場景，比如路燈開關(guān)燈，燃氣表開關(guān)閥。使用立即下發(fā)時，應(yīng)用需要自己保證下發(fā)的時機。緩存下發(fā)：收到命令后放入隊列。在設(shè)備上線的時候，依次下發(fā)命令隊列中令。緩存下發(fā)適合對命令實時性要求不高的場景，比如配置水表的參數(shù)。緩存下根據(jù)設(shè)備的