Skip to content

Commit

Permalink
Update README.md to contain instructions for Waveshare Pico-LoRa-SX12…
Browse files Browse the repository at this point in the history
…62-868M
  • Loading branch information
ThomasLeister committed Jan 16, 2022
1 parent bda1ce8 commit 8a7ab0a
Showing 1 changed file with 62 additions and 1 deletion.
63 changes: 62 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
# pico-lorawan
Enable LoRaWAN communications on your [Raspberry Pi Pico](https://www.raspberrypi.org/products/raspberry-pi-pico/) or any RP2040 based board using a [Semtech SX1276 radio module](https://www.semtech.com/apps/product.php?pn=SX1276).
Enable LoRaWAN communications on your [Raspberry Pi Pico](https://www.raspberrypi.org/products/raspberry-pi-pico/) or any RP2040 based board using a [Semtech SX1276 radio module](https://www.semtech.com/apps/product.php?pn=SX1276) or [Waveshare's SX1262-based LoRaWAN module](https://www.waveshare.com/wiki/Pico-LoRa-SX1262-868M).

Based on the Semtech's [LoRaWAN end-device stack implementation and example projects](https://github.com/Lora-net/LoRaMac-node).

Expand All @@ -11,9 +11,13 @@ Based on the Semtech's [LoRaWAN end-device stack implementation and example proj
* Semtech SX1276 board
* [Adafruit RFM95W LoRa Radio Transceiver Breakout - 868 or 915 MHz - RadioFruit](https://www.adafruit.com/product/3072)
* [Adafruit LoRa Radio FeatherWing - RFM95W 900 MHz - RadioFruit](https://www.adafruit.com/product/3231)
* Semtech SX1262 board
* [Waveshare Pico-LoRa-SX1262-868M](https://www.waveshare.com/wiki/Pico-LoRa-SX1262-868M) | [Shop](https://www.waveshare.com/pico-lora-sx1262-868m.htm)

### Default Pinout

Default Pinout for Semtech SX1276:

| Raspberry Pi Pico / RP2040 | Semtech SX1276 |
| ----------------- | -------------- |
| 3.3V | VCC |
Expand All @@ -26,8 +30,63 @@ Based on the Semtech's [LoRaWAN end-device stack implementation and example proj
| GPIO 9 | RESET |
| GPIO 10 | DIO1 / G1 |

Default Pinout for Semtech SX1262 on Waveshare Pico-LoRa-SX1262-868M:

| Raspberry Pi Pico / RP2040 | Waveshare Pico-LoRa-SX1262-868M |
| ----------------- | -------------- |
| 3.3V | VCC |
| GND | GND |
| GPIO 10 | SCK |
| GPIO 11 | MOSI |
| GPIO 12 | MISO |
| GPIO 3 | NSS / CS |
| GPIO 15 | RESET |
| GPIO 20 | DIO1 |
| GPIO 2 | BUSY |

GPIO pins are configurable in examples or API.

## Enabling support for Waveshare Pico-LoRa-SX1262-868M

By default this library only supports the Semtech SX1276 boards mentioned in the first section. Support for Waveshare's SX1262-based Raspberry Pi Pico Hat is available, but needs to be enabled actively.

Take the following steps to switch from SX1276 to Waveshare SX1262 support:

Uncomment

```
set(WITH_WAVESHARE_SX126X ON)
```

in `CMakeLists.txt`.

In your example application, e.g. otaa_temperature_led/ set the region to EU868 in `config.h`:

```
#define LORAWAN_REGION LORAMAC_REGION_EU868
```

_(and also provide your Device EUI, App EUI and App Key here!)_

In the example application's `main.c` make sure that you're using the proper `sx12xx_settings` for your SX1262 Waveshare module:

```
const struct lorawan_sx12xx_settings sx12xx_settings = {
.spi = {
.inst = spi1,
.mosi = 11,
.miso = 12,
.sck = 10,
.nss = 3
},
.reset = 15,
.busy = 2,
.dio1 = 20
};
```

_**There is no guarantee that other SX1262-based boards will work. Tests have only been run using Waveshare's board.**_

## Examples

See [examples](examples/) folder.
Expand Down Expand Up @@ -60,5 +119,7 @@ make

A big thanks to [Alasdair Allan](https://github.com/aallan) for his initial testing of EU868 support!

Thanks to Waveshare and [siuwahzhong](https://github.com/siuwahzhong) for providing their modified version of this library. Parts of their work have been merged back into this library by [Thomas Leister](https://github.com/ThomasLeister). Original source: [ZIP](https://www.waveshare.com/w/upload/0/08/Pico-LoRa-SX1262-868M_Code.zip) | [GitHub](https://github.com/siuwahzhong/lorawan-library-for-pico)

This project was created on behalf of the [Arm Software Developers](https://developer.arm.com/) team, follow them on Twitter: [@ArmSoftwareDev](https://twitter.com/armsoftwaredev) and YouTube: [Arm Software Developers](https://www.youtube.com/channel/UCHUAckhCfRom2EHDGxwhfOg) for more resources!

0 comments on commit 8a7ab0a

Please sign in to comment.