Compatible boards

Intro

All work was done on ESP32-WROOM with custom made RA-01/SX1278 LoRa shield, Arduino Board is "ESP32 Dev Module".

Supported LoRa and other module types

If using arduino-LoRa library then supported modules are SX1276/77/78/79.

If using RadioLib then supported modules - modules, which are supported by RadioLib:

• SX1278 is a default module, for other SX127x modules need to update module_name.h, replace MODULE_NAME with your module name according to RadioLib naming
• SX1268 is used when USE_SX126X is enabled in module_name.h, for other SX126x modules need to set corresponding MODULE_NAME in module_name.h
• other RadioLib module types - check RadioLib documentation, modify module_name.h and code accordingly, open Issue if help is needed, most likely it will not compile out of the box and some changes are needed.

If your ESP32 board is compatible or has build in LoRa module then it should work without redefining pinouts, for custom shields there might be need to redefine pinouts to LoRa module if it differs (see further description in Software Setup section), currently pinouts are connected from LoRa to ESP32-WROOM as (SS/RST/DIO0 could be redefined in config.h):

Default Pinouts

• Common SPI:
  • MOSI: GPIO_23/VSPI_MOSI
  • MISO: GPIO_19/VSPI_MISO
  • SCK: GPIO_18/VSPI_SCK
• Board specific:
  • SS/CS/NSS: GPIO_5
  • RST/RESET: GPIO_26
  • DIO0/IRQ: GPIO_14

SX127x Based Boards

Supported (built-in screen is not used), just select board in Arduino IDE->Tools->Board, no need to redefine pinouts:

• T-Beam LoRa
• LoPy, LoPy4
• TTGO LoRa32 v1

Pinout definition changes

Require LoRa module pinout definitions in config.h:

• Heltec WiFi LoRa 32 (v2), redefine pinouts as

  #define LORA_RST              14
  #define LORA_IRQ              26