LoRa tracker with KISS TNC capability
 
 
 
 
 
 
Go to file
Thomas Osterried aa854462d4 Major changes. Hard work on this new releae.
Improvements
- Even more intelligent behavior in "Allow failback Mode AP"
- Webserver: Current GPS location can be stored as current lat/lon;
             And fixed a not-so-nice down-rounding from i.e.
             53.2100N to 53.2099N
- Webserver: better input handling for ap password, remoteAP ssid and
  password, syslog and ntp server
- Webserver: fixed typos in tooltip texts, and improved documentation,
  especially for the new features
- Position ambiguity and higher precision
  You can choose now between
    - compressed position (also when fixed position).
    - uncompressed aprs position
    - uncompressed aprs position with higher precision (DAO W and w)
  Improvement for unknown position: encode it according to aprs spec
- OLED: more variants to display lat/lon positions.
  Displayed lat/lon resolution depends on setting and if you move,
  and current gps hdop.
  You can also configure if maidenhead grid locator is shown (always,
  never, in intervals). Locator could be shown as RR99XX, RR99XX99
  or RR99XX99xx - you can choose which variant you like.
- Oled Lines: one-liners now cut at end of display-length;
  except for line2 (if line3-5 are empty).
  Oled display.display() is called only if display is on.
  Improvement for fillDisplayLines3to5 (may be forced)
- Serial output on boot: Warn for unser preference variables only once,
  and set them accordingly
- Digipeating / Gate handling. Don't send 3rd-party packets
  back to aprsis. Digipeat telemetry only do secondary qrg.
- aprs-is:
    - 3rd-party traffic: it's not seldom that igates use
  lowercase calls. Don't tread this as (minor) error anymore.
    - aprs-is: improved filters according to aprsis spec
- digipeating:
  - if we are a WIDE1 (= fill-in) digi and if a packet is in
  lora_TXBUF_for_digipeating and we hear a repeated one with same
  source-address and content, we clear it from queue.
  Improved viscous-delay.

For development (compile time): different debug-verbose levels

Fixes
- aprsLatPreset (etc..) variables are now changed from their temporary
  variable names at once. Reading from preferences, a separate
  variable is filled. This mitigates a smp problem between webserver
  and main threads
- aprsis login messages missed word "vers " placed before the version string
- Small fix for aprsis 3rd party traffic encoding according to the spec.
- Some numbers with decimals are now shown complete (instead of cut'ed
  to two decimals (default of String(floatVariable)).
- fixes for some buffer dimensions; detected two buffer overflow conditions
- Telemetry: assurance that values > 255 are ceiled and not start from 0 again
   (An analoge value must not exceet 255)

This dedicated to the three-country-edge SysOp meeting
in Engen 2023-02-11 ;)
LoRa was one topic..

And after my commit 38387dc189 from
Sun Feb 19 20:36:05 2023 +0100, I saw at github that hb9xar found
three bugs. One is (because code changed with my last commit ant
fixed it); the other tow I add now:
  fixed "message capable" APRS indicator upon startup
  USB CLI: fixed: shutdown command was not working

Signed-off-by: DL3EL <dl3el@darc.de>
Signed-off-by: Thomas Osterried <dl9sau@darc.de>
2023-02-19 21:08:22 +01:00
.github/workflows Minor changes 2022-03-07 21:06:05 +01:00
data Texting new wifi AP array. 2022-12-15 09:16:37 +01:00
data_embed Major changes. Hard work on this new releae. 2023-02-19 20:36:05 +01:00
img Create H49c4700b02604cf9a3b9f5f1e91c9e33u.webp 2021-03-15 00:19:40 +01:00
include Major changes. Hard work on this new releae. 2023-02-19 20:36:05 +01:00
lib Major improvements and smaller bugfixes 2022-08-07 20:01:24 +02:00
pdf Heltec-WiFi-KIT32 & Heltec-WiFi-KIT32_V2 2021-03-21 17:18:14 +01:00
src Major changes. Hard work on this new releae. 2023-02-19 21:08:22 +01:00
tools Include git hash in version 2021-04-20 17:25:22 +02:00
.gitignore Adds Smart Beaconing settings 2021-07-11 11:54:11 +02:00
.travis.yml LoRa APRS Tracker 2018-11-25 21:07:34 +01:00
INSTALL.md next typo fix 2022-10-02 16:32:12 +02:00
README.md Get self telemetry path working. 2021-09-19 15:50:35 -05:00
partitions.csv Upgrade firmware from web interface 2021-03-01 14:47:34 +01:00
platformio.ini Major changes. Hard work on this new releae. 2023-02-19 20:36:05 +01:00

README.md

LoRa tracker with KISS TNC capability

Tracker can be used on its own. You can also connect it via blueetooth with APRSdroid. After connection with APRX based DIGI it can be used as KISS-TNC

diagram

Contributors

  • Initial work: OE1ACM, OE3CJB
  • Redesigned: SQ9MDD
  • KISS TNC Over Serial or Bluetooth: SQ5RWU
  • Lora32 board support: DJ1AN
  • Self-telemetry improvement: KB1GIM

Supported boards

  • TTGO T-beam v.0.7
  • TTGO T-beam v.1.0
  • Lora32 board

User key functions:

short press (OLED Enabled):

  • if OLED is OFF a short press will wake it up and show current data (as "Display Timeout" seconds)
  • if OLED is ON with GPS-FIX immediate sending of a frame with the position from the GPS
  • if OLED is ON without GPS-FIX, immediate sending of the frame with the position saved in the configuration

short press (OLED Disabled):

  • with a valid GPS-FIX immediate sending of a frame with the position from the GPS
  • without valid GPS-FIX, immediate sending of the frame with the position saved in the configuration

long press while booting

  • reset to factory default

long press: toggle on or off GPS power supply

  • if the "FIXED_BEACON_EN" option is enabled in the configuration, a beacon will be sent every set time interval

Oled screens information

  • ((TX)) - position frame sent automatically
  • ((RX)) - informs about the received frame
  • ((GPSOFF)) - GPS power-off information
  • ((GPS ON)) - GPS power-on information
  • ((MAN TX)) - information about sending a manually initialized GPS position frame
  • ((FIX TX)) - information about the forced manual sending of a frame with the position saved in the configuration when GPS is off or no fix
  • ((AUT TX)) - information about sending automatic positioning frame when GPS is turned off
  • ((KISSTX)) - information about sending the frame sent by KISS
  • ((WEB TX)) - sending frame as requested via HTTP
  • ((TEL TX)) - information about sending telemetry

How to binary first flash readme... (thanx SP6VWX)

  • Download the appropriate binary file for your board from: https://github.com/SQ9MDD/TTGO-T-Beam-LoRa-APRS/releases
  • Download current version of the esphome-flasher tool: https://github.com/esphome/esphome-flasher/releases
  • Connect your board to your USB port and open ESPHome Flasher.
  • If your board is not showing under Serial Port then you likely need to install the drivers for the CP210X serial chip. In Windows you can check by searching “Device Manager” and ensuring the device is shown under “Ports”.
  • In ESPHome Flasher, refresh the serial ports and select your board's serial port.
  • Browse to the downloaded firmware and select the correct firmware based on the board type.
  • Select/Press Flash ESP.
  • Once complete, “Done! Flashing is complete!” will be shown.
  • any subsequent updates can be done via WWW

Installing from source (only for advanced users)

  • Clone Git repo to any folder of your PC
  • Download and install "Visual Studio Code"
  • Open "Visual Studio Code" and add "PlatformIO" plugin
  • Open "PlatformIO" and click on "Import Arduino Project"
  • In the top part of the window choose youy board then browse to cloned repo and click "import"
  • In the left column click on the ANT-shaped icon, choose your board and click on "Upload". COM port should be detected automatically Wait for procedure to finish and keep reading

Configuring parameters

Wait for the board to reboot, connect to "N0CALL AP" WiFi network, password is: xxxxxxxxxx (10 times "x") and point your browser to "http://192.168.4.1" (http, not https). Hover your mouse to textboxes to get useful hints.

WiFi Settings

you can scan for local SSID or manually type in name and password

  • Scan WiFi: scan for local WiFi networks
  • SSID: name of the AP to connect to
  • Password: password of WiFi AP
  • AUTO AP Password: if configured network is not reachable the AP mode will be enabled, SSID will be your callsign and this will be the password

APRS Settings

These are main APRS settings such as callsign, SSID and symbol (refer to: http://www.aprs.org/symbols.html). Please remember to turn ON GPS in order to use it as a tracker.

  • Frequency: frequency of receive and transmit
  • Speed: speed of the LoRa APRS packet (default: 300)
  • Callsign and SSID: Callsign of the tracker (e.g: N0CALL-10)
  • Relay PATH: destination path of APRS packet
  • Symbol table & Symbol: custom APRS icon
  • Show altitude: allow altitude to be reported
  • Show comment: includes comment in APRS packet
  • Comment: custom message to send
  • Show Battery: includes current battery voltage
  • Fixed beacon: enables static beacon transmission
  • Fixed beacon interval: beacon interval in seconds (please more than 30 minutes to avoid overflow on the network)
  • Latitude & Longitude: fixed beacon position to transmit (in APRS format)
  • Min interval: packet are transmitted not less than x second apart
  • Max interval: maximum interval between packages
  • Speed and course: variables to calculate smart beaconing
  • GPS enabled: enables power to GPS module

Device Settings

These are main device settings, hover the mouse on the checkboxes and explainations will appear.

  • OLED Display enabled: Enables OLED functionalities
  • Bluetooth enabled: Enables bluetooth functions (such as TNC via APRSDROID)
  • LED Signaling: not yet implemented
  • Auto Power OFF: activate auto power off when USB is unplugged (only for TBEAM 1.0 or later)
  • Auto Power OFF delay: timer to turn off board after USB is unplugged (only if enabled)
  • Display show RX Time: when a packet is received display the packet is shown for X seconds
  • Display Timeout: display will turn OFF after X seconds for better power save (0 to disable and keep OLED ON)

Received

Here is the list of recently received stations with some details

Actions

Some shortcuts to useful functions such as manually send beacon

Update

This box allows firmware to be uploaded via OTA

Default WiFi Password:

  • Default WiFi Password is: xxxxxxxxxx
  • that is, 10 times x