MQTT 消息参考

常见

anchor_config

领域	类型	标签	描述
启动器	bool	必填	UWB启动器模式启用。
位置	节点位置	必填	节点的位置。
使溃败	routing_config	必填	路由配置。
桥	bool	可选	UWB桥接模式启用。

节点位置

领域	类型	标签	描述
x	浮动	必填	X坐标，单位为米。
y	浮动	必填	Y坐标，单位为米。
z	浮动	必填	Z坐标，单位为米。
质量	uint32	必填	品质因数从0%到100%。
sd_x	浮动	可选	X坐标的标准偏差，单位为米。
sd_y	浮动	可选	Y坐标的标准偏差，单位为米。
sd_z	浮动	可选	Z坐标的标准偏差，单位为米。
r95	浮动	可选	R95的位置单位为米。
x_err	浮动	可选	X坐标与参考位置的误差，单位为米。
y_err	浮动	可选	Y坐标与参考位置的误差，单位为米。
z_err	浮动	可选	Z坐标与参考位置的误差，单位为米。
toa	node_toa_measurement_statistics	重复	到达时间测量统计。

节点状态

领域	类型	标签	描述
起源	origin_info	重复	起源列表。
轮廓	uwb_profile	可选	当前UWB配置文件。
uwb	uwb_status	可选	UWB状态。
传感器	传感器状态	可选	传感器的状态。
route_active	bool	可选	指示网关是节点的路由候选。

node_toa_measurement_statistics

领域	类型	标签	描述
anchor_id	uint32	必填	锚点ID。
sd_tdoa	浮动	必填	到达时间测量的标准偏差。

origin_info

领域	类型	标签	描述
本我	uint64	必填
hop_level	uint32	必填

传感器状态

领域	类型	标签	描述
batt	uint32	必填	电池电量（百分比）。
temp	int32	必填	温度单位为度。

服务数据

领域	类型	标签	描述
类型	service_type	必填	服务请求的类型或响应的类型。请参考 service_type。
数据	字节	可选	编码为base64的不透明服务数据字节。

tag_config

领域	类型	标签	描述
location_engine	bool	必填	内部定位引擎启用。
low_power	bool	必填	低功耗模式启用。
stationary_detection	bool	必填	静止检测启用。
update_rate_nominal	uint32	必填	标称更新率（以超帧间隔的倍数表示）。
update_rate_stationary	uint32	必填	超帧间隔倍数下的固定更新率。。
reference_location	节点位置	可选	标签的参考位置。

uwb_profile

领域	类型	标签	描述
sfn_range	uint32	必填	超帧编号范围。
microseconds_per_sf	uint32	必填	每超帧微秒。
microseconds_per_slot	uint32	必填	每个插槽微秒。
update_rate_default	uint32	必填	更新率是超帧的倍数。
uplink_latency	uint32	可选	在内部位置引擎处理已接收到的到达时间数据之前等待的时隙数。
node_signup_optional	bool	可选	将此设置为 “true” 意味着任何边缘节点（非网关节点）都不需要注册，如果未设置此参数或将其设置为 “false”，则默认情况下需要注册。
延迟	uint32	可选	以太网延迟以超帧数表示，在发送下行链路时考虑延迟，如果未设置，则延迟应为0
max_buffer_size_downlink	uint32	可选	如果没有设置，大小应该是无限的。

version_info

领域	类型	标签
maj	uint32	必填
min	uint32	必填
patch	uint32	必填
var	uint32	可选

wifi_config

领域	类型	标签
ssid	字符串	必填
密码	字符串	必填
地区	wifi_region	可选

interface_config

名称	编号	描述
ETHERNET	0
WIFI	1

mac_address_type

名称	编号	描述
空的	0	MAC地址为空，表示接口不存在。
违约	1	默认MAC地址（无法更改）。
USER_SPECIFIED	2	用户指定的MAC地址（可以更改）。
MUTABLE_DEFAULT	3	默认MAC地址，用户只能更改一次。

routing_config

名称	编号	描述
ROUTING_OFF	0	UWB路由已关闭。
ROUTING_ON	1	UWB路由处于活动状态。
ROUTING_AUTO	2	自动UWB路由。

service_type

名称	编号	描述
GET_CONFIG	0	请求发送配置。
TLV_API_CMD	1	TLV API命令。
TLV_API_ACK	2	TLV API命令肯定确认。
TLV_API_NACK	3	TLV API命令否定确认。

tls_config

名称	编号	描述
关闭	0	TLS/SSL已关闭。
服务器	1	服务器的TLS身份验证。
相互的	2	服务器和网关/客户端的双向TLS身份验证。
SERVER_CN	3	通过检查“公用名称”对服务器进行TLS身份验证。
MUTUAL_CN	4	服务器和网关/客户端的双向TLS身份验证，并检查 “通用名称”。

uwb_mode_config

名称	编号	描述
UWB_MODE_OFFLINE	0
UWB_MODE_PASSIVE	1
UWB_MODE_ACTIVE	2

uwb_status

名称	编号	描述
已断开连接	0	已断开与UWB网络的连接。
已连接	1	连接到UWB网络。
CONNECTED_BH	2	连接，回程可能。
UPDATING_FW	3	UWB固件更新正在进行中。
UWBS_INACTIVE	4	UWBS的数据没有来

wifi_region

名称	编号	描述
欧洲	0
北美	1
亚洲	2

leaps_api

leaps_api.inet_config

TCP/IP配置选项。

领域	类型	标签	描述
ip	leaps_api.ip_config	重复	IP配置。
dns	字符串	重复	DNS主机。
iface	interface_config	必填	界面选择。
tls	tls_config	必填	TLS/SSL配置。
dhcp	bool	必填	DHCP已启用？
mac_filter	bool	必填	MAC过滤器启用了吗？
服务器	leaps_api.inet_config.server_config	必填	Leaps 服务器配置。

leaps_api.inet_config.server_config

领域	类型	标签	描述
主办	字符串	必填	Leaps 服务器主机配置。
端口	uint32	必填	Leaps 服务器端口配置。

leaps_api.ip_config

领域	类型	标签	描述
地址	字符串	必填	IP地址。
面具	字符串	可选	IP地址掩码。
网关	字符串	可选	网关IP地址。

leaps_api.location

Topic: {prefix}/{panId/}node/uplink/location/{deviceId}.

领域	类型	标签	描述
位置	节点位置	必填	设备的位置
时间戳	uint64	可选	时间戳（微秒）。

leaps_api.mac_config

MAC地址的配置。

领域	类型	标签	描述
地址	字符串	必填	以点表示的MAC地址。
类型	mac_address_type	必填	MAC地址的类型。请参考 mac_address_type。
iface	字符串	必填	MAC地址所属的接口。请参阅 mac_address_interface。

leaps_api.node_config

Topic: {prefix}/{panId/}{node|gateway}/{uplink|downlink}/config/{deviceId}.

领域	类型	标签	描述
标签	字符串	必填	设备标签。
uwb_mode	uwb_mode_config	必填	UWB模式配置。
ble	bool	必填	启用BLE？
leds	bool	必填	LED已启用？
fw_update	bool	必填	固件更新已启用？
锚点	anchor_config	可选	锚的特定配置。
标签	tag_config	可选	标签特定配置。
inet	leaps_api.inet_config	可选	TCP/IP配置
wifi	wifi_config	可选	Wi-Fi配置。
mac	leaps_api.mac_config	重复	MAC地址配置。
时间戳	uint64	可选	时间戳（微秒）。

leaps_api.server_message

Leaps服务器状态上行主题：｛prefix｝/server/status。Leaps服务器请求下行链路主题：｛prefix｝/server/request。

领域	类型	标签	描述
状态	字符串	可选	Leaps服务器的状态。请参阅服务器状态。
版本	字符串	可选	Leaps服务器版本。
请求	字符串	可选	向Leaps服务器发出请求。请参阅 leaps_api.server_request。
节点列表	leaps_api.server_message.node_list	重复	Leaps服务器管理的设备列表。
网络	leaps_api.server_message.network	重复	用于向特定UWB网络发送请求的可选网络列表。如果该列表为空，则该请求将发送到服务器管理的所有已知UWB网络。

leaps_api.server_message.network

领域	类型	标签	描述
本我	uint32	可选	网络ID（PAN ID）
名称	字符串	可选	已知网络名称/别名。

leaps_api.server_message.node_list

领域	类型	标签	描述
网络	uint32	必填	UWB网络panID。
节点	字符串	重复	UWB节点ID/地址为十六进制数.

leaps_api.service_data

主题:｛前缀｝/｛panId/｝节点/｛上行链路|下行链路｝/服务/｛设备ID｝。

领域	类型	标签	描述
类型	service_type	必填	服务器数据的类型。
数据	字节	可选	编码为base64的数据字节。
时间戳	uint64	可选	时间戳（微秒）。

leaps_api.status

主题:｛前缀｝/｛panId｝/｛节点|网关｝/上行链路/状态/｛设备ID｝。

领域	类型	标签	描述
现在	bool	必填	设备是否存在或缺失？
下行链路	bool	可选	是否可以向设备发送下行链路？
uwb	uwb_status	可选	UWB层的状态。
batt	uint32	可选	电池状态（百分比）。
temp	int32	可选	温度单位为度。
起源	origin_info	重复	UWB起源列表。
轮廓	uwb_profile	可选	当前UWB配置文件状态。
时间戳	uint64	可选	时间戳（微秒）。

leaps_api.user_data

主题:｛前缀｝/｛panId｝/节点/｛上行链路|下行链路｝/数据/｛设备ID｝。

领域	类型	标签	描述
数据	字节	必填	编码为base64的数据字节。
重写	bool	可选	Overwrite the pending data?
时间戳	uint64	可选	时间戳（微秒）。

leaps_api.mac_address_interface

在MAC地址配置方面支持的接口。

名称	编号	描述
UWB	0
BLE	1
ETHERNET	2
WIFI	3

leaps_api.server_request

Leaps服务器请求下行链路主题:｛prefix｝/server/request。

名称	编号	描述
服务器请求	0	DEPRECATED: 与 PUBLISH_ALL_TOPICS 相同
PUBLISH_NODE_LIST	1	发布当前节点列表.
PUBLISH_ALL_TOPICS	2	请求立即发布所有节点的所有消息.

leaps_api.server_state

名称	编号	描述
已断开连接	0	Leaps服务器已关闭.
已连接	1	Leaps服务器已准备就绪并正在运行.

领域	类型	标签	描述
发布	version_info	可选	发布版本。
固件	version_info	重复	固件的版本。