北斗卫星电力应用综合服务平台接口规范

GB/T××××—××××PAGE6ICSXXXICSXXXT/CECT/CECXXXX--XXXX北斗卫星电力应用综合服务平台接口规范InterfaceSpecificationforBeidouSatelliteApplicationIntegratedServicePlatform（草案）中国电力企业联合会发布××××-××-××发布××××-××-××实施中国电力企业联合会发布T/CEC××××—××××PAGEPAGE53目录前  言 错误！未定义书签。引  言 错误！未定义书签。北斗卫星电力应用综合服务平台接口规范 11范围 12规范性引用文件 13术语和定义和缩略语 13.1术语和定义 13.2缩略语 34总则 41.1接口连接关系 41.2接口功能列表 55基准站接入 75.1逻辑架构 75.2通信协议 76终端接入 96.1通信接入 96.2数据接入 97安全管理 107.1网络边界安全防护 107.2应用接口安全防护 117.3数据安全防护 13附录A（规范性附录）设备类型标准编码 15附录B（规范性附录）基准站接入要求 16附录C（规范性附录）设备接入数据样例 129北斗卫星电力应用综合服务平台接口规范范围本标准规定了北斗卫星电力应用综合服务平台接口要求、数据安全技术要求，北斗卫星电力应用综合服务平台数据格式、传输协议。本标准适用于北斗卫星电力应用综合服务平台与电力北斗基准站间的接口关系、接口协议及数据传输。规范性引用文件下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅注日期的版本适用于本文件。凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。GB/T39267-2020北斗卫星导航术语GB/T39607-2020卫星导航定位基准站数据传输和接口协议BDS-SIS-ICD-2.1北斗卫星导航系统空间信号接口控制文件公开服务信号（2.1版本）BD440015-2017北斗地基增强系统国家数据综合处理系统数据接口规范BD440017-2017北斗地基增强系统基准站数据存储与输出要求BD440018-2017北斗地基增强系统基于中国移动通信网数据播发接口规范BD440019-2017北斗地基增强系统基于中国移动多媒体广播（CMMB）播发接口规范BD410004-2015北斗/全球卫星导航系统（GNSS）接收机导航定位数据输出格式BD410001-2015北斗/全球卫星导航系统（GNSS）接收机数据自主交换格式BD410003-2015北斗全球卫星导航系统（GNSS）接收机差分数据格式（二）RTCMNTRIP数据传输协议（RTCMNTRIPdatatransmissionprotocoll）RTCM10403.2差分GNSS(全球导航卫星系统)服务标准3.2版本（DifferentialGNSS（GlobalNavigationSatelliteSystems）Services-Version3.2）术语和定义和缩略语术语和定义GB/T39267-2020和BD440013-2017界定的术语以及下列术语适用于本文件。基准站referencestation由接收机和天线等设备组成，用于观测、存储、传输卫星信号数据，并具有基准坐标。数据播发系统databroadcastingsystem使用移动通信、数字广播、卫星播发等多种手段播发差分数据产品的系统。数据处理平台dataprocessingsystem由数据接收系统、数据存储系统、数据处理系统、数据播发系统组成，完成对基准站原始观测数据的综合处理，形成和播发差分增强数据产品的系统。北斗地基增强系统BeiDouground-basedaugmentationsystem由地面基准站和数据处理平台组成。地面基准站网络实时接收卫星原始观测数据，通过数据通信网络将这些基准站观测数据传输至一个或多个数据处理平台，计算误差改正信息，生成分米级、厘米级等差分数据产品，并将数据产品提供给用户终端和其他数据处理系统。数据处理平台中的数据播发系统通过地面通信网络向用户播发差分改正信息，提高用户定位导航精度。差分定位differentialpositioning一种提高卫星导航定位精度的技术。在已知点上设置卫星导航基准接收机，根据由此获得的卫星导航观测值或误差修正量，实时或事后提供给差分用户设备，使用户设备接收并利用修正量以提高其定位精度。实时动态测量real-timekinematic（RTK）GNSS差分定位技术的一种，主要通过基准站和用户端之间的实时数据链路和载波相对定位快速解算技术，实现高精度动态相对定位。广域差分wideareadifferentialGNSS在较大区域内提高GNSS定位性能的一种技术。利用布设在较大区域内的多个GNSS基准站，监测视野内的GNSS卫星，通过集中数据处理，分类获得误差改正参数和完好性信息，并发送给用户，使用户获得较高定位性能。误差改正参数通常包括星历误差改正、卫星钟误差改正和电离层延迟改正参数等。区域差分localareadifferentialGNSS在较小区域内提高GNSS定位性能的一种技术。该技术通过一个或多个GNSS基准站的观测值为区域用户进行的差分定位。差分数据dataproductofdifferentialGNSS又称差分改正数据。各类用于修正用户接收机观测值的伪距观测值、载波相位观测值、多普勒观测值、卫星信息、坐标转换信息、轨道信息等数据统称为差分数据。差分电文differentialmessage将差分数据按照规定格式排列，加上前缀符、数据长度、校验等信息后形成的二进制数据流。每条电文都具备一个标识字段，称为电文类型号。缩略语下列缩略语适用于本文件。GNSS：全球卫星导航系统（GlobalNavigationSatelliteSystem）NTRIP：基于互联网的RTCM数据传输协议(NetworkedTransportofRTCMViaInternetProtocol)BDS：北斗卫星导航系统（BeiDouNavigationSatelliteSystem）BDT：北斗时（BDSSystemTime）RTCM：海事无线电技术委员会（Radio

Technical

Commissionfor

MaritimeServices）RTD：实时伪距差分（RealTimeDifference）RTK：实时载波相位差分（RealTimeKinematic）SBAS：星基增强系统（Satellite-BasedAugmentationSystem）TOW：历元时刻，周内秒（TimeofWeek）URA：用户测距精度（UserRangeAccuracy）UTC：协调世界时（UniversalTimeCoordinated）ARP：天线参考点（AntennaReferencePoint）GCPCD：几何载波相位差分改正（GeometricCarrierPhaseCorrectionDifference）GIVEI：格网点电离层垂直延迟误差指数（GridIonosphericVerticalErrorIndicator）GLONASS：全球导航卫星系统（俄罗斯）（GlobalNavigationSatelliteSystem）GPS：全球定位系统（美国）（GlobalPositioningSystem）ICD：接口控制文件（InterfaceControlDocument）ICPCD：电离层载波相位差分改正（IonosphericCarrierPhaseDifferenceCorrection）ID：信息编号（Identification）IGP：电离层格网点（IonosphericGridPoint）IGS：国际GNSS服务（InternationalGNSSService）IOD：数据龄期（IssueOfData）IODE：星历数据龄期（IssueOfDataEphemeris）ITRF：国际地球参考框架（InternationalTerrestrialReferenceFrame）TCP/IP：传输控制/网络通信协议（TransmissionControlProtocol/InternetProtocol）总则为适应北斗卫星电力应用综合服务平台设计，提高基准站、终端设备与北斗卫星电力应用综合服务平台数据传输的可靠性和安全性，规范平台接口建设实施，特制定本标准要求。本标准对接口关系、数据格式及数据传输安全技术要求等进行了规定，各类基准站接收机、终端设备等数据采集设备的数据格式设计、数据传输设计、生产制造及数据传输规定应符合本技术要求规定。北斗卫星电力应用综合服务平台涉及的基准站接收机、各类用户终端设备产品制造除符合本规范规定外，还应符合相应国家标准、行业标准的要求。接口连接关系系统数据接口包括与基准站之间的接口、与其他行业数据处理系统的接口、与北斗卫星电力应用综合服务平台之间的接口，连接关系如下图所示：接口功能列表序号分类接口名称接口流向备注1权限认证设备鉴权基准站->定位平台指物联网平台对接入平台的设备进行身份认证2系统信息系统信息上报基准站->定位平台用于基准站向定位平台上报系统信息3硬件状态上报基准站->定位平台用于基准站向定位平台上报硬件状态5网络状态上报基准站->定位平台用于基准站向定位平台上报网络状态6系统控制授权注册控制定位平台->基准站用于定位平台向基准站发送授权注册控制命令7系统电源控制定位平台->基准站用于定位平台向基准站发送系统电源控制命令8固件升级固件升级控制定位平台->基准站用于定位平台向基准站发送固件升级控制命令9固件升级上报基准站->定位平台用于基准站向定位平台上报升级状态10工作模式工作模式上报基准站->定位平台用于基准站向定位平台上报工作模式11工作模式获取定位平台->基准站用于定位平台向基准站获取工作模式12工作模式设置定位平台->基准站用于定位平台向基准站发送工作模式设置命令13天线参数天线参数上报基准站->定位平台用于基准站向定位平台上报天线参数14天线参数获取定位平台->基准站用于定位平台向基准站获取天线参数15天线参数设置定位平台->基准站用于定位平台向基准站发送天线参数设置命令16卫星系统卫星系统上报基准站->定位平台用于基准站向定位平台上报卫星系统17卫星系统获取定位平台->基准站用于定位平台向基准站获取卫星系统18卫星系统设置定位平台->基准站用于定位平台向基准站发送卫星系统设置命令19卫星数据差分数据格式获取定位平台->基准站用于定位平台向基准站获取差分数据格式20差分数据格式设置定位平台->基准站用于定位平台向基准站发送差分数据格式设置21导航数据格式获取定位平台->基准站用于定位平台向基准站获导航分数据格式22导航数据格式设置定位平台->基准站用于定位平台向基准站发送导航数据格式设置23原始数据格式获取定位平台->基准站用于定位平台向基准站获取原始数据格式24原始数据格式设置定位平台->基准站用于定位平台向基准站发送原始数据格式设置25数据传输数据传输上报基准站->定位平台用于基准站向定位平台上报数据传输26数据传输获取定位平台->基准站用于定位平台向基准站获取数据传输27数据传输设置定位平台->基准站用于定位平台向基准站发送数据传输控制命令28数据采集数据采集上报基准站->定位平台用于基准站向定位平台上报数据采集29数据采集获取定位平台->基准站用于定位平台向基准站获取数据采集30数据采集设置定位平台->基准站用于定位平台向基准站发送数据采集控制命令基准站接入逻辑架构认证管理、基本配置信息、运行信息、主机配置和数据配置应符合附录B的规定。通信协议协议约定基准站协议约定示意图见图1。基准站协议约定示意图观测数据，基准站使用NTRIPV2.0协议向数据中心上传差分或者原始数据，一秒一包评率上传，TCP长连接；静态信息，基准站以RESTfulAPI方式向运维管理平台低频上传，开机上传一次，TCP短连接；状态数据，基准站以FESTfulAPI方式向运维管理平台高频上传，不同命令不同频率上传，TCP短连接；控制命令，运维管理平台部署在网省的远程控制服务以RESTfulAPI方式向基准站发起请求，TCP短连接。协议结构除NTRIP登录请求本身是HTTP协议外，其它数据传输都应增加HTTP协议头。接口访问方式NTRIPV2.0使用通用技术规范。RESTful消息体格式RESTfulAPI消息体需采用JSON格式，HTTPHearder内需指定参数如下：Content-Type:application/json数据中心获取到Token后，接口请求的Header中需要携带Token，格式固定为：-X-Auth-Token:{认证接口发放的Token}RESTful变量类型定义RESTfulAPI遵循JSON格式的类型定义，包括以下几个类型：数值型（Number）：分为整数型（Integer）和浮点型（Float），均为十进制数值，长度用bit表示。当必选指标无法确定取值时，如无特殊说明，取默认值-1；字符串型（String）：零个或多个字符，长度用char表示。当必选指标无法确定取值时，如无特殊说明，取默认值""；布尔型（Boolean）：true或false，长度为1bit。当必选指标无法确定取值时，如无特殊说明，取默认值false；数组型（Array）：包含零个或多个值，值可以是数组型或其它类型，有顺序。当必选指标无法确定取值时，如无特殊说明，取默认值[]；对象型（Object）：Key-Value集合，无顺序。当必选指标无法确定取值时，如无特殊说明，取默认值{}；除此之外，还存在几种特殊类型的变量：时间日期格式的数值视为字符串型；枚举类型的变量约束了取值范围，但是变量的值最终还是归为上述几种类型。RESTful日期时间格式接口服务器必须采用当地标准时间，中国大陆地区采用UTC+8（北京标准时间）。如无特殊说明，接口中时间类字段数据格式统一为YYYY-MM-DDhh:mm:ss,如：2017-07-2019:15:00。状态码状态码说明表见表1。状态码说明表CodeShorttextDescription200OKeverythingwasfine401UnauthorizedNoorwrongauthorization404NotFoundMountpointofrequestnotfound409ConflictMountpointalreadyinusebyanotherNtripServe终端接入通信接入HTTP接入数据RESTful接口原则，采用Post方式上传。url中引入参数作为设备解析数据信息。MQTT接入数据宜采用小端方式进行组织。通信Topic由平台提供，作为数据解析准则。采用设备标识符作为用户名，进行数据校验。CoAP接入数据采用Post方式上传。url中引入参数作为设备解析数据信息。url由下面两部分组成：服务端IP和端口由平台提供；url路径描述：api/v1/{配置项}/{设备编码}/telemetry,“配置项”由平台提供，“设备编码”为设备唯一标识符，作为数据接入准则。数据接入JSON数据格式接入浮点型无效数据传输使用NAN。关键字段类型和key值见表2。关键字段类型和key值表序号类型KEY参数说明单位1Stringdevice_type设备类型--2Stringdevice_sn设备编号--3Int64ts采集时间ms4doublelng经度--5Stringlng_dir经度方向--6doublelat纬度--7Stringlat_dir纬度方向--8intalarm_type告警类型--9intpos_type定位类型--10intstate设备状态--11intpos_mode定位模式--12intpower_supply供电类型--13intsource_rtk数据来源--14floatbettery电池电量--字节流数据格式接入字节流数据采用小端数据接入。无效数据采用十六进制”FF”作为传输数据。安全管理平台的安全管理标准分为网络边界安全防护标准、主机安全防护标准、业务应用安全防护标准、数据安全防护标准、终端安全防护标准。网络边界安全防护边界类型平台存在的网络边界有：管理信息大区横向边界。北斗卫星服务与安全接入区边界。安全接入区与外网边界。管理信息大区纵向边界。平台边界类型见表3。平台边界类型表边界类型边界描述管理信息大区横向边界管理信息大区等级保护二级域与三级域间边界北斗卫星服务与安全接入区边界北斗卫星服务接入与安全接入区边界管理信息大区纵向边界总部管理信息大区与网省管理信息大区的边界边界安全防护相关管理员应明确网络边界，建立边界网络接口清单并定期进行审查复核。各个边界采取的安全防护措施为：管理信息大区横向边界安全利用信息内网现有安全域边界的防火墙设备进行访问控制，配置访问控制策略。在网络边界对跨越边界传输的信息进行内容过滤，对应用层数据流进行有效的监视和控制。利用信息内网现有安全域边界的入侵检测系统对流经边界的信息流进行入侵检测，基于对外提供的服务类别（如HTTPS、DNS等）进行入侵防护。配置入侵检测探头策略，并对日志进行分析审计。北斗卫星服务与安全接入区边界安全利用现有部署防火墙、IDS、IPS、网页防篡改设备、防病毒网关等设备，进行边界安全防护。非公司信息内网区域信息采集类、移动作业类终端以安全专网方式接入信息内网，必须通过安全接入平台进行安全认证接入，建立专用加密传输通道，实现终端身份认证、安全准入和数据安全交换，结合各业务实际需求开放端口。安全接入区与外网边界安全利用现有安全接入网关，实现移动终端用户接入认证和安全防护。管理信息大区纵向边界安全利用现有部署防火墙、IDS、IPS、网页防篡改设备、防病毒网关等设备，进行边界安全防护。应用接口安全防护身份鉴别信息内网用户通过部署于信息内网的权限系统进行用户登录认证（用户名+口令方式）。授权采用角色控制，限制用户对系统级资源的访问。系统管理员角色仅有对系统管理的权限，没有任何业务权限。对操作方面的权限控制采用前端展现和后端（服务器）共同进行访问控制。对系统资源访问控制方面采用统一的鉴权接口。输入输出验证系统对用户在客户端输入或导入的数据进行长度、范围、数据类型等属性的合法性进行检验，对不合法的数据禁止输入，并且提示明确的错误信息。各模块设置了保护内部输入、输出和存储期间的用户数据，以及和用户直接相关的安全属性。对于输入框的长度类型做限制。业务数据直接存储在数据库中，敏感信息采用加密方式存储。针对特殊字符进行检测，例如单引号、1=1、CDATA、分号、for、loop等，防止XML注入、SQL注入及脚本注入攻击。通过严格限制客户端可提交的数据类型以及对提交的数据进行有效性检查等有效措施防止跨站脚本攻击。在系统页面通过脚本对用户输入的信息进行规则匹配，异步检测等验证过滤操作防止跨站脚本攻击。在系统业务处理层使用代码规则验证以及数据查找比对的真实性验证防止跨站脚本攻击。配置管理配置使用最少特权进程和服务帐户，各项配置信息对非管理员账户不可读。通过目录权限确保配置存储的安全。用户授权等配置管理功能只允许管理员角色操作。单独分配管理特权。禁止通过web页面直接浏览服务端的目录和文件。制定严格的配置变更管理流程，系统关键信息例如数据库连接、运行参数、模板信息等发生配置变更时，需由相关负责人进行审批确认。设置配置信息的保存及版本控制规则，避免发生版本丢失或混淆。使用基于角色的授权策略控制配置管理角色，控制配置权限粒度，配置管理功能只能由经过授权的操作员和管理员访问。会话管理每次系统登录成功使用新的会话。关闭网页客户端自动会话的安全终止。在服务端保存会话认证信息和会话有效期，当登录成功后清除旧的会话创建新会话。设置会话存活时间为30分钟，超时后自动销毁用户会话，删除会话信息。在服务端进行会话信息存储，对用户登录信息及身份凭证进行加密传输。用户登录后界面提供退出、注销功能。用户注销后，服务端自动清除用户会话。加密技术用户密码采用SM4算法加密后进行传输，然后再使用哈希算法进行二次处理后保存。敏感数据采用SM4算法加密后进行传输或保存。参数操作每次请求都进行安全检查，确保用户没有绕过检查，确保用户查询的数据是权限范围内的数据。利用拦截器验证从客户端发送的所有数据，对数据进行安全检查，根据过滤规则截获敏感字符，并对其进行替换或转义。配置数据更新操作记录日志，同时对用户行为进行流程化操作限制。异常管理对终端用户屏蔽系统异常，使用通用错误信息，将系统抛出的异常信息写入日志文件。程序发生异常时，终止当前业务，并对当前业务进行回滚操作，保证业务的完整性和有效性，必要时注销当前用户会话。应用交互安全通过标准的WebService/HTTP接口与第三方系统集成。基于XML或JSON与第三方系统交互数据，通过WebService/HTTP方式传输。各种收发数据、消息的日志按日期将业务系统使用过程中输入输出、错误等进行存储。对于跨站脚本攻击风险，对系统源代码进行源代码扫描和渗透测试，确保没有跨站脚本攻击风险隐患。数据安全防护数据存储安全数据库连接用户权限最小。应用系统配置文件中的数据库用户名、密码加密存储。在数据集成时，为不同的业务系统分配不同的权限，每个账号仅能访问授权的数据视图。数据传输安全在系统之间传输数据通过WebService/HTTP方式传输。在系统内部传递默认为POST请求提交，如果用GET方式提交参数必须加密过后进行传输。用户口令传输进行加密。数据备份安全支持多台设备之间数据实时同步。通过数据库实时备份工具，实现主库到备库的实时备份。T/CEC××××—××××T/CEC××××—××××PAGE54

（规范性附录）

设备类型标准编码设备类型标准编码应符合表A.1的要求。设备类型标准编码序号名称设备类型1北斗智能手持终端ESM0022轨迹监测装置PCM0013北斗杆塔倾斜形变监测设备PCS0014北斗工卡PHM0015北斗车载终端PHM0026北斗地址监测站PMS0027北斗安全帽PSM0018北斗智能间隔棒PCM002

（规范性附录）

基准站接入要求认证管理设备鉴权功能描述平台设备侧支持MQTT协议的connect消息接口，在传输层上使用SSL/TLS进行加密传输，鉴权通过后建立设备与平台间的MQTT连接。参数说明字段必须/可选类型参数描述ClientId可选String一机一密的设备clientIdUsername可选String设备IDPassword必选String加密后的设备密钥鉴权流程基本配置信息数据模型数据模型用于描述产品的功能，是物理空间中的实体（如传感器、车载装置、楼宇、工厂等）在云端的数字化表示，从属性、服务和事件三个维度，分别描述了该实体是什么、能做什么、可以对外提供哪些信息。定义了数据模型的这三个维度，即完成了产品功能的定义。功能类型说明属性（Property）设备可读取和设置的能力。一般用于描述设备运行时的状态，如环境监测设备所读取的当前环境温度等。属性支持GET和SET请求方式。应用系统可发起对属性的读取和设置请求。服务（Service）设备可被外部调用的能力或方法，可设置输入参数和输出参数。产品提供了什么功能供云端调用。相比于属性，服务可通过一条指令实现更复杂的业务逻辑，如执行某项特定的任务。事件（Event）设备运行时，主动上报给云端的事件。事件一般包含需要被外部感知和处理的通知信息，可包含多个输出参数。例如，某项任务完成的信息，或者设备发生故障或告警时的温度等，事件可以被订阅和推送。消息主题设备使用MQTT协议接入平台时，平台和设备通过Topic进行通信。平台预置了TOPIC，通过这些预置的Topic，平台和设备可以实现属性、命令、事件的交互。数据类型消息类型主题Public

（发布者）Subscriber

（订阅者）说明属性相关设备属性上报/v1/station/properties/report设备平台用于设备按产品定义的格式将属性数据上报给平台平台查询设备属性/v1/station/{code}/properties/get平台设备用于平台查询设备属性设备返回属性查询响应/v1/station/properties/get/response设备平台用于设备返回属性查询结果命令相关平台下发命令/v1/station/{code}/commands平台设备用于平台下发命令，控制设备设备返回命令响应/v1/station/commands/response设备平台用于设备返回命令控制结果事件相关事件上报/v1/station/events/report设备平台设备运行时，主动上报给云端的事件消息格式MQTT消息体采用JSON格式进行封装，具体内容信息参考设备属性、服务、事件命令。命名规划采用camelCase标准，例如code、stationModel。通信协议北斗平台设备数据接入通信协议采用MQTT，兼容V3.X版本。变量类型定义数值型（Number）：分为整数型（Integer）和浮点型（Float），均为十进制数值，长度用bit表示。当必选指标无法确定取值时，如无特殊说明，取默认值-1；字符串型（String）：零个或多个字符，长度用char表示。当必选指标无法确定取值时，如无特殊说明，取默认值""；布尔型（Boolean）：true或false，长度为1bit。当必选指标无法确定取值时，如无特殊说明，取默认值false；数组型（Array）：包含零个或多个值，值可以是数组型或其它类型，有顺序。当必选指标无法确定取值时，如无特殊说明，取默认值[]；对象型（Object）：Key-Value集合，无顺序。当必选指标无法确定取值时，如无特殊说明，取默认值{}；除此之外，还存在几种特殊类型的变量：时间日期格式的数值视为字符串型枚举类型的变量约束了取值范围，但是变量的值最终还是归为上述几种类型日期时间格式接口统一采用当地标准时间，中国大陆地区采用UTC+8（北京标准时间）。如无特殊说明，接口中时间类字段数据格式统一为YYYY-MM-DDhh:mm:ss,如：2017-07-2019:15:00。状态码值定义状态码值定义，如下表所示：状态码状态码描述原因0x00连接成功连接成功0x01请求拒绝，协议版本错误服务器不支持客户端请求MQTT协议版0x02请求拒绝，无效的客户端标识符clientId不符合格式要求或者心跳时间间隔不满足平台要求0x03请求拒绝，服务器不可用平台服务不可用0x04请求拒绝，用户名或密码错误用户名或密码错误0x05请求拒绝，没有授权客户端没有权限连接运行信息系统信息上报功能描述基准站接收机每天生成一次接收机系统状态信息上报到定位平台，固定上报时间为北京时间8点，如果状态信息有变更，则主动及时生成上报。Topic上行：/v1/station/properties/report参数说明字段名必选/可选类型参数描述code必选String站点代码，String类型的数字和字母，如：ZH11359000，且每个设备ID在当前设备中具有唯一性eventTime必选Integer设备采集数据时间戳，单位毫秒，设备上报数据不带该参数或参数格式错误时，则数据上报时间以平台时间为准。services必选List<ServiceProperty>设备服务数据列表，多个服务数据可合并上报ServicesProperty结构定义字段名必选/可选类型参数描述serviceId必选String服务ID，systemInfoproperties必须SystemObject信息内容SystemObject结构定义字段必须/可选类型描述name可选String站点名称：广州桥南站address可选String站点地址：广州市番禺区type必选Integer设备类型：0-未知型接收机；1-授时型接收机2-导航型接收机；3-测地型接收机；4-测量型接收机；5-监测型接收机；manufacturer必选String设备厂商：Hi-TARGETmodel必选String设备型号：VNet8U-Iserialnumber必选String设备编号，11360896，各厂家内部设备唯一标识systemName必选String系统名称：LinuxsystemVersion必选String系统版本：V3.2.0firmwareVersion必选String固件版本：V2.1.0OEMModel必选String主板型号：UB4B0OEMSerialnumber必选String主板序列号：5935C2987XOEMHardwareVersion必选String主板版本：21319storageCapacity必选Float存储容量：64.5，单位：GB，参照系统磁盘风格，浮点数表示、保留1位小数点timeZone必选String时区：UTC+1~UTC+11，UTC-11~UTC-1timeStartup必选String系统开机启动时间：2020/5/1210:32:00timeRegister必选String系统注册码有效期：2020/12/3023:59:59示例报文示例：Topic:/v1/station/properties/report{"code":"ZH11359000","eventTime":1645696682211,"services":[{"serviceId":"systemInfo","properties":{"name":"广东联通大厦站","address":"广东联通大厦站","type":3,"manufacturer":"HI-TARGET","model":"VNet8U-I","serialnumber":"11360896","systemName":"Linux","systemVersion":"V3.2.0","kernelVersion":"V1.2.0","storageMedium":1,"storageCapacity":64.5,"timeZone":"UTC+8","timeStartup":"2021/10/1510:32:55","timeRegister":"2021/10/1510:32:55"}}]}硬件状态上报功能描述基准站接收机每隔120秒生成一次接收机物理硬件状态信息上报到定位平台，不支持定位平台主动设置。Topic上行：/v1/station/properties/report参数说明字段名必选/可选类型参数描述code必选String站点代码，String类型的数字和字母，如：ZH11359000，且每个设备ID在当前设备中具有唯一性eventTime必选Integer设备采集数据时间戳，单位毫秒，设备上报数据不带该参数或参数格式错误时，则数据上报时间以平台时间为准。services必选List<ServiceProperty>设备服务数据列表，多个服务数据可合并上报ServicesProperty结构定义字段名必选/可选类型参数描述serviceId必选String服务ID，hardwareInfoproperties必须HardwareObject信息内容HardwareObject结构定义字段必须/可选类型描述CPURatio必选IntergerCPU利用率%RAMRatio必选IntergerRAM使用率%storageRAW必选List<StorageDetail>已用存储空间storageUSB必选List<StorageDetail>输出电源开关：0-关闭，1-开启storageTFK必选List<StorageDetail>TNC口连接状态：0-未连接，1-连接temperature必选Float温度，保留1位小数点voltage必选Floatinexternal内部电源电压，单位V，保留1位小数点electric必选Interger电量%externalPowerStatus必选Intergerexternal外接电源状态：0-未连接，1-连接externalPowerVoltage必选Float外接电源电压，单位V，保留1位小数点USB必选IntergerUSB口接入状态：0-未连接，1-连接ETH必选IntergerETH开启状态：0-未连接，1-连接，有线、无线WIFI、移动4GWIFI必选IntergerWIFI开启状态：0-未连接，1-连接BLUE必选IntergerBLUE开启状态：0-未连接，1-连接StorageDetail结构体字段名必选/可选类型参数描述status必选Integer0-未挂载，1-挂载total必选Float总共存储空间，单位：GBused必选Float已用存储空间，单位：GB，参照系统磁盘风格，浮点数表示、保留1位小数点surplus必选Float剩余存储空间，单位：GB，参照系统磁盘风格，浮点数表示、保留1位小数点示例报文示例：Topic:/v1/station/properties/report{"code":"ZH11359000","eventTime":1645696682211,"services":[{"serviceId":"hardwareInfo","properties":{"CPURatio":20,"RAMRatio":60,"storageRAW":[{"status":1,"total":"13.3GB","used":"0.8GB","surplus":"12.5GB"}],"storageUSB":[{"status":1,"total":"13.3GB","used":"0.8GB","surplus":"12.5GB"}],"storageTFK":[{"status":1,"total":"13.3GB","used":"0.8GB","surplus":"12.5GB"}],"temperature":45,"voltage":7.3,"electric":96,"externalPowerSwitch":0,"externalPowerStatus":1,"externalPowerVoltage":220,"USB":0,"ETH":1,"WIFI":0,"BLUE":0}}]}网络状态上报功能描述基准站接收机每天生成一次接收机系统网络状态信息上报到定位平台，固定上报时间为北京时间8点，如果状态信息有变更，则主动及时生成上报。Topic上行：/v1/station/properties/report参数说明字段名必选/可选类型参数描述code必选String站点代码，String类型的数字和字母，如：ZH11359000，且每个设备ID在当前设备中具有唯一性eventTime必选Integer设备采集数据时间戳，单位毫秒，设备上报数据不带该参数或参数格式错误时，则数据上报时间以平台时间为准。services必选List<ServiceProperty>设备服务数据列表，多个服务数据可合并上报ServicesProperty结构定义字段名必选/可选类型参数描述serviceId必选String服务ID，networkInfoproperties必须NetworkObject信息内容NetworkObject结构定义字段必须/可选类型描述wireline必选List<NetworkDetail>有线网络，有线网、光纤网，按照传输介质分类wireless必选List<NetworkDetail>无线网络，WIFImobile必选List<NetworkDetail>移动网络，CDMA网络制式、GRPS网络制式NetworkDetail结构体字段名必选/可选类型参数描述state必选Interger启用状态：0-禁用；1-启用status必选Interger运行状态：0-断开1-连接physical可选String物理地址，MACprotocol可选StringIP协议：IPV4、IPV6type可选StringManual，Auto（DHCP）,需要确认是DHCP还是什么Autoaddress可选String网络地址，IPnetmask可选String子网掩码gateway可选String默认网关domain可选String域名系统（DNS:DomainNameServer）示例报文示例：Topic:/v1/station/properties/report{"code":"ZH11359000","eventTime":1645696682211,"services":[{"serviceId":"networkInfo","properties":{"wireline":[{"state":1,"status":1,"physical":"F4-39-09-F0-BC","protocol":"IPV4","type":0,"address":"00","netmask":"","gateway":"","domain":""}],"wireless":[{"state":0,"status":0,"physical":"F4-39-09-F0-BC","protocol":"IPV4","type":0,"address":"00","netmask":"","gateway":"","domain":""}],"mobile":[{"state":0,"status":0,"physical":"F4-39-09-F0-BC","protocol":"IPV4","type":0,"address":"00","netmask":"","gateway":"","domain":""}]}}]}主机配置系统控制B.4.1.1 系统信息设置功能描述定位平台调用基准站提供的接收机系统信息设置接口，实现基准站接收机系统信息设置。Topic下行：/v1/station/{code}/commands上行：/v1/staton/commands/response参数说明1）下行参数字段名必选/可选类型参数描述services必选List<ServiceProperty>设备服务数据列表（控制命令列表）packetId必须String消息ID号。String类型的数字，取值范围0~4294967295，且每个消息ID在当前设备中具有唯一性。eventTime必选Integer命令下发时间戳，单位毫秒ServicesProperty结构定义字段名必选/可选类型参数描述serviceId必选String属性ID，systemInfoproperties必须SystemSettingObject信息内容SystemSettingObject结构定义字段必须/可选类型描述name必选String站点名称：广州桥南站address必选String站点地址：广州市番禺区timeZone必选String时区：UTC+1~UTC+11，UTC-11~UTC-1上行参数字段名必选/可选类型参数描述code必选String站点代码，String类型的数字和字母，如：ZH11359000，且每个设备ID在当前设备中具有唯一性services必选List<ServiceProperty>设备服务数据列表（控制命令列表）packetId必须String消息ID号。String类型的数字，取值范围0~4294967295，且每个消息ID在当前设备中具有唯一性。eventTime必选Integer设备采集数据时间戳，单位毫秒，设备上报数据不带该参数或参数格式错误时，则数据上报时间以平台时间为准。ServiceProperty结构定义字段名必选/可选类型参数描述serviceId必选String属性ID，systemInfoproperties可选Object上报信息属性errorCode必选Interger命令的执行结果，0表示成功，其他表示失败。不带默认认为成功。errorMessage必选String命令响应描述，success标识成功示例报文示例：Topic:/v1/station/ZH11359000/commands{"packetId":"1507707025","eventTime":1645696682211,"services":[{"serviceId":"systemInfo","properties":{"name":"广州桥南站","address":"广州市番禺区","timeZone":"UTC+8"}}]}Topic:/v1/staton/commands/response{"code":"ZH11359000","packetId":"1507707025","eventTime":1645696682211,"services":[{"errorCode":0,"errorMessage":"success","serviceId":"systemInfo","properties":{}}]}B.4.1.2 本地服务上报功能描述基准站接收机每天生成一次接收机系统软件和应用软件运行状态信息上报到定位平台，固定上报时间为北京时间8点，如果状态信息有变更，则主动及时生成上报。Topic上行：/v1/station/properties/report参数说明字段名必选/可选类型参数描述code必选String站点代码，String类型的数字和字母，如：ZH11359000，且每个设备ID在当前设备中具有唯一性eventTime必选Integer设备采集数据时间戳，单位毫秒，设备上报数据不带该参数或参数格式错误时，则数据上报时间以平台时间为准。services必选List<ServiceProperty>设备服务数据列表，多个服务数据可合并上报ServicesProperty结构定义字段名必选/可选类型参数描述serviceId必选String服务ID，serviceLocalproperties必须ServiceLocalObject信息内容ServiceLocalObject结构定义字段必须/可选类型描述HTTP必选IntergerHTTP服务状态：0-关闭，1-开启HTTPPort必选IntergerHTTP服务端口，默认：80FTP必选IntergerFTP服务状态：0-关闭，1-开启FTPPort必选IntergerFTP服务端口，默认：21SSH必选IntergerSSH服务状态：0-关闭，1-开启SSHPort必选IntergerSSH服务端口，默认：22TEL必选Intergertelnet服务状态：0-关闭，1-开启TELPort必选Intergertelnet服务端口，默认：23示例报文示例：Topic:/v1/station/properties/report{"code":"ZH11359000","eventTime":1645696682211,"services":[{"serviceId":"serviceLocal","properties":{"HTTP":1,"HTTPPort":80,"FTP":0,"FTPPort":21,"SSH":0,"SSHPort":22,"TEL":0,"TELPort":23}}]}B.4.1.3 本地服务控制功能描述定位平台调用基准站提供的接收机系统服务控制接口，指定基准站接收机连接定位平台管理地址。Topic下行：/v1/station/{code}/commands上行：/v1/staton/commands/response参数说明1）下行参数字段名必选/可选类型参数描述services必选List<ServiceProperty>设备服务数据列表（控制命令列表）packetId必须String消息ID号。String类型的数字，取值范围0~4294967295，且每个消息ID在当前设备中具有唯一性。eventTime必选Integer命令下发时间戳，单位毫秒ServicesProperty结构定义字段名必选/可选类型参数描述serviceId必选String属性ID，serviceLocalproperties必须ServiceLocalObject信息内容ServiceLocalObject结构定义字段必须/可选类型描述HTTP必选ServiceDetailHTTP服务FTP必选ServiceDetailFTP服务SSH必选ServiceDetailSSH服务TEL必选ServiceDetailTEL服务ServiceDetail结构体字段名必选/可选类型参数描述state必选Integer服务启用状态：0-关闭，1-开启ip必选Integer服务地址port必选Integer服务端口username必选String账号password必选String密码connectionMode必选Integer连接方式，1-有线网络，2-无线网络，3-移动网络encryptionMode必选Integer加密方式：0-明文，1-AES-256-GCM加密2）上行参数字段名必选/可选类型参数描述code必选String站点代码，String类型的数字和字母，如：ZH11359000，且每个设备ID在当前设备中具有唯一性services必选List<ServiceProperty>设备服务数据列表（控制命令列表）packetId必须String消息ID号。String类型的数字，取值范围0~4294967295，且每个消息ID在当前设备中具有唯一性。eventTime必选Integer设备采集数据时间戳，单位毫秒，设备上报数据不带该参数或参数格式错误时，则数据上报时间以平台时间为准。ServiceProperty结构定义字段名必选/可选类型参数描述serviceId必选String属性ID，serviceLocalproperties可选Object上报信息属性errorCode必选Interger命令的执行结果，0表示成功，其他表示失败。不带默认认为成功。errorMessage必选String命令响应描述，success标识成功示例报文示例：Topic:/v1/station/ZH11359000/commands{"packetId":"1507707025","eventTime":1645696682211,"services":[{"serviceId":"serviceLocal","properties":{"HTTP":{"state":1,"ip":"","port":80,"username":"admin","password":"EF3BD472E3FD9EFADC0E89FE3CDEC59B","connectionMode":1,"encryptionMode":0},"FTP":{"state":1,"ip":"","port":21,"username":"admin","password":"EF3BD472E3FD9EFADC0E89FE3CDEC59B","connectionMode":1,"encryptionMode":0},"SSH":{"state":1,"ip":"","port":22,"username":"admin","password":"EF3BD472E3FD9EFADC0E89FE3CDEC59B","connectionMode":1,"encryptionMode":0},"TEL":{"state":1,"ip":"","port":23,"username":"admin","password":"EF3BD472E3FD9EFADC0E89FE3CDEC59B","connectionMode":1,"encryptionMode":0}}}]}Topic:/v1/staton/commands/response{"code":"ZH11359000","packetId":"1507707025","eventTime":1645696682211,"services":[{"errorCode":0,"errorMessage":"success","serviceId":"serviceLocal","properties":{}}]}B.4.1.4 远程服务上报功能描述基准站接收机每天生成一次接收机系统软件和应用软件运行状态信息上报到定位平台，固定上报时间为北京时间8点，如果状态信息有变更，则主动及时生成上报。Topic上行：/v1/station/properties/report参数说明字段名必选/可选类型参数描述code必选String站点代码，String类型的数字和字母，如：ZH11359000，且每个设备ID在当前设备中具有唯一性eventTime必选Integer设备采集数据时间戳，单位毫秒，设备上报数据不带该参数或参数格式错误时，则数据上报时间以平台时间为准。services必选List<ServiceProperty>设备服务数据列表，多个服务数据可合并上报ServicesProperty结构定义字段名必选/可选类型参数描述serviceId必选String服务ID，serviceRemoteproperties必须ServiceRemoteObject信息内容ServiceRemoteObject结构定义字段必须/可选类型描述HTTP必选ServiceDetailHTTP服务状态：0-关闭，1-开启MQTT必选ServiceDetailHTTP服务端口，默认：80ServiceDetail结构体字段名必选/可选类型参数描述state必选Integer服务启用状态：0-关闭，1-开启status必选Integer服务连接状态：0-断开，1-连接ip必选Integer服务地址port必选Integer服务端口username必选String账号password必选String密码connectionMode必选Integer连接方式，1-有线网络，2-无线网络，3-移动网络encryptionMode必选Integer加密方式：0-明文，1-AES-256-GCM加密示例报文示例：Topic:/v1/station/properties/report{"code":"ZH11359000","eventTime":1645696682211,"services":[{"serviceId":"serviceRemote","properties":{"HTTP":{"state":1,"status":1,"ip":"","port":80,"username":"admin","password":"EF3BD472E3FD9EFADC0E89FE3CDEC59B","connectionMode":1,"encryptionMode":0},"MQTT":{"state":1,"status":1,"ip":"","port":1833,"username":"admin","password":"EF3BD472E3FD9EFADC0E89FE3CDEC59B","connectionMode":1,"encryptionMode":0}}}]}B.4.1.5 远程服务控制功能描述定位平台调用基准站提供的接收机远程服务控制接口，指定基准站接收机连接定位平台管理地址。Topic下行：/v1/station/{code}/commands上行：/v1/staton/commands/response参数说明1）下行参数字段名必选/可选类型参数描述services必选List<ServiceProperty>设备服务数据列表（控制命令列表）packetId必须String消息ID号。String类型的数字，取值范围0~4294967295，且每个消息ID在当前设备中具有唯一性。eventTime必选Integer命令下发时间戳，单位毫秒ServicesProperty结构定义字段名必选/可选类型参数描述serviceId必选String属性ID，serviceRemoteproperties必须ServiceRemoteObject信息内容ServiceRemoteObject结构定义字段必须/可选类型描述HTTP必选ServiceDetailHTTP服务MQTT必选ServiceDetailMQTT服务ServiceDetail结构体字段名必选/可选类型参数描述state必选Integer服务启用状态：0-关闭，1-开启ip必选Integer服务地址port必选Integer服务端口username必选String账号password必选String密码connectionMode必选Integer连接方式，1-有线网络，2-无线网络，3-移动网络encryptionMode必选Integer加密方式：0-明文，1-AES-256-GCM加密2）上行参数字段名必选/可选类型参数描述code必选String站点代码，String类型的数字和字母，如：ZH11359000，且每个设备ID在当前设备中具有唯一性services必选List<ServiceProperty>设备服务数据列表（控制命令列表）packetId必须String消息ID号。String类型的数字，取值范围0~4294967295，且每个消息ID在当前设备中具有唯一性。eventTime必选Integer设备采集数据时间戳，单位毫秒，设备上报数据不带该参数或参数格式错误时，则数据上报时间以平台时间为准。ServiceProperty结构定义字段名必选/可选类型参数描述serviceId必选String属性ID，serviceRemoteproperties可选Object上报信息属性errorCode必选Interger命令的执行结果，0表示成功，其他表示失败。不带默认认为成功。errorMessage必选String命令响应描述，success标识成功示例报文示例：Topic:/v1/station/ZH11359000/commands{"packetId":"1507707025","eventTime":1645696682211,"services":[{"serviceId":"serviceRemote","properties":{"HTTP":{"state":1,"ip":"","port":80,"username":"admin","password":"EF3BD472E3FD9EFADC0E89FE3CDEC59B","connectionMode":1,