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

ICS

XXX

T/CEC

中国电力企业联合会团体标准

T/CECXXXX--XXXX

北斗卫星电力应用综合服务平台

接口规范

InterfaceSpecificationforBeidouSatelliteApplicationIntegratedServicePlatform

（草案）

××××-××-××发布××××-××-××实施

中国电力企业联合会发布

GB/T××××—××××

目录

前  言..............................................................................................................................错误！未定义书签。

引  言..............................................................................................................................错误！未定义书签。

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

1范围.............................................................................................................................................................1

2规范性引用文件........................................................................................................................................1

3术语和定义和缩略语................................................................................................................................1

3.1术语和定义.....................................................................................................................................1

3.2缩略语.............................................................................................................................................3

4总则.............................................................................................................................................................4

1.1接口连接关系................................................................................................................................4

1.2接口功能列表................................................................................................................................5

5基准站接入................................................................................................................................................7

5.1逻辑架构.........................................................................................................................................7

5.2通信协议.........................................................................................................................................7

6终端接入.....................................................................................................................................................9

6.1通信接入.........................................................................................................................................9

6.2数据接入.........................................................................................................................................9

7安全管理..................................................................................................................................................10

7.1网络边界安全防护.......................................................................................................................10

7.2应用接口安全防护.......................................................................................................................11

7.3数据安全防护...............................................................................................................................13

附录A（规范性附录）设备类型标准编码..........................................................................................15

附录B（规范性附录）基准站接入要求..............................................................................................16

附录C（规范性附录）设备接入数据样例........................................................................................129

II

T/CEC××××—××××

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

1范围

本标准规定了北斗卫星电力应用综合服务平台接口要求、数据安全技术要求，北斗卫星电力应用

综合服务平台数据格式、传输协议。

本标准适用于北斗卫星电力应用综合服务平台与电力北斗基准站间的接口关系、接口协议及数据

传输。

2规范性引用文件

下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅注日期的版本适用于本文

件。凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。

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（Global

NavigationSatelliteSystems）Services-Version3.2）

3术语和定义和缩略语

3.1术语和定义

GB/T39267-2020和BD440013-2017界定的术语以及下列术语适用于本文件。

1

GB/T××××—××××

3.1.1基准站referencestation

由接收机和天线等设备组成，用于观测、存储、传输卫星信号数据，并具有基准坐标。

3.1.2数据播发系统databroadcastingsystem

使用移动通信、数字广播、卫星播发等多种手段播发差分数据产品的系统。

3.1.3数据处理平台dataprocessingsystem

由数据接收系统、数据存储系统、数据处理系统、数据播发系统组成，完成对基准站原始观测数

据的综合处理，形成和播发差分增强数据产品的系统。

3.1.4北斗地基增强系统BeiDouground-basedaugmentationsystem

由地面基准站和数据处理平台组成。地面基准站网络实时接收卫星原始观测数据，通过数据通信

网络将这些基准站观测数据传输至一个或多个数据处理平台，计算误差改正信息，生成分米级、厘米

级等差分数据产品，并将数据产品提供给用户终端和其他数据处理系统。数据处理平台中的数据播发

系统通过地面通信网络向用户播发差分改正信息，提高用户定位导航精度。

3.1.5差分定位differentialpositioning

一种提高卫星导航定位精度的技术。在已知点上设置卫星导航基准接收机，根据由此获得的卫星

导航观测值或误差修正量，实时或事后提供给差分用户设备，使用户设备接收并利用修正量以提高其

定位精度。

3.1.6实时动态测量real-timekinematic（RTK）

GNSS差分定位技术的一种，主要通过基准站和用户端之间的实时数据链路和载波相对定位快速

解算技术，实现高精度动态相对定位。

3.1.7广域差分wideareadifferentialGNSS

在较大区域内提高GNSS定位性能的一种技术。利用布设在较大区域内的多个GNSS基准站，监

测视野内的GNSS卫星，通过集中数据处理，分类获得误差改正参数和完好性信息，并发送给用户，

使用户获得较高定位性能。误差改正参数通常包括星历误差改正、卫星钟误差改正和电离层延迟改正

参数等。

3.1.8区域差分localareadifferentialGNSS

在较小区域内提高GNSS定位性能的一种技术。该技术通过一个或多个GNSS基准站的观测值为

区域用户进行的差分定位。

2

T/CEC××××—××××

3.1.9差分数据dataproductofdifferentialGNSS

又称差分改正数据。各类用于修正用户接收机观测值的伪距观测值、载波相位观测值、多普勒观

测值、卫星信息、坐标转换信息、轨道信息等数据统称为差分数据。

3.1.10差分电文differentialmessage

将差分数据按照规定格式排列，加上前缀符、数据长度、校验等信息后形成的二进制数据流。每

条电文都具备一个标识字段，称为电文类型号。

3.2缩略语

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

GNSS：全球卫星导航系统（GlobalNavigationSatelliteSystem）

NTRIP：基于互联网的RTCM数据传输协议(NetworkedTransportofRTCMViaInternetProtocol)

BDS：北斗卫星导航系统（BeiDouNavigationSatelliteSystem）

BDT：北斗时（BDSSystemTime）

RTCM：海事无线电技术委员会（RadioTechnicalCommissionforMaritimeServices）

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）

3

GB/T××××—××××

IGS：国际GNSS服务（InternationalGNSSService）

IOD：数据龄期（IssueOfData）

IODE：星历数据龄期（IssueOfDataEphemeris）

ITRF：国际地球参考框架（InternationalTerrestrialReferenceFrame）

TCP/IP：传输控制/网络通信协议（TransmissionControlProtocol/InternetProtocol）

4总则

为适应北斗卫星电力应用综合服务平台设计，提高基准站、终端设备与北斗卫星电力应用综合服

务平台数据传输的可靠性和安全性，规范平台接口建设实施，特制定本标准要求。

本标准对接口关系、数据格式及数据传输安全技术要求等进行了规定，各类基准站接收机、终端

设备等数据采集设备的数据格式设计、数据传输设计、生产制造及数据传输规定应符合本技术要求规

定。北斗卫星电力应用综合服务平台涉及的基准站接收机、各类用户终端设备产品制造除符合本规范

规定外，还应符合相应国家标准、行业标准的要求。

1.1接口连接关系

系统数据接口包括与基准站之间的接口、与其他行业数据处理系统的接口、与北斗卫星电力应用

综合服务平台之间的接口，连接关系如下图所示：

4

T/CEC××××—××××

1.2接口功能列表

序号分类接口名称接口流向备注

指物联网平台对接入平台的设备进行身

1权限认证设备鉴权基准站->定位平台

份认证

2系统信息上报基准站->定位平台用于基准站向定位平台上报系统信息

3系统信息硬件状态上报基准站->定位平台用于基准站向定位平台上报硬件状态

5网络状态上报基准站->定位平台用于基准站向定位平台上报网络状态

用于定位平台向基准站发送授权注册控

6授权注册控制定位平台->基准站

制命令

系统控制

用于定位平台向基准站发送系统电源控

7系统电源控制定位平台->基准站

制命令

用于定位平台向基准站发送固件升级控

8固件升级控制定位平台->基准站

制命令

固件升级

9固件升级上报基准站->定位平台用于基准站向定位平台上报升级状态

10工作模式工作模式上报基准站->定位平台用于基准站向定位平台上报工作模式

5

GB/T××××—××××

11工作模式获取定位平台->基准站用于定位平台向基准站获取工作模式

用于定位平台向基准站发送工作模式设

12工作模式设置定位平台->基准站

置命令

13天线参数上报基准站->定位平台用于基准站向定位平台上报天线参数

14天线参数获取定位平台->基准站用于定位平台向基准站获取天线参数

天线参数

用于定位平台向基准站发送天线参数设

15天线参数设置定位平台->基准站

置命令

16卫星系统上报基准站->定位平台用于基准站向定位平台上报卫星系统

17卫星系统获取定位平台->基准站用于定位平台向基准站获取卫星系统

卫星系统

用于定位平台向基准站发送卫星系统设

18卫星系统设置定位平台->基准站

置命令

差分数据格式获用于定位平台向基准站获取差分数据格

19定位平台->基准站

取式

差分数据格式设用于定位平台向基准站发送差分数据格

20定位平台->基准站

置式设置

导航数据格式获用于定位平台向基准站获导航分数据格

21定位平台->基准站

取式

卫星数据

导航数据格式设用于定位平台向基准站发送导航数据格

22定位平台->基准站

置式设置

原始数据格式获用于定位平台向基准站获取原始数据格

23定位平台->基准站

取式

原始数据格式设用于定位平台向基准站发送原始数据格

24定位平台->基准站

置式设置

25数据传输上报基准站->定位平台用于基准站向定位平台上报数据传输

26数据传输获取定位平台->基准站用于定位平台向基准站获取数据传输

数据传输

用于定位平台向基准站发送数据传输控

27数据传输设置定位平台->基准站

制命令

28数据采集上报基准站->定位平台用于基准站向定位平台上报数据采集

29数据采集获取定位平台->基准站用于定位平台向基准站获取数据采集

数据采集

用于定位平台向基准站发送数据采集控

30数据采集设置定位平台->基准站

制命令

6

T/CEC××××—××××

5基准站接入

5.1逻辑架构

认证管理、基本配置信息、运行信息、主机配置和数据配置应符合附录B的规定。

5.2通信协议

5.2.1协议约定

基准站协议约定示意图见图1。

图1基准站协议约定示意图

a)观测数据，基准站使用NTRIPV2.0协议向数据中心上传差分或者原始数据，一秒一包评率上

传，TCP长连接；

b)静态信息，基准站以RESTfulAPI方式向运维管理平台低频上传，开机上传一次，TCP短连接；

c)状态数据，基准站以FESTfulAPI方式向运维管理平台高频上传，不同命令不同频率上传，TCP

短连接；

d)控制命令，运维管理平台部署在网省的远程控制服务以RESTfulAPI方式向基准站发起请求，

TCP短连接。

5.2.2协议结构

除NTRIP登录请求本身是HTTP协议外，其它数据传输都应增加HTTP协议头。接口访问方式

NTRIPV2.0使用通用技术规范。

7

GB/T××××—××××

5.2.3RESTful消息体格式

RESTfulAPI消息体需采用JSON格式，HTTPHearder内需指定参数如下：

Content-Type:application/json

数据中心获取到Token后，接口请求的Header中需要携带Token，格式固定为：

-X-Auth-Token:{认证接口发放的Token}

5.2.4RESTful变量类型定义

RESTfulAPI遵循JSON格式的类型定义，包括以下几个类型：

数值型（Number）：分为整数型（Integer）和浮点型（Float），均为十进制数值，长度用bit表

示。当必选指标无法确定取值时，如无特殊说明，取默认值-1；

字符串型（String）：零个或多个字符，长度用char表示。当必选指标无法确定取值时，如无特

殊说明，取默认值""；

布尔型（Boolean）：true或false，长度为1bit。当必选指标无法确定取值时，如无特殊说明，取

默认值false；

数组型（Array）：包含零个或多个值，值可以是数组型或其它类型，有顺序。当必选指标无法确

定取值时，如无特殊说明，取默认值[]；

对象型（Object）：Key-Value集合，无顺序。当必选指标无法确定取值时，如无特殊说明，取默

认值{}；

除此之外，还存在几种特殊类型的变量：

a)时间日期格式的数值视为字符串型；

b)枚举类型的变量约束了取值范围，但是变量的值最终还是归为上述几种类型。

5.2.5RESTful日期时间格式

接口服务器必须采用当地标准时间，中国大陆地区采用UTC+8（北京标准时间）。

如无特殊说明，接口中时间类字段数据格式统一为YYYY-MM-DDhh:mm:ss,如：

2017-07-2019:15:00。

5.2.6状态码

状态码说明表见表1。

8

T/CEC××××—××××

表1状态码说明表

CodeShorttextDescription

200OKeverythingwasfine

401UnauthorizedNoorwrongauthorization

404NotFoundMountpointofrequestnotfound

409ConflictMountpointalreadyinusebyanotherNtripServe

6终端接入

6.1通信接入

6.1.1HTTP接入

数据RESTful接口原则，采用Post方式上传。url中引入参数作为设备解析数据信息。

6.1.2MQTT接入

数据宜采用小端方式进行组织。

通信Topic由平台提供，作为数据解析准则。

采用设备标识符作为用户名，进行数据校验。

6.1.3CoAP接入

数据采用Post方式上传。url中引入参数作为设备解析数据信息。

url由下面两部分组成：

a)服务端IP和端口由平台提供；

b)url路径描述：api/v1/{配置项}/{设备编码}/telemetry,“配置项”由平台提供，“设备编码”

为设备唯一标识符，作为数据接入准则。

6.2数据接入

6.2.1JSON数据格式接入

浮点型无效数据传输使用NAN。关键字段类型和key值见表2。

表2关键字段类型和key值表

序号类型KEY参数说明单位

9

GB/T××××—××××

1Stringdevice_type设备类型--

2Stringdevice_sn设备编号--

3Int64ts采集时间ms

4doublelng经度--

5Stringlng_dir经度方向--

6doublelat纬度--

7Stringlat_dir纬度方向--

8intalarm_type告警类型--

9intpos_type定位类型--

10intstate设备状态--

11intpos_mode定位模式--

12intpower_supply供电类型--

13intsource_rtk数据来源--

14floatbettery电池电量--

6.2.2字节流数据格式接入

字节流数据采用小端数据接入。

无效数据采用十六进制”FF”作为传输数据。

7安全管理

平台的安全管理标准分为网络边界安全防护标准、主机安全防护标准、业务应用安全防护标准、

数据安全防护标准、终端安全防护标准。

7.1网络边界安全防护

7.1.1边界类型

平台存在的网络边界有：

a)管理信息大区横向边界。

10

T/CEC××××—××××

b)北斗卫星服务与安全接入区边界。

c)安全接入区与外网边界。

d)管理信息大区纵向边界。

平台边界类型见表3。

表3平台边界类型表

边界类型边界描述

管理信息大区横向边界管理信息大区等级保护二级域与三级域间边界

北斗卫星服务与安全接入区边界北斗卫星服务接入与安全接入区边界

管理信息大区纵向边界总部管理信息大区与网省管理信息大区的边界

7.1.2边界安全防护

相关管理员应明确网络边界，建立边界网络接口清单并定期进行审查复核。各个边界采取的安全

防护措施为：

a)管理信息大区横向边界安全

利用信息内网现有安全域边界的防火墙设备进行访问控制，配置访问控制策略。在网络边界对跨

越边界传输的信息进行内容过滤，对应用层数据流进行有效的监视和控制。

利用信息内网现有安全域边界的入侵检测系统对流经边界的信息流进行入侵检测，基于对外提供

的服务类别（如HTTPS、DNS等）进行入侵防护。配置入侵检测探头策略，并对日志进行分析审计。

b)北斗卫星服务与安全接入区边界安全

利用现有部署防火墙、IDS、IPS、网页防篡改设备、防病毒网关等设备，进行边界安全防护。

非公司信息内网区域信息采集类、移动作业类终端以安全专网方式接入信息内网，必须通过安全

接入平台进行安全认证接入，建立专用加密传输通道，实现终端身份认证、安全准入和数据安全交换，

结合各业务实际需求开放端口。

c)安全接入区与外网边界安全

利用现有安全接入网关，实现移动终端用户接入认证和安全防护。

d)管理信息大区纵向边界安全

利用现有部署防火墙、IDS、IPS、网页防篡改设备、防病毒网关等设备，进行边界安全防护。

7.2应用接口安全防护

11

GB/T××××—××××

a)身份鉴别

信息内网用户通过部署于信息内网的权限系统进行用户登录认证（用户名+口令方式）。

b)授权

采用角色控制，限制用户对系统级资源的访问。

系统管理员角色仅有对系统管理的权限，没有任何业务权限。

对操作方面的权限控制采用前端展现和后端（服务器）共同进行访问控制。

对系统资源访问控制方面采用统一的鉴权接口。

c)输入输出验证

系统对用户在客户端输入或导入的数据进行长度、范围、数据类型等属性的合法性进行检验，对

不合法的数据禁止输入，并且提示明确的错误信息。

各模块设置了保护内部输入、输出和存储期间的用户数据，以及和用户直接相关的安全属性。对

于输入框的长度类型做限制。业务数据直接存储在数据库中，敏感信息采用加密方式存储。

针对特殊字符进行检测，例如单引号、1=1、CDATA、分号、for、loop等，防止XML注入、SQL

注入及脚本注入攻击。

通过严格限制客户端可提交的数据类型以及对提交的数据进行有效性检查等有效措施防止跨站脚

本攻击。

在系统页面通过脚本对用户输入的信息进行规则匹配，异步检测等验证过滤操作防止跨站脚本攻

击。

在系统业务处理层使用代码规则验证以及数据查找比对的真实性验证防止跨站脚本攻击。

d)配置管理

配置使用最少特权进程和服务帐户，各项配置信息对非管理员账户不可读。

通过目录权限确保配置存储的安全。

用户授权等配置管理功能只允许管理员角色操作。

单独分配管理特权。

禁止通过web页面直接浏览服务端的目录和文件。

制定严格的配置变更管理流程，系统关键信息例如数据库连接、运行参数、模板信息等发生配置

变更时，需由相关负责人进行审批确认。

设置配置信息的保存及版本控制规则，避免发生版本丢失或混淆。

12

T/CEC××××—××××

使用基于角色的授权策略控制配置管理角色，控制配置权限粒度，配置管理功能只能由经过授权

的操作员和管理员访问。

e)会话管理

每次系统登录成功使用新的会话。

关闭网页客户端自动会话的安全终止。

在服务端保存会话认证信息和会话有效期，当登录成功后清除旧的会话创建新会话。

设置会话存活时间为30分钟，超时后自动销毁用户会话，删除会话信息。

在服务端进行会话信息存储，对用户登录信息及身份凭证进行加密传输。

用户登录后界面提供退出、注销功能。

用户注销后，服务端自动清除用户会话。

f)加密技术

用户密码采用SM4算法加密后进行传输，然后再使用哈希算法进行二次处理后保存。

敏感数据采用SM4算法加密后进行传输或保存。

g)参数操作

每次请求都进行安全检查，确保用户没有绕过检查，确保用户查询的数据是权限范围内的数据。

利用拦截器验证从客户端发送的所有数据，对数据进行安全检查，根据过滤规则截获敏感字符，

并对其进行替换或转义。

配置数据更新操作记录日志，同时对用户行为进行流程化操作限制。

h)异常管理

对终端用户屏蔽系统异常，使用通用错误信息，将系统抛出的异常信息写入日志文件。

程序发生异常时，终止当前业务，并对当前业务进行回滚操作，保证业务的完整性和有效性，必

要时注销当前用户会话。

i)应用交互安全

通过标准的WebService/HTTP接口与第三方系统集成。

基于XML或JSON与第三方系统交互数据，通过WebService/HTTP方式传输。

各种收发数据、消息的日志按日期将业务系统使用过程中输入输出、错误等进行存储。

对于跨站脚本攻击风险，对系统源代码进行源代码扫描和渗透测试，确保没有跨站脚本攻击风险

隐患。

7.3数据安全防护

13

GB/T××××—××××

a)数据存储安全

数据库连接用户权限最小。

应用系统配置文件中的数据库用户名、密码加密存储。

在数据集成时，为不同的业务系统分配不同的权限，每个账号仅能访问授权的数据视图。

b)数据传输安全

在系统之间传输数据通过WebService/HTTP方式传输。

在系统内部传递默认为POST请求提交，如果用GET方式提交参数必须加密过后进行传输。

用户口令传输进行加密。

c)数据备份安全

支持多台设备之间数据实时同步。

通过数据库实时备份工具，实现主库到备库的实时备份。

14

T/CEC××××—××××

附录A

（规范性附录）

设备类型标准编码

设备类型标准编码应符合表A.1的要求。

表A.1设备类型标准编码

序号名称设备类型

1北斗智能手持终端ESM002

2轨迹监测装置PCM001

3北斗杆塔倾斜形变监测设备PCS001

4北斗工卡PHM001

5北斗车载终端PHM002

6北斗地址监测站PMS002

7北斗安全帽PSM001

8北斗智能间隔棒PCM002

15

××××—××××

BT/CEC

附录B

（规范性附录）

基准站接入要求

B.1认证管理

B.1.1设备鉴权

1.功能描述

平台设备侧支持MQTT协议的connect消息接口，在传输层上使用SSL/TLS进行加密传输，鉴权通过

后建立设备与平台间的MQTT连接。

2.参数说明

字段必须/可选类型参数描述

ClientId可选String一机一密的设备clientId

Username可选String设备ID

Password必选String加密后的设备密钥

3.鉴权流程

16

T/CEC××××—××××

B.2基本配置信息

B.2.1数据模型

数据模型用于描述产品的功能，是物理空间中的实体（如传感器、车载装置、楼宇、工厂等）在

云端的数字化表示，从属性、服务和事件三个维度，分别描述了该实体是什么、能做什么、可以对外

提供哪些信息。定义了数据模型的这三个维度，即完成了产品功能的定义。

功能类型说明

设备可读取和设置的能力。一般用于描述设备运行时的状态，如环境监测设备所读

属性

取的当前环境温度等。属性支持GET和SET请求方式。应用系统可发起对属性的

（Property）

读取和设置请求。

设备可被外部调用的能力或方法，可设置输入参数和输出参数。产品提供了什么功

服务（Service）能供云端调用。相比于属性，服务可通过一条指令实现更复杂的业务逻辑，如执行

某项特定的任务。

设备运行时，主动上报给云端的事件。事件一般包含需要被外部感知和处理的通知

事件（Event）信息，可包含多个输出参数。例如，某项任务完成的信息，或者设备发生故障或告

警时的温度等，事件可以被订阅和推送。

17

T/CEC××××—××××

B.2.2消息主题

设备使用MQTT协议接入平台时，平台和设备通过Topic进行通信。平台预置了TOPIC，通过这些

预置的Topic，平台和设备可以实现属性、命令、事件的交互。

数据消息PublicSubscriber

主题说明

类型类型（发布者）（订阅者）

设备

/v1/station/propert用于设备按产品定义的格式将

属性设备平台

ies/report属性数据上报给平台

上报

平台

查询/v1/station/{code}/

平台设备用于平台查询设备属性

属性设备properties/get

相关属性

设备

返回

/v1/station/propert

属性设备平台用于设备返回属性查询结果

ies/get/response

查询

响应

平台

/v1/station/{code}/

下发平台设备用于平台下发命令，控制设备

commands

命令

命令

相关设备

返回/v1/station/command

设备平台用于设备返回命令控制结果

命令s/response

响应

事件事件/v1/station/events/设备运行时，主动上报给云端

设备平台

相关上报report的事件

B.2.3消息格式

MQTT消息体采用JSON格式进行封装，具体内容信息参考设备属性、服务、事件命令。

命名规划采用camelCase标准，例如code、stationModel。

B.2.4通信协议

北斗平台设备数据接入通信协议采用MQTT，兼容V3.X版本。

B.2.5变量类型定义

数值型（Number）：分为整数型（Integer）和浮点型（Float），均为十进制数值，长度用bit

表示。当必选指标无法确定取值时，如无特殊说明，取默认值-1；

18

T/CEC××××—××××

字符串型（String）：零个或多个字符，长度用char表示。当必选指标无法确定取值时，如无特殊

说明，取默认值""；

布尔型（Boolean）：true或false，长度为1bit。当必选指标无法确定取值时，如无特殊说明，取默

认值false；

数组型（Array）：包含零个或多个值，值可以是数组型或其它类型，有顺序。当必选指标无法确

定取值时，如无特殊说明，取默认值[]；

对象型（Object）：Key-Value集合，无顺序。当必选指标无法确定取值时，如无特殊说明，取默

认值{}；

除此之外，还存在几种特殊类型的变量：

时间日期格式的数值视为字符串型

枚举类型的变量约束了取值范围，但是变量的值最终还是归为上述几种类型

B.2.6日期时间格式

接口统一采用当地标准时间，中国大陆地区采用UTC+8（北京标准时间）。

如无特殊说明，接口中时间类字段数据格式统一为YYYY-MM-DDhh:mm:ss,如：2017-07-20

19:15:00。

B.2.7状态码值定义

状态码值定义，如下表所示：

状态码状态码描述原因

0x00连接成功连接成功

请求拒绝，协议版

0x01服务器不支持客户端请求MQTT协议版

本错误

请求拒绝，无效的

0x02clientId不符合格式要求或者心跳时间间隔不满足平台要求

客户端标识符

请求拒绝，服务器

0x03平台服务不可用

不可用

请求拒绝，用户名

0x04用户名或密码错误

或密码错误

请求拒绝，没有授

0x05客户端没有权限连接

权

19

T/CEC××××—××××

B.3运行信息

B.3.1系统信息上报

1.功能描述

基准站接收机每天生成一次接收机系统状态信息上报到定位平台，固定上报时间为北京时间8点，

如果状态信息有变更，则主动及时生成上报。

2.Topic

上行：/v1/station/properties/report

3.参数说明

字段名必选/可选类型参数描述

站点代码，String类型的数字和字母，如：

code必选StringZH11359000，且每个设备ID在当前设

备中具有唯一性

设备采集数据时间戳，单位毫秒，设备上

eventTime必选Integer报数据不带该参数或参数格式错误时，则

数据上报时间以平台时间为准。

设备服务数据列表，多个服务数据可合并

services必选List<ServiceProperty>

上报

ServicesProperty结构定义

字段名必选/可选类型参数描述

serviceId必选String服务ID，systemInfo

properties必须SystemObject信息内容

SystemObject结构定义

字段必须/可选类型描述

name可选String站点名称：广州桥南站

address可选String站点地址：广州市番禺区

设备类型：0-未知型接收机；

type必选Integer

1-授时型接收机

20

T/CEC××××—××××

2-导航型接收机；

3-测地型接收机；

4-测量型接收机；

5-监测型接收机；

manufacturer必选String设备厂商：Hi-TARGET

model必选String设备型号：VNet8U-I

设备编号，11360896，各厂家内部设备唯一标

serialnumber必选Stri