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@23:a862b5601663, 2017-08-08 (annotated)

Committer:
dudmuck
Date:
Tue Aug 08 15:16:37 2017 -0700
Revision:
23:a862b5601663
Parent:
18:9ac71c0eb70d
Child:
29:ad409c68c0a6
sx1276 driver: support PaSelect on TYPE_ABZ module

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