Links

Code examples and extended information

In the Waspmote Development section you can find complete examples:
Example:
/*
* ------ LoRaWAN Code Example --------
*
* Explanation: This example shows how to configure the module
* and all general settings related to back-end registration
* process.
*
* Copyright (C) 2016 Libelium Comunicaciones Distribuidas S.L.
* http://www.libelium.com
*
* This program is free software: you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation, either version 3 of the License, or
* (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program. If not, see <http://www.gnu.org/licenses/>.
*
* Version: 3.1
* Design: David Gascon
* Implementation: Luis Miguel Marti
*/
#include <WaspLoRaWAN.h>
//////////////////////////////////////////////
uint8_t socket = SOCKET0;
//////////////////////////////////////////////
// Device parameters for Back-End registration
////////////////////////////////////////////////////////////
char DEVICE_EUI[] =0102030405060708;
char DEVICE_ADDR[] =05060708;
char NWK_SESSION_KEY[] =01020304050607080910111213141516;
char APP_SESSION_KEY[] =000102030405060708090A0B0C0D0E0F”;
char APP_KEY[] =000102030405060708090A0B0C0D0E0F”;
////////////////////////////////////////////////////////////
// variable
uint8_t error;
void setup()
{
USB.ON();
USB.println(F(“LoRaWAN example - Module configuration”));
USB.println(F(“ _____________________________________________________”));
USB.println(F(| |));
USB.println(F(| It is not mandatory to configure channel parameters.|));
USB.println(F(| Server should configure the module during the |));
USB.println(F(| Over The Air Activation process. |));
USB.println(F(|_____________________________________________________|));
USB.println();
//////////////////////////////////////////////
// 1. switch on
//////////////////////////////////////////////
error = LoRaWAN.ON(socket);
// Check status
if( error == 0 )
{
USB.println(F(1. Switch ON OK”));
}
else
{
USB.print(F(1. Switch ON error =));
USB.println(error, DEC);
}
//////////////////////////////////////////////
// 2. Reset to factory default values
//////////////////////////////////////////////
error = LoRaWAN.factoryReset();
// Check status
if( error == 0 )
{
USB.println(F(2. Reset to factory default values OK”));
}
else
{
USB.print(F(2. Reset to factory error =));
USB.println(error, DEC);
}
//////////////////////////////////////////////
// 3. Set/Get Device EUI
//////////////////////////////////////////////
// Set Device EUI
error = LoRaWAN.setDeviceEUI(DEVICE_EUI);
// Check status
if( error == 0 )
{
USB.println(F(3.1. Set Device EUI OK”));
}
else
{
USB.print(F(3.1. Set Device EUI error =));
USB.println(error, DEC);
}
// Get Device EUI
error = LoRaWAN.getDeviceEUI();
// Check status
if( error == 0 )
{
USB.print(F(3.2. Get Device EUI OK.));
USB.print(F(“Device EUI:));
USB.println(LoRaWAN._devEUI);
}
else
{
USB.print(F(3.2. Get Device EUI error =));
USB.println(error, DEC);
}
//////////////////////////////////////////////
// 4. Set/Get Device Address
//////////////////////////////////////////////
// Set Device Address
error = LoRaWAN.setDeviceAddr(DEVICE_ADDR);
// Check status
if( error == 0 )
{
USB.println(F(4.1. Set Device address OK”));
}
else
{
USB.print(F(4.1. Set Device address error =));
USB.println(error, DEC);
}
// Get Device Address
error = LoRaWAN.getDeviceAddr();
// Check status
if( error == 0 )
{
USB.print(F(4.2. Get Device address OK.));
USB.print(F(“Device address:));
USB.println(LoRaWAN._devAddr);
}
else
{
USB.print(F(4.2. Get Device address error =));
USB.println(error, DEC);
}
//////////////////////////////////////////////
// 5. Set Network Session Key
//////////////////////////////////////////////
error = LoRaWAN.setNwkSessionKey(NWK_SESSION_KEY);
// Check status
if( error == 0 )
{
USB.println(F(5. Set Network Session Key OK”));
}
else
{
USB.print(F(5. Set Network Session Key error =));
USB.println(error, DEC);
}
//////////////////////////////////////////////
// 6. Set Application Session Key
//////////////////////////////////////////////
error = LoRaWAN.setAppSessionKey(APP_SESSION_KEY);
// Check status
if( error == 0 )
{
USB.println(F(6. Set Application Session Key OK”));
}
else
{
USB.print(F(6. Set Application Session Key error =));
USB.println(error, DEC);
}
//////////////////////////////////////////////
// 7. Set retransmissions for uplink confirmed packet
//////////////////////////////////////////////
// set retries
error = LoRaWAN.setRetries(7);
// Check status
if( error == 0 )
{
USB.println(F(7.1. Set Retransmissions for uplink confirmed packet OK”));
}
else
{
USB.print(F(7.1. Set Retransmissions for uplink confirmed packet error =));
USB.println(error, DEC);
}
// Get retries
error = LoRaWAN.getRetries();
// Check status
if( error == 0 )
{
USB.print(F(7.2. Get Retransmissions for uplink confirmed packet OK.));
USB.print(F(“TX retries:));
USB.println(LoRaWAN._retries, DEC);
}
else
{
USB.print(F(7.2. Get Retransmissions for uplink confirmed packet error =));
USB.println(error, DEC);
}
//////////////////////////////////////////////
// 8. Set application key
//////////////////////////////////////////////
error = LoRaWAN.setAppKey(APP_KEY);
// Check status
if( error == 0 )
{
USB.println(F(8. Application key set OK”));
}
else
{
USB.print(F(8. Application key set error =));
USB.println(error, DEC);
}
////////////////////////////////////////////////////////
// ______________________________________________________
// | |
// | It is not mandatory to configure channel parameters.|
// | Server should configure the module during the |
// | Over The Air Activation process. If channels aren’t |
// | configured, please uncomment channel configuration |
// | functions below these lines. |
// |______________________________________________________|
//
////////////////////////////////////////////////////////
//////////////////////////////////////////////
// 9. Channel configuration. (Recommended)
// Consult your Network Operator and Backend Provider
//////////////////////////////////////////////
// Set channel 3 -> 867.1 MHz
// Set channel 4 -> 867.3 MHz
// Set channel 5 -> 867.5 MHz
// Set channel 6 -> 867.7 MHz
// Set channel 7 -> 867.9 MHz
// uint32_t freq = 867100000;
//
// for (uint8_t ch = 3; ch <= 7; ch++)
// {
// error = LoRaWAN.setChannelFreq(ch, freq);
// freq += 200000;
//
// // Check status
// if( error == 0 )
// {
// USB.println(F(“9. Frequency channel set OK”));
// }
// else
// {
// USB.print(F(“9. Frequency channel set error = “));
// USB.println(error, DEC);
// }
//
//
// }
//////////////////////////////////////////////
// 10. Set Duty Cycle for specific channel. (Recommended)
// Consult your Network Operator and Backend Provider
//////////////////////////////////////////////
// for (uint8_t ch = 0; ch <= 2; ch++)
// {
// error = LoRaWAN.setChannelDutyCycle(ch, 33333);
//
// // Check status
// if( error == 0 )
// {
// USB.println(F(“10. Duty cycle channel set OK”));
// }
// else
// {
// USB.print(F(“10. Duty cycle channel set error = “));
// USB.println(error, DEC);
// }
// }
//
// for (uint8_t ch = 3; ch <= 7; ch++)
// {
// error = LoRaWAN.setChannelDutyCycle(ch, 40000);
//
// // Check status
// if( error == 0 )
// {
// USB.println(F(“10. Duty cycle channel set OK”));
// }
// else
// {
// USB.print(F(“10. Duty cycle channel set error = “));
// USB.println(error, DEC);
// }
// }
//////////////////////////////////////////////
// 11. Set Data Range for specific channel. (Recommended)
// Consult your Network Operator and Backend Provider
//////////////////////////////////////////////
// for (int ch = 0; ch <= 7; ch++)
// {
// error = LoRaWAN.setChannelDRRange(ch, 0, 5);
//
// // Check status
// if( error == 0 )
// {
// USB.println(F(“11. Data rate range channel set OK”));
// }
// else
// {
// USB.print(F(“11. Data rate range channel set error = “));
// USB.println(error, DEC);
// }
// }
//////////////////////////////////////////////
// 12. Set Data rate range for specific channel. (Recommended)
// Consult your Network Operator and Backend Provider
//////////////////////////////////////////////
// for (int ch = 0; ch <= 7; ch++)
// {
// error = LoRaWAN.setChannelStatus(ch, “on”);
//
// // Check status
// if( error == 0 )
// {
// USB.println(F(“12. Channel status set OK”));
// }
// else
// {
// USB.print(F(“12. Channel status set error = “));
// USB.println(error, DEC);
// }
// }
//////////////////////////////////////////////
// 13. Set Adaptive Data Rate (recommended)
//////////////////////////////////////////////
// set ADR
error = LoRaWAN.setADR(“on”);
// Check status
if( error == 0 )
{
USB.println(F(13.1. Set Adaptive data rate status to on OK”));
}
else
{
USB.print(F(13.1. Set Adaptive data rate status to on error =));
USB.println(error, DEC);
}
// Get ADR
error = LoRaWAN.getADR();
// Check status
if( error == 0 )
{
USB.print(F(13.2. Get Adaptive data rate status OK.));
USB.print(F(“Adaptive data rate status:));
if (LoRaWAN._adr == true)
{
USB.println(“on”);
}
else
{
USB.println(“off”);
}
}
else
{
USB.print(F(13.2. Get Adaptive data rate status error =));
USB.println(error, DEC);
}
//////////////////////////////////////////////
// 14. Set Automatic Reply
//////////////////////////////////////////////
// set AR
error = LoRaWAN.setAR(“on”);
// Check status
if( error == 0 )
{
USB.println(F(14.1. Set automatic reply status to on OK”));
}
else
{
USB.print(F(14.1. Set automatic reply status to on error =));
USB.println(error, DEC);
}
// Get AR
error = LoRaWAN.getAR();
// Check status
if( error == 0 )
{
USB.print(F(14.2. Get automatic reply status OK.));
USB.print(F(“Automatic reply status:));
if (LoRaWAN._ar == true)
{
USB.println(“on”);
}
else
{
USB.println(“off”);
}
}
else
{
USB.print(F(14.2. Get automatic reply status error =));
USB.println(error, DEC);
}
//////////////////////////////////////////////
// 15. Save configuration
//////////////////////////////////////////////
error = LoRaWAN.saveConfig();
// Check status
if( error == 0 )
{
USB.println(F(15. Save configuration OK”));
}
else
{
USB.print(F(15. Save configuration error =));
USB.println(error, DEC);
}
USB.println(F(------------------------------------));
USB.println(F(“Now the LoRaWAN module is ready for));
USB.println(F(“joining networks and send messages.));
USB.println(F(“Please check the next examples...));
USB.println(F(------------------------------------\n”));
}
void loop()
{
// do nothing
}