ICS03.080.99CCSA01

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