* ------ [ZB_09b] - complete example receive ------
* Explanation: This is a complete example for XBee-ZigBee.
* This example shows how to reeive a packet. When the source
* address is the expected one, an answer is sent back to the
* Copyright (C) 2015 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 .
* Implementation: Yuri Carmona
USB.println(F("Complete example (RX node)"));
//////////////////////////
//////////////////////////
//////////////////////////
// 2. check XBee's network parameters
//////////////////////////
// receive XBee packet (wait message for 20 seconds)
error = xbeeZB.receivePacketTimeout( 20000 );
USB.println(F("\n1. New packet received"));
// Show data stored in '_payload' buffer indicated by '_length'
USB.print(F("--> Data: "));
USB.println( xbeeZB._payload, xbeeZB._length);
// Show data stored in '_payload' buffer indicated by '_length'
USB.print(F("--> Length: "));
USB.println( xbeeZB._length,DEC);
/*** Available info in library structure ***/
// get Source's MAC address
destination[0] = xbeeZB._srcMAC[0];
destination[1] = xbeeZB._srcMAC[1];
destination[2] = xbeeZB._srcMAC[2];
destination[3] = xbeeZB._srcMAC[3];
destination[4] = xbeeZB._srcMAC[4];
destination[5] = xbeeZB._srcMAC[5];
destination[6] = xbeeZB._srcMAC[6];
destination[7] = xbeeZB._srcMAC[7];
// Show data stored in '_payload' buffer indicated by '_length'
USB.print(F("--> Source MAC address: "));
USB.printHex( destination[0] );
USB.printHex( destination[1] );
USB.printHex( destination[2] );
USB.printHex( destination[3] );
USB.printHex( destination[4] );
USB.printHex( destination[5] );
USB.printHex( destination[6] );
USB.printHex( destination[7] );
// insert small delay to wait TX node
// to prepare to receive messages
/*** Send message to TX node ***/
USB.println(F("\n2. Send a response to the TX node: "));
error = xbeeZB.send( destination, "Message_from_RX_node" );
USB.println(F("send ok"));
USB.println(F("send error"));
* '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(F("\n----------------------------------"));
/*******************************************
* checkNetworkParams - Check operating
* network parameters in the XBee module
*******************************************/
void checkNetworkParams()
// 1. get operating 64-b PAN ID
xbeeZB.getOperating64PAN();
// 2. wait for association indication
xbeeZB.getAssociationIndication();
USB.println(F("Wait for association"));
while( xbeeZB.associationIndication != 0 )
// get operating 64-b PAN ID
xbeeZB.getOperating64PAN();
USB.print(F("operating 64-b PAN ID: "));
USB.printHex(xbeeZB.operating64PAN[0]);
USB.printHex(xbeeZB.operating64PAN[1]);
USB.printHex(xbeeZB.operating64PAN[2]);
USB.printHex(xbeeZB.operating64PAN[3]);
USB.printHex(xbeeZB.operating64PAN[4]);
USB.printHex(xbeeZB.operating64PAN[5]);
USB.printHex(xbeeZB.operating64PAN[6]);
USB.printHex(xbeeZB.operating64PAN[7]);
xbeeZB.getAssociationIndication();
USB.println(F("\nJoined a network!"));
// 3. get network parameters
xbeeZB.getOperating16PAN();
xbeeZB.getOperating64PAN();
USB.print(F("operating 16-b PAN ID: "));
USB.printHex(xbeeZB.operating16PAN[0]);
USB.printHex(xbeeZB.operating16PAN[1]);
USB.print(F("operating 64-b PAN ID: "));
USB.printHex(xbeeZB.operating64PAN[0]);
USB.printHex(xbeeZB.operating64PAN[1]);
USB.printHex(xbeeZB.operating64PAN[2]);
USB.printHex(xbeeZB.operating64PAN[3]);
USB.printHex(xbeeZB.operating64PAN[4]);
USB.printHex(xbeeZB.operating64PAN[5]);
USB.printHex(xbeeZB.operating64PAN[6]);
USB.printHex(xbeeZB.operating64PAN[7]);
USB.print(F("channel: "));
USB.printHex(xbeeZB.channel);
/*******************************************
* printAssociationState - Print the state
* of the association flag
*******************************************/
void printAssociationState()
switch(xbeeZB.associationIndication)
USB.println(F("Successfully formed or joined a network"));
USB.println(F("Scan found no PANs"));
USB.println(F("Scan found no valid PANs based on current SC and ID settings"));
USB.println(F("Valid Coordinator or Routers found, but they are not allowing joining (NJ expired)"));
USB.println(F("No joinable beacons were found"));
USB.println(F("Unexpected state, node should not be attempting to join at this time"));
USB.println(F("Node Joining attempt failed"));
USB.println(F("Coordinator Start attempt failed"));
USB.println(F("Checking for an existing coordinator"));
USB.println(F("Attempt to leave the network failed"));
USB.println(F("Attempted to join a device that did not respond."));
USB.println(F("Secure join error: network security key received unsecured"));
USB.println(F("Secure join error: network security key not received"));
USB.println(F("Secure join error: joining device does not have the right preconfigured link key"));
USB.println(F("Scanning for a ZigBee network (routers and end devices)"));
USB.println(F("Unkown associationIndication"));