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@18:9ac71c0eb70d, 2017-08-02 (annotated)

Committer:
dudmuck
Date:
Wed Aug 02 11:42:33 2017 -0700
Revision:
18:9ac71c0eb70d
Parent:
16:915815632c1f
Child:
23:a862b5601663
add pwm commands and 434MHz band

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 0:8f0d0ae0a077 48 #define LORAMAC_MAX_TX_POWER TX_POWER_26_DBM
dudmuck 0:8f0d0ae0a077 49 #define LORAMAC_MIN_TX_POWER TX_POWER_10_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 0:8f0d0ae0a077 65
dudmuck 0:8f0d0ae0a077 66 /*!
dudmuck 0:8f0d0ae0a077 67 * LoRaMac maximum number of bands
dudmuck 0:8f0d0ae0a077 68 */
dudmuck 0:8f0d0ae0a077 69 #define LORA_MAX_NB_BANDS 1
dudmuck 0:8f0d0ae0a077 70 //
dudmuck 0:8f0d0ae0a077 71 // Band = { DutyCycle, TxMaxPower, LastTxDoneTime, TimeOff }
dudmuck 0:8f0d0ae0a077 72 #define BAND0 { 1, TX_POWER_20_DBM, 0/*, 0*/ } // 100.0 %
dudmuck 0:8f0d0ae0a077 73
dudmuck 0:8f0d0ae0a077 74
dudmuck 0:8f0d0ae0a077 75 /*!
dudmuck 0:8f0d0ae0a077 76 * Default datarate used by the node
dudmuck 0:8f0d0ae0a077 77 */
dudmuck 0:8f0d0ae0a077 78 //#define LORAMAC_DEFAULT_DATARATE DR_8 // SINGLE sf12 8192us
dudmuck 0:8f0d0ae0a077 79 //#define LORAMAC_DEFAULT_DATARATE DR_9 // SINGLE sf11 4096us
dudmuck 0:8f0d0ae0a077 80 //#define LORAMAC_DEFAULT_DATARATE DR_10 // SINGLE sf10 2048us
dudmuck 0:8f0d0ae0a077 81 //#define LORAMAC_DEFAULT_DATARATE DR_11 // SINGLE sf9 1024us
dudmuck 16:915815632c1f 82 //#define LORAMAC_DEFAULT_DATARATE DR_12 // SINGLE sf8 512us
dudmuck 16:915815632c1f 83 #define LORAMAC_DEFAULT_DATARATE DR_13 // SINGLE sf7 256us
dudmuck 0:8f0d0ae0a077 84
dudmuck 0:8f0d0ae0a077 85 /*!
dudmuck 0:8f0d0ae0a077 86 * Default Tx output power used by the node
dudmuck 0:8f0d0ae0a077 87 */
dudmuck 0:8f0d0ae0a077 88 #define LORAMAC_DEFAULT_TX_POWER TX_POWER_20_DBM
dudmuck 0:8f0d0ae0a077 89
dudmuck 0:8f0d0ae0a077 90 /*!
dudmuck 18:9ac71c0eb70d 91 * Minimal (slowest) datarate that can be used by the node
dudmuck 0:8f0d0ae0a077 92 */
dudmuck 18:9ac71c0eb70d 93 #define LORAMAC_MIN_DATARATE DR_8
dudmuck 0:8f0d0ae0a077 94
dudmuck 0:8f0d0ae0a077 95 /*!
dudmuck 18:9ac71c0eb70d 96 * Maximal (fastest) datarate that can be used by the node
dudmuck 0:8f0d0ae0a077 97 */
dudmuck 18:9ac71c0eb70d 98 #define LORAMAC_MAX_DATARATE DR_13
dudmuck 18:9ac71c0eb70d 99
dudmuck 18:9ac71c0eb70d 100 /* end us915 */
dudmuck 18:9ac71c0eb70d 101 #elif defined (USE_BAND_433) && defined (ENABLE_SX1276)
dudmuck 18:9ac71c0eb70d 102 #define TX_POWER_10_DBM 0
dudmuck 18:9ac71c0eb70d 103 #define TX_POWER_07_DBM 1
dudmuck 18:9ac71c0eb70d 104 #define TX_POWER_04_DBM 2
dudmuck 18:9ac71c0eb70d 105 #define TX_POWER_01_DBM 3
dudmuck 18:9ac71c0eb70d 106 #define TX_POWER_M2_DBM 4
dudmuck 18:9ac71c0eb70d 107 #define TX_POWER_M5_DBM 5
dudmuck 18:9ac71c0eb70d 108
dudmuck 18:9ac71c0eb70d 109 #define LORAMAC_DEFAULT_TX_POWER TX_POWER_10_DBM
dudmuck 18:9ac71c0eb70d 110
dudmuck 18:9ac71c0eb70d 111 #define LORAMAC_MIN_TX_POWER TX_POWER_M5_DBM
dudmuck 18:9ac71c0eb70d 112 #define LORAMAC_MAX_TX_POWER TX_POWER_10_DBM
dudmuck 0:8f0d0ae0a077 113
dudmuck 18:9ac71c0eb70d 114 #define DR_0 0 // SF12 - BW125
dudmuck 18:9ac71c0eb70d 115 #define DR_1 1 // SF11 - BW125
dudmuck 18:9ac71c0eb70d 116 #define DR_2 2 // SF10 - BW125
dudmuck 18:9ac71c0eb70d 117 #define DR_3 3 // SF9 - BW125
dudmuck 18:9ac71c0eb70d 118 #define DR_4 4 // SF8 - BW125
dudmuck 18:9ac71c0eb70d 119 #define DR_5 5 // SF7 - BW125
dudmuck 18:9ac71c0eb70d 120 #define DR_6 6 // SF7 - BW250
dudmuck 18:9ac71c0eb70d 121 #define DR_7 7 // FSK
dudmuck 18:9ac71c0eb70d 122
dudmuck 18:9ac71c0eb70d 123 #define LORAMAC_MIN_DATARATE DR_0 // slowest
dudmuck 18:9ac71c0eb70d 124 #define LORAMAC_MAX_DATARATE DR_5 // fastest
dudmuck 18:9ac71c0eb70d 125
dudmuck 18:9ac71c0eb70d 126 //#define LORAMAC_DEFAULT_DATARATE DR_0 // sf12, 32768us
dudmuck 18:9ac71c0eb70d 127 //#define LORAMAC_DEFAULT_DATARATE DR_1 // sf11, 16384us
dudmuck 18:9ac71c0eb70d 128 //#define LORAMAC_DEFAULT_DATARATE DR_2 // sf10, 8192us
dudmuck 18:9ac71c0eb70d 129 //#define LORAMAC_DEFAULT_DATARATE DR_3 // sf9, 4096us
dudmuck 18:9ac71c0eb70d 130 //#define LORAMAC_DEFAULT_DATARATE DR_4 // sf8, 2048us
dudmuck 18:9ac71c0eb70d 131 #define LORAMAC_DEFAULT_DATARATE DR_5 // sf7, 1024us
dudmuck 18:9ac71c0eb70d 132
dudmuck 18:9ac71c0eb70d 133 /* end USE_BAND_433 */
dudmuck 0:8f0d0ae0a077 134 #else
dudmuck 0:8f0d0ae0a077 135 #error "Please define a frequency band in the compiler options."
dudmuck 0:8f0d0ae0a077 136 #endif
dudmuck 0:8f0d0ae0a077 137
dudmuck 0:8f0d0ae0a077 138 #endif // __LORAMAC_BOARD_H__