DB3305T 252-2022 物联中台接入与数据转发技术规范

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":