- SX1276 is a LoRa modem that can send and receive data over a long distance (kilometers away) in an enery-efficient way.
- This repo is to help the beginner learning how to operate the SX1276 chip (do basic transmittion/Tx and reception/Rx).
- This repo is almost a rewrite of martynwheeler/u-lora with extensive annotations.
- Code is compatible with jgromes/RadioLib (An popular Arduino LoRa Library)
- Many ESP32 LoRa development boards (Heltec WiFi LoRa 32 V2, TTGO T-Beam V1.1 ) are using SX1276.
- Adafruit created a standalone breakout based on SX1276: Adafruit RFM95W
- Either way, the MCU talks to the SX1276 chip via a SPI interface.
- MAC link layer is implemented in another repo
- Adressing
- Broadcasting
- Request Acknowledgement
- Frequency Hopping is also implemented to tranmit large packet since we abide by FCC 15.247: Don't jam one frequency.
Wiring RFM95W with Pico
- We decide which GPIO we want to use
# RFM95W Pico GPIO
LoRa_MISO_Pin = 16
LoRa_CS_Pin = 17
LoRa_SCK_Pin = 18
LoRa_MOSI_Pin = 19
LoRa_G0_Pin = 20 # DIO0_Pin
LoRa_EN_Pin = 21
LoRa_RST_Pin = 22
SPI_CH = 0
Heltec WiFi LoRa 32 V2
- Predefined (see the pinout)
LoRa_MISO_Pin = 19
LoRa_MOSI_Pin = 27
LoRa_SCK_Pin = 5
LoRa_CS_Pin = 18
LoRa_RST_Pin = 14
LoRa_DIO0_Pin = 26
LoRa_DIO1_Pin = 35
LoRa_DIO2_Pin = 34
SPI_CH = 1
TTGO T-Beam V1.1
- Predefined (see the pinout)
LoRa_MISO_Pin = 19
LoRa_MOSI_Pin = 27
LoRa_SCK_Pin = 5
LoRa_CS_Pin = 18
LoRa_RST_Pin = 23
LoRa_DIO0_Pin = 26
- Enable the Adafruit RFM95W before use (No enable pin on other ESP32 development boards so they are always enabled)
- Configure SPI communication to control the LoRa modem
- Choose LoRa mode instead of FSK/OOK mode
- Set parameters: bandwidth (bw), coding rate (CR), header mode, spreading factor (SF), syncword, preamble length, frequency, amplifier.
- Following waterfall diagram is what the signal out of LoRa modem looks like, I might provide a tutorial about parameters in the future
- Set an interrupt routine service (IRS) to read incoming message and to monitor modem's working status
- When message is received during Rx, an IRS is triggered and we read FIFO data buffer. We write FIFO data buffer before the message is sent and then an IRS is triggered during Tx.
- Waterfall diagram that shows the physical representation of modulated signal.
- Header (exists in explicit mode): Payload length, payload's coding rate
- Explicit header's coding rate is 4/8 and payload's could be different (Tx tells Rx which CR Tx uses).
- SF is for whole packet
- The LoRa ® modem comprises three types of digital interface,
- static configuration registers
- status registers
- a 256-byte user-defined FIFO data buffer
- We control the modem through this digital interface
- Practically, we read/write modem's registers via SPI protocol so we can configure its parameters (static configuration registers), query status, send or receive data (buffer registers).
- In order to write packet data into FIFO user should:
- Set register RegFifoAddrPtr's content to *RegFifoTxBaseAddr (register RegFifoTxBaseAddr's content).
- Write *RegPayloadLength bytes to the FIFO (RegFifo)
- In order to read packet data from FIFO user should:
- Set RegFifoAddrPtr to *RegFifoRxCurrentAddr.
- Read RegRxNbBytes from RegFifo
Jargon in Datasheet
- RF: Radio Frequency
- RFI: RF Input
- RFO: RF Output
- { High Frequency: {Band 1: ~915MHz}, LF: {Band 2: ~433MHz, Band 3: ~150MHz} }
- PA: Power Amplifier
- Three amplifiers: RFO_LF, RFO_HF, PA_BOOST
- PA_HP: High Power
- PA_HF and PA_LF are high efficiency amplifiers
- AFC: automatic frequency correction
- RFOP: RF output power
- Change to Standby mode so the modem initializes everything
- Start Tx loop
- Prepare payload to Tx
- Fill FIFO data buffer with payload
- Change to Tx mode
- Wait for TxDone IRQ
- In ISR, do something and clear IRQ Flags
- Fall back to Standby mode automatically
- Change to Standby mode so the modem initiate everything
- Change to Rx Continuous mode
- Wait for IRQ (RxDone and ValidHeader/PayloadCrcError)
- In ISR, Read FIFO data buffer to get payload
- Next IRQ and next FIFO reading
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent