Links

802 01: Configure XBee

This program shows how to configure basic XBee parameters in order to communicate between different XBee devices using the same network.

Required Materials

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

Notes

- The XBee module must be configured to the default baud rate (BD=7) and AP parameter (AP=2). - To store parameter changes after power cycles, it is needed to execute the "writeValues" function. If not, when the XBee is powered off, values do not remain in the module's memory. - The battery has to be connected. - This example can be executed in Waspmote v12 and Waspmote v15

Code

/*
* ------ [802_01] - configure XBee basic parameters --------
*
* Explanation: This program shows how to configure basic XBee
* parameters in order to communicate between different XBee
* devices using the same network.
*
* 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
// PAN (Personal Area Network) Identifier
uint8_t panID[2] = {0x12,0x34};
// Define Freq Channel to be set:
// Center Frequency = 2.405 + (CH - 11d) * 5 MHz
// Range: 0x0B - 0x1A (XBee)
// Range: 0x0C - 0x17 (XBee-PRO)
uint8_t channel = 0x0F;
// Define the Encryption mode: 1 (enabled) or 0 (disabled)
uint8_t encryptionMode = 0;
// Define the AES 16-byte Encryption Key
char encryptionKey[] = "WaspmoteLinkKey!";
void setup()
{
// open USB port
USB.ON();
USB.println(F("-------------------------------"));
USB.println(F("Configure XBee 802.15.4"));
USB.println(F("-------------------------------"));
// init XBee
xbee802.ON();
/////////////////////////////////////
// 1. set channel
/////////////////////////////////////
xbee802.setChannel( channel );
// check at commmand execution flag
if( xbee802.error_AT == 0 )
{
USB.print(F("1. Channel set OK to: 0x"));
USB.printHex( xbee802.channel );
USB.println();
}
else
{
USB.println(F("1. Error calling 'setChannel()'"));
}
/////////////////////////////////////
// 2. set PANID
/////////////////////////////////////
xbee802.setPAN( panID );
// check the AT commmand execution flag
if( xbee802.error_AT == 0 )
{
USB.print(F("2. PAN ID set OK to: 0x"));
USB.printHex( xbee802.PAN_ID[0] );
USB.printHex( xbee802.PAN_ID[1] );
USB.println();
}
else
{
USB.println(F("2. Error calling 'setPAN()'"));
}
/////////////////////////////////////
// 3. set encryption mode (1:enable; 0:disable)
/////////////////////////////////////
xbee802.setEncryptionMode( encryptionMode );
// check the AT commmand execution flag
if( xbee802.error_AT == 0 )
{
USB.print(F("3. AES encryption configured (1:enabled; 0:disabled):"));
USB.println( xbee802.encryptMode, DEC );
}
else
{
USB.println(F("3. Error calling 'setEncryptionMode()'"));
}
/////////////////////////////////////
// 4. set encryption key
/////////////////////////////////////
xbee802.setLinkKey( encryptionKey );
// check the AT commmand execution flag
if( xbee802.error_AT == 0 )
{
USB.println(F("4. AES encryption key set OK"));
}
else
{
USB.println(F("4. Error calling 'setLinkKey()'"));
}
/////////////////////////////////////
// 5. write values to XBee module memory
/////////////////////////////////////
xbee802.writeValues();
// check the AT commmand execution flag
if( xbee802.error_AT == 0 )
{
USB.println(F("5. Changes stored OK"));
}
else
{
USB.println(F("5. Error calling 'writeValues()'"));
}
USB.println(F("-------------------------------"));
}
void loop()
{
/////////////////////////////////////
// 1. get channel
/////////////////////////////////////
xbee802.getChannel();
USB.print(F("channel: "));
USB.printHex(xbee802.channel);
USB.println();
/////////////////////////////////////
// 2. get PANID
/////////////////////////////////////
xbee802.getPAN();
USB.print(F("panid: "));
USB.printHex(xbee802.PAN_ID[0]);
USB.printHex(xbee802.PAN_ID[1]);
USB.println();
/////////////////////////////////////
// 3. get encryption mode (1:enable; 0:disable)
/////////////////////////////////////
xbee802.getEncryptionMode();
USB.print(F("encryption mode: "));
USB.printHex(xbee802.encryptMode);
USB.println();
USB.println(F("-------------------------------"));
delay(3000);
}

Output

H#
-------------------------------
Configure XBee 802.15.4
-------------------------------
1. Channel set OK to: 0x0F
2. PAN ID set OK to: 0x1234
3. AES encryption configured (1:enabled; 0:disabled):0
4. AES encryption key set OK
5. Changes stored OK
-------------------------------
channel: 0F
panid: 1234
encryption mode: 00
-------------------------------
channel: 0F
panid: 1234
encryption mode: 00
-------------------------------
Last modified 2yr ago