Debugging Shell

The system provides a serial debugging shell on the RX/TX pins in the debugging connector. The serial configuration is 8N1 at 115200 baud, and the console requires an Enter key press to be activated.

For Linux systems, Satlab recommends the tio serial terminal application (https://tio.github.io/) but other applications such as minicom should also work. When using the Satlab JTAG/serial adapter, the debug shell is typically available on /dev/serial/by-id/usb-FTDI_Dual_RS232-if01-port0.

A number of timestamped log messages are printed during boot from various logging groups. Additional logging can be enabled at runtime using the trace commands. The help command can be used to list available commands and their usage. The installed software version and build information is also printed in the debugging shell during boot.

satlab@satlab:~$ tio -b 115200 /dev/serial/by-id/usb-FTDI_Dual_RS232-if01-port0
[tio 14:29:41] tio v3.7
[tio 14:29:41] Press ctrl-t q to quit
[tio 14:29:41] Connected

Satlab Polaris AIS bootloader v2.0.0
boot slot 0 (2 remaining attempts)

[    0.000303] system: Copyright (c) 2016-2025 Satlab A/S <satlab@satlab.com>
[    0.001322] system: boot slot: 0 count: 1 reset cause: general reset
[    0.002422] system: board serial #208b1b37
[    0.007717] prop: using stored sys properties
[    0.009715] prop: using stored demod properties
[    0.016447] prop: using stored cal properties

Satlab Polaris AIS v2.0.0

[polaris] help
Available commands:
boot            Bootloader commands
csp             CSP commands
echo            Display a line of text
fs              File system commands
help            Show available commands
history         Show previous commands
prop            System configuration properties
reboot          Reboot system
store           Frame store commands
time            Time command execution
tm              Telemetry commands
trace           Trace subcommands
uptime          Show system uptime
watch           Run command periodically

To show current telemetry values, run the tm show command. The watch command can be used to periodically run a command, with the -b switch enabling screen blanking between updates. Press any key to stop the loop:

[polaris] watch -b tm show
Running command 'tm show' every 1000 ms
Power Channels
FPGA          On
RF            On
SD-card       Off
Ethernet      Off

Power Rails
VIN       4875.00 mV   313.00 mA  1513.00 mW
3V3       3325.00 mV   429.00 mA  1428.00 mW
2V0       1995.00 mV   194.00 mA   387.00 mW
1V0        955.00 mV   430.00 mA   411.00 mW

Temperature Sensors
MCU         33.75 C
FPGA core   38.62 C
Power       32.75 C
LNA         34.12 C
ADC         34.31 C
SD-card     33.12 C
Interrupted

To list the last 5 received messages, the store read command can be used:

[polaris] store read 5
Frame 8800941 ch: 1 type: 26 mmsi: 219000005 power: -84.3 dBm frequency: -2 Hz Flags: True, False, True time: 3797.002499610
6b3436b314ba1139cbe31f14e864f340e7ef000000881b [23]
Frame 8800940 ch: 2 type: 26 mmsi: 219000005 power: -84.3 dBm frequency: 1 Hz Flags: True, False, True time: 3797.002499596
6b3436b314865799327e55b368032a5e2ea20000003908 [23]
Frame 8800939 ch: 3 type: 26 mmsi: 219000005 power: -84.3 dBm frequency: 2 Hz Flags: True, False, True time: 3797.002499558
6b3436b314417967823de9bc5d8836aad7210000005148 [23]
Frame 8800938 ch: 0 type: 26 mmsi: 219000005 power: -84.1 dBm frequency: -2 Hz Flags: True, False, True time: 3797.002499658
6b3436b31432b4026d26c9c594c818eb359c000000b324 [23]
Frame 8800937 ch: 1 type: 26 mmsi: 219000005 power: -84.3 dBm frequency: -2 Hz Flags: True, False, True time: 3796.002499610
6b3436b314ba1139cbe31f14e864f340e7ef000000881b [23]

Dynamic debugging messages can be enabled through the trace command group. This can for example be used to log all received and transmitted CSP messages. To do so, run trace print csp all:

[polaris] trace print csp all
[   55.551903] csp: INP: S 1, D 20, Dp 1, Sp 62, Pr 2, Fl 0x00, Sz 1 VIA: KISS
[   55.552103] csp: SERVICE: Ping received
[   55.552210] csp: OUT: S 20, D 1, Dp 62, Sp 1, Pr 2, Fl 0x00, Sz 1 VIA: KISS

Logging of all incoming AIS messages can also be enabled with trace print store info.