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

中國電信物聯(lián)網(wǎng)開放平臺(tái)_NB-IoTLWM2M場景對接指本文檔針對NB-IoT業(yè)務(wù)的LWM2M場景，從準(zhǔn)備工作、自定義設(shè)備模型、編插NB-IoT業(yè)務(wù)中LWM2M “注意”不涉及人身前 目 創(chuàng)建APP應(yīng) 開發(fā)編插 設(shè) 接 8功 開放測 中國電信物聯(lián)網(wǎng)開放平臺(tái)_設(shè)備能力描述文件profile開發(fā)指 中國電信物聯(lián)網(wǎng)開放平臺(tái)V100R001C30編庫開發(fā)與升級(jí)指 中國電信物聯(lián)網(wǎng)開放平臺(tái)北向應(yīng)用 在設(shè)備側(cè)，智能設(shè)備采用了NB-IOT，它和中國電信物聯(lián)網(wǎng)開放平臺(tái)之間通CoAP協(xié)議通訊。CoAPpayloadserverhttp/https協(xié)議和平臺(tái)通訊，通過調(diào)用平臺(tái)的開放API來控制設(shè)備，平j(luò)son

NB-IOT業(yè)務(wù)主要包含NB-IOT設(shè)備、NB-IOT控制器、中國電信物聯(lián)網(wǎng)開放平臺(tái)、垂NB-IOT設(shè)備：CoAP協(xié)議接入。NB-IOT網(wǎng)絡(luò)：為NB-IoT終端建立網(wǎng)絡(luò)承載，傳下行業(yè)務(wù)數(shù)據(jù)中國電信物聯(lián)網(wǎng)開放平臺(tái)：實(shí)現(xiàn)對NB-IoT設(shè)備的管理，同時(shí)向第應(yīng)用系統(tǒng)開放接垂直行業(yè)應(yīng)用：實(shí)現(xiàn)對NB設(shè)備的業(yè)務(wù)管理，包括業(yè)務(wù)、業(yè)務(wù)控制和呈現(xiàn)等，由第基于中國電信物聯(lián)網(wǎng)開放平臺(tái)開放接口進(jìn)行開發(fā)?？蛻艋螂娦耪蠼?jīng)理登錄“天翼物聯(lián)” APP登錄中國電信物聯(lián)網(wǎng)開放平臺(tái)對接測試環(huán)境SPPortal（初次登錄需要修改初始。

NB-IoT應(yīng)用的參數(shù)設(shè)置可參考如下設(shè)置：API包：基礎(chǔ)API包和公用事業(yè)(NB-IoTAPI包CA：第應(yīng)用通過HTTPS對接中國電信物聯(lián)網(wǎng)開放服務(wù)器下發(fā)的證書，用于識(shí)別和電子信息加密，實(shí)現(xiàn)雙向認(rèn)證。文件限制為不超過1M的PEM格式文件。當(dāng)?shù)趹?yīng)用通過HTTP對接中國電信物聯(lián)網(wǎng)開放，不需要上傳CA。

NB-IoT點(diǎn)擊已經(jīng)創(chuàng)建好的應(yīng)用，并對NB-IoT

PSM模式：powersavingmode，省電模式。對下行業(yè)務(wù)時(shí)延無要求，對于下行業(yè)務(wù)消DRX模式：discontinuousreception，不連續(xù)接收模式。對下行業(yè)務(wù)時(shí)延要求高，可認(rèn)eDRX模式：ExtendedidlemodeDRX，擴(kuò)展不連續(xù)接收模式。DRX的擴(kuò)展模式，對下PSM模式時(shí)，ACTIVETIMER可以不設(shè)置，無影響；當(dāng)省電模式設(shè)eDRX模式時(shí)，eDRX周期的設(shè)置需要與網(wǎng)絡(luò)側(cè)的一致，請聯(lián)系中國電信物聯(lián)網(wǎng)說明方式一：從Portal制作Profile文件，請參考章節(jié)方式二：參考《中國電信物聯(lián)網(wǎng)開放平臺(tái)_profile開發(fā)指南》離線制Profile3.8Profile文件號(hào)、協(xié)議等構(gòu)成的具體實(shí)例。SPPortal支持用戶根據(jù)需求自定義產(chǎn)品。設(shè)備模板通過設(shè)備服務(wù)定義設(shè)備基本特性和能力。設(shè)備模板由多個(gè)服務(wù)模板組成。SPPortal支持用力，包括屬性、命令、等。SPPortal支持用戶使用預(yù)置服務(wù)模板，也支持用戶根

（Brightess（emerature（Elecrcy其中，度（rghe）務(wù)擁有個(gè)亮度屬及設(shè)置屬性值令（eprare（eeaue）（Eecrcy）（voag（current（powerfactor使用瀏覽器登錄SPPortal；單擊左側(cè)，打開“設(shè)備管理”頁面；單擊“模型”下（emeraturestring、jsonObject或DateTime單擊確定即可在命令欄看到新增令協(xié)議：產(chǎn)品所屬的協(xié)議類型。NB-IoTCoAPLWM2M兩種協(xié)議，（emperature（Brightess單擊已創(chuàng)建好的設(shè)備產(chǎn)品,此章節(jié)針對方式二使用《中國電信物聯(lián)網(wǎng)開放平臺(tái)V100R001C30編庫開發(fā)與升級(jí)Profile文件后再導(dǎo)入到中國電信物聯(lián)網(wǎng)開放平臺(tái)的場景

開發(fā)編插義了decode接口的輸出，encode接口的輸入格式。編插件開發(fā)可參考《中國電信物聯(lián)網(wǎng)開放平臺(tái)V100R001C30編庫開發(fā)與升級(jí)指南》文檔。當(dāng)編插件開發(fā)完后，在安裝到平臺(tái)之前，需要先對插件包進(jìn)行簽名。此時(shí)需要下1使用瀏覽器登錄SPPortal步驟2離線簽名工具步驟3在路徑找到壓縮包“signtool.zip”，右鍵菜單中選擇“Extracttosigntool\”解壓縮4signtool文件夾，運(yùn)行“signtool.exe5 6 65.3中生成的私鑰 75.3中生成的公鑰6中生成的名為“XXX_signed.XXX”的 編插件化能夠動(dòng)態(tài)的新增編庫，這樣新增設(shè)備接入時(shí)，只需要把對應(yīng)的編解（accessokenrequest：(非JSON格式)StatusCode:200{"accessToken":"*******","tokenType":"*******","expiresIn":"*******","scope":"*******"}注意：如果多次獲取令牌，則之前的令牌失效,最后一次獲取的令牌才有效。并發(fā)token后，接下來所有接口必須在httpsBeareraccessToken（注意中間有空格}app}appkey:******Authorization:Bearer******{"notifyType":"deviceD "callbackurl":" 訂閱成功后，設(shè)備上報(bào)數(shù)據(jù)時(shí)，中國電信物聯(lián)網(wǎng)開放平臺(tái)會(huì)將數(shù)據(jù)推送到所有設(shè)備須先在向進(jìn)行，才許連接平。通過設(shè)備，臺(tái)會(huì)為個(gè)eveIeveId來指定設(shè)psk參數(shù)（psk，DLSSPportaldeviceIdappkey:******"Authorization:Bearer******{ }StatusCode:201CREATED{"deviceId":"*******","psk":" }verifyCodenodeId需要填寫為設(shè)備唯一標(biāo)識(shí)，請聯(lián)系模組廠商確認(rèn)唯一標(biāo)識(shí)；nodeId5.5.2中的endpointname一致。timeout0。appkey:******Authorization:Bearer******{"deviceType":"****","protocolType":"CoAP","model":"****"}StatusCode:2005684端口。5684端口走DTLS+CoAP5683CoAP。5684（即走DTLS加密通道String型，長度范圍為8-32位。調(diào)用5.3設(shè)備接口，即可將設(shè)備PSK設(shè)置到平臺(tái)使用用非加密端口接入時(shí)，只需要使用原生的CoAP無論是還是非，設(shè)備都只需使用標(biāo)準(zhǔn)OMA接口進(jìn)行，CoAPurl里帶的參數(shù)可能有:ep={EndpointName}<={Lifetime}&sms={MSISDN}&lwm2m={version}&b={bindingmode}&{ObjectLinks}ep消息address/rd?ep={endpointname}<={lifetime}&sms={smsNumber}{endpointname}：必選，即為的endpointname（endpointname字nodeId需與endpointname一致。{ObjectLinks}：必選，如</1/1>,2/13/0>Option1：Uri-Path（11）：rd，說明：括號(hào)里面的為Option編號(hào)Option2：Content-Format（12）：application/link-formatOption3：Uri-Option4：Uri-Query（15）：{lifetime}Option5：Uri-Query（15）：{endpointname}例如2.014.00BadRequest,4.03設(shè)備成功平臺(tái)將會(huì)返回regis tionId以用于后續(xù)的更新與設(shè)備去。注：平臺(tái)暫時(shí)不會(huì)處理LifeTime，及當(dāng)LifeTime超時(shí)，設(shè)備訂閱信息也不會(huì)被刪除。更新接 tionId } tionIdOption3：Uri-Query（15）：{binding}Option4：Uri-2.044.00BadRequest,4.01設(shè)備更新使用OMA標(biāo)準(zhǔn)的接口，設(shè)備需要攜帶平臺(tái)的registionId，進(jìn)行更新，平臺(tái)registionId2.04Change4.01Unauthorized.address/{registionIdOption1：location-Path（8）：{ tionId2.024.00BadRequest,4.04Not（19/0/0臺(tái)將會(huì)根據(jù)設(shè)備的廠商ID和設(shè)備型號(hào)查找對應(yīng)的編（編信息參見第4章，在后會(huì)將數(shù)據(jù)通知到北向應(yīng)用。操作ObserveAsynchronousOption2：Content-Format（12），即為ObserveAcceptOption中設(shè)置的2.05Content（with{{{"requestId":null,"deviceId":"b8b92cc7-2622-4f27-a24b-041ab26f0b80", {"serviceId":"Brightness","data":{"brightness":50}, {"serviceId":"Electricity","voltage":218{ {"serviceId":"Temperature","serviceType":"Temperature","data":{"temperature":25},"eventTime":" }]}servicesBrightnessElectricity及Temperature服務(wù)數(shù)據(jù)就是經(jīng)過編json格式的數(shù)據(jù)，字段和產(chǎn)品設(shè)備模型定義的一致。APP編APP編 插步驟3步驟4decodeAPI1.3.1 appkey: appkey:{":" Temperature Temperature }}}StatusCode:200{"requestId":"de651c90331c4d11ba94b8cef3810efe","commandStatus":"SENT"}SPportal的設(shè)備管理頁面里選擇“命令”命令下發(fā)的情況，下圖顯示該命令已ACK（2.04Changed）命令應(yīng)答時(shí)，命令的狀態(tài)由“已發(fā)送”狀態(tài)變?yōu)檎f明ACK（2.04Changed）命NAexpireTime（TTL，表示最大緩存時(shí)間expireTimeexpireTime48小時(shí)。post 調(diào)用插件編碼命令送達(dá)通知命令響應(yīng)通知步驟 NA調(diào)用北向接口立即下發(fā)命令，參數(shù)expireTime傳0表示立即下發(fā)，樣例app_key:{appId}{"requestId":"********","command":{"serviceId":"********","method":"********","paras":{"paraName1":"paraValue1","paraName2":"paraValue2"}"callbackUrl":"}步驟2 平臺(tái)收到后，調(diào)用插件編碼。Encode接口輸入樣例：其中mid參數(shù)表示平臺(tái)分配步驟 {{"cmd":"SETTEMPERATUREREAD}步驟4 NB模組收到命令時(shí)，