Uttam Bhat
SX1276 Shield based Applications
Dependencies: X_NUCLEO_IKS01A1 LoRaWAN-lib SX1276Lib mbed
LoRaWAN-SX1276-Application Demo uses SX1276MB1LAS mbed component shield on a nucleo board platform to demonstrate a Class-A LoRaWAN device in the 915MHz ISM band for North American region. It uses the LoRaWAN-lib and SX1276Lib libraries.
Comissioning.h (LoRaWAN Network Configuration)
The end-device can be activated in one of the two ways:
Over the Air (OTA) activation can be enabled as shown in the figure below.
The end-device must be configured with the following parameters:
LORAWAN_DEVICE_EUI(8 Bytes) : Fist 3 Bytes is the Organizationally Unique Identifier (OUI) followed by 5 bytes of unique ID. If not defined by user, then the firmware automatically assigns one to the end-deviceLORAWAN_APPLICATION_EUI(8 Bytes)LORAWAN_APPLICATION_KEY(or DEVKEY) (16 Bytes)
Activation by Personalization (ABP) can be enabled as shown in the figure below.
The end-device must be configured with the following parameters:
LORAWAN_DEVICE_ADDRESS(4 Bytes) : If not defined by user, then the firmware automatically assigns one to the end-deviceLORAWAN_NWKSKEY(16 Bytes)LORAWAN_APPSKEY(16 Bytes)
Config.h (LoRaWAN Communication Parameters)
- Mode of Operation : Hybrid
If the end-device needs to be configured to operate over 8-channels, then
Hybrid Modeneeds to be enabled
- Mode of Operation : Frequency Hop
If the end-device needs to be configured to operate over 64-channels, then
Hybrid Modeneeds to be disabled
- Delay between successive JOIN REQUESTs :
The delay between successive Join Requests (until the end-device joins the network) can be configured using the parameter
OVER_THE_AIR_ACTIVATION_DUTYCYCLE
- Inter-Frame Delay :
One can change the delay between each frame transmission using
APP_TX_DUTYCYCLEIt is advisable thatAPP_TX_DUTYCYCLEis greater than or equal to 3sec.
- Data Rate :
The data rate can be configured as per LoRaWAN specification using the paramter
LORAWAN_DEFAULT_DATARATE. The range of values are DR_0, DR_1, DR_2, DR_3 and DR_4
- Confirmed/Unconfirmed Messages :
The uplink message or payload can be chosen to be confirmed or unconfirmed using the parameter
LORAWAN_CONFIRMED_MSG_ON. When set to 1, the transmitted messages need to be confirmed with anACKby the network server in the subsequent RX window. When set to 0, noACKis requested.
- ADR ON/OFF :
The ADR can be enabled or disabled using the parameter
LORAWAN_ADR_ON. When set to 1, ADR is enabled and disabled when set to 0.
- Application Port :
The application port can be set using parameter
LORAWAN_APP_PORT. A few examples are associated to specific Application Port, and are defined in Config.h
- Payload Length :
The lenght of the payload (in bytes) to be transmitted can be configured using
LORAWAN_APP_DATA_SIZE
- Transmit Power :
The transmit power can be configured using
LORAWAN_TX_POWER(LoRaMAC verifies if the set power is compliant with the LoRaWAN spec and FCC guidelines)
The baud-rate for serial terminal display is 115200
app/Config.h
- Committer:
- ubhat
- Date:
- 2016-08-27
- Revision:
- 2:78df92a365c2
- Parent:
- 1:80c1daf19aa4
- Child:
- 3:4bca7f8f731a
File content as of revision 2:78df92a365c2:
/*
/ _____) _ | |
( (____ _____ ____ _| |_ _____ ____| |__
\____ \| ___ | (_ _) ___ |/ ___) _ \
_____) ) ____| | | || |_| ____( (___| | | |
(______/|_____)_|_|_| \__)_____)\____)_| |_|
(C)2015 Semtech
Description: End device communication parameters
License: Revised BSD License, see LICENSE.TXT file include in the project
Maintainer: Uttam Bhat
*/
#ifndef __LORA_CONFIG_H__
#define __LORA_CONFIG_H__
/*!
* Configure End-Device to use 8-channels corresponding to Block A
* Comment/Uncomment to disable/enable Hybrid mode
*/
#define USE_BAND_915_HYBRID
#ifndef USE_BAND_915_HYBRID
/*!
* Configure End-Device to use 64-channels across to Block A thru Block H
*/
#define USE_BAND_915
#endif
/*!
* Join requests trials periodicity. It is the time between RX1/RX2 and next TX
*/
#define OVER_THE_AIR_ACTIVATION_DUTYCYCLE 5000000 // value in us
/*!
* Defines the application data transmission periodicity. It is the time between RX1/RX2 and next TX
*/
#define APP_TX_DUTYCYCLE 5000000 // value in us
/*!
* LoRaWAN confirmed messages
* \remark 1 : Confirmed messages enabled. Must receive ACK from network server
0 : Confirmed messages disabled.
*/
#define LORAWAN_CONFIRMED_MSG_ON 1
/*!
* LoRaWAN Adaptive Data Rate
*
* \remark Please note that when ADR is enabled the end-device uses default datarate of DR_0
*/
#define LORAWAN_ADR_ON 0
/*!
* Default mote datarate
* \remark DR_0 : 980 bps; DR_1 : 1760 bps; DR_2 : 3125 bps; DR_3 : 5470 bps; DR_4 : 12500 bps
*/
#define LORAWAN_DEFAULT_DATARATE DR_0
/*!
* LoRaWAN application port
*/
#define LORAWAN_APP_PORT 8
/*!
* LoRaWAN User defined Tx Power
*
* \remark The Tx power level is set as TX_POWER_P_DBM, where 10 <= P <= 30 and P is even value { i.e. P = 10, 12, 14 ... 28 or 30 }
*/
#define LORAWAN_TX_POWER TX_POWER_20_DBM
#if ( LORAWAN_APP_PORT == 5 )
/*====================================================
US01 GPS APPLICATION DEMO (PORT 5)
====================================================*/
/*!
* User application data buffer size
*/
#define LORAWAN_APP_DATA_SIZE 11
/*%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%*/
#elif ( LORAWAN_APP_PORT == 8 )
/*====================================================
IKS01A1 SENSOR DATA (PORT 8)
====================================================*/
#define USE_IKS01A1_SENSOR
/*!
* User application data buffer size
*/
#define LORAWAN_APP_DATA_SIZE 11
/*%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%*/
#elif ( LORAWAN_APP_PORT == 11 )
/*====================================================
PUSH BUTTON DEMO (PORT 11)
====================================================*/
/*!
* User application data buffer size
*/
#define LORAWAN_APP_DATA_SIZE 2
/*%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%*/
#endif
#endif // __LORA_CONFIG_H__