Debug and tuning
Where: Serial menu s → d, h, n, o, p · not in the panel
Five menus of the MS2net reference station, under System, for diagnostics and internal tuning, meant for the team or for an expert user asked to collect information about a problem. Settings are stored with the others when the main menu is closed.
Leave them as they are
Most items only add messages on the serial port: left on, they fill the terminal and slow the station down. The RTK Operation values are internal parameters: a wrong value can lose data or stop the station. Change them only if asked by the team.
r) Force system reset, in Debug Software, Hardware and Network, stores the settings and
restarts at once.
Debug Software
System → d.
Menu: Debug Software
1) Heap Reporting: Disabled
10) Print ring buffer offsets: Disabled
11) Print ring buffer overruns: Disabled
12) RTCM message checking: Disabled
20) Print Rover accuracy messages: Enabled
30) Print states: Enabled
31) Print duplicate states: Disabled
32) Reboot RTK after uptime reaches: Disabled
34) Print partition table
50) Task Highwater Reporting: Disabled
60) Print firmware update states: Disabled
70) Correction service certificate management: Disabled
e) Erase internal file system
r) Force system reset
x) Exit
| Key | Item |
|---|---|
1 |
free memory, printed regularly |
10, 11 |
internal GNSS data buffer: offsets, overruns |
12 |
checks the RTCM messages passing through |
20 |
Rover Accuracy (m): …, SIV: … every 2 seconds in rover |
30, 31 |
every change of internal state (STATE_…), with or without duplicates |
32 |
restarts by itself after this many seconds, 30 to 4294967; other values disable it; once set, the line shows 86400 (1 days 0:00:00) |
34 |
layout of the internal flash memory |
50 |
stack use of the internal tasks |
60 |
messages of the automatic firmware check |
70 |
no effect on MS2net |
e |
erases the internal memory (profiles and settings) and restarts, without asking |
Debug Hardware
System → h.
Menu: Debug Hardware
1) Print battery status messages: Enabled
2) Run Bluetooth Test
3) Print RTC resyncs: Disabled
4) Print log file messages: Disabled
5) Print log file status: Enabled
6) Run Logging Test: Disabled
7) Print SD and UART buffer sizes: Disabled
8) Print messages with bad checksums or CRCs: Disabled
9) GNSS module I2C Debugging Output: Enabled
10) L-Band Debugging Output: Disabled
11) Battery NMEA via Bluetooth ($PMS2,BAT): Enabled
e) Erase internal file system
t) Test Screen
r) Force system reset
x) Exit
| Key | Item |
|---|---|
1 |
Batt (…%): Voltage: …, printed regularly |
2 |
tests the internal link to the GNSS module that feeds Bluetooth, prints the result |
3 |
clock set again from GNSS time |
4, 5 |
recording messages and status (Log file size: … - Generation rate: …) |
6 |
recording test: closes the current file and writes test files, not for field work |
7 |
internal buffer sizes |
8 |
prints damaged messages instead of discarding them silently |
9 |
internal bus towards the GNSS module |
10 |
no effect on MS2net |
11 |
adds a battery sentence to the Bluetooth stream, for apps that read it |
e |
as in Debug Software: erases the internal memory and restarts, without asking |
t |
factory test screen on the display when the menu is closed |
Debug Network
System → n.
Menu: Debug Network
1) Print unused port diagnostics: Disabled
2) ESP-Now Broadcast Override: Enabled
3) Debug WiFi state: Disabled
10) Debug network layer: Disabled
11) Print network layer status: Enabled
20) Debug NTP: Disabled
21) Debug NTRIP client state: Disabled
22) Debug NTRIP client --> caster GGA messages: Disabled
23) Debug NTRIP server state: Disabled
24) Debug caster --> NTRIP server GNSS messages: Disabled
25) Debug PVT client: Disabled
26) Debug PVT server: Disabled
27) Debug PVT UDP server: Disabled
28) Debug WiFi Config: Disabled
r) Force system reset
x) Exit
| Key | Item |
|---|---|
1 |
a port MS2net does not have: no effect |
2 |
not a debug item: Broadcast Override of the panel |
3, 28 |
WiFi connection, Config mode |
10, 11 |
network layer shared by all services |
20 |
no effect on MS2net |
21, 22 |
NTRIP client: state, GGA sent to the caster |
23, 24 |
NTRIP server: state, data sent to the caster |
25 … 27 |
TCP client, TCP server, UDP server |
RTK Operation
System → o. Internal parameters of the data flow.
Menu: RTK Operation
1) Display Reset Counter: 0 - Disabled
2) GNSS Serial Timeout: 1
3) GNSS Handler Buffer Size: 8192
4) GNSS Serial RX Full Threshold: 50
5) Set L-Band RTK Fix Timeout (seconds): 180
6) SPI/SD Interface Frequency: 16 MHz
7) SPP RX Buffer Size: 2048
8) SPP TX Buffer Size: 32
9) UART Receive Buffer Size: 2048
10) Mirror GNSS module's UART1 settings to USB
11) Use I2C for L-Band Corrections: Enabled
12) RTCM timeout before L-Band override (seconds): 10
13) CONFIG GNSS module USB port: Enabled
---- Interrupts ----
30) Bluetooth Interrupts Core: 1
31) GNSS UART Interrupts Core: 1
32) I2C Interrupts Core: 1
------- Tasks ------
50) BT Read Task Core: 1
51) BT Read Task Priority: 1
52) GNSS Data Handler Core: 1
53) GNSS Data Handler Task Priority: 1
54) GNSS Read Task Core: 1
55) GNSS Read Task Priority: 1
x) Exit
| Key | Item | Range |
|---|---|---|
1 |
restart counter on the display (not power-ons); enabling resets it to 0. Same as Debug Zone in System | on, off |
2 |
read timeout of the internal GNSS link | 0 to 1000 ms |
3 |
GNSS data buffer; stores and restarts at once, 0 aborts | 32 to 65535 bytes |
4 |
bytes received before the processor reads them | 1 to 127 |
5, 11, 12 |
no effect on MS2net | — |
6 |
microSD card speed | 1 to 16 MHz |
7, 8 |
Bluetooth RX / TX buffers | 32 to 16384 bytes |
9 |
UART receive buffer; stores and restarts at once, 0 aborts | 32 to 16384 bytes |
10 |
copies the message rates to the GNSS module's own USB port | — |
13 |
protocols of the GNSS module's own USB port, sent at once | on, off |
30 … 32 |
processor core serving each interrupt (30 not implemented) |
0, 1 |
50 … 55 |
core and priority of the internal tasks | core 0, 1 · priority 0 to 3 |
Periodic Print Messages
System → p. Status lines printed at a fixed interval, one switch per subject.
Menu: Periodic Print Messages
----- Hardware -----
1) Bluetooth RX: Disabled
2) Bluetooth TX: Disabled
3) Unused port IP address: Disabled
4) Unused port state: Disabled
5) SD log write data: Disabled
6) WiFi IP Address: Disabled
7) WiFi state: Disabled
8) GNSS module RX data: Disabled
9) GNSS module TX data: Disabled
----- Software -----
20) Periodic print: 0 (0x00000000)
21) Interval (seconds): 15
22) CPU idle time: Disabled
23) Network state: Disabled
24) Ring buffer consumer times: Disabled
25) RTK position: Disabled
26) RTK state: Disabled
------ Clients -----
40) NTP server data: Disabled
41) NTP server state: Disabled
42) NTRIP client data: Disabled
43) NTRIP client GGA writes: Disabled
44) NTRIP client state: Disabled
45) NTRIP server data: Disabled
46) NTRIP server state: Disabled
47) PVT client data: Disabled
48) PVT client state: Disabled
49) PVT server client data: Disabled
50) PVT server data: Disabled
51) PVT server state: Disabled
52) OTA client state: Disabled
------- Tasks ------
70) btReadTask state: Disabled
71) ButtonCheckTask state: Disabled
72) gnssReadTask state: Disabled
73) handleGnssDataTask state: Disabled
74) sdSizeCheckTask state: Disabled
x) Exit
- Each numbered item switches that report on or off.
20sets all the switches at once as a number (sum of their bits);21sets the interval in seconds. Neither shows a prompt: type the value right after the item and press Enter.3,4,40and41refer to ports and services MS2net does not have.