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

UWB ネットワーク クロックに対する推定 RTC ドリフト (運用中に使用)

ble_con_ok

各BLE接続イベントは、このカウンタをインクリメントします。

ble_dis_ok

各BLE切断イベントは、このカウンタをインクリメントします。

ble_err

最後の内部BLEエラーを特定する数

api_err

最後の内部APIエラーを特定する数

api_err_cnt

API 错误计数器

api_dl_cnt

API経由で受信したバックホールDownLinkパケット数（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

エッジノードからのアップリンクIoTデータ受信数

ul_tx_err

エッジノードからのアップリンクデータ送信中の失敗数

dl_iot_ok

エッジノードへのダウンリンクデータ送信数

ul_loc_ok

エッジノードからのアップリンクロケーションデータ受信数

ul_iot_ok

エッジノードからのアップリンクIoTデータ受信数

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