This program is guided to help establish a connection between two RFM95 900MHz LoRa radio modules using Maxim Integrated's Feather MCUs (MAX32630FTHR Mbed and the MAX32620FTHR Mbed). Once the radios are configured after powering on and if the radios are wired correctly, the two radios will self identify as either a master or a slave, and will then proceed to PING and PONG back and forth. Information about what is happening between the radios can be seen if the two boards are hooked up to a USB COM port through the included DAPLINK modules.

Dependencies:   BMI160 BufferedSerial SX1276GenericLib USBDeviceHT max32630fthr

Fork of MAX326xxFTHR_LoRa_RFM95 by Central Applications - Mbed Code repo

RFM95 LoRa Example Ping Pong Program

Getting Started

This program has the support for sx1276 (Adafruit RFM95W LoRa Radio Transceiver Breakout - 900 MHz) and (Adafruit LoRa Radio FeatherWing - RFM95W 900 MHz) to work with a few different mbed boards (see PinMap.h for supported boards). However, this specific program is set up to work with the following mbed boards and RFM95 915MHz LoRa radios and the given pin diagrams without modifications: MAX32620FTHR and MAX32630FTHR.

Configuring the LoRa Radio

The setup for the radio can be found in <<SX1276GenericPingPong/GenericPingPong.cpp>>, which can be found by navigating from the root directory. Setup for the radio starts on line #14 in <<SX1276GenericPingPong/GenericPingPong.cpp>>.

Choosing the Correct Frequency

This program was written with libraries compatible with RFM95 LoRa 900MHz Radio modules. The radio's frequency is able to be tuned dynamically, however this program configures the frequency by programming registers at device power on. The 900MHz module supports both 868MHz and 915MHz operation. Check local laws for which band around 900MHz is set aside for the scientific, commercial, and/or license free usage in your country. The supported frequencies can be found in <<SX1276GenericLib.lib/sx1276/sx1276.h>>

They are also listed below for convenience:

SX1276GenericLib.lib/sx1276/sx1276.h

typedef enum {
    RF_FREQUENCY_868_0 = 868000000, //Hz
    RF_FREQUENCY_868_1 = 868100000, //Hz
    RF_FREQUENCY_868_3 = 868300000, //Hz
    RF_FREQUENCY_868_5 = 868500000, //Hz
    RF_FREQUENCY_915_0 = 915000000, //Hz
    RF_FREQUENCY_915_1 = 915100000, //Hz
    RF_FREQUENCY_915_3 = 915300000, //Hz
    RF_FREQUENCY_915_5 = 915500000, //Hz
} rf_frequency_t;

Please chose a supported frequency above that is compatible with your RFM95 (or likewise single band compatible sx1276 radio) module and change line #22 in <<SX1276GenericPingPong/GenericPingPong.cpp>> to the correct enum above.

Wiring

This program is aimed at working without modifications with RFM95W LoRa 900MHz modules in both a Breakout board and a FeatherWing version.

FeatherWing setup

This wiring diagram is useful if your RFM95W LoRa 900MHz module is a Feather wing made by Adafruit.

Before jumpers are soldered in:

/media/uploads/dev_alexander/feather_pinouts.jpg

After jumpers are soldered in:

/media/uploads/dev_alexander/rfm95_feather_pinouts_drawn_in.jpg

Note: The default pin configurations for the radio in this program (found in <<PinMap.h>> under targets MAX32630FTHR and MAX32630FTHR ) can be changed to suite additional modifications built from a fork of this program repo. If this is the case, the diagrams above will need to be changed to suite the new pin map.

For more information, a detailed wiring guide for the RFM95W Featherwing can be found here.

Breakout Board

For a breakout board, the following wiring diagram will work with both the MAX32630FTHR and the MAX32630FTHR mbed boards if wired in the same locations:

Before the RFM95W is connected with wires:

/media/uploads/dev_alexander/rfm95_breakout_pinouts.jpg

After the RFM95W is connected with wires:

/media/uploads/dev_alexander/rfm95_breakout_pinouts_drawn_in.jpg

The representations of the connections above can be found in<<PinName.h>> under targets MAX32630FTHR and MAX32630FTHR.

This default pin configuration will set you up with a connection to the MCU.

For more information, a detailed wiring guide for the RFM95W Brakout Board can be found here.

Antenna

Since this is radio communication, we are going to need antennas to be attached to both of the Radios used in this example.

For more information on how to solder an antenna to the RFM95, please click here

Committer:
Helmut64
Date:
Tue Jan 30 09:51:21 2018 +0000
Revision:
15:c70f65d606c4
Parent:
13:5a32a1922fbc
Child:
16:675f4d0ee9e9
Added STM32L432KC into PinMap.h

Who changed what in which revision?

UserRevisionLine numberNew contents of line
Helmut64 0:c43b6919ae15 1 /*
Helmut64 0:c43b6919ae15 2 * Copyright (c) 2017 Helmut Tschemernjak
Helmut64 0:c43b6919ae15 3 * 30826 Garbsen (Hannover) Germany
Helmut64 0:c43b6919ae15 4 * Licensed under the Apache License, Version 2.0);
Helmut64 0:c43b6919ae15 5 */
Helmut64 0:c43b6919ae15 6
Helmut64 0:c43b6919ae15 7
Helmut64 0:c43b6919ae15 8
Helmut64 0:c43b6919ae15 9 #ifdef TARGET_NUCLEO_L476RG
Helmut64 0:c43b6919ae15 10 #define FEATURE_LORA 1
Helmut64 9:2f9e4be4d046 11 #elif TARGET_DISCO_L072CZ_LRWAN1
Helmut64 0:c43b6919ae15 12 #define FEATURE_LORA 1
Helmut64 15:c70f65d606c4 13 #elif NUCLEO_L432KC
Helmut64 15:c70f65d606c4 14 #define FEATURE_LORA 1
Helmut64 0:c43b6919ae15 15 #endif
Helmut64 0:c43b6919ae15 16
Helmut64 0:c43b6919ae15 17
Helmut64 0:c43b6919ae15 18
Helmut64 13:5a32a1922fbc 19 #if defined(TARGET_DISCO_L072CZ_LRWAN1)
Helmut64 0:c43b6919ae15 20
Helmut64 0:c43b6919ae15 21 #define LORA_SPI_MOSI PA_7
Helmut64 0:c43b6919ae15 22 #define LORA_SPI_MISO PA_6
Helmut64 0:c43b6919ae15 23 #define LORA_SPI_SCLK PB_3
Helmut64 0:c43b6919ae15 24 #define LORA_CS PA_15
Helmut64 0:c43b6919ae15 25 #define LORA_RESET PC_0
Helmut64 0:c43b6919ae15 26 #define LORA_DIO0 PB_4
Helmut64 0:c43b6919ae15 27 #define LORA_DIO1 PB_1
Helmut64 0:c43b6919ae15 28 #define LORA_DIO2 PB_0
Helmut64 13:5a32a1922fbc 29 #define LORA_DIO3 PC_13
Helmut64 0:c43b6919ae15 30 #define LORA_DIO4 PA_5
Helmut64 0:c43b6919ae15 31 #define LORA_DIO5 PA_4
Helmut64 0:c43b6919ae15 32 #define LORA_ANT_RX PA_1
Helmut64 0:c43b6919ae15 33 #define LORA_ANT_TX PC_2
Helmut64 0:c43b6919ae15 34 #define LORA_ANT_BOOST PC_1
Helmut64 0:c43b6919ae15 35 #define LORA_TCXO PA_12 // 32 MHz
Helmut64 0:c43b6919ae15 36
Helmut64 0:c43b6919ae15 37
Helmut64 0:c43b6919ae15 38
Helmut64 0:c43b6919ae15 39 #elif defined(TARGET_NUCLEO_L476RG) // using the RFM95 board
Helmut64 0:c43b6919ae15 40
Helmut64 0:c43b6919ae15 41 #define LORA_SPI_MOSI PC_12
Helmut64 0:c43b6919ae15 42 #define LORA_SPI_MISO PC_11
Helmut64 0:c43b6919ae15 43 #define LORA_SPI_SCLK PC_10
Helmut64 0:c43b6919ae15 44 #define LORA_CS PA_0
Helmut64 0:c43b6919ae15 45 #define LORA_RESET PA_1
Helmut64 0:c43b6919ae15 46 #define LORA_DIO0 PD_2 // DIO0=TxDone/RXDone
Helmut64 0:c43b6919ae15 47 #define LORA_DIO1 PB_7 //
Helmut64 0:c43b6919ae15 48 #define LORA_DIO2 PC_14 // DIO2=FhssChangeChannel
Helmut64 0:c43b6919ae15 49 #define LORA_DIO3 PC_15 // DIO3=CADDone
Helmut64 0:c43b6919ae15 50 #define LORA_DIO4 PH_0 // ????
Helmut64 0:c43b6919ae15 51 #define LORA_DIO5 NC // unused?
Helmut64 0:c43b6919ae15 52
Helmut64 15:c70f65d606c4 53 #elif defined(TARGET_NUCLEO_L432KC) // using the RFM95 board
Helmut64 15:c70f65d606c4 54
Helmut64 15:c70f65d606c4 55
Helmut64 15:c70f65d606c4 56 #define LORA_SPI_MOSI PC_12
Helmut64 15:c70f65d606c4 57 #define LORA_SPI_MISO PC_11
Helmut64 15:c70f65d606c4 58 #define LORA_SPI_SCLK PC_10
Helmut64 15:c70f65d606c4 59 #define LORA_CS PA_0
Helmut64 15:c70f65d606c4 60 #define LORA_RESET PA_1
Helmut64 15:c70f65d606c4 61 #define LORA_DIO0 PD_2 // DIO0=TxDone/RXDone/CADDone
Helmut64 15:c70f65d606c4 62 #define LORA_DIO1 NC //
Helmut64 15:c70f65d606c4 63 #define LORA_DIO2 NC //
Helmut64 15:c70f65d606c4 64 #define LORA_DIO3 NC //
Helmut64 15:c70f65d606c4 65 #define LORA_DIO4 NC //
Helmut64 15:c70f65d606c4 66 #define LORA_DIO5 NC //
Helmut64 0:c43b6919ae15 67 #endif