802 04b: Receive unicast @16b

This program shows how to receive packets with XBee-802.15.4 modules. The source address is read when the packet is received.

Required Materials

1 x Waspmote PRO 1 x Battery 1 x MiniUSB wire 1 x XBee-802.15.4 module

Notes

- This example belongs to a two-code example. This is the receiving part. - Both XBee modules must be configured with the same network parameters (PANID, channel, encryption mode) - The battery has to be connected. - This example can be executed in Waspmote v12 and Waspmote v15

Code

/*  
 *  ------ [802_04b] - receive packets using a 16-bit source address -------- 
 *  
 *  Explanation: This program shows how to receive packets with 
 *  XBee-802.15.4 modules. The source address is read when the
 *  packet is received
 *  
 *  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 . 
 *  
 *  Version:           3.0
 *  Design:            David Gascón 
 *  Implementation:    Yuri Carmona
 */

#include 

// variable to store source's network address
uint8_t sourceNetworkAddress[2];

// define the network address for the Xbee module
char OWN_NETADDRESS[] = "1234";

// define variable
uint8_t error;


void setup()
{  
  // init USB port
  USB.ON();
  USB.println(F("Sending packets example - RX NODE (16-bit addressing)"));

  // init XBee 
  xbee802.ON();  
  
  // set 0x1234 as this XBee's Network Address (MY address)
  xbee802.setOwnNetAddress( OWN_NETADDRESS );
  
  // write values to XBee module memory
  xbee802.writeValues(); 

}


void loop()
{   
   // receive XBee packet (wait for 10 seconds)
  error = xbee802.receivePacketTimeout( 10000 );

  // check answer  
  if( error == 0 ) 
  {
    // Show data stored in '_payload' buffer indicated by '_length'
    USB.print(F("Data: "));  
    USB.println( xbee802._payload, xbee802._length);
    
    // Show data stored in '_payload' buffer indicated by '_length'
    USB.print(F("Length: "));  
    USB.println( xbee802._length,DEC);
    
    // Show data stored in '_payload' buffer indicated by '_length'
    USB.print(F("Source Network Address: "));  
    USB.printHex( xbee802._srcNA[0] );
    USB.printHex( xbee802._srcNA[1] );
    USB.println();    
    USB.println(F("--------------------------------"));
  }
  else
  {
    // Print error message:
    /*
     * '7' : Buffer full. Not enough memory space
     * '6' : Error escaping character within payload bytes
     * '5' : Error escaping character in checksum byte
     * '4' : Checksum is not correct	  
     * '3' : Checksum byte is not available	
     * '2' : Frame Type is not valid
     * '1' : Timeout when receiving answer   
    */
    USB.print(F("Error receiving a packet:"));
    USB.println(error,DEC);     
    USB.println(F("--------------------------------"));
  }
} 

Output

H#
 Sending packets example - RX NODE (16-bit addressing)
 Data: <=>€
#387245265#node_01#1#STR:This_is_a_message#
 Length: 48
 Source Network Address: 1212
 --------------------------------
 Data: <=>€
#387245265#node_01#2#STR:This_is_a_message#
 Length: 48
 Source Network Address: 1212
 --------------------------------