Development v12

Warning - Product Update

All the resources present on this section belong to Waspmote v12, Waspmote Plug & Sense! v12 and Meshlium v3.8.

If you have a Waspmote v15, Waspmote Plug & Sense! v15 or Meshlium v4.0 please go to the new Development Section.

Check what is your version and what are the differences between the old and the new one in this document.

» LoRaWAN 04: Data rate

This example shows how to configure the data rate.

Required Materials

1 x Waspmote
1 x Battery
1 x LoRaWAN EU or US or AU or IN or ASIA-PAC / LATAM or JP/KR module
1 x 868/900 MHz antenna

Notes

- This example can be executed in Waspmote v12 and Waspmote v15

Code

/*
    ------ LoRaWAN Code Example --------

    Explanation: This example shows how to configure the data rate.
    The possibilities are:

      LoRaWAN EU or IN or ASIA-PAC / LATAM:

      0: SF = 12, BW = 125 kHz, BitRate =  250 bps
      1: SF = 11, BW = 125 kHz, BitRate =  440 bps
      2: SF = 10, BW = 125 kHz, BitRate =  980 bps
      3: SF =  9, BW = 125 kHz, BitRate = 1760 bps
      4: SF =  8, BW = 125 kHz, BitRate = 3125 bps
      5: SF =  7, BW = 125 kHz, BitRate = 5470 bps

      LoRaWAN US or AU:

      0: SF = 10, BW = 125 kHz, BitRate =   980 bps
      1: SF =  9, BW = 125 kHz, BitRate =  1760 bps
      2: SF =  8, BW = 125 kHz, BitRate =  3125 bps
      3: SF =  7, BW = 125 kHz, BitRate =  5470 bps

      LoRaWAN JP:

      0: SF = 12, BW = 125 kHz, BitRate =   250 bps
      1: SF = 11, BW = 125 kHz, BitRate =   440 bps
      2: SF = 10, BW = 125 kHz, BitRate =   980 bps
      3: SF =  9, BW = 125 kHz, BitRate =  1760 bps
      4: SF =  8, BW = 125 kHz, BitRate =  3125 bps
      5: SF =  7, BW = 125 kHz, BitRate =  5470 bps
      6: SF =  7, BW = 250 kHz, BitRate = 11000 bps

      LoRaWAN KR:

      0: SF = 12, BW = 125 kHz, BitRate =   250 bps
      1: SF = 11, BW = 125 kHz, BitRate =   440 bps
      2: SF = 10, BW = 125 kHz, BitRate =   980 bps
      3: SF =  9, BW = 125 kHz, BitRate =  1760 bps
      4: SF =  8, BW = 125 kHz, BitRate =  3125 bps
      5: SF =  7, BW = 125 kHz, BitRate =  5470 bps

    Copyright (C) 2019 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.6
    Design:            David Gascon
    Implementation:    Luismi Marti
*/

#include <WaspLoRaWAN.h>

//////////////////////////////////////////////
uint8_t socket = SOCKET0;
//////////////////////////////////////////////

// variable
uint8_t error;


void setup()
{
  USB.ON();
  USB.println(F("LoRaWAN example - Data Rate configuration"));
  USB.println(F("\nData Rate options:"));

  //////////////////////////////////////////////
  // 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);
  }

  if (LoRaWAN._version == RN2483_MODULE || LoRaWAN._version == RN2903_IN_MODULE || LoRaWAN._version == RN2903_AS_MODULE)
  {
    USB.println(F("------------------------------------------------------"));
    USB.println(F("  0: SF = 12, BW = 125 kHz, BitRate =   250 bps"));
    USB.println(F("  1: SF = 11, BW = 125 kHz, BitRate =   440 bps"));
    USB.println(F("  2: SF = 10, BW = 125 kHz, BitRate =   980 bps"));
    USB.println(F("  3: SF =  9, BW = 125 kHz, BitRate =  1760 bps"));
    USB.println(F("  4: SF =  8, BW = 125 kHz, BitRate =  3125 bps"));
    USB.println(F("  5: SF =  7, BW = 125 kHz, BitRate =  5470 bps"));
    USB.println(F("------------------------------------------------------\n"));
  }
  else if (LoRaWAN._version == RN2903_MODULE)
  {
    USB.println(F("------------------------------------------------------"));
    USB.println(F("  0: SF = 10, BW = 125 kHz, BitRate =   980 bps"));
    USB.println(F("  1: SF = 9,  BW = 125 kHz, BitRate =  1760 bps"));
    USB.println(F("  2: SF = 8,  BW = 125 kHz, BitRate =  3125 bps"));
    USB.println(F("  3: SF = 7,  BW = 125 kHz, BitRate =  5470 bps"));
    USB.println(F("------------------------------------------------------\n"));
  }
  else if (LoRaWAN._version == ABZ_MODULE)
  {
    // Get band
    error = LoRaWAN.getBand();

    // Check status
    if ( error == 0 )
    {
      if (LoRaWAN._bandABZ == BAND_JP923)
      {
        USB.println(F("------------------------------------------------------"));
        USB.println(F("  0: SF = 12, BW = 125 kHz, BitRate =   250 bps"));
        USB.println(F("  1: SF = 11, BW = 125 kHz, BitRate =   440 bps"));
        USB.println(F("  2: SF = 10, BW = 125 kHz, BitRate =   980 bps"));
        USB.println(F("  3: SF =  9, BW = 125 kHz, BitRate =  1760 bps"));
        USB.println(F("  4: SF =  8, BW = 125 kHz, BitRate =  3125 bps"));
        USB.println(F("  5: SF =  7, BW = 125 kHz, BitRate =  5470 bps"));
        USB.println(F("  6: SF =  7, BW = 250 kHz, BitRate = 11000 bps"));
        USB.println(F("------------------------------------------------------\n"));
      }
      else if (LoRaWAN._bandABZ == BAND_KR920)
      {
        USB.println(F("------------------------------------------------------"));
        USB.println(F("  0: SF = 12, BW = 125 kHz, BitRate =   250 bps"));
        USB.println(F("  1: SF = 11, BW = 125 kHz, BitRate =   440 bps"));
        USB.println(F("  2: SF = 10, BW = 125 kHz, BitRate =   980 bps"));
        USB.println(F("  3: SF =  9, BW = 125 kHz, BitRate =  1760 bps"));
        USB.println(F("  4: SF =  8, BW = 125 kHz, BitRate =  3125 bps"));
        USB.println(F("  5: SF =  7, BW = 125 kHz, BitRate =  5470 bps"));
        USB.println(F("------------------------------------------------------\n"));
      }
    }
    else
    {
      USB.print(F("1.1. Get band error = "));
      USB.println(error, DEC);
    }

  }
  //////////////////////////////////////////////
  // 2. Set Data Rate
  //////////////////////////////////////////////

  error = LoRaWAN.setDataRate(2);

  // Check status
  if ( error == 0 )
  {
    USB.println(F("2. Data rate set OK"));
  }
  else
  {
    USB.print(F("2. Data rate set error = "));
    USB.println(error, DEC);
  }


  //////////////////////////////////////////////
  // 3. Get Data Rate
  //////////////////////////////////////////////

  error = LoRaWAN.getDataRate();

  // Check status
  if ( error == 0 )
  {
    USB.print(F("3. Data rate get OK. "));
    USB.print(F("Data rate index:"));
    USB.println(LoRaWAN._dataRate, DEC);
  }
  else
  {
    USB.print(F("3. Data rate get error = "));
    USB.println(error, DEC);
  }


  //////////////////////////////////////////////
  // 4. Save configuration
  //////////////////////////////////////////////

  error = LoRaWAN.saveConfig();

  // Check status
  if ( error == 0 )
  {
    USB.println(F("4. Save configuration OK"));
  }
  else
  {
    USB.print(F("4. Save configuration error = "));
    USB.println(error, DEC);
  }

}


void loop()
{

}

Output

J#
LoRaWAN example - Data Rate configuration

Data Rate options:
1. Switch ON OK
------------------------------------------------------
0: SF = 12, BW = 125 kHz, BitRate = 250 bps
1: SF = 11, BW = 125 kHz, BitRate = 440 bps
2: SF = 10, BW = 125 kHz, BitRate = 980 bps
3: SF = 9, BW = 125 kHz, BitRate = 1760 bps
4: SF = 8, BW = 125 kHz, BitRate = 3125 bps
5: SF = 7, BW = 125 kHz, BitRate = 5470 bps
------------------------------------------------------

2. Data rate set OK
3. Data rate get OK. Data rate index:2
4. Save configuration OK

Quick Publish: