DecodingLora
Project DecodingLora | |
---|---|
Status | Initializing |
Contact | bertrik |
Last Update | 2016-01-03 |
This page is about understanding the LoRa RF modulation format.
LoRa is an abbreviation of Long Range, meaning it is an radio modulation format that gives longer range than straight FSK modulation. This is achieved by a combination of methods: it uses a spread spectrum technique called Chirp Spread Spectrum (CSS) and it uses forward error coding (in combination with whitening and interleaving).
To transmit or receive LoRa signals, you need to buy hardware that supports this modulation format.
The goal of this project is to collect more detailed information on the LoRa modulation and packet format. A concrete result could be that someone writes software which makes it possible to receive and decode LoRa signals with a cheap software defined radio, like rtlsdr.
Modulation basics
The LoRa modulation appears to be defined by the following parameters:
- the bandwidth BW, meaning the difference in minimum and maximum frequency
- the spreading factor SF
- the coding rate CR
On the air I have seen the following waveforms:
- a series of down-chirps at the start of a message (preamble)
- two up-chirps at the end of the preamble (sync-pattern)
- data-chirps, these consists of down-chirps (like the preamble), but with a jump in the "phase"/timing of the down-chirp. The frequency shift of this jump likely encodes one symbol representing several data bits (SF bits per symbol).
One symbol has a length in time of (2^SF)/BW. Chirps seem to have a constant chirp rate for a specific modulation setting, both when going up and down. When the frequency of a chirp reaches the end of the band, it "wraps around" to the other side. One chirp nominally covers the entire bandwidth BW once during one symbol time.
Investigation
Since the LoRa is basically a carrier being swept over a certain bandwidth in a specific way, it is possible to recover the frequency by FM demodulation of the signal generated by a Semtech chip, in my case from a hoperf RFM95 module.
The image on the right shows the LoRa spectrogram for a short message as recorded by gqrx, when sending a 1-byte payload (with settings SF=12,BW=8,CR=4/8, implicit header). At the bottom of the spectrogram you can see the preamble consisting of 10 up-chirps and 2 down-chirps. At the top of the spectrogram you see the data portion of the signal, consisting solely of up-chirps.
External links
- A nice explanation of the preamble and data modulation at link-labs
- Semtech AN1200.22 Lora modulation basics
- rtl-sdrangelove plugins f4exb github
- hexameron github