Save configuration to tracker's filesystem (/preferences.cfg)
Save configuration
Save Wifi configuration to tracker's filesystem (/wifi.cfg)
Documentation
Tooltip
If you navigate your mouse over an input field / button, you see a detailed description what it does / which values are expected.
Info for SNR/RSSI path encoding
If enabled, add SNR and RSSI in path on receiption, prefixed with 'Q'. Examples:
SNR 23 RSSI -73 -> Q2373
SNR -03 RSSI -104 -> QA3K4
SNR -13 RSSI -114 -> QB3L4
Still testing, if it behaves good to our network.
Use with care; resulting longer path consumes a bit more airtime.
a short press will wake it up and show current data (as long as your configured "Display Timeout")
If OLED is disabled or OLED is ON:
flip through the available pages
1. press: show lastheard list (Call, time, distance, direction)
2. press: show current build number
3. - 5. press: show last 3 received packets (raw)
6. press: with GPS-FIX immediate send a beacon with the position from the GPS
6. press: without GPS-FIX, immediate send a beacon with the position saved in the configuration
long press
toggle on or off WiFi and WebServer
Cave: if you long-press during boot, your settings are purged!
TTGO T-Beam left/right hardware-buttons:
Left button (nearby USB-port): if long-pressed, your device will powered off (press 7s), or is switched on again (2s).
Right button (lateral): short-press reboots your device (restarts the CPU).
Tips for reducing power (Usage as tracker only):
WiFi OFF
be aware, that aprs-is connection depends on the Webserver and will stop working).
select option 0 to disable WiFi & APRS-IS
select option 1 to disable WiFi if a bluetooth client is connected in between 60s on boot (recommended for portables, and for LORA32_21 devices)
LoRa Receiver OFF:
reduces power consumption, if you just use the device as a tracker
Fixed Beacon off:
Smart Beaconing is activated and GPS position is sent (if GPS fix is available). There is no fixed beacon. Beaconing starts after first GPS-fix (or if you manualy send a fixed beacon). If GPS-fix is lost, the last GPS position is sent in Fixed Beacon Interval.
Config in Filesystem:
General
There could be two files: wifi.cfg and preferences.cfg. You find in the directory "data" of this sources-tree.
Each file should not exceed 2560 bytes.
To upload both files to SPIFFS of your board, you have to do this via Upload File System image in PlatformIO!
To find the 'Upload File System image' click the PlatformIO symbol (the little alien) on the left side, choose your configuration, click on 'Platform' and search for 'Upload File System image'. If you use platformio-cli, upload the filesystem as described below.
data/wifi.cfg
wifi.cfg can to be created manually, following the json structure in the example. The names of the variables (aka keys) must not be altered
The preferred way is to upgrade the firmware to the newest version, make sure, that the wifi credentials are set correctly and then kilck the SAVEWIFI2FS Button.
The content, what will be saved, can be viewed above.
wifi.cfg in the directory data contains SSID and password of up to 10 AP and a password for the local accesspoint
The password must not be shorter that 8 byte. The json structure must not be changed
if something is wrong or the file is missing, the complete file will be ignored. If credentials are available in flash, they will be used.
An alternative to upload wifi.cfg to your board is via Upload File System image in PlatformIO!
To find the 'Upload File System image' click the PlatformIO symbol (the little alien) on the left side, choose your configuration, click on 'Platform' and search for 'Upload File System image'. If you use platformio-cli, upload the filesystem as described below.
which WiFi is selected?
An AP entry containing the keyword "prio":1 defines the entry which is taken as first to connect before following the configured order
if there is nothing prioritized, then the configured order is followed. If credentials are available in flash, they will be used first.
if no connection to a configured AP could be established, a local accesspoint with the SSID "call AP" will be created. After connected to, this Webserver will be reachable with the IP Address 192.168.4.1. The password for the selfAP can be preconfigured with the key "ap_password" in this file
data/preferences.cfg
preferences.cfg can be created by the system, if you kilck to "SAVE2FS" in the Update section of the site.
if you want to changes items of the preferences, you have to start with the data shown in the configuration view of this WebSite. Be sure to deleted everything before the "{". Again the keys must not be altered. The file then has to be placed into the data directory on your system using the name preferences.cfg.
which config is selected?
during startup it will be checked, if there is a prevously used config stored in the system. Normally that is the config, you enter via the webserver. This will be used, if available.
If the previously stored config is not available (i.e., after a complete system erase or a factory reset), it will be checked, if a correct file data/preferences.cfg is availabe. If yes, it will be used. If not, the system comes up with the default values.
Factory reset
if factory reset is selected (either via the right button or the webserver), the system will start up with the config saved in data/preferences.cfg. So if you are in the field, make sure, that you have a working setup stored there and be carefull when overwriting.
If you really need a fresh system with the compiled default configuration, you have to delete the file data/preferences.cfg on the board, before you do a factory reset.
Platform.IO CLI
if your computer is a raspberry PI3 or if you do not want/need the overhead of the Platfrom.IO GUI, you can use the CLI
Compile and Upload Firmware: ~/.platformio/penv/bin/pio run -e [board identifier] -t upload --upload-port /dev/[port]
start serial monitor: ~/.platformio/penv/bin/pio device monitor -p /dev/[port] -b 115200
all the commands above executed in that order, will completely erase the board, compile and upload the filesystem, compile and upload the current firmware, reboot the board and start the serial monitor
if a precompiled fw should be uploaded, without compilation, use the nobuild switch:
~/.platformio/penv/bin/pio run -e ttgo-t-beam-v1.0-development -t nobuild -t upload --upload-port /dev/ttyACM0
Hardware notices
TTGO LoRa32 V2.1 (aka T3 V1.6.1)
Hardware limitation: if bluetooth is enabled and BT-client is connected, WIFI (-> Web-Server) does not work anymore.
You'll see the red LED while booting turned on for 60s as indicatior for waiting for BT-clients.
Hack: firmware compiled with -e ttgo-lora32-v2.1 and bluetooth configuration variable is set to enabled, now listens on boot up to one minute for your bluetooth device to connect.
If a bluetooth device connects, it does not start the Web-Server. Else, it closes SerialBT port and starts the Web-Server on LORA32_21 devices.
See also: new feature for switching WIFI off (i.e. if you use the device as portable tracker), if you don't need it: Webserver eats abt 80mA..
How to switch the Webserver on again, please read the long-press button (GPS) section.