mr-dwight-schrute / lorago2040

LoRaGo2040 Firmware

This is the firmware for the Uputronics LoRaGo2040 device which is a USB LoRa receiver for use with an Android phone or tablet or connected to a Windows PC.

Suitable host software includes:

HAB Explora for Android phones

HAB PADD for Android tablets

HAB Base for Windows

Lora Serial Gateway

Programming

Serial Protocol

If you want to write your own software then you need to know the serial protocol for controlling the device. The device appears as a serial port, and will send status information and incoming LoRa packets without being polled. Each of these is of the form

something=value

The somethings are, currently:

- CurrentRSSI=<RSSI>
- Message=<telemetry>
- Hex=<hex packet e.g. SSDV>
- FreqErr=<error in kHz>
- PacketRSSI=<RSSI>
- PacketSNR=<SNR>

The serial interface accepts a few commands, each of the form

~

(a trailing can be sent but is ignored). Accepted commands are responded to with an OK (* ) and rejected commands (unknown command, or invalid command value) with a WTF (? )

The current commands are:

- F<frequency in MHz>
- M<mode>
- B<bandwidth>
- E<error coding from 5 to 8>
- S<spreading factor from 6 to 11>
- I<1=implicit mode, 0=explicit mode>
- L(low data rate optimisation: 1=enable, 0=disable)
- T<data to transmit>

The supported modes are:

0 = (normal for telemetry) Explicit mode, Error coding 4:8, Bandwidth 20.8kHz, SF 11, Low data rate optimize on 1 = (normal for SSDV) Implicit mode, Error coding 4:5, Bandwidth 20.8kHz, SF 6, Low data rate optimize off 2 = (normal for repeater) Explicit mode, Error coding 4:8, Bandwidth 62.5kHz, SF 8, Low data rate optimize off

Bandwidth value strings can be 7K8, 10K4, 15K6, 20K8, 31K25, 41K7, 62K5, 125K, 250K, 500K