SYS

重置

Reboot the system. The reset command immediately initiates a system reboot. Upon execution, the system will restart. The message reset ok confirms that the command has been received and executed.

示例:

leaps> reset
reset ok

备注

  • Unsaved data will be lost.

  • The system will be unavailable until the reboot completes.

frst

Performs a factory reset, restoring the system to its original default configuration.

The frst command initiates a factory reset of the system. All user settings, configurations, and stored data are erased, and the system is restored to its out-of-box state. The message frst ok confirms that the command has been received and executed.

示例:

leaps> frst
frst ok

备注

  • This action is irreversible. All user data and custom settings will be permanently lost.

  • The system may automatically reboot after the factory reset completes.

  • Ensure any critical data is backed up before issuing this command.

si

The output provides detailed information about system status, configuration, UWB (Ultra-Wideband) parameters, connectivity, and enabled features at startup.

示例:

  • Firmware & System Information

    • Release Version: LEAPS RTLS v1.2.0-5eea93

    • Main Firmware Version: x02070001

    • Configuration Version: x01040000

    [000028.104 INF] release: LEAPS RTLS v1.2.0-5eea93
[085136.177 INF] sys: main main_ver=x02070001 cfg_ver=x01040000 ...

  • System Status

    • Battery: No battery (0 mV), no charger detected

    • Board Type: LC14_B

    • Product Type: LC14_B

    • Power Cycle Count: 0

    • Reset Count: 6

    [085136.177 INF] sys: main main_ver=x02070001 cfg_ver=x01040000 batt=empty:0mV:NoCharger board=LC14_B prod=LC14_B pwr_cnt=0 rst_cnt=6

  • UWB Radio Configuration

    • Channel: 5

    • PRF (Pulse Repetition Frequency): 64 MHz

    • Preamble Length: 128

    • PAC Size: 8

    • TX Code / RX Code: 9 / 9

    • Data Rate: 6.8 Mbps

    • PHR Mode: Extended

    • PHR Rate: Standard

    • SFD Type: IEEE 4a

    • SFD Timeout: 129

    • STS Mode: Off

    • STS Length: 64

    • PDOA Mode: Mode 0

    These parameters must match across all devices in the same RTLS network to ensure proper communication and ranging accuracy.

    [000028.105 INF] uwb: ch5 prf64 plen128 pac8 txcode9 rxcode9 baud6800 phrmodeext phrratestd sfdtypeieee4a sfdto129 stsmodeoff stslen64 pdoamodem0

  • UWB Device RF Settings

    • TX Power: x34 / xDADADADA

    • Signal Strength (STS/SHR/PHR/DATA): 24.6 dB

    • Compliance: FCC / ETSI

    • PG Count: 238

    • Temperature: 25°C

    • LNA (Low Noise Amplifier): Enabled

    • PA (Power Amplifier): Disabled

    • RF Paths: RF1 enabled, RF2 disabled

    • Crystal Trim: 32

    • TX Delay: 16431

    • RX Delay: 16431

    Regulatory compliance is required based on the deployment region. Verify which standard applies before operation.

    Adjust TX power and RF settings if operating conditions change.

    [000028.106 INF] uwb: tx_pwr=x34/xDADADADA sts:shr:phr:data=24.6:24.6:24.6:24.6[dB] cpl=FCC/ETSI pgcnt=238 temp=25
[000028.107 INF] uwb: lna=1 pa=0 rf1=1 rf2=0 xtaltrim=32 tx_delay=16431 rx_delay=16431

  • UWB Network Identification

    • PAN ID: x1234

    • PAN ID Mask: xFFFF

    • Device Address: xDECA7561EB60D9B9

    Ensure all devices in the same network share the same PAN ID. The address must be unique for each device.

    [000028.110 INF] uwb: panid=x1234(sys_cfg=x1234) panid_mask=xFFFF addr=xDECA7561EB60D9B9

  • Operating Mode

    • Mode: tn (Tag Node)

    • Supported Modes: act, twr, np, le

    • uwb (0-off,1-pasv,2-act)

      • off - UWB radio disabled

      • pasv - Passive mode (listen only, no transmissions)

      • act - Active mode (UWB active)

    • mode (0-twr,1-ul-tdoa,2-dl-tdoa)

      • twr - Two-Way Ranging (both ways ranging between devices)

      • ul-tdoa - Uplink Time Difference of Arrival (tags transmit, anchors receive)

      • dl-tdoa - Downlink Time Difference of Arrival (anchors transmit, tags receive)

    • Mode of operations

      • TN: Tag Node - Mobile node with moving location - It uses Anchors to measure, locate its position and depending on the mode it can exchange data at a specified update rate.

      • AN: Anchor Node - Infrastructure node with fixed location - reference node capable of measuring location data, data offload and routing.

      • ANI: Anchor Node Initiator - Network Initiator and timekeeper.

    [000028.126 INF] mode: tn (act,twr,np,le)

  • MAC & Connectivity

    • UWBMAC: Connected (Profile 2 – manual)

    • Backhaul (bh): Disconnected

    [000028.127 INF] uwbmac: connected prof=2 (auto)
[000028.127 INF] uwbmac: bh disconnected

  • Device Configuration

    • Synchronization: Disabled

    • Firmware Update: Enabled

    • BLE: Enabled

    • LEDs: Enabled

    • Location Engine: Enabled

    • Low Power Mode: Disabled

    • UWB Auto-Bridge: Enabled

    • Stationary Detection: Enabled (Sensitivity: 2)

    • Mode: 0

    • Update Rate (Normal): 1

    • Update Rate (Stationary): 50

    • Device Label: IDD9B9

    Adjust update rates and stationary detection sensitivity depending on use case (e.g., asset tracking vs. real-time positioning).

    [000028.152 INF] cfg: sync=0 fwup=1 ble=1 leds=1 le=1 lp=0 uab=1 stat_det=1 (sens=2) mode=0 upd_rate_norm=1 upd_rate_stat=50 label=IDD9B9

  • Security & Encryption

    • Encryption: Disabled

    Ensure encryption keys are properly configured across devices to maintain secure communication.

    [000028.152 INF] enc: off

  • Bluetooth Low Energy (BLE)

    • BLE Address: D4:35:94:99:56:F9

    Use this address for BLE-based provisioning, diagnostics, or integration with mobile applications.

    [000028.153 INF] ble: addr=D4:35:94:99:56:F9

Example: TN device with UWB profile 2 (auto).

leaps> si
[000028.104 INF] release: LEAPS RTLS v1.2.0-5eea93
[000028.104 INF] sys: main main_ver=x02070001 cfg_ver=x01040000 batt=empty:0mV:NoCharger board=LC14_B prod=LC14_B pwr_cnt=0 rst_cnt=2
[000028.105 INF] uwb: ch5 prf64 plen128 pac8 txcode9 rxcode9 baud6800 phrmodeext phrratestd sfdtypeieee4a sfdto129 stsmodeoff stslen64 pdoamodem0
[000028.106 INF] uwb: tx_pwr=x34/xDADADADA sts:shr:phr:data=24.6:24.6:24.6:24.6[dB] cpl=FCC/ETSI pgcnt=238 temp=25
[000028.107 INF] uwb: lna=1 pa=0 rf1=1 rf2=0 xtaltrim=32 tx_delay=16431 rx_delay=16431
[000028.110 INF] uwb: panid=x1234(sys_cfg=x1234) panid_mask=xFFFF addr=xDECA7561EB60D9B9
[000028.126 INF] mode: tn (act,twr,np,le)
[000028.127 INF] uwbmac: connected prof=2 (auto)
[000028.127 INF] uwbmac: bh disconnected
[000028.152 INF] cfg: sync=0 fwup=1 ble=1 leds=1 le=1 lp=0 uab=1 stat_det=1 (sens=2) mode=0 upd_rate_norm=1 upd_rate_stat=50 label=IDD9B9
[000028.152 INF] enc: off
[000028.153 INF] ble: addr=D4:35:94:99:56:F9

f

Show free memory on the heap. The f command displays the current memory usage statistics for the system heap. The output includes three values:

  • free — Amount of free (unused) memory on the heap

  • alloc — Amount of currently allocated memory

  • tot — Total heap memory available

All values are typically shown in bytes.

示例:

leaps> f

[000014.560 INF] mem: free=3888 alloc=9184 tot=13072

备注

  • Useful for monitoring memory usage and detecting leaks.

  • The timestamp and log level ([000014.560 INF]) may vary depending on system logging configuration.

stg

Displays system statistics. The stg command displays various system statistics. The following statistics are shown:

统计

描述

正常运行时间

重新启动后的系统时间（秒）

rtc_drift

估计RTC相对于UWB网络时钟的漂移（在生产过程中使用）

ble_con_ok

每个BLE连接事件都会增加此计数器

ble_dis_ok

每个BLE断开连接事件都会增加此计数器

ble_err

标识最后一个内部BLE错误的编号

api_err

标识最后一个内部API错误的编号

api_err_cnt

API 错误计数器

api_dl_cnt

通过API接收的回程下行链路数据包的数量（仅限GN）

uwb0_intr

DW1000的中断次数

uwb0_rst

重置DW1000以从错误中恢复的尝试次数

uwb0_bpc: 1

带宽/温度补偿数量

rx_ok

按时接收的次数

rx_err

无法按时接收的失败次数

tx_err

按时启用传输的失败次数

tx_errx

与TX缓冲区相关的错误数

bcn_tx_ok

发射的信标数量

bcn_tx_err

信标传输过程中的失败次数

bcn_rx_ok

接收到的信标数量

alma_tx_ok

传输的历书数量

alma_tx_err

历书传输过程中的失败次数

alma_rx_ok

收到的年鉴数量

cl_rx_ok

接收到的群集加入数

cl_tx_ok

已传输的群集加入数

cl_coll

检测到的群集冲突数

fwup_tx_ok

传输的固件更新帧数

fwup_tx_err

传输固件更新帧失败的次数

fwup_rx_ok

接收到的固件更新帧数

svc_tx_ok

传输的服务帧数量

svc_tx_err

传输服务帧失败的次数

svc_rx_ok

接收到的服务帧数量

clk_sync

节点已同步的次数

bh_rt

路由表切换期间AN路由的次数

bh_nort

路由表切换期间AN未路由的次数

bh_ev

发送到DWM内核模块的事件数

bh_buf_lost[0]

为内核模块准备的丢失缓冲区数量

bh_buf_lost[1]

为内核模块准备的丢失缓冲区数量

bh_tx_err

传输回程帧失败的次数

bh_dl_err

处理下行链路回程帧期间的失败次数

bh_dl_ok

接收到的下行链路回程帧数

bh_ul_err

处理上行链路回程帧期间的失败次数

bh_ul_ok

接收到的上行链路回程帧数

fwdl_tx_err

向边缘节点发送下行链路数据时的失败次数

fwdl_iot_ok

发送到边缘节点的下行链路数据数量

fwul_loc_ok

从边缘节点接收到的上行链路位置数据的数量

fwul_iot_ok

从边缘节点接收到的上行物联网数据数量

ul_tx_err

从边缘节点发送上行数据时的失败次数

dl_iot_ok

发送到边缘节点的下行链路数据数

ul_loc_ok

从边缘节点接收上行链路位置数据的数量

ul_iot_ok

从边缘节点接收到的上行物联网数据数量

enc_err

加密错误数

重置

节点重新初始化次数

twr_ok

TWR循环成功次数

twr_err

TWR循环失败次数

res[0] x00000000

保留

res[1] x00000000

保留

res[2] x00000000

保留

res[3] x00000000

保留

res[4] x00000000

保留

res[5] x00000000

保留

示例:

leaps> stg
uptime: 85590
rtc_drift: 0.000000
ble_con_ok: 1
ble_dis_ok: 1
ble_err: 0
api_err_cnt: 10
api_dl_cnt: 0
uwb_intr: 62669859
rx_ok: 61479115
rx_err: 1378
tx_err: 633
tx_errx: 0
bcn_tx_ok: 854295
bcn_tx_err: 585
bcn_rx_ok: 5959105
alma_tx_ok: 28494
alma_tx_err: 1
alma_rx_ok: 198776
cl_rx_ok: 149
cl_tx_ok: 6
cl_coll: 0
svc_tx_ok: 0
svc_tx_err: 0
svc_rx_ok: 0
clk_sync: 16147
bh_rt: 7124
bh_nort: 0
bh_ev: 0
bh_buf_lost[0]: 0
bh_buf_lost[1]: 0
bh_tx_err: 0
bh_dl_err: 0
bh_dl_ok: 0
bh_ul_err: 0
bh_ul_ok: 0
fw_dl_tx_err: 0
fw_dl_iot_ok: 0
fw_ul_iot_ok: 0
ul_tx_err: 1
dl_iot_ok: 23
ul_loc_ok: 0
ul_iot_ok: 28494
enc_err: 0
ani_ses_err: 0
reinit: 3
reinit_last: 42370
tdoa_ok: 0
tdoa_err: 0
twr_ok: 279457
twr_err: 50
le_err: 0
res[0]: 11 x0000000B
res[1]: 21 x00000015
res[2]: 0 x00000000
res[3]: 0 x00000000
res[4]: 1 x00000001
res[5]: 1508 x000005E4
tot_err: 2648

备注

  • All statistics are read-only and updated in real time by the system.

stc

Clears system statistics. The stc command clears or resets all system statistics. This includes counters such as ble_con_ok and other accumulated statistical data. The response stc: ok confirms that the statistics have been successfully cleared.

示例:

leaps> stc
stc: ok

备注

  • This action resets counters to zero (or their default initial values).

  • The uptime and rtc_drift values may be unaffected depending on system implementation.

  • Useful for starting a fresh monitoring session or debugging.

rbv

RReads the battery voltage. The rbv command reads and displays the current battery voltage level. The output may vary depending on the system’s power source and hardware configuration.

示例:

leaps> rbv
No battery

备注

  • Useful for monitoring power status and estimating remaining battery life.

  • If the system is running on external power only, a “No battery” message may be returned.

rcs

Reads the charger status. The rcs command reads and displays the current status of the battery charging system. The output depends on hardware support and configuration.

示例:

leaps> rcs
No battery

备注

  • Useful for monitoring power management and battery health.

  • The “Unsupport get charge state” message indicates that this feature is not available on the current platform.

ut

描述

显示设备正常运行时间。

Parameters (In)

None

Parameters (Out)

  • uptime: the up-time of device

示例

 
leaps> ut
[000003.680 INF] uptime: 00:07:49.210 0 days (469210 ms)

sbl

描述

Set the battery voltage level.

Parameters (In)

  • low: Voltage threshold for Empty / Low battery detection.

  • med: Voltage threshold for Low → Mid-transition.

  • high: Voltage threshold for Mid → Full transition.

Parameters (Out)

  • SUCCESSED if successful, UNSUCCESSED otherwise.

示例

 
leaps> sbl 3800 3900 4200
[INFO]: Update the battery levels: SUCCESSED