DB3305T 252-2022 物聯(lián)中臺接入與數(shù)據(jù)轉(zhuǎn)發(fā)技術(shù)規(guī)范

ICS03.080.99CCSA01

DB3305浙 江 省 湖 州 市 地 方 標(biāo) 準(zhǔn)DB3305/T252—2022物聯(lián)中臺接入與數(shù)據(jù)轉(zhuǎn)發(fā)技術(shù)規(guī)范InternetofThingsPlatformAccessandDataForwardingTechnicalSpecification2022-12-7布 2022-12-9湖州市市場監(jiān)督管理局 發(fā)布1DB3305/T252DB3305/T252—2022目 次前言 II1范圍 12規(guī)性用件 13術(shù)和義 14縮語 35接管理 36數(shù)轉(zhuǎn)發(fā) 9附錄A（料）開API使示例 13I前 言本標(biāo)準(zhǔn)旨在指導(dǎo)湖州市物聯(lián)中臺物聯(lián)感知體系規(guī)劃、建設(shè)及改造，夯實全域感知的基礎(chǔ)。本標(biāo)準(zhǔn)編寫原則：遵循國家感知終端有關(guān)法律法規(guī)，保證本文檔內(nèi)容能適用于物聯(lián)中臺建設(shè)需求，規(guī)范終端接入、數(shù)據(jù)轉(zhuǎn)發(fā)以及安全等相關(guān)活動。本文件由湖州市大數(shù)據(jù)發(fā)展管理局提出并歸口。II物聯(lián)中臺接入與數(shù)據(jù)轉(zhuǎn)發(fā)技術(shù)規(guī)范范圍本文件規(guī)定了物聯(lián)中臺的接入和數(shù)據(jù)轉(zhuǎn)發(fā)規(guī)范等內(nèi)容。（GB/T33745-2017物聯(lián)網(wǎng)術(shù)語GB/T36951-2018信息安全技術(shù)物聯(lián)網(wǎng)感知終端應(yīng)用安全技術(shù)要求GB/T38637.2-2020物聯(lián)網(wǎng)感知控制設(shè)備接入第2部分：數(shù)據(jù)管理要求下列術(shù)語和定義適用于本文件。3.1物聯(lián)中臺InternetofThingsPlatformAPI3.2感知數(shù)據(jù)sensingdata通過數(shù)據(jù)采集獲取的原始數(shù)據(jù)或在此基礎(chǔ)上進(jìn)行加工處理的表征對象信息的數(shù)據(jù)統(tǒng)稱。[GB/T38637.2-2020，定義3.1]3.3感知終端sensingterminal能對物或環(huán)境進(jìn)行信息采集和/或執(zhí)行操作，并能聯(lián)網(wǎng)進(jìn)行通信的裝置。[GB/T36951-2018，定義3.1.2]3.4物聯(lián)網(wǎng)應(yīng)用IoTService1物聯(lián)網(wǎng)在具體場景中的使用實例，向用戶提供物聯(lián)網(wǎng)服務(wù)的集合。[GB/T33745-2017物聯(lián)網(wǎng)術(shù)語]3.5產(chǎn)品product產(chǎn)品是一組具有相同功能定義的設(shè)備集合。3.6設(shè)備device3.7物模型physicalmodel3.8功能點functionpoints3.9協(xié)議適配protocoladaptation如MQTTLwM2M、CoAP3.10心跳包heartbeatpacket3.11邊緣物聯(lián)網(wǎng)平臺edgeIoTplatform3.12應(yīng)用發(fā)者 applicationdevelopers23.13第三平臺 thethird-partyplatform承載具體物聯(lián)網(wǎng)應(yīng)用并提供服務(wù)的第三方系統(tǒng)。縮略語下列縮略語適用于本文件。API：應(yīng)用程序接口（ApplicationProgrammingInterface）CoAP：受約束的應(yīng)用協(xié)議（ConstrainedApplicationProtocol）HTTPS：超文本傳輸安全協(xié)議（HyperTextTransferProtocoloverSecureSocketLayer）IETF：國際互聯(lián)網(wǎng)工程任務(wù)組（TheInternetEngineeringTaskForce）JSON：對象簡譜（JavaScriptObjectNotation）LwM2M：輕量級M2M協(xié)議(LightweightMachine-to-Machine)MQTT：消息隊列遙測傳輸（MessageQueueTelemetryTransport）OMA：開放移動聯(lián)盟（OpenMobileAlliance）REST（RepresentationalStateTransfer）SDK（SoftwareDevelopmentKit）UDP（UserDatagramProtocol）URI（UniformResourceIdentifier）（）1所示。3圖1 總接框圖設(shè)備直連、網(wǎng)關(guān)接入、第三方平臺以及邊緣物聯(lián)網(wǎng)平臺總計四種接入方式均應(yīng)該和互聯(lián)網(wǎng)打通。設(shè)備健壯性要求包括：——主動上報心跳包功能；——主動離線斷開連接功能；——上報離線原因的功能；——命令回復(fù)機制；——上報固件版本信息功能；——上報設(shè)備型號功能；——上報網(wǎng)絡(luò)信號強度功能（對于用無線方式接入的設(shè)備）。4概述各類感知終端接入物聯(lián)中臺總體上應(yīng)遵循以下流程，見圖2：圖2 接流程設(shè)備接入的第一步是創(chuàng)建產(chǎn)品。產(chǎn)品為同種設(shè)備類型，產(chǎn)品下的設(shè)備擁有相同的物模型（功能）、數(shù)據(jù)格式。物理設(shè)備要連接到平臺，應(yīng)先在物聯(lián)中臺創(chuàng)建設(shè)備，并獲取連接到物聯(lián)中臺的鑒權(quán)信息。按照不同的接入方式應(yīng)通過協(xié)議適配開發(fā)或配置打通感知終端和物聯(lián)中臺的數(shù)據(jù)通道。5概述設(shè)備應(yīng)通過有線傳輸方式或無線傳輸方式（蜂窩網(wǎng)、wifi等）直接連接到物聯(lián)中臺?！兄K端功能單一，分布分散，獨立使用；——對時延要求不高的業(yè)務(wù)應(yīng)用場景；——已建項目相關(guān)感知終端已采用直連方式接入業(yè)務(wù)平臺的情況。圖3 設(shè)直接示圖MQTTCoAP——基于無連接的LwM2M實時通信。MQTT（）MQTTMQTTMQTT，MQTTCoAP（）CoAPCoAPIETFHTTPSRESTLwM2M（）LwM2MLwM2MOMAM2MLwM2M——LwM2MServer服務(wù)器；6——LwM2MClient客戶端，負(fù)責(zé)執(zhí)行服務(wù)器的命令和上報執(zhí)行結(jié)果；——LwM2M引導(dǎo)服務(wù)器BootstrapServer，負(fù)責(zé)配置LwM2M客戶端。4——DeviceDiscoveryandRegistration：客戶端注冊到服務(wù)器并通知服務(wù)器客戶端所支持的能力；——Bootstrap：BootstrapServer配置Client；——DeviceManagementandServiceEnablement：指令發(fā)送和接收；——InformationReporting：上報其資源信息。（無線蜂窩網(wǎng)、LoRawifi）圖4 網(wǎng)接示圖（）HTTPS。7圖5 平接示圖第三方平臺與協(xié)議適配服務(wù)通過HTTPSAPIAPIb）企業(yè)融合模塊提供API服務(wù)，第三方平臺定期將設(shè)備數(shù)據(jù)通過API的形式上報到協(xié)議適配服務(wù)。c）在實際操作中，只需選用任意一種對接方式即可。JSONAPIMQTTMQTT8圖6 邊物網(wǎng)臺入示圖應(yīng)通過設(shè)備調(diào)試功能進(jìn)行數(shù)據(jù)交互調(diào)試，查看設(shè)備實時日志，進(jìn)行設(shè)備功能數(shù)據(jù)驗證。API（HTTPS）。HTTPSHTTPS（API）API（HTTPS）概述數(shù)據(jù)推送服務(wù)（HTTPS）應(yīng)包括實例創(chuàng)建、實例驗證、規(guī)則配置、消息推送4個步驟。業(yè)務(wù)流程如圖7所示:9圖7 數(shù)推服使流程每個實例對應(yīng)一個HTTPS的推送配置實例。應(yīng)用開發(fā)者需要在物聯(lián)中臺創(chuàng)建實例，需要配置參數(shù)包括：推送地址，Token，消息加密方式。HTTPSGEThttps://url?msg=xxx&nonce=xxx&signature=xxxsignatureGETmsgJSONHTTPSbody10圖8 推數(shù)流流程msgAPIAPIAPIAPIAPIAPIhttps://xxxxxx/{namespace}?action=xxxx&version=1APIAPIAPIHeader11authorizationkeyvalue&作為分隔符：authorization:version=2020-05-29&res=userid%2F38055&et=1623982416&method=sha1&sign=S04GcvafYIjtAMHJthkGPevbNwE%3Dsignsign=base64(hmac_<method>(base64decode(AccessKey),utf-8(StringForSignature)))AccessKey（）AccessKeyAccessKey，且只AccessKeybase64decodeStringForSignatureet、method、resourceversionStringForSignature=et+"\n"+method+"\n"+res+"\n"+version12附 錄 A（）API請求示例如下：GET/common?action=QueryDeviceDetail&version=1&product_id=lsibd9&device_name=no001請求響應(yīng)參數(shù)說明見表A.1。表A.1響應(yīng)參數(shù)說明序號參數(shù)類型描述1requestIdstring請求ID，調(diào)用API時由平臺生成唯一請求標(biāo)識2codestring調(diào)用失敗時，返回的錯誤碼3msgstring調(diào)用失敗時，返回的錯誤信息4successboolean接口是否調(diào)用成功5dataobject調(diào)用成功時，返回的業(yè)務(wù)數(shù)據(jù)（null）成功響應(yīng)示例如下：{"requestId":"8906582E6722409AA6C40E7863B733A5","success":