Digi International Inc.
ZigBee IO Sampling Callback example for mbed XBeeLib By Digi
This example shows how to monitor remote XBee modules DigitalInputs and ADCs. The remote XBee module sends packets periodically to the local XBee module containing the value of its DigitalInputs and ADCs. This library processes those packets and calls the user registered function callback so the user can handle them.
See Handling IO Data Samples from other 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.
Hardware
On the Remote XBee module, wire following peripherals on the pins specified on the table and schematics or change the application pins according to your hardware setup:
| Line | Pin | Value |
|---|---|---|
| DIO2/ADC2 | 18 | ADC (Analog Input) |
| DIO3/ADC3 | 17 | Digital Input |
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.
Once joined to the coordinator, the application will do following operations:
- Register the function callback that will be called by the library when corresponding IO sample frame is received.
- Configure the remote XBee module pins according to the table above.
- Configure the sample rate.
- Configure remote XBee module to send IO Samples to local XBee module
- Periodically ask the XBee library to process received frames
When a IO Sample frame is received the user callback does:
- Read DIO3_AD3 digital value
- Read DIO2_AD2 analog value
main.cpp@10:d7b73d453c26, 2016-07-29 (annotated)
- Committer:
- hbujanda
- Date:
- Fri Jul 29 12:12:49 2016 +0200
- Revision:
- 10:d7b73d453c26
- Parent:
- 7:f4af8c290fd4
Automatic upload
Who changed what in which revision?
| User | Revision | Line number | New contents of line |
|---|---|---|---|
| hbujanda | 5:01c27f88ec7d | 1 | /** |
| hbujanda | 5:01c27f88ec7d | 2 | * Copyright (c) 2015 Digi International Inc., |
| hbujanda | 5:01c27f88ec7d | 3 | * All rights not expressly granted are reserved. |
| hbujanda | 5:01c27f88ec7d | 4 | * |
| hbujanda | 5:01c27f88ec7d | 5 | * This Source Code Form is subject to the terms of the Mozilla Public |
| hbujanda | 5:01c27f88ec7d | 6 | * License, v. 2.0. If a copy of the MPL was not distributed with this file, |
| hbujanda | 5:01c27f88ec7d | 7 | * You can obtain one at http://mozilla.org/MPL/2.0/. |
| hbujanda | 5:01c27f88ec7d | 8 | * |
| hbujanda | 5:01c27f88ec7d | 9 | * Digi International Inc. 11001 Bren Road East, Minnetonka, MN 55343 |
| hbujanda | 5:01c27f88ec7d | 10 | * ======================================================================= |
| hbujanda | 5:01c27f88ec7d | 11 | */ |
| hbujanda | 5:01c27f88ec7d | 12 | |
| hbujanda | 5:01c27f88ec7d | 13 | #include "mbed.h" |
| hbujanda | 5:01c27f88ec7d | 14 | #include "XBeeLib.h" |
| hbujanda | 5:01c27f88ec7d | 15 | #if defined(ENABLE_LOGGING) |
| hbujanda | 5:01c27f88ec7d | 16 | #include "DigiLoggerMbedSerial.h" |
| hbujanda | 5:01c27f88ec7d | 17 | using namespace DigiLog; |
| hbujanda | 5:01c27f88ec7d | 18 | #endif |
| hbujanda | 5:01c27f88ec7d | 19 | |
| hbujanda | 5:01c27f88ec7d | 20 | #define REMOTE_NODE_ADDR64_MSB ((uint32_t)0x0013A200) |
| spastor | 7:f4af8c290fd4 | 21 | |
| spastor | 7:f4af8c290fd4 | 22 | #error "Replace next define with the LSB of the remote module's 64-bit address (SL parameter)" |
| spastor | 7:f4af8c290fd4 | 23 | #define REMOTE_NODE_ADDR64_LSB ((uint32_t)0x01234567) |
| hbujanda | 5:01c27f88ec7d | 24 | |
| hbujanda | 5:01c27f88ec7d | 25 | #define REMOTE_NODE_ADDR64 UINT64(REMOTE_NODE_ADDR64_MSB, REMOTE_NODE_ADDR64_LSB) |
| hbujanda | 5:01c27f88ec7d | 26 | |
| hbujanda | 5:01c27f88ec7d | 27 | using namespace XBeeLib; |
| hbujanda | 5:01c27f88ec7d | 28 | |
| hbujanda | 5:01c27f88ec7d | 29 | Serial *log_serial; |
| hbujanda | 5:01c27f88ec7d | 30 | |
| hbujanda | 5:01c27f88ec7d | 31 | static void io_data_cb(const RemoteXBeeZB& remote, const IOSampleZB& sample_data) |
| hbujanda | 5:01c27f88ec7d | 32 | { |
| hbujanda | 5:01c27f88ec7d | 33 | const uint64_t remote_addr64 = remote.get_addr64(); |
| hbujanda | 5:01c27f88ec7d | 34 | |
| hbujanda | 5:01c27f88ec7d | 35 | log_serial->printf("\r\nGot an IO SAMPLE packet [%08x:%08x|%04x]\r\n", UINT64_HI32(remote_addr64), UINT64_LO32(remote_addr64), remote.get_addr16()); |
| hbujanda | 5:01c27f88ec7d | 36 | |
| hbujanda | 5:01c27f88ec7d | 37 | RadioStatus radioStatus; |
| hbujanda | 5:01c27f88ec7d | 38 | |
| hbujanda | 5:01c27f88ec7d | 39 | DioVal dio3; |
| hbujanda | 5:01c27f88ec7d | 40 | radioStatus = sample_data.get_dio(XBeeZB::DIO3_AD3, &dio3); |
| hbujanda | 5:01c27f88ec7d | 41 | if (radioStatus != Success) |
| hbujanda | 5:01c27f88ec7d | 42 | log_serial->printf("sample_data.get_dio(XBeeZB::DIO3_AD3, &dio3) FAILED\r\n"); |
| hbujanda | 5:01c27f88ec7d | 43 | else |
| hbujanda | 5:01c27f88ec7d | 44 | log_serial->printf("DIO3 Digital value %d\r\n", dio3); |
| hbujanda | 5:01c27f88ec7d | 45 | |
| hbujanda | 5:01c27f88ec7d | 46 | uint16_t ad2; |
| hbujanda | 5:01c27f88ec7d | 47 | radioStatus = sample_data.get_adc(XBeeZB::DIO2_AD2, &ad2); |
| hbujanda | 5:01c27f88ec7d | 48 | if (radioStatus != Success) |
| hbujanda | 5:01c27f88ec7d | 49 | log_serial->printf("sample_data.get_adc(XBeeZB::DIO2_AD2, &ad2) FAILED\r\n"); |
| hbujanda | 5:01c27f88ec7d | 50 | else |
| hbujanda | 5:01c27f88ec7d | 51 | log_serial->printf("AD2 Analog value %04x\r\n", ad2); |
| hbujanda | 5:01c27f88ec7d | 52 | } |
| hbujanda | 5:01c27f88ec7d | 53 | |
| hbujanda | 5:01c27f88ec7d | 54 | int main() |
| hbujanda | 5:01c27f88ec7d | 55 | { |
| hbujanda | 5:01c27f88ec7d | 56 | log_serial = new Serial(DEBUG_TX, DEBUG_RX); |
| hbujanda | 5:01c27f88ec7d | 57 | log_serial->baud(9600); |
| hbujanda | 5:01c27f88ec7d | 58 | log_serial->printf("Sample application to demo how to receive IO Sample Data from a RemoteXBeeZB node\r\n\r\n"); |
| hbujanda | 5:01c27f88ec7d | 59 | log_serial->printf(XB_LIB_BANNER); |
| hbujanda | 5:01c27f88ec7d | 60 | |
| hbujanda | 5:01c27f88ec7d | 61 | #if defined(ENABLE_LOGGING) |
| hbujanda | 5:01c27f88ec7d | 62 | new DigiLoggerMbedSerial(log_serial, LogLevelInfo); |
| hbujanda | 5:01c27f88ec7d | 63 | #endif |
| hbujanda | 5:01c27f88ec7d | 64 | |
| hbujanda | 5:01c27f88ec7d | 65 | XBeeZB xbee = XBeeZB(RADIO_TX, RADIO_RX, RADIO_RESET, NC, NC, 9600); |
| hbujanda | 5:01c27f88ec7d | 66 | |
| hbujanda | 5:01c27f88ec7d | 67 | /* Register callback */ |
| hbujanda | 5:01c27f88ec7d | 68 | xbee.register_io_sample_cb(&io_data_cb); |
| hbujanda | 5:01c27f88ec7d | 69 | |
| hbujanda | 5:01c27f88ec7d | 70 | RadioStatus radioStatus; |
| hbujanda | 5:01c27f88ec7d | 71 | radioStatus = xbee.init(); |
| hbujanda | 5:01c27f88ec7d | 72 | MBED_ASSERT(radioStatus == Success); |
| hbujanda | 5:01c27f88ec7d | 73 | |
| hbujanda | 5:01c27f88ec7d | 74 | /* Wait until the device has joined the network */ |
| hbujanda | 5:01c27f88ec7d | 75 | log_serial->printf("Waiting for device to join the network: "); |
| hbujanda | 5:01c27f88ec7d | 76 | while (!xbee.is_joined()) { |
| hbujanda | 5:01c27f88ec7d | 77 | wait_ms(1000); |
| hbujanda | 5:01c27f88ec7d | 78 | log_serial->printf("."); |
| hbujanda | 5:01c27f88ec7d | 79 | } |
| hbujanda | 5:01c27f88ec7d | 80 | |
| hbujanda | 5:01c27f88ec7d | 81 | log_serial->printf("OK\r\n"); |
| hbujanda | 5:01c27f88ec7d | 82 | |
| hbujanda | 5:01c27f88ec7d | 83 | const RemoteXBeeZB remoteDevice = RemoteXBeeZB(REMOTE_NODE_ADDR64); |
| hbujanda | 5:01c27f88ec7d | 84 | log_serial->printf("Configuring remote Device (%08X:%08X) DIO3_AD3 as Input and DIO2_AD2 as ADC\r\n", REMOTE_NODE_ADDR64_MSB, REMOTE_NODE_ADDR64_LSB); |
| hbujanda | 5:01c27f88ec7d | 85 | radioStatus = xbee.set_pin_config(remoteDevice, XBeeZB::DIO3_AD3, DigitalInput); |
| hbujanda | 5:01c27f88ec7d | 86 | MBED_ASSERT(radioStatus == Success); |
| hbujanda | 5:01c27f88ec7d | 87 | log_serial->printf("Enabling remote Device (%08X:%08X) internal Pull-up resistor on DIO3_AD3\r\n", REMOTE_NODE_ADDR64_MSB, REMOTE_NODE_ADDR64_LSB); |
| hbujanda | 5:01c27f88ec7d | 88 | radioStatus = xbee.set_pin_pull_up(remoteDevice, XBeeZB::DIO3_AD3, true); |
| hbujanda | 5:01c27f88ec7d | 89 | MBED_ASSERT(radioStatus == Success); |
| hbujanda | 5:01c27f88ec7d | 90 | radioStatus = xbee.set_pin_config(remoteDevice, XBeeZB::DIO2_AD2, Adc); |
| hbujanda | 5:01c27f88ec7d | 91 | MBED_ASSERT(radioStatus == Success); |
| hbujanda | 5:01c27f88ec7d | 92 | |
| hbujanda | 5:01c27f88ec7d | 93 | log_serial->printf("Configuring remote Device (%08X:%08X) to send samples every 5 seconds\r\n", REMOTE_NODE_ADDR64_MSB, REMOTE_NODE_ADDR64_LSB); |
| hbujanda | 5:01c27f88ec7d | 94 | xbee.set_io_sample_rate(remoteDevice, 5.0); |
| hbujanda | 5:01c27f88ec7d | 95 | |
| hbujanda | 5:01c27f88ec7d | 96 | log_serial->printf("Configuring remote Device (%08X:%08X) to send samples to this device\r\n", REMOTE_NODE_ADDR64_MSB, REMOTE_NODE_ADDR64_LSB); |
| hbujanda | 5:01c27f88ec7d | 97 | const uint64_t localAddr = xbee.get_addr64(); |
| hbujanda | 5:01c27f88ec7d | 98 | xbee.config_io_sample_destination(remoteDevice, localAddr); |
| hbujanda | 5:01c27f88ec7d | 99 | |
| hbujanda | 5:01c27f88ec7d | 100 | while (true) { |
| hbujanda | 5:01c27f88ec7d | 101 | xbee.process_rx_frames(); |
| hbujanda | 5:01c27f88ec7d | 102 | wait_ms(100); |
| hbujanda | 5:01c27f88ec7d | 103 | log_serial->printf("."); |
| hbujanda | 5:01c27f88ec7d | 104 | } |
| hbujanda | 5:01c27f88ec7d | 105 | |
| hbujanda | 5:01c27f88ec7d | 106 | delete(log_serial); |
| hbujanda | 5:01c27f88ec7d | 107 | } |