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)