Command Reference
This is a complete list of the commands that are available in the command-shell (console). Many of them are setting. The most important settings can also be accessed through the REST-API (Web application).
System commands
- cd <directory>
Change working directory
- format
Reformat file system.
- free
Show amount of free memory (in bytes)
- fw-uprade
OTA Firmware upgrade
- ioconfig <gpio-num>
Show info on GPIO configuration (for developing/debugging)
- trk-reset
Reset track storage
- ls
List files in filesystem
- log <tag> | * [<level>]
Set loglevel (for debugging/testing)
- mkdir <path>
Create a new directory
- nmea [raw]
Show NMEA data stream from GNSS. Use ‘raw’ switch to indicate that all data is to be shown. Otherwise only fixed data will be shown.
- rm <file>
Remove file
- read <file>
Read content from file
- sysinfo.
Show system information.
- restart
Restart the system
- tasks
Show list of tasks running in system (threads/processes)
- time
Show time (UTC and local-time if timezone is set)
- timezone <tz-string>
Set timezone. Use tz-string format to specify timezone information.
- vbatt
Show battery status and voltage.
- write <file>
Write content to file
- rssi
Show signal strength on radio receiver.
Networking commands
- ap [<index> <ssid> [<password>]]
List or change AP alternatives. Up to 6 alternatives can be specified (index 1-6).
- ap-auth [<password>]
WIFI SoftAP password.
- ap-ip [<ip>]
WIFI SoftAP IP address. Default is 192.168.0.1.
- ap-ssid [<ssid>]
WIFI SoftAP SSID setting. Default is ‘Arctic_XXXX’ where XXXX is mycall. Should work in most cases.
- ap-sta
Show WIFI SoftAP connected stations.
- api-key [<key>]
REST API secret key.
- api-origins [<regex>]
Allowed origins for REST API webclients. Default is to allow all.
- connect <host> <port>
Connect to internet server (like telnet). Use for testing/debugging.
- fw-cert
Certificate for firmware update. Use only if a self-signed certificate is used.
- fw-url [<url>]
URL for OTA firmware update.
- mdns <type>
Scan for MDNS services.
- netmon [on|off]
Turn on telnet service for monitoring. If on You can connect the tracker to see received and sent packets.
- netmon-port <port>
Specify the port number for net-monitoring. Default: 23.
- newcert
Generate new self-signed certificate (for REST API). Reboot tracker to activate it.
- softap [on|off]
Wifi softap on/off setting.
- wifi [on|off]
Wifi on/off setting.
- wifi-info
Info about Wifi connection.
- wifi-scan
Scan for access points.
APRS tracking commands
- altitude [on|off]
Altitude setting
- comment [<text>]
APRS posreport comment. Default “Arctic Tracker”
- compress [on|off]
Compress setting
- crypto [on|off]
Encrypt APRS packets.
- crypto-key <key>
Secret (password/passphrase) used to generate a key for encryption.
- extraturn [on|off]
Send extra posreport when changing direction
- listen
Monitor radio channel for incoming APRS packets
- maxpause [<val>]
Tracking max pause (seconds). Default 120.
- minpause [<val>]
Tracking min pause (seconds). Default 20.
- mindist [<val>]
Tracking min distance (meters). Default 100.
- mycall [<callsign>]
My callsign. Default “NOCALL”. Setting the callsign will trigger the generation of a new security certificate. A reboot is recommended after using this command.
- osymbol [<T><S>]
APRS symbol for objects (sym-table symbol). Default: “/[” (running person)
- objectid <str>
ID prefix for object reports
- repeat [val]
# Times to repeat posreports (0-3)
- reportbeep [on|off]
Beep when report is sent
- statustime [<val>]
Status report time (10 sec units)
- symbol [<T><S>]
APRS symbol (sym-table symbol). Default: “/[” (running person)
- testpacket
Send test APRS packet (for testing/development)
- timestamp [on|off]
Timestamp setting
- tracker [on|off]
APRS tracker setting
- turnlimit [<val>]
Threshold for change of direction (degrees). Default 35.
- txmon [on|off]
Tx monitor (show own TX packets on console in listen mode)
Igate and digipeater commands
- digi [on|off]
Digipeater setting
- digipath [<addr>, …]
APRS Digipeater path. Default “WIDE1-1”
- digi-wide1 [on|off]
Digipeater fill-in mode (WIDE1)
- digi-sar [on|off]
Digipeater preemption on ‘SAR’
- igate [on|off]
Igate setting
- igate-host [<hostname>]
Igate server host to connect to. Default “aprs.no”
- igate-port [<portnr>]
Igate server port to connect to. Default 14580.
- igate-user [<callsign>]
Igate server logon user. Default “NOCALL”.
- igate-pass [<code>]
Igate server logon passcode
- igtrack [on|off]
Send posreports (from tracker) directly to APRS/IS when available
Track logging commands
The tracker can store position-reports in the file-system and upload them to a Polaric Server instance when internet is in range. Commands related to track-logging are:
- tracklog [on|off]
Track logging
- trklog-get
Get tracklog record (for testing/development)
- trklog-put
Put tracklog record (for testing/development)
- trklog-int [<val>]
Interval for track logging (seconds). Default 5.
- trklog-post [on|off]
Track log automatic post to server
- trklog-ttl [<val>]
Max time to keep tracklog entries (hours). Default 24.
- trklog-key [<key>]
KEY for authenticating tracklog-messages to Polaric Server
- trklog-url [<url>]
URL for posting tracklog updates to Polaric Server
AFSK APRS radio commands
These commands are only valid on trackers with VHF AFSK trackers (Arctic Tracker 4 VHF or Lilygo T-TWR Plus)
- ptt
Transmitter on
- radio [on|off]
Radio module power
- rxfreq [<val>]
RX frequency (100 Hz units). Default 1448000.
- softsq [<val>]
Soft Squelch setting. Default 17 on T_TWR, 110 on other trackers.
- squelch [<val>]
Squelch setting (1-8). Default 1.
- teston <byte>
HDLC encoder test
- tone
Tone generator test. Use space to cycle between 1200 and 2200 Hz
- txdelay [<val>]
APRS TXDELAY setting. Default 10.
- txfreq [<val>]
TX frequency (100 Hz units). Default 1448000.
- txlow [on|off]
Tx power low
- txtail [<val>]
APRS TXTAIL setting. Default 10.
- volume [<val>]
RX audio level setting (1-8). Default 6 on T_TWR, 7 otherwise.
LoRa APRS radio commands
These commands are only valid on trackers with LoRa APRS (Arctic Tracker 4 UHF)
- freq [<val>]
TX/RX frequency (Hz). Default 433775000.
- freq-offset [<val>]
Correction for TX/RX frequency (Hz). Default 0.
- heard
Last heard packet
- lora-cr [<val>]
LoRa coding rate (5-8). Default 5.
- lora-sf [<val>]
LoRa spreading factor (7-12). Default 12.
- txpower [<val>]
Tx power (1-6). Default 4 (500 mW)