DB5120T 29.3-2024 感知信息共享應(yīng)用規(guī)范 第3部分：物聯(lián)感知平臺接入管理

ICS35.240.01CCSL70 DB5120四 川 省 （ 資 陽 市 ） 地 方 標(biāo) 準(zhǔn)DB5120/T29.3—2024感知信息共享應(yīng)用規(guī)范第3部分：物聯(lián)感知平臺接入管理2024-12-12發(fā)布 2024-12-27實(shí)施資陽市市場監(jiān)督管理局 發(fā)布DB5120/T29.3DB5120/T29.3—2024PAGE\*ROMANPAGE\*ROMANII目 次前言 II范圍 1規(guī)范性引用文件 1術(shù)語和定義 1縮略語 2總體架構(gòu) 2接入方式概覽 3設(shè)備通信能力要求 4設(shè)備接入?yún)f(xié)議 6設(shè)備物模型 6設(shè)備鑒權(quán)方式 8應(yīng)用側(cè)訪問與接入方式 9附錄A（資料性）Topic對應(yīng)的業(yè)務(wù)參數(shù)及開發(fā)指南 10附錄B（資料性）JSON格式轉(zhuǎn)換示例 12附錄C（資料性）設(shè)備屬性應(yīng)用示例 14附錄D（資料性）請求URI示例 22附錄E（資料性）鑒權(quán)認(rèn)證示例 25參考文獻(xiàn) 27前 言本文件按照GB/T1.1-2020《標(biāo)準(zhǔn)化工作導(dǎo)則第1部分：標(biāo)準(zhǔn)化文件的結(jié)構(gòu)和起草規(guī)則》的規(guī)定起草。請注意本文件的某些內(nèi)容可能涉及專利。本文件的發(fā)布機(jī)構(gòu)不承擔(dān)識別專利的責(zé)任。本文件由資陽市政務(wù)服務(wù)管理局提出并歸口。本文件起草單位:資陽市政府政務(wù)服務(wù)和公共資源交易服務(wù)中心、資陽市大數(shù)據(jù)服務(wù)中心、資陽乾耀信創(chuàng)科技有限責(zé)任公司、成都工貿(mào)職業(yè)技術(shù)學(xué)院、四川省職業(yè)技能鑒定指導(dǎo)中心。DB5120/T29.3DB5120/T29.3—2024PAGEPAGE18感知信息共享應(yīng)用規(guī)范第3部分：物聯(lián)感知平臺接入管理范圍本文件規(guī)定了物聯(lián)感知設(shè)備接入物聯(lián)感知平臺的管理規(guī)范，包含術(shù)語和定義、縮略語、整體架構(gòu)、規(guī)范性引用文件（包括所有的修改單適用于本文件。GB/T2260 中華人民共和國行政區(qū)劃代碼GB/T22239 信息安全技術(shù)網(wǎng)絡(luò)安全等級保護(hù)基本要求GB/T28181 公共安全視頻監(jiān)控聯(lián)網(wǎng)系統(tǒng)信息傳輸、交換、控制技術(shù)要求GB/T33474 物聯(lián)網(wǎng)參考體系結(jié)構(gòu)GB/T33745 物聯(lián)網(wǎng)術(shù)語GB/T34678 智慧城市技術(shù)參考模型GB/T36620 面向智慧城市的物聯(lián)網(wǎng)技術(shù)應(yīng)用指南GB/T36478.4 物聯(lián)網(wǎng)信息交換和共享第4部分：數(shù)據(jù)接口GB/T37024 信息安全技術(shù)物聯(lián)網(wǎng)感知層網(wǎng)關(guān)安全技術(shù)要求GB/T37093 信息安全技術(shù)物聯(lián)網(wǎng)感知層接入通信網(wǎng)的安全要求GB/T38624.1 物聯(lián)網(wǎng)網(wǎng)關(guān)第1部分：面向感知設(shè)備接入的網(wǎng)關(guān)技術(shù)要求GB/T38637 物聯(lián)網(wǎng)感知控制設(shè)備接入GB/T38606 物聯(lián)網(wǎng)標(biāo)識體系數(shù)據(jù)內(nèi)容標(biāo)識符GB/T38656 特種設(shè)備物聯(lián)網(wǎng)系統(tǒng)數(shù)據(jù)交換技術(shù)規(guī)范GB/T40688 物聯(lián)網(wǎng)生命體征感知設(shè)備數(shù)據(jù)接口GB/T40687 物聯(lián)網(wǎng)生命體征感知設(shè)備通用規(guī)范GB/T41780 物聯(lián)網(wǎng)邊緣計(jì)算GB/T41782 物聯(lián)網(wǎng)系統(tǒng)互操作性GB/T42196 公安物聯(lián)網(wǎng)視頻圖像元數(shù)據(jù)分析技術(shù)要求GB/T42197 公安物聯(lián)網(wǎng)視頻圖像內(nèi)容元數(shù)據(jù)描述規(guī)范GB/T42409 物聯(lián)網(wǎng)電子價(jià)簽系統(tǒng)總體要求GB/T42760 智慧城市感知終端應(yīng)用指南GB/Z41294 物聯(lián)網(wǎng)應(yīng)用協(xié)議受限應(yīng)用協(xié)議（CoAP）技術(shù)要求DB5120/T18-2023 公共信息資源標(biāo)識指南DB5120/T19-2023 數(shù)據(jù)資源體系技術(shù)指南術(shù)語和定義以上“規(guī)范性引用文件”中所引用標(biāo)準(zhǔn)界定以及下列術(shù)語和定義適用于本文件。物聯(lián)感知平臺IoTplatform物聯(lián)網(wǎng)設(shè)備 IoTdevice縮略語下列縮略語適用于本文件。HTTP：超文本傳輸協(xié)議（HyperTextTransferProtocol）[參考RFC7540]安全的超文本傳輸協(xié)（HyperText Transfer Protocol over Secure Socket 考RFC2818]MQTT：遙測傳輸協(xié)議（MessageQueueTelemetryTransport）[參考ISO/IECPRF20922]MQTTS：使用了TLS加密的MQTT協(xié)議(TLSSupportforMessageQueueTelemetryTransport)COAP：受限應(yīng)用協(xié)議（ConstrainedApplicationProtocol）[參考RFC7252]OPCUA：OPC統(tǒng)一架構(gòu)協(xié)議（OpenPlatformCommunicationUnifiedArchitecture）[參考IEC62541]ModbusTCP：Modbus傳輸控制協(xié)議（ModbusTransmissionControlProtocol）[參考GB/T19582.3-2008]TSL：物品描述語言（ThingSpecificationLanguage）SDK：軟件開發(fā)工具包（SoftwareDevelopmentKit）API：應(yīng)用程序接口（ApplicationProgrammingInterface）NB-IoT：窄帶物聯(lián)網(wǎng)（NarrowBandInternetofThings）[參考ITUIMT-2020]LWM2M：輕量級M2M（LightweightMachine-To-Machine）[參考ETSITS118114]OTA：空中編程（Over-the-air）總體架構(gòu)物聯(lián)感知平臺（以下也稱IoT平臺、IoTDA（IoTDeviceAccess）），包括以下3種接入平臺的方式:設(shè)備直連、網(wǎng)關(guān)接入、平臺對接。新建物聯(lián)網(wǎng)設(shè)備應(yīng)按設(shè)備直連平臺或通過網(wǎng)關(guān)接入兩種方式接入。圖1 物聯(lián)感知平臺接入架構(gòu)接入方式概覽設(shè)備命名要符合業(yè)務(wù)要求，設(shè)備名稱只允許中文、字母、數(shù)字、以及_?'#().,&%@!-等字符的組合，4xx_streetlight_1,表示xx1Mqtt/Coap/http協(xié)議接入的設(shè)備，可以采用直連接入方式，sdk推薦接入策略如下：CoAP/LWM2MIoTDeviceSDKTiny設(shè)備使用Mqtt協(xié)議，建議采用設(shè)備直連方式接入物聯(lián)感知平臺，設(shè)備也可以采用網(wǎng)關(guān)接入方IoTDeviceSDK接入即可。設(shè)備使用opcua,opcda,Modbus,iec等協(xié)議，推薦其使用網(wǎng)關(guān)接入方式接入物聯(lián)感知平臺。具體實(shí)施需項(xiàng)目組單獨(dú)評估規(guī)劃并申請經(jīng)費(fèi)。設(shè)備數(shù)據(jù)，需要通過查詢第三方系統(tǒng)api，或者查詢第三方數(shù)據(jù)庫才可以獲取，推薦采用網(wǎng)關(guān)接入方式。具體實(shí)施需項(xiàng)目組單獨(dú)評估規(guī)劃并申請經(jīng)費(fèi)。如設(shè)備無法主動上報(bào)數(shù)據(jù)，需要采用特定方式，采集設(shè)備相關(guān)數(shù)據(jù)，推薦使用網(wǎng)關(guān)接入方式對接物聯(lián)感知平臺。具體實(shí)施需項(xiàng)目組單獨(dú)評估規(guī)劃并申請經(jīng)費(fèi)。設(shè)備數(shù)據(jù)使用plc上報(bào)，推薦使用網(wǎng)關(guān)接入方式對接。具體實(shí)施需項(xiàng)目組單獨(dú)評估規(guī)劃并申請經(jīng)費(fèi)。設(shè)備數(shù)據(jù)是先匯聚到scada系統(tǒng)，則推薦采用網(wǎng)關(guān)方式對接。具體實(shí)施需項(xiàng)目組單獨(dú)評估規(guī)劃并申請經(jīng)費(fèi)。j）設(shè)備是采用其他非標(biāo)準(zhǔn)協(xié)議，如jt808(應(yīng)用于交通領(lǐng)域),hj212（應(yīng)用于環(huán)境領(lǐng)域）,sl651（應(yīng)用于水里領(lǐng)域平臺提供了兩種SDK，它們之間的主要區(qū)別如表1所示。表1 兩種SDK區(qū)別SDK種類SDK集成場景SDK支持的物聯(lián)網(wǎng)通信協(xié)議IoTDeviceSDK面向運(yùn)算、存儲能力較強(qiáng)的嵌入式設(shè)備，例如網(wǎng)關(guān)、采集器等。MQTTIoTDeviceSDKTiny面向?qū)?、存儲、?jì)算資源有苛刻限制的終端設(shè)備，例如單片機(jī)、模組。LWM2MoverCoAP、MQTT設(shè)備通信能力要求通則2G/3G/4G/5G/NB-IoTWLAN，用戶可以根據(jù)物聯(lián)網(wǎng)應(yīng)用場景從固定網(wǎng)絡(luò)固定網(wǎng)絡(luò)接入（如通過RJ45有線網(wǎng)口、光模塊等），需要用戶將物聯(lián)網(wǎng)設(shè)備的網(wǎng)絡(luò)接入到整個(gè)工廠、園區(qū)或交通設(shè)施等應(yīng)用場景中。2表2 網(wǎng)絡(luò)接口要求類型項(xiàng)目規(guī)格備注必選網(wǎng)卡10/100/1000M全雙工網(wǎng)卡帶寬大小可根據(jù)承載的數(shù)據(jù)類型選擇IP類型IPv4/IPv6優(yōu)先IPv6可選PoE支持簡化現(xiàn)場布線運(yùn)營商傳統(tǒng)蜂窩網(wǎng)絡(luò)（2G/3G/4G/5G）SIM可根據(jù)物聯(lián)網(wǎng)應(yīng)用場景選擇對應(yīng)網(wǎng)絡(luò)制式，2G到5G帶寬性能、時(shí)延性能依次升高，但相應(yīng)設(shè)備芯片成本也相應(yīng)提升。設(shè)備網(wǎng)絡(luò)制式要求如表3所示。表3 網(wǎng)絡(luò)制式項(xiàng)目規(guī)格備注網(wǎng)絡(luò)制式2G:GSMCDMA3G:WCDMACDMA4G:TD-LTE/LTEFDD5G:NR具體制式可根據(jù)場地運(yùn)營商支持情況、帶寬時(shí)延要求、功耗成本要求選擇網(wǎng)絡(luò)制式LTECATNB1LTECATNB1具體制式可根據(jù)場地運(yùn)營商支持情況、帶寬時(shí)延要求、功耗成本要求選擇對于高帶寬、低延遲以及高可靠場景，推薦采用5G網(wǎng)絡(luò)切片構(gòu)建虛擬專網(wǎng)，結(jié)合物聯(lián)感知平臺下沉的混合云方案，從而提高可靠性以及保障極致性能。2G網(wǎng)絡(luò)正在逐步退網(wǎng)，不推薦使用，建議采用4G網(wǎng)絡(luò)的Cat.1替代。運(yùn)營商窄帶網(wǎng)絡(luò)（NB-IoT）在物聯(lián)網(wǎng)領(lǐng)域，NB-IoT比傳統(tǒng)蜂窩網(wǎng)絡(luò)有更強(qiáng)的競爭力和更加旺盛的生命力。工信部《工業(yè)和信息化部辦公廳關(guān)于深入推進(jìn)移動物聯(lián)網(wǎng)全面發(fā)展的通知》則明確要求推動2G/3G物聯(lián)網(wǎng)業(yè)務(wù)轉(zhuǎn)網(wǎng)，能夠遷移到NB-IoT等技術(shù)生態(tài)上來。NB-IoT相較傳統(tǒng)蜂窩網(wǎng)絡(luò)在同頻段下，可以獲得20dB更多的增益，因而擁有更強(qiáng)的覆蓋能力。NB網(wǎng)絡(luò)單扇區(qū)可以支持10萬個(gè)連接，時(shí)延敏感度低，同時(shí)設(shè)備成本及功耗低，適合遠(yuǎn)程抄表、智慧農(nóng)業(yè)、資產(chǎn)跟蹤等業(yè)務(wù)。設(shè)備通過NB-IoT網(wǎng)絡(luò)需實(shí)時(shí)控制設(shè)備時(shí)，需組建專線網(wǎng)絡(luò)：設(shè)備通NB-IoT網(wǎng)絡(luò)連接，推送CoAP下行消息，需要等待NB設(shè)備主動連線后才能下發(fā)，因此下行消息根據(jù)CoAP心跳時(shí)間會有不同的延時(shí)。這是由于運(yùn)營商公共地址池和NB-IoT設(shè)備的映射表會老化，平臺無法找到消息下行時(shí)刻的設(shè)備地址。在NB-IoT要求消息下行能夠?qū)崟r(shí)送到的場景，需委托電信運(yùn)營商組建專線網(wǎng)絡(luò)。在平臺和NB設(shè)備所在EPC之間搭建專線或建立基于公網(wǎng)的VPN（GRE/IPSec）等，以保證平臺消息下行時(shí)能夠正常地進(jìn)行設(shè)備尋址。無線局域網(wǎng)（WLAN）無線局域網(wǎng)（WLAN）在物聯(lián)網(wǎng)行業(yè)使用較為廣泛的接入方式，主流物聯(lián)網(wǎng)設(shè)備對WLAN的支持非WLAN設(shè)備WLAN接入規(guī)格要求如表4所示。表4 WLAN接入規(guī)格類型項(xiàng)目規(guī)格備注必選頻段2.4GHz信道1～13信道使用需符合當(dāng)?shù)胤ㄒ?guī)標(biāo)準(zhǔn)802.11n以上帶寬150MHz以上可選PoE支持簡化現(xiàn)場布線頻段5GHz獲得更高的帶寬，但犧牲覆蓋通過網(wǎng)關(guān)接入網(wǎng)絡(luò)要求（RS485標(biāo)準(zhǔn)等Zigbee等進(jìn)場通信協(xié)議接入。此場景需要經(jīng)終端的網(wǎng)關(guān)做數(shù)據(jù)轉(zhuǎn)換對接到物聯(lián)感知平臺。設(shè)備接入?yún)f(xié)議MQTT/MQTTS終端設(shè)備通過原生MQTT/MQTTSMQTT/MQTTS協(xié)議要求如表5所示。表5 MQTT/MQTTS協(xié)議描述限制支持的MQTT協(xié)議版本3.1.1與標(biāo)準(zhǔn)MQTT協(xié)議的區(qū)別支持Qos0MQTTS支持的安全等級采用TCP通道基礎(chǔ)+TLS協(xié)議（TLSV1.2、TLS1.3）單個(gè)設(shè)備最大MQTT連接數(shù)1單個(gè)MQTT連接每秒的吞吐量，即帶寬，包含直連設(shè)備和網(wǎng)關(guān)3KB/sMQTT1MBMQTT連接心跳時(shí)間建議值301200120秒LwM2M/CoAP目前LWM2M/CoAP協(xié)議主要用在NB-IoT場景上，業(yè)務(wù)數(shù)據(jù)交互端口是物聯(lián)感知平臺的5684端口，5684端口走DTLS+CoAP協(xié)議通道接入，NB-IoT設(shè)備端接入時(shí)提供必要的數(shù)據(jù)憑證，并支持標(biāo)準(zhǔn)DTLS協(xié)議。設(shè)備在登錄平臺前，需將設(shè)備對接平臺的端口設(shè)置為5684（即走DTLS加密通道）。將設(shè)備出廠前的PSK秘鑰預(yù)置到物聯(lián)感知平臺中，PSK秘鑰的數(shù)據(jù)類型為String型，長度范圍為8-32位。泛協(xié)議設(shè)備接入目前平臺支持基于MQTT/LWM2M等標(biāo)準(zhǔn)協(xié)議接入，為解決用戶自定義處理設(shè)備數(shù)據(jù)以及自定義協(xié)議設(shè)備快速接入IOTIoT使用場景設(shè)備只支持某種類型協(xié)議，而平臺目前不支持該協(xié)議。設(shè)備與其接入服務(wù)器之間已有通信網(wǎng)絡(luò)，您希望在不修改設(shè)備和協(xié)議的情況下，將設(shè)備接入IOT平臺。由于設(shè)備硬件資源或者網(wǎng)絡(luò)限制，設(shè)備無法直接接入IOT平臺。設(shè)備物模型物模型概述圖2 設(shè)備物模型設(shè)備物模型包括產(chǎn)品信息和服務(wù)能力：a）產(chǎn)品信息描述一款設(shè)備的基本信息，包括廠商ID、廠商名稱、設(shè)備類型、協(xié)議類型。例如：水表的廠商名稱為“HZYB”，廠商ID為“TestUtf8ManuId”，設(shè)備類型為“WaterMeter”，協(xié)議類型為“CoAP”。b）服務(wù)能力物模型接入的方式MQTTNB-IoT設(shè)備只支持編解碼插件接入。平臺標(biāo)準(zhǔn)接口接入：物聯(lián)感知平臺預(yù)置了數(shù)據(jù)、消息、事件上報(bào)，以及命令、消息、事件下發(fā)MQTTTopic，設(shè)備廠商可根據(jù)業(yè)務(wù)特點(diǎn)按需實(shí)現(xiàn)集成。a）設(shè)備命令b)通過編解碼插件接入平臺為實(shí)現(xiàn)非標(biāo)接口和數(shù)據(jù)格式兼容，以及非MQTT的物聯(lián)網(wǎng)協(xié)議兼容，支持設(shè)備廠商開發(fā)編解碼插件(JavaScript設(shè)備鑒權(quán)方式DeviceId和Secret將用于設(shè)備南向鑒權(quán)。設(shè)備側(cè)應(yīng)支持MQTT協(xié)議的connect消息接口，接口規(guī)范參考MQTT標(biāo)準(zhǔn)規(guī)范，鑒權(quán)通過后建立設(shè)備與平臺間的MQTT連接，參考的參數(shù)表6所示。表6 密鑰方式鑒權(quán)參數(shù)必選/可選類型參數(shù)描述ClientId必選String(256)設(shè)備clientId由3ID0。例：5f052ac562369102d42b0fb6_0_ff5bbx7a488f其他場景：設(shè)備clientId由4個(gè)部分組成：設(shè)備ID、設(shè)備身份標(biāo)識類型、密碼簽名類型、時(shí)間戳。通過下劃線“_”分隔，設(shè)備身份標(biāo)識類型固定值為0密碼簽名類型：長度1字節(jié)，當(dāng)前支持2種類型：“0”代表HMACSHA256不校驗(yàn)時(shí)間戳。“1”代表HMACSHA256校驗(yàn)時(shí)間戳。時(shí)間戳：為設(shè)備連接平臺時(shí)的UTC時(shí)間，格式為YYYYMMDDHH，如UTC時(shí)間2018/7/2417:56:20則應(yīng)表示為2018072417。例：5f052ac562369102d42b0fb6_0_0_2019122614Username必選String(256)設(shè)備ID。Password必選String(256)Password的值為使用“HMACSHA256”算法以時(shí)間戳為密鑰，對secret進(jìn)行加密后的值。secret為注冊設(shè)備時(shí)平臺返回的secret。當(dāng)設(shè)備認(rèn)證類型使用密鑰認(rèn)證接入(SECRET)可填寫該字段。通過X.509設(shè)備證書方式鑒權(quán)。設(shè)備使用證書認(rèn)證鑒權(quán)，除滿足ClientId與Username要求外，還需要設(shè)備能夠支持X.509證書方式與平臺鑒權(quán)。c）LwM2M/CoAP協(xié)議鑒權(quán)：通過物聯(lián)感知平臺添加的設(shè)備，會獲得nodeId，DTLS方式接入有PSK，設(shè)備通過LwM2M接入需實(shí)現(xiàn)Register功能進(jìn)行南向接入鑒權(quán)，各參數(shù)參考如表7所示。表7 Registe接入規(guī)范參數(shù)名參數(shù)位置可選/必選說明EndpointClientNameUri-Query必選設(shè)備身份標(biāo)識nodeIdLifetimeUri-Query否，默認(rèn)為86400s生命周期VersionUri-Query可選，默認(rèn)為1.0設(shè)備版本ObjectsandObjectInstancesPayload必選設(shè)備支持的對象和實(shí)例應(yīng)用側(cè)訪問與接入方式通則物聯(lián)感知平臺把自身豐富的管理能力通過API的形式對外開放，包括產(chǎn)品管理、設(shè)備管理、設(shè)備組管理、標(biāo)簽管理、設(shè)備CA證書管理、設(shè)備影子、設(shè)備命令、設(shè)備消息、設(shè)備屬性、訂閱管理、規(guī)則管理、批量任務(wù)等，幫助用戶快速構(gòu)筑基于物聯(lián)感知平臺的行業(yè)應(yīng)用。API物聯(lián)感知平臺提供了RESTful風(fēng)格API，支持用戶通過HTTPS請求調(diào)用。為保障物聯(lián)感知平臺與其他信息系統(tǒng)對接的功能完整性與可靠性，應(yīng)用側(cè)接入系統(tǒng)需要滿足以下要求：API應(yīng)用在接收處理物聯(lián)感知平臺發(fā)送的響應(yīng)消息和推送消息時(shí)，需要兼容或忽略消息中的新增參數(shù)，不能因?yàn)橄⒅械男略鰠?shù)導(dǎo)致應(yīng)用的處理異常。在應(yīng)用側(cè)調(diào)用APITopic，對平臺下行指令進(jìn)行回復(fù)響應(yīng)。否則應(yīng)用側(cè)同步接口會執(zhí)行超時(shí)，報(bào)Timeout。在應(yīng)用側(cè)調(diào)用API的異步接口時(shí)，諸如“查詢設(shè)備消息”，“下發(fā)設(shè)備消息”等，允許設(shè)備在線后訂閱對應(yīng)的平臺下行Topic，對平臺下行指令回復(fù)或不回復(fù)響應(yīng)。也支持設(shè)備不在線，應(yīng)用側(cè)異步接口執(zhí)行不會超時(shí)。API構(gòu)造請求：本節(jié)介紹RESTAPI請求的組成，并以調(diào)用物聯(lián)感知平臺的查詢產(chǎn)品和創(chuàng)建產(chǎn)品接口說明如何調(diào)用API，該API可用于獲取用戶的指定產(chǎn)品信息。認(rèn)證鑒權(quán)調(diào)用接口有如下兩種認(rèn)證方式，用戶可以選擇其中一種進(jìn)行認(rèn)證鑒權(quán)。Token認(rèn)證：通過Token認(rèn)證通用請求。AK/SK認(rèn)證：通過AK（AccessKeyID）/SK（SecretAccessKey)加密調(diào)用請求。附 錄 A（資料性）Topic對應(yīng)的業(yè)務(wù)參數(shù)及開發(fā)指南A.1Topic對應(yīng)的業(yè)務(wù)參數(shù)及開發(fā)指南應(yīng)符合表A.1規(guī)則（資陽市雁江區(qū)641300主題（Topic）分類主題Topic主題（Topic）分類主題Topic生產(chǎn)者Publisher訂閱者Subscriber用途設(shè)備消息相關(guān)Topic$oc/devices/{device_id}/sys/messages/up設(shè)備平臺設(shè)備消息上報(bào)$oc/devices/{device_id}/sys/messages/down平臺設(shè)備平臺下發(fā)消息給設(shè)備設(shè)備命令相關(guān)Topic$oc/devices/{device_id}/sys/commands/request_id={request_id}平臺設(shè)備平臺下發(fā)命令給設(shè)備$oc/devices/{device_id}/sys/commands/response/request_id={request_id}設(shè)備平臺設(shè)備返回命令響應(yīng)設(shè)備屬性相關(guān)Topic$oc/devices/{device_id}/sys/properties/report設(shè)備平臺設(shè)備上報(bào)屬性數(shù)據(jù)$oc/devices/{device_id}/sys/gateway/sub_devices/properties/report設(shè)備平臺網(wǎng)關(guān)批量上報(bào)屬性數(shù)據(jù)$oc/devices/{device_id}/sys/properties/set/request_id={request_id}平臺設(shè)備平臺設(shè)置設(shè)備屬性$oc/devices/{device_id}/sys/properties/set/response/request_id={request_id}設(shè)備平臺屬性設(shè)置的響應(yīng)結(jié)果$oc/devices/{device_id}/sys/properties/get/request_id={request_id}平臺設(shè)備平臺查詢設(shè)備屬性$oc/devices/{device_id}/sys/properties/get/response/request_id={request_id}設(shè)備平臺屬性查詢響應(yīng)結(jié)產(chǎn)生影響$oc/devices/{device_id}/sys/shadow/get/request_id={request_id}設(shè)備平臺設(shè)備側(cè)主動獲取平臺的設(shè)備影子數(shù)據(jù)（續(xù)）表A.1 Topic對應(yīng)的業(yè)務(wù)參數(shù)主題（Topic）分類主題Topic生產(chǎn)者Publisher訂閱者Subscriber用途設(shè)備屬性相關(guān)Topic$oc/devices/{device_id}/sys/shadow/get/response/request_id={request_id}平臺設(shè)備設(shè)備側(cè)主動獲取平臺設(shè)備影子數(shù)據(jù)的響應(yīng)設(shè)備事件相關(guān)Topic$oc/devices/{device_id}/sys/events/up設(shè)備平臺設(shè)備事件上報(bào)$oc/devices/{device_id}/sys/events/down平臺設(shè)備平臺事件下發(fā)附 錄 B（資料性）JSON格式轉(zhuǎn)換示例B.1低配置且資源受限或者對網(wǎng)絡(luò)流量有要求的設(shè)備，不適合直接構(gòu)造JSON數(shù)據(jù)與物聯(lián)感知平臺通信時(shí)，可將原始二進(jìn)制數(shù)據(jù)透傳到物聯(lián)感知平臺。通過開發(fā)編解碼插件實(shí)現(xiàn)二進(jìn)制數(shù)據(jù)到平臺定義JSON格式的轉(zhuǎn)換。Topic下行：$oc/devices/{device_id}/sys/commands/request_id={request_id}上行：$oc/devices/{device_id}/sys/commands/response/request_id={request_id}{request_id}用于唯一標(biāo)識這次請求。設(shè)備側(cè)收到下行請求的topic帶該參數(shù)時(shí)，上行響應(yīng)的topic需要將該參數(shù)值返回給平臺。設(shè)備側(cè)訂閱帶{request_id}結(jié)尾的topic時(shí)，可以使用通配#，設(shè)備側(cè)訂閱平臺命令下發(fā)的topic為：下行請求參數(shù)說明字段名必選/可選類型參數(shù)描述object_device_id可選Stringtopicservice_id可選String設(shè)備的服務(wù)ID，在設(shè)備關(guān)聯(lián)的產(chǎn)品模型中定義command_name可選String設(shè)備命令名稱，在設(shè)備關(guān)聯(lián)的產(chǎn)品模型中定義。paras可選Object設(shè)備命令的執(zhí)行參數(shù)，具體字段在設(shè)備關(guān)聯(lián)的產(chǎn)品模型中定義。上行響應(yīng)參數(shù)說明命令應(yīng)答的json格式，具體字段在設(shè)備關(guān)聯(lián)的產(chǎn)品模型中定義。字段名必選/可選類型參數(shù)描述result_code可選Integer標(biāo)識命令的執(zhí)行結(jié)果，0表示成功，其他表示失敗。不帶默認(rèn)認(rèn)為成功。response_name可選String命令的響應(yīng)名稱，在設(shè)備關(guān)聯(lián)的產(chǎn)品模型中定義。paras可選Object命令的響應(yīng)參數(shù)，具體字段在設(shè)備關(guān)聯(lián)的產(chǎn)品模型中定義。下行請求示例Topic:$oc/devices/{device_id}/sys/commands/request_id={request_id}數(shù)據(jù)格式：{"object_device_id":"{object_device_id}","command_name":"ON_OFF","service_id":"WaterMeter","paras":{"value":"1"}}上行響應(yīng)示例數(shù)據(jù)格式：{"result_code":0,"response_name":"COMMAND_RESPONSE","paras":{"result":"success"}}附 錄 C（資料性）設(shè)備屬性應(yīng)用示例C.1示例設(shè)備屬性上報(bào)：用于設(shè)備按產(chǎn)品模型中定義的格式將屬性數(shù)據(jù)上報(bào)給平臺。屬性上報(bào)和消息上報(bào)的區(qū)別，請查看消息通信說明。說明：低配置且資源受限或者對網(wǎng)絡(luò)流量有要求的設(shè)備，不適合直接構(gòu)造JSON數(shù)據(jù)與物聯(lián)感知平開發(fā)編解碼插件實(shí)現(xiàn)二進(jìn)制數(shù)據(jù)到平臺定義JSON格式的轉(zhuǎn)換。Topic上行：$oc/devices/{device_id}/sys/properties/report字段名必選/可選類型參數(shù)描述services必選List<ServiceProperty>設(shè)備服務(wù)數(shù)據(jù)列表（具體結(jié)構(gòu)參考下表ServiceProperty定義表）。參數(shù)說明ServiceProperty結(jié)構(gòu)定義：字段名必選/可選類型參數(shù)描述service_id必選String設(shè)備的服務(wù)ID。properties必選Objectevent_time可選String設(shè)備采集數(shù)據(jù)UTC時(shí)間（格式可選：秒級別：yyyyMMdd'T'HHmmss'Z'，毫秒級別：2020-08-12T12:12:12.333Z。設(shè)備上報(bào)數(shù)據(jù)不帶該參數(shù)或參數(shù)格式錯(cuò)誤時(shí)，則數(shù)據(jù)上報(bào)時(shí)間以平臺時(shí)間為準(zhǔn)。示例Topic:$oc/devices/{device_id}/sys/properties/report數(shù)據(jù)格式：{"services":[{"service_id":"Temperature","properties":{"value":57,"value2":60},"event_time":"20151212T121212Z"},{"service_id":"Battery","properties":{"level":80,"level2":90},"event_time":"20151212T121212Z"}]}網(wǎng)關(guān)批量設(shè)備屬性上報(bào)用于批量設(shè)備上報(bào)屬性數(shù)據(jù)給平臺。網(wǎng)關(guān)設(shè)備可以用此接口同時(shí)上報(bào)多個(gè)子設(shè)備的屬性數(shù)據(jù)。屬性上報(bào)和消息上報(bào)的區(qū)別，請查看消息通信說明。Topic上行：$oc/devices/{device_id}/sys/gateway/sub_devices/properties/report參數(shù)說明字段名必選/可選類型參數(shù)描述devices必選List<DeviceProperty>設(shè)備數(shù)據(jù)DeviceService定義表字段名必選/可選類型參數(shù)描述device_id必選String設(shè)備IDservices必選List<ServiceProperty>設(shè)備服務(wù)數(shù)據(jù)列表ServiceProperty定義表：字段名必選/可選類型參數(shù)描述service_id必選String設(shè)備的服務(wù)ID。properties必選Object設(shè)備服務(wù)的屬性列表，具體字段在產(chǎn)品模型里定義，可以設(shè)置多個(gè)字段。event_time可選String設(shè)備采集數(shù)據(jù)UTC時(shí)間（格式可選：秒級別：yyyyMMdd'T'HHmmss'Z'，毫秒級別：yy-MMddTH:mm:ss.SSZ'01121T14920Z2020-08-12T12:12:12.333Z。設(shè)備上報(bào)數(shù)據(jù)不帶該參數(shù)或參數(shù)格式錯(cuò)誤時(shí)，則數(shù)據(jù)上報(bào)時(shí)間以平臺時(shí)間為準(zhǔn)。示例Topic: 數(shù)據(jù)格式:{"devices":[{"device_id":"bf40f0c4-4022-41c6-a201-c5133122054a","services":[{"service_id":"analog","properties":{"PhV_phsA":"1","PhV_phsB":"2"},"event_time":"20190606T121212Z"}]},{"device_id":"42aa08ea-84c1-4025-a7b2-c1f6efe547c2","services":[{"service_id":"analog","properties":{"PhV_phsA":"3","PhV_phsB":"5"},"event_time":"20190606T121212Z"},{"service_id":"parameter","properties":{"Load":"6","ImbA_strVal":"8"},"event_time":"20190606T121212Z"}]}]}平臺設(shè)置設(shè)備屬性說明低配置且資源受限或者對網(wǎng)絡(luò)流量有要求的設(shè)備，不適合直接構(gòu)造JSON數(shù)據(jù)與物聯(lián)感知平臺通信時(shí)，可將原始二進(jìn)制數(shù)據(jù)透傳到物聯(lián)感知平臺。通過開發(fā)編解碼插件實(shí)現(xiàn)二進(jìn)制數(shù)據(jù)到平臺定義JSON格式的轉(zhuǎn)換。Topic下行:上行:說明{request_id}用于唯一標(biāo)識這次請求。設(shè)備側(cè)收到下行請求的topic帶該參數(shù)時(shí)，上行響應(yīng)的topic需要將該參數(shù)值返回給平臺。設(shè)備側(cè)訂閱帶{request_id}結(jié)尾的topic時(shí)，可以使用#，設(shè)備側(cè)訂閱平臺設(shè)置設(shè)備屬性的topic為：$oc/devices/{device_id}/sys/properties/set/#下行請求參數(shù)說明字段名必選/可選類型參數(shù)描述object_device_id可選String屬性設(shè)置對應(yīng)的目標(biāo)設(shè)備IDservices必選List<ServiceProperty>設(shè)備服務(wù)數(shù)據(jù)列表。ServiceProperty結(jié)構(gòu)定義：字段名必選/可選類型參數(shù)描述service_id必選String設(shè)備的服務(wù)ID。properties必選Object設(shè)備服務(wù)的屬性列表，具體字段在產(chǎn)品模型里定義，可以設(shè)置多個(gè)字段。上行響應(yīng)參數(shù)說明字段名必選/可選類型參數(shù)描述result_code可選Integer命令的執(zhí)行結(jié)果，0表示成功，其他表示失敗。不帶默認(rèn)認(rèn)為成功。result_desc可選String屬性設(shè)置的響應(yīng)描述。下行請求示例Topic:$oc/devices/{device_id}/sys/properties/set/request_id={request_id}數(shù)據(jù)格式：{"object_device_id":"{object_device_id}","services":[{"service_id":"Temperature","properties":{"value":57,"value2":60}},{"service_id":"Battery","properties":{"level":80,"level2":90}}]}上行響應(yīng)示例Topic：$oc/devices/{device_id}/sys/properties/set/response/request_id={request_id}數(shù)據(jù)格式：{"result_code":0,"result_desc":"success"}平臺查詢設(shè)備屬性說明低配置且資源受限或者對網(wǎng)絡(luò)流量有要求的設(shè)備，不適合直接構(gòu)造JSON數(shù)據(jù)與物聯(lián)感知平臺通信時(shí)，可將原始二進(jìn)制數(shù)據(jù)透傳到物聯(lián)感知平臺。通過開發(fā)編解碼插件實(shí)現(xiàn)二進(jìn)制數(shù)據(jù)到平臺定義JSON格式的轉(zhuǎn)換。Topic下行:$oc/devices/{device_id}/sys/properties/get/request_id={request_id}上行:說明{request_id}用于唯一標(biāo)識這次請求。設(shè)備側(cè)收到下行請求的topic帶該參數(shù)時(shí)，上行響應(yīng)的topic需要將該參數(shù)值返回給平臺。設(shè)備側(cè)訂閱帶{request_id}結(jié)尾的topic時(shí)，可以使用#，設(shè)備側(cè)訂閱平臺查詢設(shè)備屬性的topic為：字段名必選/可選類型字段名必選/可選類型參數(shù)描述object_device_id可選String屬性查詢對應(yīng)的目標(biāo)設(shè)備ID。service_id可選String設(shè)備的服務(wù)ID。上行響應(yīng)參數(shù)說明字段名必選/可選類型參數(shù)描述services可選List<ServiceProperty>設(shè)備服務(wù)數(shù)據(jù)列表。ServiceProperty結(jié)構(gòu)定義：字段名必選/可選類型參數(shù)描述service_id必選String設(shè)備的服務(wù)ID。properties必選Object設(shè)備服務(wù)的屬性列表，具體字段在設(shè)備關(guān)聯(lián)的產(chǎn)品模型里定義，可以設(shè)置多個(gè)字段。event_time可選String設(shè)備采集數(shù)據(jù)UTC時(shí)間（格式：yyyyMMdd'T'HHmmss'Z'），如：20161219T114920Z。字段名必選/可選類型參數(shù)描述設(shè)備上報(bào)數(shù)據(jù)不帶該參數(shù)或參數(shù)格式錯(cuò)誤時(shí)，則數(shù)據(jù)上報(bào)時(shí)間以平臺時(shí)間為準(zhǔn)。下行請求示例Topic:$oc/devices/{device_id}/sys/properties/get/request_id={request_id}數(shù)據(jù)格式：{"object_device_id":"{object_device_id}","service_id":"Temperature"}上行響應(yīng)示例Topic：$oc/devices/{device_id}/sys/properties/get/response/request_id={request_id}數(shù)據(jù)格式：{"services":[{"service_id":"Temperature","properties":{"PhV_phsA":"1","PhV_phsB":"2"},"event_time":"20190606T121212Z"}]}e)設(shè)備側(cè)獲取平臺的設(shè)備影子數(shù)據(jù)Topic上行請求:$oc/devices/{device_id}/sys/shadow/get/request_id={request_id}下行響應(yīng):$oc/devices/{device_id}/sys/shadow/get/response/request_id={request_id}說明{request_id}用于唯一標(biāo)識這次請求。設(shè)備側(cè)發(fā)起的消息帶該參數(shù)時(shí)，需要保證設(shè)備側(cè)該參數(shù)值的唯一性，可以用遞增的數(shù)字或者UUID來實(shí)現(xiàn)。設(shè)備側(cè)訂閱帶{request_id}結(jié)尾的topic時(shí)，可以使用#，設(shè)備側(cè)訂閱獲取平臺設(shè)備影子數(shù)據(jù)響應(yīng)的topic為：$oc/devices/{device_id}/sys/shadow/get/response/#上行請求參數(shù)說明字段名必選/可選類型參數(shù)描述object_device_id可選String需要獲取設(shè)備影子的目標(biāo)設(shè)備ID。service_id可選String需要獲取設(shè)備影子的設(shè)備服務(wù)ID,不帶的話查詢所有服務(wù)ID的設(shè)備影子數(shù)據(jù)。下行響應(yīng)參數(shù)說明字段名必選/可選類型參數(shù)描述object_device_id必選String設(shè)備影子的目標(biāo)設(shè)備ID。shadow可選List<ShadowData>服務(wù)影子數(shù)據(jù)。ShadowData結(jié)構(gòu)定義：字段名必選/可選類型參數(shù)描述service_id必選String設(shè)備的服務(wù)ID。desired可選PropertiesData設(shè)備影子desired區(qū)的屬性列表。reported可選PropertiesData設(shè)備影子reported區(qū)的屬性列表。version可選Integer設(shè)備影子版本信息PropertiesData結(jié)構(gòu)定義：字段名必選/可選類型參數(shù)描述properties必選Object設(shè)備服務(wù)的屬性列表，具體字段在設(shè)備關(guān)聯(lián)的產(chǎn)品模型里定義，可以設(shè)置多個(gè)字段。event_time可選String設(shè)備屬性數(shù)據(jù)的UTC時(shí)間（格式：yyyyMMdd'T'HHmmss'Z'），如：20161219T114920Z。上行請求示例Topic:$oc/devices/{device_id}/sys/shadow/get/request_id={request_id}數(shù)據(jù)格式：{"object_device_id":"40fe3542-f4cc-4b6a-98c3-61a49ba1acd4","service_id":"WaterMeter"}下行響應(yīng)示例Topic：$oc/devices/{device_id}/sys/shadow/get/response/request_id={request_id}數(shù)據(jù)格式：{"object_device_id":"40fe3542-f4cc-4b6a-98c3-61a49ba1acd4","shadow":[{"service_id":"WaterMeter","desired":{"properties":{"temperature":"60"},"event_time":"20151212T121212Z"},"reported":{"properties":{"temperature":"60"},"event_time":"20151212T121212Z"},"version":1}]}注：具體開發(fā)流程可以參考《IoT設(shè)備接入開發(fā)指南》->“腳本化開發(fā)插件”章節(jié)。附 錄 D（資料性）請求URI示例示例D.1示例請求URI由如下部分組成。{URI-chme}//{npon}/{rsurc-pah}?{uer-srig}盡管請求URI包含在請求消息頭中，但大多數(shù)語言或框架都要求用戶從請求消息中單獨(dú)傳遞它，所以在此單獨(dú)強(qiáng)調(diào)。URI-scheme：表示用于傳輸請求的協(xié)議，當(dāng)前所有API均采用HTTPS協(xié)議。Endpoint：指定承載REST服務(wù)端點(diǎn)的服務(wù)器域名或IP，不同服務(wù)不同區(qū)域的Endpoint不同，用戶需要根據(jù)實(shí)際區(qū)域填寫。resource-path：資源路徑，也即API訪問路徑。從具體API的URI模塊獲取，例如“查詢產(chǎn)品”API的resource-path為“/v5/iot/{project_id}/products/{product_id}”。ur-srngAI1)請求消息頭附加請求頭字段，如指定的URI和HTTP方法所要求的字段。例如定義消息體類型的請求頭“Content-Type”，請求鑒權(quán)信息等。如下公共消息頭需要添加到請求中。Content-Type：消息體的類型（格式），必選，默認(rèn)取值為“application/json”，有其他取值時(shí)會在具體接口中專門說明。Token接口獲取，接口返回的響應(yīng)消息頭中“X-Subject-Token”就是需要獲取的用戶Token。添加消息頭后的請求如下所示。GEThttps:///v5/iot/{project_id}/products/{product_id}Content-Type:application/json2)請求消息體請求消息體通常以結(jié)構(gòu)化格式發(fā)出，與請求消息頭中Content-type對應(yīng)，傳遞除請求消息頭之外的內(nèi)容。若請求消息體中參數(shù)支持中文，則中文字符必須為UTF-8編碼。每個(gè)接口的請求消息體內(nèi)容不同，也并不是每個(gè)接口都需要有請求消息體（或者說消息體為空），GET、DELETE操作類型的接口就不需要消息體，消息體具體內(nèi)容需要根據(jù)具體接口而定。name為產(chǎn)品名稱，device_type為設(shè)備類型，protocol_type為設(shè)備使用的協(xié)議類型。POSThttps:///v5/iot/abab***cdcd/productsContent-Type:application/jsonX-Auth-Token:********{"name":"Thermometer","device_type":"Thermometer","protocol_type":"MQTT","data_format":"binary","manufacturer_name":"ABC","industry":"smartCity","description":"thisisathermometer","service_capabilities":[{"service_type":"temperature","service_id":"temperature","description":"temperature","properties":[{"unit":"centigrade","min":"1","method":"R","max":"100","data_type":"decimal","description":"force","step":0.1,"enum_list":["string"],"required":true,"property_name":"temperature","max_length":100}],"commands":[{"command_name":"reboot","responses":[{"response_name":"ACK","paras":[{"unit":"km/h","min":"1","max":"100","para_name":"force","data_type":"string","description":"force","step":0.1,"enum_list":["string"],"required":false,"max_length":100}