Development

Communication / LoRa:

» SX 06b: RX Frame ACK

This example shows how to configure the SX1272 module in LoRa mode and then receive packets with Waspmote Frames within the payload sending back an ACK to the sender

Required Materials

1 x Waspmote PRO
1 x Battery
1 x MiniUSB wire
1 x SX1272 module (LoRa)
1 x Sender module with SX_06a example

Notes

- The SX1272 module is provided with a special 4.5 dBi antenna, which enables maximum range. The only exception is Smart Parking; in this case the antenna is smaller, 0 dBi, to fit inside the enclosure.
- It is not recommended to work without an antenna screwed to the module. The module could be damaged due to RF reflections.
- The SX1272 module can only be used in special Waspmote units which have been modified to drive the SPI pins to SOCKET0. (only SOCKET0 is available for SX1272)
- This module does not save the configuration. So, the network settings as the mode or the channel MUST be configured every time it is switched on.
- This example can be executed in Waspmote v12 and Waspmote v15

Code

/*  
 *  ------ [SX_06b] - RX LoRa with Waspmote Frame and ACKs -------- 
 *
 *  Explanation: This example shows how to configure the semtech 
 *  module in LoRa mode and then receive packets with Waspmote 
 *  Frames within the payload sending back an ACK to the sender
 *  
 *  Copyright (C) 2014 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:           0.1
 *  Design:            David Gascón 
 *  Implementation:    Covadonga Albiñana, Yuri Carmona
 */

// Include these libraries to transmit frames with sx1272
#include <WaspSX1272.h>
#include <WaspFrame.h>

// status variable
int8_t e;


void setup() 
{
  // Init USB port
  USB.ON();
  USB.println(F("SX_06b example"));
  USB.println(F("Semtech SX1272 module. RX LoRa with Waspmote Frame using ACKs"));


  USB.println(F("----------------------------------------"));
  USB.println(F("Setting configuration:")); 
  USB.println(F("----------------------------------------"));

  // Init SX1272 module
  sx1272.ON();

  // Select frequency channel
  e = sx1272.setChannel(CH_11_868);
  USB.print(F("Setting Channel CH_11_868.\t state ")); 
  USB.println(e);

  // Select implicit (off) or explicit (on) header mode
  e = sx1272.setHeaderON();
  USB.print(F("Setting Header ON.\t\t state "));  
  USB.println(e); 

  // Select mode: from 1 to 10
  e = sx1272.setMode(1);  
  USB.print(F("Setting Mode '1'.\t\t state "));
  USB.println(e);  

  // select CRC on or off
  e = sx1272.setCRC_ON();
  USB.print(F("Setting CRC ON.\t\t\t state "));
  USB.println(e);  

  // Select output power (Max, High or Low)
  e = sx1272.setPower('H');
  USB.print(F("Setting Power to 'H'.\t\t state "));  
  USB.println(e); 

  // Select the node address value: from 2 to 255
  e = sx1272.setNodeAddress(2);
  USB.print(F("Setting Node Address to '2'.\t state "));
  USB.println(e); 
  USB.println();

  delay(1000);  

  USB.println(F("----------------------------------------"));
  USB.println(F("Receiving:")); 
  USB.println(F("----------------------------------------"));
}


void loop()
{
  // Receiving packet and sending an ACK response  
  e = sx1272.receivePacketTimeoutACK(10000);

  // check status
  if( e == 0 )
  {
    USB.println(F("\nShow packet received: "));

    // show frame received
    sx1272.showFramefromPacket();
  }
  else
  {
    USB.print(F("\nReceiving packet TIMEOUT, state "));
    USB.println(e, DEC);  
  }  
}

Output

H#
SX_06b example
Semtech SX1272 module. RX LoRa with Waspmote Frame using ACKs
----------------------------------------
Setting configuration:
----------------------------------------
Setting Channel CH_11_868. state 0
Setting Header ON. state 0
Setting Mode '1'. state 0
Setting CRC ON. state 0
Setting Power to 'H'. state 0
Setting Node Address to '2'. state 0

----------------------------------------
Receiving:
----------------------------------------

Show packet received:
==============================
Current ASCII Frame:
Length: 34
Frame Type (decimal): 128
HEX: 3C3D3E800123333837323536303030236E6F64655F3030312330234241543A393823
String: <=>€#387256000#node_001#0#BAT:98#
==============================

Show packet received:
==============================
Current ASCII Frame:
Length: 34
Frame Type (decimal): 128
HEX: 3C3D3E800123333837323536303030236E6F64655F3030312331234241543A393923
String: <=>€#387256000#node_001#1#BAT:99#
==============================

Show packet received:
==============================
Current ASCII Frame:
Length: 34
Frame Type (decimal): 128
HEX: 3C3D3E800123333837323536303030236E6F64655F3030312332234241543A393923
String: <=>€#387256000#node_001#2#BAT:99#
==============================
...

Quick Publish: