wayne roberts / Mbed OS LoRaWAN_singlechannel_endnode

end node on synchronous star LoRa network.

Dependencies:   SX127x sx12xx_hal TSL2561

radio chip selection

Radio chip driver is not included, allowing choice of radio device.
If you're using SX1272 or SX1276, then import sx127x driver into your program.
if you're using SX1261 or SX1262, then import sx126x driver into your program.
if you're using SX1280, then import sx1280 driver into your program.
If you're using NAmote72 or Murata discovery, then you must import only sx127x driver.

This project for use with LoRaWAN_singlechannel_gateway project.

Alternately gateway running on raspberry pi can be used as gateway.

LoRaWAN on single radio channel

Network description is at gateway project page. Synchronous star network.

Hardware Support

This project supports SX1276 and SX1272, sx126x kit, sx126x shield, and sx128x 2.4GHz. The ST board B-L072Z-LRWAN1 is also supported (TypeABZ module). When B-L072Z-LRWAN1 target is selected, TARGET_DISCO_L072CZ_LRWAN1 is defined by tools, allowing correct radio driver configuration for this platform. Alternately, any mbed board that can use LoRa radio shield board should work, but NUCLEO boards are tested.

End-node Unique ID

DevEUI is created from CPU serial number. AppEUI and AppKey are declared as software constants.

End-node Configuration

Data rate definition LORAMAC_DEFAULT_DATARATE configured in LoRaMac-definitions.h. See gateway project page for configuration of gateway.
LoRaWAN addressing is configured in Comissioning.h; only OTA mode is functional.
Header file board/lora_config.h, selects application layer options (i.e. sensors) to be compiled in.

Serial Interface

Serial port operates at 115200bps.
Application layer single_us915_main.cpp User button triggers uplink (i.e. blue button on nucleo board), or jumper enables continuously sends repeated uplink packets. The MAC layer holds each uplink request until the allocated timeslot.

commandargumentsdescription
?-print available commands
. (period)-print status (DevEUI, DevAddr, etc)
ullength integerset payload length of test uplink packets

sensor demo

Selected grove sensors may be plugged into SX1272 shield.
To enable, edit lora_config.h to define SENSORS.

Sensor connections on SX1272MB2xAS:

D8 D9: buttonRX TX: (unused)A3 A4: Rotary Angle Sensor
D6 D7: RGB LEDSCL SDA: digital light sensorA1 A2: Rotary Angle Sensor

Digital input pin, state reported via uplink: PC8
Digital output pin, controlled via downlink: PC6
PWM out: PB_10

Jumper enables auto-repeated transmit: PC10 and PC12 on NUCLEO board, located on end of morpho headers nearby JP4.

mac/LoRaMac-definitions.h@29:ad409c68c0a6, 2018-12-07 (annotated)

Committer:
Wayne Roberts
Date:
Fri Dec 07 17:57:41 2018 -0800
Revision:
29:ad409c68c0a6
Parent:
23:a862b5601663 
update to latest radio HAL

Who changed what in which revision?

UserRevisionLine numberNew contents of line
dudmuck 0:8f0d0ae0a077 1 /*
dudmuck 0:8f0d0ae0a077 2 / _____) _ | |
dudmuck 0:8f0d0ae0a077 3 ( (____ _____ ____ _| |_ _____ ____| |__
dudmuck 0:8f0d0ae0a077 4 \____ \| ___ | (_ _) ___ |/ ___) _ \
dudmuck 0:8f0d0ae0a077 5 _____) ) ____| | | || |_| ____( (___| | | |
dudmuck 0:8f0d0ae0a077 6 (______/|_____)_|_|_| \__)_____)\____)_| |_|
dudmuck 0:8f0d0ae0a077 7 (C)2013 Semtech
dudmuck 0:8f0d0ae0a077 8
dudmuck 0:8f0d0ae0a077 9 Description: LoRa MAC layer global definitions
dudmuck 0:8f0d0ae0a077 10
dudmuck 0:8f0d0ae0a077 11 License: Revised BSD License, see LICENSE.TXT file include in the project
dudmuck 0:8f0d0ae0a077 12 */
dudmuck 0:8f0d0ae0a077 13 #ifndef __LORAMAC_BOARD_H__
dudmuck 0:8f0d0ae0a077 14 #define __LORAMAC_BOARD_H__
dudmuck 0:8f0d0ae0a077 15
dudmuck 0:8f0d0ae0a077 16 /*!
dudmuck 0:8f0d0ae0a077 17 * Returns individual channel mask
dudmuck 0:8f0d0ae0a077 18 *
dudmuck 0:8f0d0ae0a077 19 * \param[IN] channelIndex Channel index 1 based
dudmuck 0:8f0d0ae0a077 20 * \retval channelMask
dudmuck 0:8f0d0ae0a077 21 */
dudmuck 0:8f0d0ae0a077 22 #define LC( channelIndex ) ( uint16_t )( 1 << ( channelIndex - 1 ) )
Wayne Roberts 29:ad409c68c0a6 23 #if defined(SX128x_H)
dudmuck 0:8f0d0ae0a077 24
Wayne Roberts 29:ad409c68c0a6 25 #define LORAMAC_DEFAULT_DATARATE 5 // 5=sf7
Wayne Roberts 29:ad409c68c0a6 26 #define LORAMAC_DEFAULT_TX_POWER 0
Wayne Roberts 29:ad409c68c0a6 27 #define LORAMAC_MAX_TX_POWER 0
Wayne Roberts 29:ad409c68c0a6 28 #define LORAMAC_MIN_TX_POWER 1
Wayne Roberts 29:ad409c68c0a6 29 #define LORAMAC_MIN_DATARATE 0 // slowest
Wayne Roberts 29:ad409c68c0a6 30 #define LORAMAC_MAX_DATARATE 9 // fastest
Wayne Roberts 29:ad409c68c0a6 31
Wayne Roberts 29:ad409c68c0a6 32 #elif defined( USE_BAND_915_SINGLE )
dudmuck 0:8f0d0ae0a077 33
dudmuck 0:8f0d0ae0a077 34 /*!
dudmuck 0:8f0d0ae0a077 35 * LoRaMac datarates definition
dudmuck 0:8f0d0ae0a077 36 */
dudmuck 0:8f0d0ae0a077 37 //#define DR_0 0 // SF10 - BW125 |
dudmuck 0:8f0d0ae0a077 38 //#define DR_1 1 // SF9 - BW125 |
dudmuck 0:8f0d0ae0a077 39 //#define DR_2 2 // SF8 - BW125 +-> Up link
dudmuck 0:8f0d0ae0a077 40 //#define DR_3 3 // SF7 - BW125 |
dudmuck 0:8f0d0ae0a077 41 //#define DR_4 4 // SF8 - BW500 |
dudmuck 0:8f0d0ae0a077 42 //#define DR_5 5 // RFU
dudmuck 0:8f0d0ae0a077 43 //#define DR_6 6 // RFU
dudmuck 0:8f0d0ae0a077 44 //#define DR_7 7 // RFU
dudmuck 0:8f0d0ae0a077 45 #define DR_8 8 // SF12 - BW500 |
dudmuck 0:8f0d0ae0a077 46 #define DR_9 9 // SF11 - BW500 |
dudmuck 0:8f0d0ae0a077 47 #define DR_10 10 // SF10 - BW500 |
dudmuck 0:8f0d0ae0a077 48 #define DR_11 11 // SF9 - BW500 |
dudmuck 0:8f0d0ae0a077 49 #define DR_12 12 // SF8 - BW500 +-> Down link
dudmuck 0:8f0d0ae0a077 50 #define DR_13 13 // SF7 - BW500 |
dudmuck 0:8f0d0ae0a077 51 #define DR_14 14 // RFU |
dudmuck 0:8f0d0ae0a077 52 #define DR_15 15 // RFU |
dudmuck 0:8f0d0ae0a077 53
dudmuck 23:a862b5601663 54 #define LORAMAC_MAX_TX_POWER TX_POWER_20_DBM
dudmuck 23:a862b5601663 55 #define LORAMAC_MIN_TX_POWER TX_POWER_00_DBM
dudmuck 0:8f0d0ae0a077 56
dudmuck 0:8f0d0ae0a077 57 /*!
dudmuck 0:8f0d0ae0a077 58 * LoRaMac TxPower definition
dudmuck 0:8f0d0ae0a077 59 */
dudmuck 0:8f0d0ae0a077 60 #define TX_POWER_30_DBM 0
dudmuck 0:8f0d0ae0a077 61 #define TX_POWER_28_DBM 1
dudmuck 0:8f0d0ae0a077 62 #define TX_POWER_26_DBM 2
dudmuck 0:8f0d0ae0a077 63 #define TX_POWER_24_DBM 3
dudmuck 0:8f0d0ae0a077 64 #define TX_POWER_22_DBM 4
dudmuck 0:8f0d0ae0a077 65 #define TX_POWER_20_DBM 5
dudmuck 0:8f0d0ae0a077 66 #define TX_POWER_18_DBM 6
dudmuck 0:8f0d0ae0a077 67 #define TX_POWER_16_DBM 7
dudmuck 0:8f0d0ae0a077 68 #define TX_POWER_14_DBM 8
dudmuck 0:8f0d0ae0a077 69 #define TX_POWER_12_DBM 9
dudmuck 0:8f0d0ae0a077 70 #define TX_POWER_10_DBM 10
dudmuck 23:a862b5601663 71 #define TX_POWER_08_DBM 11
dudmuck 23:a862b5601663 72 #define TX_POWER_06_DBM 12
dudmuck 23:a862b5601663 73 #define TX_POWER_04_DBM 13
dudmuck 23:a862b5601663 74 #define TX_POWER_02_DBM 14
dudmuck 23:a862b5601663 75 #define TX_POWER_00_DBM 15
dudmuck 0:8f0d0ae0a077 76
dudmuck 0:8f0d0ae0a077 77 /*!
dudmuck 0:8f0d0ae0a077 78 * LoRaMac maximum number of bands
dudmuck 0:8f0d0ae0a077 79 */
dudmuck 0:8f0d0ae0a077 80 #define LORA_MAX_NB_BANDS 1
dudmuck 0:8f0d0ae0a077 81 //
dudmuck 0:8f0d0ae0a077 82 // Band = { DutyCycle, TxMaxPower, LastTxDoneTime, TimeOff }
dudmuck 0:8f0d0ae0a077 83 #define BAND0 { 1, TX_POWER_20_DBM, 0/*, 0*/ } // 100.0 %
dudmuck 0:8f0d0ae0a077 84
dudmuck 0:8f0d0ae0a077 85
dudmuck 0:8f0d0ae0a077 86 /*!
dudmuck 0:8f0d0ae0a077 87 * Default datarate used by the node
dudmuck 0:8f0d0ae0a077 88 */
dudmuck 0:8f0d0ae0a077 89 //#define LORAMAC_DEFAULT_DATARATE DR_8 // SINGLE sf12 8192us
dudmuck 0:8f0d0ae0a077 90 //#define LORAMAC_DEFAULT_DATARATE DR_9 // SINGLE sf11 4096us
dudmuck 0:8f0d0ae0a077 91 //#define LORAMAC_DEFAULT_DATARATE DR_10 // SINGLE sf10 2048us
dudmuck 0:8f0d0ae0a077 92 //#define LORAMAC_DEFAULT_DATARATE DR_11 // SINGLE sf9 1024us
dudmuck 16:915815632c1f 93 //#define LORAMAC_DEFAULT_DATARATE DR_12 // SINGLE sf8 512us
dudmuck 16:915815632c1f 94 #define LORAMAC_DEFAULT_DATARATE DR_13 // SINGLE sf7 256us
dudmuck 0:8f0d0ae0a077 95
dudmuck 0:8f0d0ae0a077 96 /*!
dudmuck 0:8f0d0ae0a077 97 * Default Tx output power used by the node
dudmuck 0:8f0d0ae0a077 98 */
dudmuck 0:8f0d0ae0a077 99 #define LORAMAC_DEFAULT_TX_POWER TX_POWER_20_DBM
dudmuck 0:8f0d0ae0a077 100
dudmuck 0:8f0d0ae0a077 101 /*!
dudmuck 18:9ac71c0eb70d 102 * Minimal (slowest) datarate that can be used by the node
dudmuck 0:8f0d0ae0a077 103 */
dudmuck 18:9ac71c0eb70d 104 #define LORAMAC_MIN_DATARATE DR_8
dudmuck 0:8f0d0ae0a077 105
dudmuck 0:8f0d0ae0a077 106 /*!
dudmuck 18:9ac71c0eb70d 107 * Maximal (fastest) datarate that can be used by the node
dudmuck 0:8f0d0ae0a077 108 */
dudmuck 18:9ac71c0eb70d 109 #define LORAMAC_MAX_DATARATE DR_13
dudmuck 18:9ac71c0eb70d 110
dudmuck 18:9ac71c0eb70d 111 /* end us915 */
Wayne Roberts 29:ad409c68c0a6 112 #elif defined (USE_BAND_433)
dudmuck 18:9ac71c0eb70d 113 #define TX_POWER_10_DBM 0
dudmuck 18:9ac71c0eb70d 114 #define TX_POWER_07_DBM 1
dudmuck 18:9ac71c0eb70d 115 #define TX_POWER_04_DBM 2
dudmuck 18:9ac71c0eb70d 116 #define TX_POWER_01_DBM 3
dudmuck 18:9ac71c0eb70d 117 #define TX_POWER_M2_DBM 4
dudmuck 18:9ac71c0eb70d 118 #define TX_POWER_M5_DBM 5
dudmuck 18:9ac71c0eb70d 119
dudmuck 18:9ac71c0eb70d 120 #define LORAMAC_DEFAULT_TX_POWER TX_POWER_10_DBM
dudmuck 18:9ac71c0eb70d 121
dudmuck 18:9ac71c0eb70d 122 #define LORAMAC_MIN_TX_POWER TX_POWER_M5_DBM
dudmuck 18:9ac71c0eb70d 123 #define LORAMAC_MAX_TX_POWER TX_POWER_10_DBM
dudmuck 0:8f0d0ae0a077 124
dudmuck 18:9ac71c0eb70d 125 #define DR_0 0 // SF12 - BW125
dudmuck 18:9ac71c0eb70d 126 #define DR_1 1 // SF11 - BW125
dudmuck 18:9ac71c0eb70d 127 #define DR_2 2 // SF10 - BW125
dudmuck 18:9ac71c0eb70d 128 #define DR_3 3 // SF9 - BW125
dudmuck 18:9ac71c0eb70d 129 #define DR_4 4 // SF8 - BW125
dudmuck 18:9ac71c0eb70d 130 #define DR_5 5 // SF7 - BW125
dudmuck 18:9ac71c0eb70d 131 #define DR_6 6 // SF7 - BW250
dudmuck 18:9ac71c0eb70d 132 #define DR_7 7 // FSK
dudmuck 18:9ac71c0eb70d 133
dudmuck 18:9ac71c0eb70d 134 #define LORAMAC_MIN_DATARATE DR_0 // slowest
dudmuck 18:9ac71c0eb70d 135 #define LORAMAC_MAX_DATARATE DR_5 // fastest
dudmuck 18:9ac71c0eb70d 136
dudmuck 18:9ac71c0eb70d 137 //#define LORAMAC_DEFAULT_DATARATE DR_0 // sf12, 32768us
dudmuck 18:9ac71c0eb70d 138 //#define LORAMAC_DEFAULT_DATARATE DR_1 // sf11, 16384us
dudmuck 18:9ac71c0eb70d 139 //#define LORAMAC_DEFAULT_DATARATE DR_2 // sf10, 8192us
dudmuck 18:9ac71c0eb70d 140 //#define LORAMAC_DEFAULT_DATARATE DR_3 // sf9, 4096us
dudmuck 18:9ac71c0eb70d 141 //#define LORAMAC_DEFAULT_DATARATE DR_4 // sf8, 2048us
dudmuck 18:9ac71c0eb70d 142 #define LORAMAC_DEFAULT_DATARATE DR_5 // sf7, 1024us
dudmuck 18:9ac71c0eb70d 143
dudmuck 18:9ac71c0eb70d 144 /* end USE_BAND_433 */
dudmuck 0:8f0d0ae0a077 145 #else
dudmuck 0:8f0d0ae0a077 146 #error "Please define a frequency band in the compiler options."
dudmuck 0:8f0d0ae0a077 147 #endif
dudmuck 0:8f0d0ae0a077 148
dudmuck 0:8f0d0ae0a077 149 #endif // __LORAMAC_BOARD_H__