wayne roberts
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.
| command | arguments | description |
|---|---|---|
? | - | print available commands |
. (period) | - | print status (DevEUI, DevAddr, etc) |
ul | length integer | set 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: button | RX TX: (unused) | A3 A4: Rotary Angle Sensor |
| D6 D7: RGB LED | SCL SDA: digital light sensor | A1 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@2:f2d9aa163652, 2017-05-23 (annotated)
- Committer:
- dudmuck
- Date:
- Tue May 23 17:50:14 2017 +0000
- Revision:
- 2:f2d9aa163652
- Parent:
- 0:8f0d0ae0a077
- Child:
- 16:915815632c1f
rejoin network after several missed beacons
Who changed what in which revision?
| User | Revision | Line number | New 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 | * LoRaMac maximum number of channels |
| dudmuck | 0:8f0d0ae0a077 | 76 | */ |
| dudmuck | 0:8f0d0ae0a077 | 77 | #define LORA_MAX_NB_CHANNELS 8 |
| dudmuck | 0:8f0d0ae0a077 | 78 | |
| dudmuck | 0:8f0d0ae0a077 | 79 | /*! |
| dudmuck | 0:8f0d0ae0a077 | 80 | * Default datarate used by the node |
| dudmuck | 0:8f0d0ae0a077 | 81 | */ |
| dudmuck | 0:8f0d0ae0a077 | 82 | //#define LORAMAC_DEFAULT_DATARATE DR_8 // SINGLE sf12 8192us |
| dudmuck | 0:8f0d0ae0a077 | 83 | //#define LORAMAC_DEFAULT_DATARATE DR_9 // SINGLE sf11 4096us |
| dudmuck | 0:8f0d0ae0a077 | 84 | //#define LORAMAC_DEFAULT_DATARATE DR_10 // SINGLE sf10 2048us |
| dudmuck | 0:8f0d0ae0a077 | 85 | //#define LORAMAC_DEFAULT_DATARATE DR_11 // SINGLE sf9 1024us |
| dudmuck | 2:f2d9aa163652 | 86 | #define LORAMAC_DEFAULT_DATARATE DR_12 // SINGLE sf8 512us |
| dudmuck | 2:f2d9aa163652 | 87 | //#define LORAMAC_DEFAULT_DATARATE DR_13 // SINGLE sf7 256us |
| dudmuck | 0:8f0d0ae0a077 | 88 | |
| dudmuck | 0:8f0d0ae0a077 | 89 | /*! |
| dudmuck | 0:8f0d0ae0a077 | 90 | * Default Tx output power used by the node |
| dudmuck | 0:8f0d0ae0a077 | 91 | */ |
| dudmuck | 0:8f0d0ae0a077 | 92 | #define LORAMAC_DEFAULT_TX_POWER TX_POWER_20_DBM |
| dudmuck | 0:8f0d0ae0a077 | 93 | |
| dudmuck | 0:8f0d0ae0a077 | 94 | /*! |
| dudmuck | 0:8f0d0ae0a077 | 95 | * Minimal datarate that can be used by the node |
| dudmuck | 0:8f0d0ae0a077 | 96 | */ |
| dudmuck | 0:8f0d0ae0a077 | 97 | #define LORAMAC_RX_MIN_DATARATE DR_8 |
| dudmuck | 0:8f0d0ae0a077 | 98 | |
| dudmuck | 0:8f0d0ae0a077 | 99 | /*! |
| dudmuck | 0:8f0d0ae0a077 | 100 | * Maximal datarate that can be used by the node |
| dudmuck | 0:8f0d0ae0a077 | 101 | */ |
| dudmuck | 0:8f0d0ae0a077 | 102 | #define LORAMAC_RX_MAX_DATARATE DR_13 |
| dudmuck | 0:8f0d0ae0a077 | 103 | |
| dudmuck | 0:8f0d0ae0a077 | 104 | #else |
| dudmuck | 0:8f0d0ae0a077 | 105 | #error "Please define a frequency band in the compiler options." |
| dudmuck | 0:8f0d0ae0a077 | 106 | #endif |
| dudmuck | 0:8f0d0ae0a077 | 107 | |
| dudmuck | 0:8f0d0ae0a077 | 108 | #endif // __LORAMAC_BOARD_H__ |