ICS03.080.99CCSA01

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