Digi International Inc. / Mbed 2 deprecated XBee802_AT_Commands

802.15.4 AT Commands example for mbed XBeeLib By Digi

Dependencies:   XBeeLib mbed

This example shows how to read and change configuration parameters of either the local XBee module or a remote XBee module.

See Configuring local and remote modules chapter for more information.

Common Setup

Make sure you have a valid Example Common Setup

Example Setup

Application

You have to configure:

  • The remote device 64-bit address by customizing the REMOTE_NODE_ADDR64_MSB and REMOTE_NODE_ADDR64_LSB defines with the remote XBee module 64-bit address.
  • The remote device 16-bit address by customizing the REMOTE_NODE_ADDR16 define with the remote XBee module 16-bit address.

Running the example

Build and deploy the example to the mbed module.
Reset the mbed module so the example starts. You should see the example debug information through the debug interface configured in the 'Local Setup' chapter.
The application will do following operations:

OperationXBee moduleparameterVerification
ReadlocalSLThe result is asserted against the known local module SL value. So just check the assertion passed
SetlocalNIClick 'discover remote devices' on the X-CTU connected to the remote. Should discover the local XBee module with the new NI (ni_example_local)
ReadremoteSLThe result is asserted against the known remote module SL value. So just check the assertion passed. This test is done using both 64-bit and 16-bit addressing for demonstration
SetremoteNIRefresh the 'NI' parameter in the X-CTU connected to the remote and check it has changed to the new NI (ni_example_remote)

main.cpp

Committer:
hbujanda
Date:
2016-07-29
Revision:
11:5e3da09ec988
Parent:
10:776b6cf3e506

File content as of revision 11:5e3da09ec988:

/**
 * Copyright (c) 2015 Digi International Inc.,
 * All rights not expressly granted are reserved.
 *
 * This Source Code Form is subject to the terms of the Mozilla Public
 * License, v. 2.0. If a copy of the MPL was not distributed with this file,
 * You can obtain one at http://mozilla.org/MPL/2.0/.
 *
 * Digi International Inc. 11001 Bren Road East, Minnetonka, MN 55343
 * =======================================================================
 */

#include "mbed.h"
#include "XBeeLib.h"
#if defined(ENABLE_LOGGING)
#include "DigiLoggerMbedSerial.h"
using namespace DigiLog;
#endif

#define REMOTE_NODE_ADDR64_MSB  ((uint32_t)0x0013A200)

#error "Replace next define with the LSB of the remote module's 64-bit address (SL parameter)"
#define REMOTE_NODE_ADDR64_LSB  ((uint32_t)0x01234567)

#error "Replace next define with the remote module's 16-bit address (MY parameter)"
#define REMOTE_NODE_ADDR16      ((uint16_t)0x1111)

#define REMOTE_NODE_ADDR64      UINT64(REMOTE_NODE_ADDR64_MSB, REMOTE_NODE_ADDR64_LSB)

using namespace XBeeLib;

Serial *log_serial;

int main()
{
    log_serial = new Serial(DEBUG_TX, DEBUG_RX);
    log_serial->baud(9600);
    log_serial->printf("Sample application to demo how to read and set local and remote AT parameters with XBee802\r\n\r\n");
    log_serial->printf(XB_LIB_BANNER);

#if defined(ENABLE_LOGGING)
    new DigiLoggerMbedSerial(log_serial, LogLevelInfo);
#endif

    XBee802 xbee = XBee802(RADIO_TX, RADIO_RX, RADIO_RESET, NC, NC, 9600);

    RadioStatus radioStatus = xbee.init();
    MBED_ASSERT(radioStatus == Success);

    AtCmdFrame::AtCmdResp cmdresp;
    uint32_t value;

    /* Read local device SL parameter */
    log_serial->printf("\r\nReading local device SL parameter:\r\n");
    cmdresp = xbee.get_param("SL", &value);
    if (cmdresp == AtCmdFrame::AtCmdRespOk) {
        log_serial->printf("OK. Local SL=%08x\r\n", value);

        /* Get the local device 64 bit address to compare */
        const uint64_t LocalDeviceAddr64 = xbee.get_addr64();

        MBED_ASSERT(value == (LocalDeviceAddr64 & 0xFFFFFFFF));
    } else {
        log_serial->printf("FAILED with %d\r\n", (int) cmdresp);
    }

    /* Set local device NI parameter */
    char ni_local[] = "param config example";
    log_serial->printf("\r\nSetting local device NI parameter to '%s':\r\n", ni_local);
    cmdresp = xbee.set_param("NI", (uint8_t*)ni_local, strlen(ni_local));
    if (cmdresp == AtCmdFrame::AtCmdRespOk)
        log_serial->printf("OK\r\n");
    else
        log_serial->printf("FAILED with %d\r\n", (int) cmdresp);

    const RemoteXBee802 remoteDevice64b = RemoteXBee802(REMOTE_NODE_ADDR64);
    const RemoteXBee802 remoteDevice16b = RemoteXBee802(REMOTE_NODE_ADDR16);

    /* Read remote device SL parameter using 64b addressing */
    log_serial->printf("\r\nReading remote device SL parameter using 64b address:\r\n");
    cmdresp = xbee.get_param(remoteDevice64b, "SL", &value);
    if (cmdresp == AtCmdFrame::AtCmdRespOk) {
        log_serial->printf("OK. Remote SL=%08x\r\n", value);
        MBED_ASSERT(value == REMOTE_NODE_ADDR64_LSB);
    } else {
        log_serial->printf("FAILED with %d\r\n", (int) cmdresp);
    }

    /* Read remote device SL parameter using 16b addressing */
    log_serial->printf("\r\nReading remote device SL parameter using 16b address:\r\n");
    cmdresp = xbee.get_param(remoteDevice16b, "SL", &value);
    if (cmdresp == AtCmdFrame::AtCmdRespOk) {
        log_serial->printf("OK. Remote SL=%08x\r\n", value);
        MBED_ASSERT(value == REMOTE_NODE_ADDR64_LSB);
    } else {
        log_serial->printf("FAILED with %d\r\n", (int) cmdresp);
    }

    /* Set remote device NI parameter */
    char ni_remote[] = "ni_example_remote";
    log_serial->printf("\r\nSetting remote device NI parameter to '%s':\r\n", ni_remote);
    cmdresp = xbee.set_param(remoteDevice64b, "NI", (uint8_t*)ni_remote, strlen(ni_remote));
    if (cmdresp == AtCmdFrame::AtCmdRespOk) {
        log_serial->printf("OK\r\n");
    } else {
        log_serial->printf("FAILED with %d\r\n", (int) cmdresp);
    }

    delete(log_serial);
}