GB/T 40689-2021 智慧城市 设备联接管理与服务平台技术要求

　　ICS 35 . 240 . 0 1 CCS L 70

　　中 华 人 民 共 和 国 国 家 标 准

　　GB/T 40689—2021

　　智慧城市 设备联接管理与

　　服务平台技术要求

　　Smartcity—Technicalrequirementsof

　　managementandserviceplatform fordeviceconnection

　　2021-10-1 1 发布 2022-05-01 实施

　　国家市场监督管理总局国家标准化管理委员会

　　发

　　布

　　GB/T 40689—202 1

　　GB/T 40689—202 1

　　前 言

　　本文件按照 GB/T 1 . 1—2020《标准化工作导则 第 1 部分：标准化文件的结构和起草规则》的规定起草。

　　请注意本文件的某些内容可能涉及专利。 本文件的发布机构不承担识别专利的责任。

　　本文件由全国信息技术标准化技术委员会(SAC/TC 28)提出并归口 。

　　本文件起草单位：华为技术有限公司、中国电子技术标准化研究院、中电科新型智慧城市研究院有限公司、腾讯云计算(北京)有限责任公司、北京电信规划设计院有限公司、浪潮软件科技有限公司、中移雄安信息通信科技有限公司、潍坊市大数据局、太极计算机股份有限公司、建设综合勘察研究设计院有限公司、泰华智慧产业集团股份有限公司、深圳市龙华区政务服务数据管理局、深圳天致信息工程咨询有限公司、中睿信数字技术有限公司、北京睿呈时代信息科技有限公司、北京清华同衡规划设计研究院有限公司、深圳市敢为软件技术有限公司、成都秦川物联网科技股份有限公司、山东省计算中心(国家超级计算济南中心)、中国联合网络通信有限公司智能城市研究院、浙江大华技术股份有限公司、山东省标准化研究院、深圳市标准技术研究院、中国电子科技集团公司信息科学研究院、中国科学技术大学、广州广电运通金融电子股份有限公司、南京南大智慧城市规划设计股份有限公司、中星技术股份有限公司、成都中科大旗软件有限公司、北京超图软件股份有限公司。

　　本文件主要起草人：康宁、王盾、张红卫、崔昊、刘文、陈佳喜、李赞、刘兴川、周波、彭革非、高有军、冯霄鹏、胡延年、冯晓蒙、董南、郑其荣、康柳、刘炜、张国强、王兵、王飞飞、杨奎、鲁静、郑庆国、王珏、张磊、庄广新、梁芳、李君兰、李永韬、于静、王曙光、毕建秀、王益群、李存国、熊焰、洪江、董莉、刘晓勇、刘大扬、魏东、李昱、蒋洪月、李少华。

　　GB/T 40689—202 1

　　智慧城市 设备联接管理与

　　服务平台技术要求

　　1 范围

　　本文件给出了智慧城市设备联接管理与服务平台的总体框架，并规定了功能要求、接口要求。

　　本文件适用于智慧城市设备联接管理与服务平台项目的规划、建设、运行和维护。

　　2 规范性引用文件

　　下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。 其中，注 日期的引用文件，仅该日期对应的版本适用于本文件;不注日期的引用文件，其最新版本(包括所有的修改单)适用于本文件。

　　GB/T 22080—2016 信息技术 安全技术 信息安全管理体系 要求

　　GB/T 22239—2019 信息安全技术 网络安全等级保护基本要求

　　GB 35114—2017 公共安全视频监控联网信息安全技术要求

　　GB/T 35319—2017 物联网 系统接口要求

　　3 术语和定义

　　下列术语和定义适用于本文件。

　　3.1

　　设备 device

　　具备通信能力的终端或具备通信能力和计算能力的网关。

　　注：除具备通信能力，设备也可具备传感、控制、数据获取、数据存储、数据处理、数据加密等能力。

　　3.2

　　智慧城市设备联接管理与服务平台 smartcitymanagementandserviceplatform fordeviceconnec- tion

　　实现智慧城市设备和行业应用集成开放的一种信息系统，通过不同通信协议和开放接口，提供多行业设备(3 . 1)联接管理、数据管理功能，为行业应用提供数据与服务的支撑能力。

　　3.3

　　物模型 thing-model

　　对设备(3 . 1)属性、状态、功能等进行抽象化描述的一种对象模型。

　　3.4

　　边缘管理 edgemanagement

　　一种在网络边缘侧对感知、传输、决策等提供管理功能的分布式计算。

　　注：管理功能可发生在边缘侧或接近边缘侧，其接近程度由系统的需求决定。

　　GB/T 40689—202 1

　　4 缩略语

　　下列缩略语适用于本文件。

　　API：应用程序编程接口(Application Programming Interface)

　　BACnet：楼宇自动化与控制网络(Building Automation and Control networks)

　　CAN：控制器局域网络(Controller Area Network)

　　CMIP：通用管理信息协议(Common Management Information Protocol)

　　CoAP：受约束的应用协议(Constrained Application Protocol)

　　CORBA：公共对象请求代理体系结构(Common Object Request Broker Architecture)

　　Da接 口：平台与行业应用的接 口 (Management and Service Platform for Device connection—Ap- plication)

　　Dd接 口：平台与设备的接口(Management and Service Platform for Device connection—Device)

　　Dr接 口：平台与其他平台的接口(Management and Service Platform for Device connection—other

　　Resource Platform)

　　DTLS：数据包传输层安全性协议(Datagram Transport Layer Security)

　　HTTP：超文本传输协议(Hypertext Transfer Protocol)

　　HTTPS：超文本传输安全协议(Hypertext Transfer Protocol Secure)

　　IP：网际协议 (Internet Protocol)

　　LonWorks：局部操作网络(Local operating netWorks)

　　LwM2M：轻量化的 M2M协议(lightweight Machine to Machine)

　　MQTT：消息队列遥测传输协议(Message queuing telemetry transport)

　　MQTTS：消息队列遥测传输安全协议(Message Queuing Telemetry Transport Secure)

　　NB-IoT：基于蜂窝的窄带物联网(Narrow Band—Internet of Things)

　　PON：无源光网络(Passive Optical Network)

　　QoS：服务质量(Quality of Service)

　　RF：射频(Radio Frequency)

　　SDH：同步数字系列 (Synchronous Digital Hierarchy)

　　SDK：软件开发工具包(Software Development Kit)

　　SDN：软件定义网络(Software Defined Network)

　　SIM：用户识别模块(Subscriber Identity Module)

　　SNMP：简单网络管理协议(Simple Network Management Protocol)

　　SQL：结构化查询语言(Structured Query Language)

　　TCP：传输控制协议(Transmission Control Protocol)

　　TLS：传输层安全性协议(Transport Layer Security)

　　UDP：用户数据报协议(User Datagram Protocol)

　　WAPI：无线局域网鉴别和保密基础结构 (Wireless LAN Authentication and Privacy Infrastruc-

　　ture)

　　GB/T 40689—202 1

　　5 平台总体框架

　　5 . 1 概述

　　智慧城市设备联接管理与服务平台(以下简称“平台”)为智慧城市各行业设备提供统一的联接管理功能，为智慧城市行业应用提供数据、服务、可视化等支撑能力，与其他平台保持互联互通和交互协作，满足智慧城市对设备联接管理与服务的需求。

　　5 . 2 总体框架

　　平台总体框架见图 1 。

　　注 1 ：物联层、数据层、服务层、可视化层、运维管理、安全管理(实线框内容)及平台接口是平台的核心，也是本文件约束的核心范围。

　　注 2：设备、行业应用、其他平台(虚线框内容)是平台的相关内容，不是本文件约束的范围。

　　图 1 智慧城市设备联接管理与服务平台总体框架

　　平台总体框架由物联层、数据层、服务层、可视化层、运维管理、安全管理、接口等部分组成。 各部分描述如下：

　　a) 物联层：提供物联管理、边缘管理、通信传输、感知与执行等设备接入与管理能力;

　　b) 数据层：提供数据汇聚、数据存储、数据转换、数据交换、数据分析、数据建模、数据管理等能力;

　　c) 服务层：提供数据服务、应用服务、开发服务、集成服务等能力;

　　d) 可视化层：提供空间、设备、业务等可视化能力;

　　e) 运维管理：提供平台 日常运维、监控告警、事件处理、运维统计等运维管理能力;

　　GB/T 40689—202 1

　　f) 安全管理：提供平台自身、设备接入、平台对外服务的安全管理能力;

　　g) 平台接口：包括平台与设备的接口 ( Dd 接口)、平台与行业应用的接 口 ( Da 接口)、平台与其他平台的接口(Dr接口)。

　　6 平台功能要求

　　6 . 1 物联层

　　6 . 1 . 1 物联管理

　　6 . 1 . 1 . 1 设备联接

　　设备联接功能包括接入管理、设备鉴权、负载均衡、长连接和短连接等，功能要求分别规定如下。

　　a) 接入管理功能要求：

　　1) 应支持设备直接接入、边缘网关接入、第三方系统接入等多种接入方式;

　　2) 应支持有线宽带、移动通信网、NB-IoT及其他无线接入等多种网络接入方式;

　　3) 应支持 HTTP/HTTPS、MQTT/MQTTS、LwM2M/CoAP等多种协议接入方式;

　　4) 应支持 SDK、API等多种应用接入方式;

　　5) 应提供支持多操作系统和多语言的设备接入 SDK 开发工具。

　　b) 设备鉴权功能要求：

　　1) 应支持对接入平台的设备进行鉴权认证，确定终端设备的有效身份，认证成功后下发内部唯一标识到设备;

　　2) 应具备一机一密的设备认证机制，生成密码要素应包括但不限于设备编号、厂商代号、设备类型、出厂信息等。

　　c) 负载均衡功能要求：

　　1) 应提供分布式消息中间件，平台支持根据设备接入协议设置分布式消息中间件对应主题，形成物联接入设备协议与所述主题的映射关系;

　　2) 应支持设备数据负载均衡，平台支持根据不同负载均衡策略，将设备数据转发至后续的数据处理模块。

　　d) 应支持长连接和短连接等多种连接方式。

　　6 . 1 . 1 . 2 设备管理

　　设备管理功能包括设备注册、设备注销、设备信息查询、设备变更管理、设备升级管理和设备群组管理等，功能要求分别规定如下。

　　a) 设备注册功能要求：

　　1) 应支持单个设备注册或批量设备注册，并分配内部唯一设备标识，且内部设备标识与设备编码应建立关联关系;

　　2) 应支持设备信息的注册，包括但不限于设备名称、设备用户、设备厂商、设备位置、设备类型、设备型号、协议类型等;

　　3) 应支持设备参数配置，并确保平台与设备配置信息同步。

　　b) 设备注销功能要求：

　　1) 应支持单个或批量设备注销;

　　2) 设备注销后，应基于时限要求保留设备的历史信息。

　　GB/T 40689—202 1

　　c) 设备信息查询功能要求：

　　1) 应支持设备信息的查询，包括但不限于设备名称、设备用户、设备厂商、设备位置、设备类型、设备型号、协议类型等;

　　2) 应支持设备运行信息的查询，包括但不限于配置参数、历史命令、在线记录、运行状态等;

　　3) 应支持查询指定设备采集的信息;

　　4) 应支持对具有空间位置属性的设备，提供基于地图服务的空间查询方式。

　　d) 设备变更管理功能要求：

　　1) 应支持设备信息的变更，包括但不限于设备名称、设备用户、设备厂商、设备位置、设备类型、设备型号、协议类型等;

　　2) 应支持设备配置参数的变更，可指定设备配置参数保存策略，并支持人工修改。

　　e) 设备升级功能要求：

　　1) 应为设备软件升级提供支持;

　　2) 应支持设备远程升级，提供版本更新迭代和管理能力;

　　3) 应支持批量升级、群组升级、时间策略升级、并发数升级等升级策略;

　　4) 应支持服务端决策升级、终端决策升级、协商升级等升级模式。

　　f) 应支持设备群组管理功能，支持基于群组的用户赋权、订阅和通知。

　　g) 针对通过蜂窝网络连接的设备，应支持设备的 SIM卡管理，辅助故障定位，实现终端故障监控和远程管理。

　　6 . 1 . 1 . 3 设备监控告警

　　设备监控告警功能包括设备状态(如在线、离线、正常、异常、休眠、唤醒等)监控、设备告警管理和设备故障诊断等，功能要求分别规定如下。

　　a) 设备状态监控功能应支持设备状态的实时监控。

　　b) 设备告警管理功能要求：

　　1) 应支持告警类型管理，并在设备配置文件中定义;

　　2) 设备告警时应向平台提供告警信息，包括但不限于告警事件名称、告警事件类型、告警事件等级、告警设备名称、告警设备标识、告警设备地址、操作字段等;

　　3) 当收到设备告警信息，平台可主动上报给上层应用，支持告警的查看和管理，并定位告警位置和区域;

　　4) 应支持根据告警事件性质与设备重要程度划定告警事件等级，为多项事件同时告警处置提供优先级参考;

　　5) 应支持告警过滤;

　　6) 应支持设备告警记录，包括但不限于设备的告警类型、告警原因、告警开始时间、告警持续时间、告警处置人员、告警处置结果等信息;

　　7) 应支持告警解除，告警解除后设备状态恢复为正常状态。

　　c) 设备故障诊断功能要求：

　　1) 应支持设备在平台的注册情况、电源电量、数据传输量、运行状态的分析;

　　2) 应支持对设备进行远程复位或升级;

　　3) 应实现设备运行日志的分析，包括但不限于设备的运行时间情况、设备的告警信息、设备与平台的交互时间等。

　　GB/T 40689—202 1

　　6 . 1 . 1 . 4 设备规则引擎

　　设备规则引擎功能包括规则定义、规则管理和规则调用等，功能要求分别规定如下。

　　a) 规则定义功能应支持预置定义或定制开发的规则场景以及规则内容定义，包括但不限于规则名称、规则类型、规则参数、规则操作等，规则定义功能可符合以下要求：

　　1) 支持物联层中物联管理模块的规则定义，包括但不限于设备在线/离线状态判定规则、设备正常/故障状态判定规则、设备故障诊断方式的规则、设备告警之后平台的响应规则、设备维护方式、维护流程等;

　　2) 支持物联层中边缘管理模块的规则定义，包括但不限于传感网络拓扑重组规则、节点黑白名单定义规则、设备加入鉴权规则、感知网络的故障分析与排查规则等;

　　3) 支持物联层中通信传输模块的规则定义，包括但不限于数据收发路由规则、数据隔离规则、协议切换规则等;

　　4) 支持物联层中传输执行模块的规则定义，包括但不限于感知设备数据上报规则、感知设备状态上报规则、多类感知数据上报机制、数据上报冲突避免规则、指令优先级的定义规则、指令权限的划分规则等;

　　5) 支持其他用户 自定义规则的制定。

　　b) 规则管理功能要求：

　　1) 应支持对现有规则的修改、删除和查询等;

　　2) 应支持规则管理流程的制定;

　　3) 应支持规则与设备、应用、告警等绑定，满足规则条件时，规则可以 自动化的执行响应动作;

　　4) 应支持将阈值超限、范围超限、位置跟踪等事件，作为规则引擎输入条件，并关联对应的处理动作;

　　5) 应支持自定义触发条件，特定条件的事件告警自动推送给应用。

　　c) 规则调用功能要求：

　　1) 应支持规则调用前进行规则判断，即判断设备当前相关状态与相关的规则是否满足相应条件，满足条件后进行规则调用;

　　2) 应支持需要提供规则调用所需的阈值、范围等作为规则引擎输入条件，保证平台对相应场景的规则响应;

　　3) 应支持在线增加并管理规则触发器，在线设置触发器名称和触发条件，并提供至少一种触发报警方式，包括但不限于邮箱接收、短信接收、第三方服务器接收等;

　　4) 应支持基于预设规则的设备联动触发，实现多设备的协同反应;

　　5) 应支持基于规则引擎的业务流自定义，实现数据个性化流转和处理。

　　6 . 1 . 2 通信传输

　　6 . 1 . 2 . 1 有线传输

　　有线传输功能要求如下：

　　a) 应支持不同场景对传输要求的能力，包括但不限于核心网、IP 城域网、分组传送网等应用范围;

　　b) 应支持不同的网络接入能力，包括但不限于以太网、SDH、PON 等 ;

　　c) 应支持根据不同场景选用不同时延等级的网络;

　　GB/T 40689—202 1

　　d) 应支持 QoS调度，根据不同要求进行区别传输转发，包括区分控制信令、采集数据等报文;

　　e) 应支持高精度时间同步能力，并可接入主/备用时间同步源;

　　f) 应支持不受设备厂家限制的 SDN 功能。

　　6 . 1 . 2 . 2 宽带无线传输

　　宽带无线在物联网中承担大容量数据传送网络的功能。 宽带无线传输功能要求如下：

　　a) 应支持无线网络持续演进，如 5G 以及后续演进;

　　b) 应支持不同流量等级的区分;

　　c) 应支持网络切片，根据服务等级协议为特定业务配置用户数、QoS、带宽等参数;

　　d) 应支持无线接入点的传输接入。

　　6 . 1 . 2 . 3 窄带无线传输

　　窄带无线在物联网中承担低功耗、小数据场景的数据传输网络功能。 窄带无线传输功能要求如下：

　　a) 应支持不同场景的窄带传输方式;

　　b) 应支持后续演进网络中窄带无线可与宽带共组网能力;

　　c) 应支持多个租户、多个用户同时接入，并且保证数据隔离;

　　d) 应支持满足低功耗场景的需求，如报文唤醒等;

　　e) 应支持不同来源的不同协议间的数据转换;

　　f) 应支持 SNMP、CMIP、CORBA 等多种网络管理协议，并支持不同协议间的切换，满足不同场景对窄带通信网络的需要。

　　6 . 1 . 3 边缘管理

　　6 . 1 . 3 . 1 传感网络管理

　　传感网络管理功能要求如下：

　　a) 应支持无线和有线两种方式，有线传感网络包括但不限于电力线载波、CAN线路等，无线传感网络包括但不限于蓝牙、WAPI、RF、ZigBee(一种低速短距离传输的无线网络协议)等 ;

　　b) 应支持拓扑的自动改变功能;

　　c) 应支持数据的自动路由功能;

　　d) 应支持传感的自动发现功能;

　　e) 应支持用户的远程访问功能;

　　f) 应支持节点黑白名单功能;

　　g) 应支持设备加入鉴权功能;

　　h) 应支持连接信道的动态分配功能;

　　i) 应支持物联网关的参数配置功能、定位的上报及查询功能;

　　j) 应支持传感网络遭外力破坏后的重组自愈功能;

　　k) 应支持自主完成指定任务的分布式智能化网络系统;

　　l) 应支持微型传感器实时获取监测对象的数据。

　　6 . 1 . 3 . 2 感知管理

　　感知管理功能要求如下：

　　a) 应支持设备在边缘网络中的加入、退出和变更的感知;

　　GB/T 40689—202 1

　　b) 应支持设备状态的感知;

　　c) 应支持感知传感网络的拓扑变化、线路状态变化，并能实时刷新路由;

　　d) 应支持感知上行网络的变化，根据网络变化能对数据进行本地化保存或处理及重传传感数据;

　　e) 应支持设备的移动性管理，并能实时刷新设备位置信息;

　　f) 应支持感知网络的规模变化与扩展状况，更新感知网络整体信息;

　　g) 应支持对感知网络资源的参数配置;

　　h) 应支持对感知网络的实时运行性能、服务质量状态等资源的监视;

　　i) 应支持实时对感知网络的远程控制;

　　j) 应支持对同类型感知网络的按需调度;

　　k) 应支持对感知网络的测试、故障分析与排查功能。

　　6 . 1 . 3 . 3 边缘决策

　　边缘决策功能要求如下：

　　a) 应支持在网络中断或关闭状态下设备的自我管理和本地控制功能;

　　b) 应支持设备的规则调度与处理功能;

　　c) 应支持感知网络被入侵状况下的告警与设备自动切断功能;

　　d) 应支持特定场景下部分感知数据和设备状态数据的边缘处理功能。

　　6 . 1 . 4 感知与执行

　　6 . 1 . 4 . 1 设备数据上报

　　设备数据上报功能要求如下：

　　a) 应支持设备状态数据和设备监测数据的上报;

　　b) 应支持基于规则引擎中定义的规则进行数据上报，包括但不限于基于设定的周期、事件触发等;

　　c) 平台接收到设备上报数据后，应及时向设备返回响应消息;

　　d) 应支持解析设备上报数据，并基于配置策略(包括转发、保存、透传等)发送至行业应用;

　　e) 应支持同时存在多条数据采集路径;

　　f) 应支持感知设备采集数据本地存储，以降低中心节点的存储资源压力;

　　g) 应支持在数据采集时，设备故障时空白数据段的标记填充功能;

　　h) 应支持因设备故障发生替换时同点采集数据的匹配功能;

　　i) 应支持同时进行多点数据采集与上传功能;

　　j) 当设备上报数据后没有收到平台的响应消息时，应能重新上报数据;

　　k) 若超出设定的重传次数阈值，上报数据失败，应支持数据本地缓存，下一个上报周期上报;

　　l) 应支持单一感知设备多类感知数据同时进行数据上报;

　　m) 应支持不同优先级数据采集与上传。

　　6 . 1 . 4 . 2 设备状态上报

　　设备状态上报功能要求如下：

　　a) 应支持可配置定时发送心跳;

　　b) 应支持上报一段时间内的设备状态;

　　c) 应支持其他平台当前状态信息的上报;

　　GB/T 40689—202 1

　　d) 应支持设备按照规则引擎中定义的规则进行状态上报，如一定频率或事件触发进行状态上报。

　　6 . 1 . 4 . 3 平台命令下发

　　命令下发功能要求如下：

　　a) 应支持对平台命令进行定义、管理和命令下发过程的管理等;

　　b) 命令定义的内容应包括但不限于命令名称、命令类型、命令编码、命令关联设备、对应操作等;

　　c) 应支持对命令进行管理，包括但不限于增加、删除、修改、查询;

　　d) 应支持对命令关联设备发送命令，并能够监控命令执行的过程;

　　e) 应支持行业应用通过平台开放的接口对设备进行管理和控制;

　　f) 应支持行业应用通过平台下发设备控制命令，支持立即下发、缓存下发及批量命令下发能力;

　　g) 应支持通过管理门户或 API进行远程设备命令下发，如开启、关闭等，实现对设备的手动远程控制;

　　h) 应支持基于规则引擎远程开启或关闭设备;

　　i) 应支持平台命令集的合并与扩充;

　　j) 应支持对命令集中的命令优先级和权限的划分，具体划分规则可在规则引擎中进行定义;

　　k) 命令下发的对象范围包括但不限于平台联接管理的设备和其他平台;

　　l) 命令下发规则应在规则引擎中定义，其传输的途径参照通信传输中定义的传输途径。

　　6 . 2 数据层

　　6 . 2 . 1 数据汇聚

　　数据汇聚功能要求如下：

　　a) 应支持多种数据源的读取和写入操作，包括但不限于文件、数据库、web 服务等;

　　b) 应支持对数据集成任务的管理、调度、监控、异常恢复等操作;

　　c) 应支持按照任务触发规则来调度数据集成任务;

　　d) 应支持多种可靠数据传输通道，实现不间断监听数据通道中的数据;

　　e) 应支持数据源管理、连接测试等功能;

　　f) 应支持异构数据源之间的数据同步功能;

　　g) 应支持数据在线汇聚、统计功能。

　　6 . 2 . 2 数据存储

　　平台应对采集到的数据及时进行存储，用于后续各类应用的查询、加工和分享。 数据存储功能要求如下：

　　a) 应支持设备上报的数据直接透传给应用处理，或数据在平台内存储，存储周期可以配置;

　　b) 应支持多种存储方式，包括但不限于对象存储、列式存储、云存储、分布式数据库存储;

　　c) 应支持数据缓存处理，包括用户和应用的权限数据、资源订阅数据等存储;

　　d) 应支持数据存储节点和组件的动态伸缩;

　　e) 应支持多租户环境下的存储空间配额管理功能;

　　f) 应采用国家密码管理主管部门鉴定的密码算法，采用多重密钥保护机制对数据进行存储加密保护;

　　g) 应支持文件级细粒度安全存储，可单独设置文件的密级、加密算法、加密密钥等;

　　h) 应支持数据冗余多节点可靠存储，支持单节点故障业务不中断，保证平台业务数据存储规模变

　　GB/T 40689—202 1

　　更时的可靠性;

　　i) 应支持数据备份和恢复。

　　6 . 2 . 3 数据转换

　　数据转换功能要求如下：

　　a) 应支持异构数据转换成统一格式;

　　b) 应支持不同设备上报数据转换为标准格式数据;

　　c) 应支持数据转换规则定制和管理;

　　d) 应支持数据转换规则、任务等程序的统一调度与监控;

　　e) 应支持设备数据解析，并按照统一的监测数据模型进行转换;

　　f) 应支持数据转换前的保存、备份功能，保证转换过程中的数据完整性;

　　g) 应支持设备空间数据坐标系的统一 ;

　　h) 应支持特定数据格式和统一数据格式的双向转换。

　　6 . 2 . 4 数据交换

　　数据交换功能要求如下：

　　a) 应符合数据交换共享有关的法律法规和监管要求;

　　b) 应支持数据处理功能，包括但不限于数据压缩、数据加密和签名、数据填充、数据格式转换、坐标位置提取等;

　　c) 应支持实时数据交换、批量数据交换;

　　d) 应支持多种类型数据交换，包括但不限于文件、数据库、web 服务等;

　　e) 应支持多种交换策略，包括但不限于点对点、交换共享、服务订阅等，提供自适应动态数据传输打包机制、消息确认和消息选择性重发机制;

　　f) 应支持对数据交换流程定义、规则定义等可视化配置与管理，支持对交换过程状态管理、监控、报警、容错处理、故障恢复等。

　　6 . 2 . 5 数据分析

　　数据分析功能要求如下：

　　a) 应支持设备状态数据分析，包括但不限于设备分布区域统计、设备部署类别统计、设备运行状态及趋势分析、设备区域故障状况统计、设备历史故障状况分析、设备维护状况统计、设备故障恢复率分析等;

　　b) 应支持设备监测数据分析，包括但不限于设备监测密度分析、设备监测数据均值/极值统计、设备监测数据偏差分析、设备监测数据异常频率统计、设备监测数据趋势分析等。

　　6 . 2 . 6 数据建模

　　数据建模功能要求如下：

　　a) 应支持建立统一的物模型和监测数据模型;

　　b) 应支持数据模型版本管理;

　　c) 应支持数据模型的更新与扩展;

　　d) 应支持对数据模型的元数据进行增加、删除、修改、查询等操作。

　　GB/T 40689—202 1

　　6 . 2 . 7 数据管理

　　数据治理功能要求如下：

　　a) 应提供可靠的数据应用规范，支持数据应用流程管理、数据应用审核、数据应用发布等;

　　b) 应提供数据从产生到消亡的全周期管理，支持识别、度量、监控、预警、数据架构定义、数据管理流程配置、数据责任流程配置和数据治理审核机制;

　　c) 应支持数据质量分析和预警，甄别数据优劣程度，对质量较差数据进行清理和长期不用数据进行清洗和归档;

　　d) 应支持通过预定的规则进行数据稽核，稽核发现的问题按照预定规则 自动治理或者生成任务工单进行处理，并生成稽核报告;

　　e) 应支持对数据属性标签标注功能，包括但不限于单个和批量标注标签、标签的增加、删除和修改等;

　　f) 应支持数据血缘关系管理，可自动生成和维护数据血缘关系地图;

　　g) 应支持敏感数据识别、标记和脱敏，脱敏类型包括但不限于替换、截断、掩码、重排、日期偏移取整等;

　　h) 应支持数据资源目录动态管理，包括但不限于梳理、编制、审核、发布等;

　　i) 应支持对不完整数据、错误数据、重复数据进行统一标识、清洗对比、整合转换等。

　　6 . 3 服务层

　　6 . 3 . 1 数据服务

　　数据服务功能要求如下：

　　a) 应支持对数据进行服务化封装、管理与开放;

　　b) 应支持以服务的形式对上层应用提供数据资源;

　　c) 应支持数据发布管理，保障数据使用者通过权限管理实时获取数据服务;

　　d) 应支持提供模型构建、脚本开发、任务调度、流程开发与编排等开发工具;

　　e) 应支持提供可视化建模工具，构造数据库模式、建立数据库、构建表结构和表关系;

　　f) 应支持异构数据库之间同步，包括但不限于采用基于数据表、数据视图、自定义 SQL 等方式构建数据模型。

　　6 . 3 . 2 应用服务

　　应用服务功能包括门户服务、模型服务、公共服务等，功能要求分别规定如下。

　　a) 门户服务功能要求：

　　1) 应支持移动应用开发构建;

　　2) 应支持基础通信能力集成，包括但不限于即时消息、语音呼叫、视频、邮件等;

　　3) 应支持第三方专业性服务(如短信服务、支付服务等)，供行业应用使用。

　　b) 模型服务功能要求：

　　1) 应提供标准的物联网关集成接口;

　　2) 应支持批量管理设备实例的能力，包括但不限于批量更新设备实例、批量删除设备实例、批量注册、批量禁用、批量激活设备的能力;

　　3) 应支持配置设备的触发规则，包括但不限于启动或禁用触发器、设置触发器有效期、配置触发器规则参数等;

　　GB/T 40689—202 1

　　4) 应支持对平台的应用、用户、设备数据进行管理和关联绑定操作，并提供群组管理和批操作;

　　5) 应支持对同类模型设备批量添加共性的数据。

　　c) 公共服务功能要求：

　　1) 应支持公共组件通过服务化接口方式提供给行业应用使用，包括但不限于空间服务、信息服务、用户管理服务、账号管理服务、权限管理服务、认证授权服务、审计服务、服务管理等;

　　2) 应提供定位、纠偏、道路匹配、地理围栏和导航服务;

　　3) 应提供数据分析、模型配置、质量管理、运行监控等服务;

　　4) 应提供面向使用者的统一用户信息管理服务;

　　5) 应提供统一的账号管理服务，能够兼容已有账号管理系统;

　　6) 应提供基于组织或角色的权限管理服务，支持权限信息同步给对应行业应用;

　　7) 应提供统一的身份认证和授权服务，用户身份认证应支持“账号+密码”、人脸识别、指纹识别等多种认证方式;

　　8) 应提供事前预警，对登录模式、访问时间、操作行为、访问习惯和访问关系中出现的异常行为进行监控和预警;

　　9) 应支持对身份管理、访问行为和运维管理等进行全方位的合规审计;

　　10) 应提供服务管理功能，包括但不限于服务注册、服务发现、服务调用、服务编排、服务治理等;

　　11) 应提供服务生存周期管理，包括但不限于服务发布、申请、审批、交付、管理、监控、撤销等。

　　6 . 3 . 3 开发服务

　　开发服务功能包括开发功能、测试功能、发布功能和监控功能等，功能要求分别规定如下。

　　a) 开发功能宜符合以下要求：

　　1) 提供相应的开发工具，包括但不限于在线编排、开发模板、代码编译与测试、开发程序打包工具等;

　　2) 提供 API开放管理、可视化组件等服务;

　　3) 提供构件仓库，支持构件的分类管理、版本管理、上传、下载、检索等;

　　4) 提供软件服务化封装;

　　5) 支持应用项目管理、代码托管等。

　　b ) 测试功能宜符合以下要求：

　　1) 提供在线错误的检测和修正;

　　2) 支持设备与平台的数据传输与接收过程调试;

　　3) 支持对平台上注册的设备发送模拟数据，记录和查看发送日志;

　　4) 支持 API在线调试，如添加请求参数和请求内容，并显示返回结果;

　　5) 提供可视化在线调试工具，包括但不限于数据模拟器、地图数据模拟器、API调试工具等;

　　6) 提供沙箱环境，用于在线测试运行新开发的应用;

　　7) 测试环境支持物理机部署、虚拟化部署、云部署，支持集中式部署和分布式部署，支持服务器环境配置及核查。

　　c) 发布功能宜符合以下要求：

　　GB/T 40689—202 1

　　1) 支持应用的持续集成、在线打包发布和自动部署;

　　2) 提供应用运行环境;

　　3) 支持服务构件的热加载(即插即用)。

　　d) 支持实时监控应用的运行状态和资源使用情况。

　　6 . 3 . 4 集成服务

　　集成服务功能包括应用集成、消息集成等，功能要求分别规定如下。

　　a) 应用集成功能要求：

　　1) 应支持在线创建设备关联的轻应用，支持对应用进行预览发布和公开访问，支持对应用进行增加、删除、修改、查询等编辑操作;

　　2) 应支持在线对第三方开发平台进行服务器配置，设置推送的地址和数据内容，并支持相关消息进行加解密接入验证等操作;

　　3) 应支持对应用服务进行注册、发布、审核、订阅、编排等操作;

　　4) 应支持对应用服务进行路由管理、流控管理、授权管理、运维管理等操作;

　　5) 应支持通过服务的形式将数据库对外开放使用。

　　b) 消息集成功能要求：

　　1) 应支持消息的创建、修改、查询、删除、授权等操作;

　　2) 应提供消息的发布、订阅、存储、跨数据中心路由和跨云传输，支持安全接入和轨迹跟踪;

　　3) 应支持多种发布订阅模式;

　　4) 应提供可靠的消息传输通道;

　　5) 应提供自动化的运维可视和告警机制。

　　6 . 4 可视化层

　　6 . 4 . 1 空间可视化

　　空间可视化是将基于地理信息数据的数字空间通过可视化的形式进行呈现，空间可视化功能要求如下：

　　a) 应支持基础地理信息要素数据的显示，包括但不限于区域范围内的卫星影像、行政区划、道路、水系等;

　　b) 应支持多种显示方式，包括但不限于二三维一体化显示、地上地下一体化显示、宏微观一体化显示及无缝切换显示;

　　c) 应支持加载地理信息数据和城市信息模型;

　　d) 应支持加载建筑信息模型，支持模型内部漫游及设备状态查看;

　　e) 应支持城市地下基础设施效果呈现，包括但不限于地下综合管廊、地下隐蔽工程、地下建筑结构体等，对特定区域进行地表剥离，显示地表以下空间关系。

　　6 . 4 . 2 设备可视化

　　设备可视化是将设备的属性、状态、功能等通过可视化的形式进行呈现。 设备可视化功能要求如下：

　　a) 应支持对设备全生存周期数据的综合呈现;

　　b) 应支持设备与其周边场景融合一体化呈现;

　　c) 应支持设备状态、效能状态、预警状态、内部结构等可视化呈现;

　　GB/T 40689—202 1

　　d) 应支持设备报警后自动推送报警信息及报警现场照片，进行一体化推送呈现;

　　e) 应支持设备指标数据的不同方式展示，包括但不限于空间标牌方式、空间飞线方式等;

　　f) 应支持设备模型动画展示设备状态的能力，如开关的旋转、车轮的转动等;

　　g) 应支持将设备状态、报警状态等信息统一推送到移动端、桌面终端、大屏幕等多终端融合呈现;

　　h) 应支持将设备根据空间位置进行区域化管理、空间位置查找;

　　i) 应支持模型透视，实现关键部件查看。

　　6 . 4 . 3 业务可视化

　　业务可视化是将用户的业务数据、业务逻辑、工作流程等结合空间和设备进行可视化呈现。 业务可视化功能要求如下：

　　a) 应支持与指定业务场景相关联的多类设备监测数据、报警数据的管理与呈现;

　　b) 应支持对业务管辖区域、业务责任人等业务管理数据的呈现与推送;

　　c) 应支持业务与设备的远程联动控制与可视化呈现;

　　d) 应支持与指定业务相关联的设备维护、事件告警等业务处置流程的可视化呈现;

　　e) 应支持通过移动端、桌面终端、大屏幕等多种方式实现业务信息的可视化呈现。

　　6 . 5 运维管理

　　6 . 5 . 1 平台 日常运维

　　6 . 5 . 1 . 1 配置管理

　　平台配置管理功能要求如下：

　　a) 应根据业务需求配置平台运行管理参数，包括但不限于日志管理、监控告警、校时管理、版本管理、接口管理、统计分析等;

　　b) 应支持资源模型和资源属性的自定义配置;

　　c) 应支持配置统计查看，进行配置数据及配置关系展示。

　　6 . 5 . 1 . 2 资源管理

　　平台资源管理功能应支持对平台使用的硬件资源、软件资源、数据资源等进行管理，掌握资源现状和配置信息。

　　6 . 5 . 1 . 3 升级维护

　　平台升级维护功能要求如下：

　　a) 应按需完成平台升级维护;

　　b) 应支持平滑升级，保证数据不丢失;

　　c) 应支持记录升级维护的 日志;

　　d) 若升级不成功，平台应保持可用状态或恢复升级前状态。

　　6 . 5 . 2 平台监控告警

　　6 . 5 . 2 . 1 监控管理

　　平台监控管理功能要求如下。

　　a) 应支持监控类型管理，同时需在设备配置文件中定义。

　　GB/T 40689—202 1

　　b) 应支持对平台运行状态监控管理：

　　1) 应实时监控平台 自身运行的基本信息，包括但不限于平台运行状态监控、用户行为监测、信息监控等;

　　2) 应支持第三方监控系统对接。

　　c) 应支持对自身状态进行实时查看：

　　1) 应支持对平台运行环境进行日常化巡检和实时监测;

　　2) 应支持平台运行环境资源状态的可视化显示。

　　6 . 5 . 2 . 2 告警管理

　　平台告警管理功能要求如下：

　　a) 应支持在监控指标超出阈值时提出告警，并提供告警过滤功能;

　　b) 告警信息应包括但不限于告警标题、告警来源、告警发生时间、告警地点、告警描述和告警级别等;

　　c) 应支持多种告警通知方式，包括但不限于工单、系统弹窗、短信、邮件、声音等;

　　d) 应支持告警分级分域上报，用户应按权限查看告警信息;

　　e) 应支持告警解除，在告警解除后，平台运行环境状态恢复为正常状态;

　　f) 应提供故障报告生成、故障跟踪、故障处理、故障关闭、故障复盘等功能;

　　g) 应支持告警信息的批量处理，并可对历史告警处理进行追溯。

　　6 . 5 . 3 平台事件处理

　　平台事件处理功能要求如下：

　　a) 应支持事件分级分类;

　　b) 应支持事件的受理、分类、调查、诊断、解决进展、关闭等环节的全流程跟踪;

　　c) 应支持对事件工单的各个节点设置触发动作，如邮件、短信、调用外部接口等;

　　d) 应支持事件工单多种任务分派方式，包括发起人指定、自动分配、主动认领等，支持任务的干预和改派;

　　e) 应支持运维人员通过移动智能终端对相应事件工单进行查看、处理、审批、反馈等操作，并同步上传至运维管理系统;

　　f) 应提供事件处理评估功能。

　　6 . 5 . 4 平台运维统计

　　平台运维统计功能要求如下：

　　a) 应提供多维度的平台运维统计功能，包括但不限于设备统计、用户统计、资源统计、告警统计、日志统计、事件统计等;

　　b) 应支持多种形式展示运维统计结果，包括但不限于数据报表、可视化图表、地图展示等;

　　c) 应支持运维数据对外开放，为可视化页面和自定义报表的开发提供数据资源，并可适配多终端屏幕显示。

　　6 . 6 安全管理

　　平台在安全管理方面应符合 GB/T 22239—2019、GB/T 22080—2016、GB 35114—2017 等的要求。

　　GB/T 40689—202 1

　　7 平台接口要求

　　7 . 1 接口大类

　　根据平台业务交互对象，平台定义了如下外部接口：

　　a) Dd接口是平台与设备之间接口，提供设备与平台之间控制信息传递和感知数据传输;

　　b) Da接口是平台与行业应用之间接口，提供数据和服务能力支撑以及适配接入管理;

　　c) Dr接口是平台与其他平台之间接口，提供数据共享与交换能力。

　　7 . 2 接口总体要求

　　平台接口总体要求如下：

　　a) 平台接口的实现应与实现技术无关，接口内部实现技术变更不应导致服务接口变化;

　　b) 平台接口应符合统一的数据格式与交互参数，同时应提供防错、容错、合法性校验等机制;

　　c) 平台接口服务端应对客户端做身份认证，应对敏感数据做加密;

　　d) 平台不应支持可绕过系统安全机制访问平台或数据的接口 ;

　　e) 平台接口访问操作应有记录 日志，日志内容应符合审计要求。

　　7.3 Dd接口要求

　　7 . 3 . 1 接口子类

　　7 . 3 . 1 . 1 设备消息接口

　　设备消息接口清单见表 1,接口示例见附录 A 中的 A. 1 。

　　表 1 设备消息接口清单

　　7 . 3 . 1 . 2 设备命令接口

　　设备命令接口清单见表 2,接口示例见 A. 2 。

　　表 2 设备命令接口清单

　　7 . 3 . 1 . 3 设备属性接口

　　设备属性接口清单见表 3,接口示例见 A. 3 。

　　GB/T 40689—202 1

　　表 3 设备属性接口清单

　　7 . 3 . 1 . 4 设备事件接口

　　设备事件接口清单见表 4,接口示例见 A. 4 。

　　表 4 设备事件接口清单

　　7 . 3 . 2 接口技术要求

　　Dd接口技术要求如下：

　　a) 接口协议应符合 GB/T 35319—2017 中 6.10 规定的要求;

　　b) 应支持设备直联接入和通过网关接入：

　　1) 设备直联接入：针对已实现 TCP/IP协议栈的设备，可以直接与平台进行通信并对协议解析，如网关设备、以太网设备、NB-IoT设备等;

　　2) 通 过 网 关 接 入：针 对 未 实 现 TCP/IP 协 议 栈 的 设 备，基 于 近 场 通 信 协 议(如 ZigBee、

　　GB/T 40689—202 1

　　ZWave、蓝牙等)或非 IP 有线方式传输协议(如串口、并口等)的设备，先让设备接入到网关，再通过网关进行数据转发，与平台通信;

　　c) 应支持多种网络协议、传输协议、安全协议等，并且具备开放可扩展和向后兼容的能力;

　　d) 应支持有线和无线的接入方式，符合 6 . 1 . 2 通信传输要求;

　　e) 应支持主流的终端设备接入通信协议，包括但不限于：CoAP、MQTT/MQTTS、HTTP/HT- TPS、LwM2M、Modbus(一 种 串 行 通 信 协 议)、BACnet、LonWorks 及 其 他 行 业 协 议，支 持UDP/TCP传输协议;

　　f) 应支持通过扩展协议插件实现私有或非标协议设备和应用的接入，支持上传、加载、卸载协议插件;

　　g) 应支持数据交互，采用 TLS/DTLS加密协议传输，其中 TCP 方式接入的遵循 TLS 加密协议传输，UDP方式接入遵循 DTLS加密协议接入;

　　h) 应支持选择对称和非对称加密方式。

　　7.4 Da接口要求

　　7 . 4 . 1 接口子类

　　7 . 4 . 1 . 1 鉴权管理接口

　　鉴权管理接口清单见表 5,接口示例见附录 B 中的 B. 1 。

　　表 5 鉴权管理接口清单

　　7 . 4 . 1 . 2 设备管理接口

　　设备管理接口清单见表 6,接口示例见 B. 2 。

　　表 6 设备管理接口清单

　　GB/T 40689—202 1

　　表 6 设备管理接口清单(续)

　　7 . 4 . 1 . 3 设备服务接口

　　设备服务接口清单见表 7,接口示例见 B. 3 。

　　表 7 设备服务接口清单

　　7 . 4 . 1 . 4 设备影子接口

　　设备影子接口清单见表 8,接口示例见 B. 4 。

　　表 8 设备影子接口清单

　　7 . 4 . 1 . 5 数据采集接口

　　数据采集接口清单见表 9,接口示例见 B. 5 。

　　GB/T 40689—202 1

　　表 9 数据采集接口清单

　　7 . 4 . 1 . 6 命令下发接口

　　命令下发接口清单见表 10,接口示例见 B. 6 。

　　表 10 命令下发接口清单

　　7 . 4 . 1 . 7 订阅管理接口

　　订阅管理接口清单见表 11,接口示例见 B. 7 。

　　表 1 1 订阅管理接口清单

　　7 . 4 . 1 . 8 推送通知接口

　　推送通知接口清单见表 12,接口示例见 B. 8 。

　　GB/T 40689—202 1

　　表 12 推送通知接口清单

　　7 . 4 . 2 接口技术要求

　　Da接口技术要求如下：

　　a) 接口协议应符合 GB/T 35319—2017 中 6.18 规定的要求。

　　b) 应支持自定义的方式与行业应用对接;

　　c) 应具备开放可扩展和向后兼容的能力;

　　d) 提供给应用服务的数据交互采用应用层 HTTPS 协议传输，采用加密协议宜使用 TLSv1. 2、 TLSv1 . 3 ;

　　e) 应支持 HTTPS、MQTTS、DTLS+等多种安全协议;

　　f) 针对网络传输的用户重要数据，应支持通过设置完整性标签等进行完整性检测，其完整性受到破坏，能采取相应措施进行数据恢复;

　　g) 应支持在服务器端对所有来自不可信数据源的数据进行校验，拒绝任何未通过校验的数据。

　　7 . 5 Dr接口要求

　　7 . 5 . 1 接口引用

　　Dr接口引用应符合其他平台定义的接口标准规范，Dr接口清单见附录 C。

　　7 . 5 . 2 接口技术要求

　　Dr接口技术要求如下：

　　a) 接口协议应符合 GB/T 35319—2017 中 6.16 规定的要求;

　　b) 应提供针对异构数据接口提供适配接入管理;

　　c) 应提供数据库的接入;

　　d) 应支持身份管理，身份信息包含但不限于系统名称、系统 IP、端口号、鉴权码等;

　　e) 应支持鉴权码管理，鉴权码应采用加密算法，保证外部系统接入的安全性;

　　f) 应支持数据共享与交换，实现系统与平台之间的互联互通。

　　GB/T 40689—202 1

　　附 录 A

　　(资料性)

　　Dd接口示例

　　A.1 设备消息接口

　　A.1 . 1 设备消息接收

　　设备消息接收接口原型见表 A. 1 。

　　表 A.1 设备消息接收接口原型

　　设备消息接收接口请求参数见表 A. 2 。

　　表 A.2 设备消息接收接口请求参数

　　接口请求示例：

　　Body:{

　　"device_id " : "40000012345 " ,

　　" name" : " name" ,

　　"content " : "hello" }

　　A.1 . 2 平台消息下发

　　平台消息下发接口原型见表 A. 3 。

　　表 A.3 平台消息下发接口原型

　　平台消息下发接口请求参数见表 A. 4 。

　　GB/T 40689—202 1

　　表 A.4 平台消息下发接口请求参数

　　接口请求示例：

　　Body:{

　　"device_id " : "40000012345 " ,

　　"id " : "id " ,

　　"content " : "hello" }

　　A.2 设备命令接口

　　A.2 . 1 平台命令下发

　　平台命令下发接口原型见表 A. 5 。

　　表 A.5 平台命令下发接口原型

　　平台命令下发接口下行请求参数见表 A. 6 。

　　表 A.6 平台命令下发接口下行请求参数

　　平台命令下发接口上行请求参数见表 A. 7 。

　　表 A.7 平台命令下发接口上行请求参数

　　GB/T 40689—202 1

　　平台命令下发接口下行请求示例：

　　Body:{

　　"device_id " : "40000012345 " ,

　　"command_name" : "ON_OFF" ,

　　"service_id " : "WaterMeter " ,

　　"paras" : { "value" : "1" }}

　　平台命令下发接口上行请求示例：

　　Body:{

　　"result_code " : 0 ,

　　"response_name" : "COMMAND_RESPONSE" , "paras" : { "result" : "success" }}

　　A.3 设备属性接口

　　A.3 . 1 终端装置属性接收

　　终端装置属性接收接口原型见表 A. 8 。

　　表 A.8 终端装置属性接收接口原型

　　终端装置属性接收接口参数说明见表 A. 9 。

　　表 A.9 终端装置属性接收接口参数说明

　　ServiceProperty结构定义见表 A.10。

　　表 A.10 serviceproperty结构定义

　　接口请求数据格式：

　　Body:{

　　"device_id " : "40000012345 " , "services " : [{

　　"service_id" : "Temperature" , "properties" : { "value" : 57}}]}

　　GB/T 40689—202 1

　　A.3 . 2 批量终端装置属性接收

　　批量终端装置属性接收接口原型见表 A. 11 。

　　表 A.1 1 批量终端装置属性接收接口原型

　　批量终端装置属性接收接口参数说明见表 A. 12 。

　　表 A.12 批量终端装置属性接收接口参数说明

　　DeviceProperty定义见表 A.13。

　　表 A.13 Deviceproperty定义

　　接口请求示例：

　　Body:{

　　"devices" :[{

　　"device_id" : "bf40f0c4-4022-41c6-a201-c5133122054a " , "services" :[{

　　"service_id" : "analog" ,

　　"properties":{"PhV_phsA":"1"}}]

　　} ,{

　　"device_id" : "42aa08ea-84c1-4025-a7b2-c1f6efe547c2 " , "services" :[{

　　"service_id" : "parameter" ,

　　"properties":{"Load":"6"}}]}]}

　　A.3 . 3 设备影子数据获取

　　设备影子数据获取接口原型见表 A. 14 。

　　GB/T 40689—202 1

　　表 A.14 设备影子数据获取接口原型

　　设备影子数据获取接口上行请求参数见表 A. 15 。

　　表 A.15 设备影子数据获取接口上行请求参数

　　设备影子数据获取接口下行请求参数见表 A. 16 。

　　表 A.16 设备影子数据获取接口下行请求参数

　　ShadowData结构定义见表 A.17。

　　表 A.17 shadowData结构定义

　　PropertiesData结构定义见表 A.18。

　　表 A.18 propertiesData结构定义

　　设备影子数据获取接口设备上行请求示例：

　　Body:{

　　"device_id " : "40000012345 " ,

　　GB/T 40689—202 1

　　"service_id" : "Temperature"}

　　设备影子数据获取接口下行请求示例：

　　Body:{

　　"device_id" : "40fe3542-f4cc-4b6a-98c3-61a49ba1acd4 " ,

　　"shadow" :[{

　　"service_id " : "WaterMeter " ,

　　"desired" :{ "properties" :{ "temperature" : "60" }} ,

　　"reported":{"properties":{"temperature":"80"}}}]}

　　A.3 . 4 设备属性设置

　　设备属性设置接口原型见表 A. 19 。

　　表 A.19 设备属性设置接口原型

　　设备属性设置接口下行请求参数见表 A. 20 。

　　表 A.20 设备属性设置接口下行请求参数

　　设备属性设置接口上行请求参数见表 A. 21 。

　　表 A.2 1 设备属性设置接口上行请求参数

　　设备属性设置接口下行请求数据格式：

　　Body:{

　　"device_id " : "40000012345 " , "services" :[{

　　"service_id" : "Temperature" , "properties":{"value":57}}]}

　　设备属性设置接口上行响应数据格式：

　　Body:{

　　"result_code " : 0 ,

　　GB/T 40689—202 1

　　"result_desc " : "success" }

　　A.3 . 5 设备属性查询

　　设备属性查询接口原型见表 A. 22 。

　　表 A.22 设备属性查询接口原型

　　设备属性查询接口下行请求参数见表 A. 23 。

　　表 A.23 设备属性查询接口下行请求参数

　　设备属性查询接口上行请求参数见表 A. 24 。

　　表 A.24 设备属性查询接口上行请求参数

　　设备属性查询接口下行请求示例：

　　Body:{

　　"device_id " : "40000012345 " ,

　　"service_id" : "Temperature"}

　　设备属性查询接口上行请求示例：

　　Body:{

　　"services" :[{

　　"service_id" : "Temperature" , "properties":{"value":"1"}}]}

　　A.4 设备事件接口

　　A.4 . 1 设备事件接收

　　设备事件接收接口原型见表 A. 25 。

　　GB/T 40689—202 1