Arduino library for LoRa communication with Semtech SX126x chips. It is based on Semtech's SX126x libraries and adapted to the Arduino framework for ESP32, ESP8266, NRF52840 and nRF52832. It will not work with other uC's like AVR.
To install this library:
install it using the Arduino Library manager ("Sketch" -> "Include Library" -> "Manage Libraries..."), or download a zipfile from github using the "Download ZIP" button and install it using the IDE ("Sketch" -> "Include Library" -> "Add .ZIP Library..." clone this git repository into your sketchbook/libraries folder. For more info, see https://www.arduino.cc/en/Guide/Libraries
This library is intended to be used with plain LoRa transceivers, connecting to them using SPI. In particular, the SX126x LoRa family families are supported (which should include SX1262, SX1268 and SX126x which only differ in the available frequencies, bandwidths and spreading factors).
Some of the supported pre-built board currently available in the market are:
- Electronic Cats BastFrontier
- RakWisBlock
- RAKwireless WisCore RAK4630
This library has been tested using:
- ESP8266
- ESP32
- NRF52840 core mbed
- NRF52832 RAK
- Insight SIP ISP4520
- Semtech open source code for SX126x chips SX126xLib
- Insight SIP open source code for ISP4520 module LIBRARY - Source Code Examples
- Support SX1261, SX1262 and SX1268 chips
- Support of LoRa protocol and FSK protocol (theoretical, I did not test FSK at all)
- Flexible setup for different modules (antenna control, TXCO control)
- Support LoRaWan node class A, B and C tested with single channel LoRaWan gateway
Electronic Cats invests time and resources providing this open source design, please support Electronic Cats and open-source hardware by purchasing products from Electronic Cats!
Library published under MIT license
Semtech revised BSD license for codeparts used from Semtech S.A.
--- Revised BSD License ---
Copyright (c) 2013, SEMTECH S.A.
All rights reserved.
Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions are met:
* Redistributions of source code must retain the above copyright
notice, this list of conditions and the following disclaimer.
* Redistributions in binary form must reproduce the above copyright
notice, this list of conditions and the following disclaimer in the
documentation and/or other materials provided with the distribution.
* Neither the name of the Semtech corporation nor the
names of its contributors may be used to endorse or promote products
derived from this software without specific prior written permission.
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
DISCLAIMED. IN NO EVENT SHALL SEMTECH S.A. BE LIABLE FOR ANY
DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.