Arduino-LoRa-Ra01S

This is an Arduino library for LoRa Communication using the radio transceiver chips SX1262 and SX1268.

Ai-Thinker offers several LoRa modules.
You can get these on AliExpress and eBay.

Model	Type	Interface/Core	Chip	Frequency	Foot-Pattern	IPEX-Antena	LoRa-WAN
Ra-01	Tranceiver	SPI	SX1278	410-525Mhz	SMD16	No	No
Ra-02	Tranceiver	SPI	SX1278	410-525Mhz	SMD16	Yes	No
Ra-01H	Tranceiver	SPI	SX1276	803-930Mhz	SMD16	No	No
Ra-01S	Tranceiver	SPI	SX1268	410-525Mhz	SMD16	No	No
Ra-01SH	Tranceiver	SPI	SX1262	803-930Mhz	SMD16	Yes	No
Ra-01SC	Tranceiver	SPI	LLCC68	410-525Mhz	SMD16	Yes	No
Ra-06	MCU	ARM Cortex M0+	SX1278	410-525Mhz	SMD20	Yes	No
Ra-07	MCU	ARM Cortex M0+	ASR6501	410-525Mhz	SMD18	No	Yes
Ra-07H	MCU	ARM Cortex M0+	ASR6501	803-930Mhz	SMD18	No	Yes
Ra-08	MCU	ARM Cortex M4	ASR6601	410-525Mhz	SMD18	No	Yes
Ra-08H	MCU	ARM Cortex M4	ASR6601	803-930Mhz	SMD18	No	Yes

Option with SX1262/1268

LoRa modules with SX1262/1268 have several options.

Using TCXO(Temperature-Compensated Crystal Oscillator)
SX1262/1268 can use the TCXO.
If the TCXO is used, the XTB pin is not connected.
However, the 6th pin (DIO3) of the SX1262/1268 can be used to power the TCXO.
Explanation for TXCO and antenna control is here.
Ra-01S / Ra-01SH does not use TCXO.
Power supply modes
SX1262/1268 has two power supply modes.
One is that only LDO used in all modes.
Another is that DC_DC+LDO used for STBY_XOSC,FS, RX and TX modes.
Explanation for LDO and DCDC selection is here.
Ra-01S / Ra-01SH use only LDO in all modes.
RF-Switching
In general, use DIO2 to switch the RF-Switch.
However, some tranceiver use an external gpio to switch the RF-Switch.
Ra-01S / Ra-01SH use the SC70-6 integrated load switch to switch between RFO and RFI.
Ra-01S / Ra-01SH use DIO2 to control this.
DIO2 = 1, CTRL = 0, RFC to RF1 Tx Mode.
DIO2 = 0, CTRL = 1, RFC to R21 Rx Mode.

You need to look at the schematic to set these options properly, but it's very esoteric.
The default settings for this library are for Ra-01S / Ra-01SH.
When using other than Ra-01S / Ra-01SH, you need to set them appropriately.

I created this library based on this.
But with this library, Ra-01S / Ra-01SH doesn't work.

Datasheet

Foot pattern

RA-0x(SMD16) has the same foot pattern as ESP12.
Therefore, a pitch conversion PCB for ESP12 can be used.

Wireing

Ra-01S/SH		UNO	MEGA	ESP8266
VCC	--	3.3V(*1)	3.3V	3.3V
GND	--	GND	GND	GND
SCK	--	D13(*2)	D52(*2)	IO14
MISO	--	D12	D50	IO12
MOSI	--	D11(*2)	D51(*2)	IO13
NSS	--	D5(*2)	D5(*2)	IO2
RST	--	D6(*2)	D6(*2)	IO0
BUSY	--	D7(*2)	D7(*2)	IO16

(*1)
UNO's 3.3V output can only supply 50mA.
In addition, the output current capacity of UNO-compatible devices is smaller than that of official products.
So this module may not work normally when supplied from the on-board 3v3.

(*2)
SX126x is not 5V tolerant.
You need level shift from 5V to 3.3V.
I used this for a level shift.

Installing

Download this repo as zip. Then in the Arduino IDE go to Sketch->Add library->add .zip library.

Software compatibility

This library can communicate with RadioLib.

  // Set frequency: 866Mhz
  // Set bandwidth(BW): 125Khz
  // Set Spreading Factor(SF): 7
  // Set Error Cording Rate(CR): 4/5
  // Set SyncWord: 0x1424(Private Network)
  // Set Power: 10dBm
  // Set Preamble Length: 8
  // Configure the radio to NOT use a TCXO controlled by DIO3
  // Set regulator mode: DC-DC
  int state = radio.begin(866.0, 125.0, 7, 5, RADIOLIB_SX126X_SYNC_WORD_PRIVATE, 10, 8, 0.0, false);

Limitation

The SX126x chip implements FSK, but FSK is not supported in this library.
Interrupts is not supported in this library.

SX1262 and SX1278, SX1276 Comparison

This will be helpful.

Build ESP8266 with PlatformIO

$ git clone https://github.com/nopnop2002/Arduino-LoRa-Ra01S

$ cd Arduino-LoRa-Ra01S/example/Ra01S-RX/

$ pio init -b d1_mini

$ cp Ra01S-RX.ino src/

$ vi src/Ra01S-RX.ino
Disable AtMega
Enable ESP8266

$ vi platform.ini
[env:d1_mini]
platform = espressif8266
board = d1_mini
framework = arduino
lib_deps = https://github.com/nopnop2002/Arduino-LoRa-Ra01S --> Add this line

$ pio run -t upload && pio device monitor -b 115200

ut2uh / arduino-lora-ra01s Goto Github PK