SYS

reset

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.

Example:

leaps> reset
reset ok

Note

  • 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.

Example:

leaps> frst
frst ok

Note

  • 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.

Example:

  • 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.

Example:

leaps> f

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

Note

  • 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:

Statistic

Description

uptime

System time since restart in seconds

rtc_drift

Estimated RTC drift against the UWB network clock (used during production)

ble_con_ok

Each BLE connect events increments this counter

ble_dis_ok

Each BLE disconnect events increments this counter

ble_err

Number that identifies last internal BLE error

api_err

Number that identifies last internal API error

api_err_cnt

Counter of errors on API

api_dl_cnt

Number of received backhaul DownLink packets via API (GN only)

uwb0_intr

Number of interrupts from the DW1000

uwb0_rst

Number of attempts to reset the DW1000 to recover from error

uwb0_bpc: 1

Number of bandwidth/temperature compensation

rx_ok

Number of enabling the reception on time

rx_err

Number of failures to enable the reception on time

tx_err

Number of failures to enable the transmission on time

tx_errx

Number of errors related with the TX buffer

bcn_tx_ok

Number of transmitted beacons

bcn_tx_err

Number of failures during transmission of beacons

bcn_rx_ok

Number of received beacons

alma_tx_ok

Number of transmitted almanacs

alma_tx_err

Number of failures during transmission of almanacs

alma_rx_ok

Number of received almanacs

cl_rx_ok

Number of received cluster join

cl_tx_ok

Number of transmitted cluster join

cl_coll

Number of detected cluster collisions

fwup_tx_ok

Number of transmitted firmware update frames

fwup_tx_err

Number of failures to transmit firmware update frames

fwup_rx_ok

Number of received firmware update frames

svc_tx_ok

Number of transmitted service frames

svc_tx_err

Number of failures to transmit service frames

svc_rx_ok

Number of received service frames

clk_sync

Number of times the node has synchronized

bh_rt

Number of times the AN was routing during routing table switch

bh_nort

Number of times the AN was not routing during routing table switch

bh_ev

Number of events sent to the DWM Kernel Module

bh_buf_lost[0]

Number of lost buffers ready for the Kernel Module

bh_buf_lost[1]

Number of lost buffers ready for the Kernel Module

bh_tx_err

Number of failures to transmit backhaul frames

bh_dl_err

Number of failures during processing of downlink backhaul frames

bh_dl_ok

Number of received downlink backhaul frames

bh_ul_err

Number of failures during processing of uplink backhaul frames

bh_ul_ok

Number of received uplink backhaul frames

fwdl_tx_err

Number of failures during sending downlink data to the edge nodes

fwdl_iot_ok

Number of sent downlink data to the edge nodes

fwul_loc_ok

Number of received uplink location data from the edge nodes

fwul_iot_ok

Number of received uplink IoT data from the edge nodes

ul_tx_err

Number of failures during sending uplink data from the edge node

dl_iot_ok

Number of sent downlink data to the edge node

ul_loc_ok

Number of receive uplink location data from the edge node

ul_iot_ok

Number of received uplink IoT data from the edge nodes

enc_err

Number of encryption errors

reinit

Number of node reinitialization

twr_ok

Number of succeeded TWR cycle

twr_err

Number of failed TWR cycle

res[0] x00000000

Reserved

res[1] x00000000

Reserved

res[2] x00000000

Reserved

res[3] x00000000

Reserved

res[4] x00000000

Reserved

res[5] x00000000

Reserved

Example:

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

Note

  • 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.

Example:

leaps> stc
stc: ok

Note

  • 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.

Example:

leaps> rbv
No battery

Note

  • 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.

Example:

leaps> rcs
No battery

Note

  • 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

Description

Show device uptime.

Parameters (In)

None

Parameters (Out)

  • uptime: the up-time of device

Example

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

sbl

Description

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.

Example

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