/**
 * Copyright (c) 2014-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
 * =======================================================================
 */
package com.digi.xbee.api;

import java.io.IOException;

import com.digi.xbee.api.connection.DataReader;
import com.digi.xbee.api.connection.IConnectionInterface;
import com.digi.xbee.api.connection.serial.SerialPortParameters;
import com.digi.xbee.api.exceptions.ATCommandException;
import com.digi.xbee.api.exceptions.InterfaceAlreadyOpenException;
import com.digi.xbee.api.exceptions.InterfaceNotOpenException;
import com.digi.xbee.api.exceptions.InvalidOperatingModeException;
import com.digi.xbee.api.exceptions.OperationNotSupportedException;
import com.digi.xbee.api.exceptions.TimeoutException;
import com.digi.xbee.api.exceptions.XBeeException;
import com.digi.xbee.api.listeners.IIOSampleReceiveListener;
import com.digi.xbee.api.listeners.IModemStatusReceiveListener;
import com.digi.xbee.api.listeners.IPacketReceiveListener;
import com.digi.xbee.api.listeners.IDataReceiveListener;
import com.digi.xbee.api.models.APIOutputMode;
import com.digi.xbee.api.models.ATCommand;
import com.digi.xbee.api.models.ATCommandResponse;
import com.digi.xbee.api.models.ExplicitXBeeMessage;
import com.digi.xbee.api.models.ModemStatusEvent;
import com.digi.xbee.api.models.OperatingMode;
import com.digi.xbee.api.models.XBee16BitAddress;
import com.digi.xbee.api.models.XBee64BitAddress;
import com.digi.xbee.api.models.XBeeMessage;
import com.digi.xbee.api.models.XBeePacketsQueue;
import com.digi.xbee.api.models.XBeeProtocol;
import com.digi.xbee.api.models.XBeeTransmitOptions;
import com.digi.xbee.api.packet.APIFrameType;
import com.digi.xbee.api.packet.XBeeAPIPacket;
import com.digi.xbee.api.packet.XBeePacket;
import com.digi.xbee.api.packet.common.ExplicitAddressingPacket;
import com.digi.xbee.api.packet.common.ExplicitRxIndicatorPacket;
import com.digi.xbee.api.packet.common.ReceivePacket;
import com.digi.xbee.api.packet.common.TransmitPacket;
import com.digi.xbee.api.packet.raw.RX16Packet;
import com.digi.xbee.api.packet.raw.RX64Packet;
import com.digi.xbee.api.packet.raw.TX64Packet;
import com.digi.xbee.api.utils.HexUtils;

/**
 * This class represents a local XBee device.
 * 
 * @see DigiMeshDevice
 * @see DigiPointDevice
 * @see Raw802Device
 * @see ZigBeeDevice
 */
public class XBeeDevice extends AbstractXBeeDevice {

        // Constants.
        private static int TIMEOUT_RESET = 5000;
        private static int TIMEOUT_READ_PACKET = 3000;
        
        private static String COMMAND_MODE_CHAR = "+";
        private static String COMMAND_MODE_OK = "OK\r";
        
        // Variables.
        protected XBeeNetwork network;
        
        private Object resetLock = new Object();
        
        private boolean modemStatusReceived = false;
        
        /**
         * Class constructor. Instantiates a new {@code XBeeDevice} object 
         * physically connected to the given port name and configured at the 
         * provided baud rate.
         * 
         * @param port Serial port name where XBee device is attached to.
         * @param baudRate Serial port baud rate to communicate with the device. 
         *                 Other connection parameters will be set as default (8 
         *                 data bits, 1 stop bit, no parity, no flow control).
         * 
         * @throws IllegalArgumentException if {@code baudRate < 0}.
         * @throws NullPointerException if {@code port == null}.
         * 
         * @see #XBeeDevice(IConnectionInterface)
         * @see #XBeeDevice(String, SerialPortParameters)
         * @see #XBeeDevice(String, int, int, int, int, int)
         */
        public XBeeDevice(String port, int baudRate) {
                super(port, baudRate);
        }
        
        /**
         * Class constructor. Instantiates a new {@code XBeeDevice} object 
         * physically connected to the given port name and configured to communicate 
         * with the provided serial settings.
         * 
         * @param port Serial port name where XBee device is attached to.
         * @param baudRate Serial port baud rate to communicate with the device.
         * @param dataBits Serial port data bits.
         * @param stopBits Serial port data bits.
         * @param parity Serial port data bits.
         * @param flowControl Serial port data bits.
         * 
         * @throws IllegalArgumentException if {@code baudRate < 0} or
         *                                  if {@code dataBits < 0} or
         *                                  if {@code stopBits < 0} or
         *                                  if {@code parity < 0} or
         *                                  if {@code flowControl < 0}.
         * @throws NullPointerException if {@code port == null}.
         * 
         * @see #XBeeDevice(IConnectionInterface)
         * @see #XBeeDevice(String, int)
         * @see #XBeeDevice(String, SerialPortParameters)
         */
        public XBeeDevice(String port, int baudRate, int dataBits, int stopBits, int parity, int flowControl) {
                super(port, baudRate, dataBits, stopBits, parity, flowControl);
        }
        
        /**
         * Class constructor. Instantiates a new {@code XBeeDevice} object 
         * physically connected to the given port name and configured to communicate 
         * with the provided serial settings.
         * 
         * @param port Serial port name where XBee device is attached to.
         * @param serialPortParameters Object containing the serial port parameters.
         * 
         * @throws NullPointerException if {@code port == null} or
         *                              if {@code serialPortParameters == null}.
         * 
         * @see #XBeeDevice(IConnectionInterface)
         * @see #XBeeDevice(String, int)
         * @see #XBeeDevice(String, int, int, int, int, int)
         * @see com.digi.xbee.api.connection.serial.SerialPortParameters
         */
        public XBeeDevice(String port, SerialPortParameters serialPortParameters) {
                super(port, serialPortParameters);
        }
        
        /**
         * Class constructor. Instantiates a new {@code XBeeDevice} object with the 
         * given connection interface.
         * 
         * @param connectionInterface The connection interface with the physical 
         *                            XBee device.
         * 
         * @throws NullPointerException if {@code connectionInterface == null}.
         * 
         * @see #XBeeDevice(String, int)
         * @see #XBeeDevice(String, SerialPortParameters)
         * @see #XBeeDevice(String, int, int, int, int, int)
         * @see com.digi.xbee.api.connection.IConnectionInterface
         */
        public XBeeDevice(IConnectionInterface connectionInterface) {
                super(connectionInterface);
        }
        
        /**
         * Opens the connection interface associated with this XBee device.
         * 
         * <p>When opening the device an information reading process is 
         * automatically performed. This includes:</p>
         * 
         * <ul>
         * <li>64-bit address.</li>
         * <li>Node Identifier.</li>
         * <li>Hardware version.</li>
         * <li>Firmware version.</li>
         * <li>XBee device protocol.</li>
         * <li>16-bit address (not for DigiMesh modules).</li>
         * </ul>
         * 
         * @throws InterfaceAlreadyOpenException if this device connection is 
         *                                       already open.
         * @throws XBeeException if there is any problem opening this device 
         *                       connection.
         * 
         * @see #close()
         * @see #isOpen()
         */
        public void open() throws XBeeException {
                logger.info(toString() + "Opening the connection interface...");
                
                // First, verify that the connection is not already open.
                if (connectionInterface.isOpen())
                        throw new InterfaceAlreadyOpenException();
                
                // Connect the interface.
                connectionInterface.open();
                
                logger.info(toString() + "Connection interface open.");
                
                // Initialize the data reader.
                dataReader = new DataReader(connectionInterface, operatingMode, this);
                dataReader.start();
                
                // Wait 10 milliseconds until the dataReader thread is started.
                // This is because when the connection is opened immediately after 
                // closing it, there is sometimes a concurrency problem and the 
                // dataReader thread never dies.
                try {
                        Thread.sleep(10);
                } catch (InterruptedException e) {}
                
                // Determine the operating mode of the XBee device if it is unknown.
                if (operatingMode == OperatingMode.UNKNOWN)
                        operatingMode = determineOperatingMode();
                
                // Check if the operating mode is a valid and supported one.
                if (operatingMode == OperatingMode.UNKNOWN) {
                        close();
                        throw new InvalidOperatingModeException("Could not determine operating mode.");
                } else if (operatingMode == OperatingMode.AT) {
                        close();
                        throw new InvalidOperatingModeException(operatingMode);
                }
                
                // Read the device info (obtain its parameters and protocol).
                try {
                        readDeviceInfo();
                } catch (ATCommandException e) {
                        throw new XBeeException("Error reading device information.", e);
                }
        }
        
        /**
         * Closes the connection interface associated with this XBee device.
         * 
         * @see #isOpen()
         * @see #open()
         */
        public void close() {
                // Stop XBee reader.
                if (dataReader != null && dataReader.isRunning())
                        dataReader.stopReader();
                // Close interface.
                connectionInterface.close();
                logger.info(toString() + "Connection interface closed.");
        }
        
        /**
         * Returns whether the connection interface associated to this device is 
         * already open.
         * 
         * @return {@code true} if the interface is open, {@code false} otherwise.
         * 
         * @see #close()
         * @see #open()
         */
        public boolean isOpen() {
                if (connectionInterface != null)
                        return connectionInterface.isOpen();
                return false;
        }
        
        /**
         * Always returns {@code false}, since this is always a local device.
         * 
         * @return {@code false} since it is a local device.
         */
        @Override
        public boolean isRemote() {
                return false;
        }
        
        /**
         * Returns the network associated with this XBee device.
         * 
         * @return The XBee network of the device.
         * 
         * @throws InterfaceNotOpenException if this device connection is not open.
         * 
         * @see XBeeNetwork
         */
        public XBeeNetwork getNetwork() {
                if (!isOpen())
                        throw new InterfaceNotOpenException();
                
                if (network == null)
                        network = new XBeeNetwork(this);
                return network;
        }
        
        /**
         * Returns the Operating mode (AT, API or API escaped) of this XBee device.
         * 
         * @return The operating mode of this XBee device.
         * 
         * @see com.digi.xbee.api.models.OperatingMode
         */
        @Override
        public OperatingMode getOperatingMode() {
                return super.getOperatingMode();
        }
        
        /*
         * (non-Javadoc)
         * @see com.digi.xbee.api.AbstractXBeeDevice#getNextFrameID()
         */
        @Override
        protected int getNextFrameID() {
                return super.getNextFrameID();
        }
        
        /**
         * Returns this XBee device configured timeout for receiving packets in 
         * synchronous operations.
         * 
         * @return The current receive timeout in milliseconds.
         * 
         * @see #setReceiveTimeout(int)
         */
        public int getReceiveTimeout() {
                return receiveTimeout;
        }
        
        /**
         * Configures this XBee device timeout in milliseconds for receiving 
         * packets in synchronous operations.
         *  
         * @param receiveTimeout The new receive timeout in milliseconds.
         * 
         * @throws IllegalArgumentException if {@code receiveTimeout < 0}.
         * 
         * @see #getReceiveTimeout()
         */
        public void setReceiveTimeout(int receiveTimeout) {
                if (receiveTimeout < 0)
                        throw new IllegalArgumentException("Receive timeout cannot be less than 0.");
                
                this.receiveTimeout = receiveTimeout;
        }
        
        /**
         * Determines the operating mode of this XBee device.
         * 
         * @return The operating mode of the XBee device.
         * 
         * @throws InterfaceNotOpenException if this device connection is not open.
         * @throws OperationNotSupportedException if the packet is being sent from 
         *                                        a remote device.
         * 
         * @see com.digi.xbee.api.models.OperatingMode
         */
        protected OperatingMode determineOperatingMode() throws OperationNotSupportedException {
                try {
                        // Check if device is in API or API Escaped operating modes.
                        operatingMode = OperatingMode.API;
                        dataReader.setXBeeReaderMode(operatingMode);
                        
                        ATCommandResponse response = sendATCommand(new ATCommand("AP"));
                        if (response.getResponse() != null && response.getResponse().length > 0) {
                                if (response.getResponse()[0] != OperatingMode.API.getID()) {
                                        operatingMode = OperatingMode.API_ESCAPE;
                                        dataReader.setXBeeReaderMode(operatingMode);
                                }
                                logger.debug(toString() + "Using {}.", operatingMode.getName());
                                return operatingMode;
                        }
                } catch (TimeoutException e) {
                        // Check if device is in AT operating mode.
                        operatingMode = OperatingMode.AT;
                        dataReader.setXBeeReaderMode(operatingMode);
                        
                        try {
                                // It is necessary to wait at least 1 second to enter in 
                                // command mode after sending any data to the device.
                                Thread.sleep(TIMEOUT_BEFORE_COMMAND_MODE);
                                // Try to enter in AT command mode, if so the module is in AT mode.
                                boolean success = enterATCommandMode();
                                if (success)
                                        return OperatingMode.AT;
                        } catch (TimeoutException e1) {
                                logger.error(e1.getMessage(), e1);
                        } catch (InvalidOperatingModeException e1) {
                                logger.error(e1.getMessage(), e1);
                        } catch (InterruptedException e1) {
                                logger.error(e1.getMessage(), e1);
                        }
                } catch (InvalidOperatingModeException e) {
                        logger.error("Invalid operating mode", e);
                } catch (IOException e) {
                        logger.error(e.getMessage(), e);
                }
                return OperatingMode.UNKNOWN;
        }
        
        /**
         * Attempts to put this device in AT Command mode. Only valid if device is 
         * working in AT mode.
         * 
         * @return {@code true} if the device entered in AT command mode, 
         *         {@code false} otherwise.
         * 
         * @throws InterfaceNotOpenException if this device connection is not open.
         * @throws InvalidOperatingModeException if the operating mode cannot be 
         *                                       determined or is not supported.
         * @throws TimeoutException if the configured time for this device expires.
         */
        private boolean enterATCommandMode() throws InvalidOperatingModeException, TimeoutException {
                if (!connectionInterface.isOpen())
                        throw new InterfaceNotOpenException();
                if (operatingMode != OperatingMode.AT)
                        throw new InvalidOperatingModeException("Invalid mode. Command mode can be only accessed while in AT mode.");
                
                // Enter in AT command mode (send '+++'). The process waits 1,5 seconds for the 'OK\n'.
                byte[] readData = new byte[256];
                try {
                        // Send the command mode sequence.
                        connectionInterface.writeData(COMMAND_MODE_CHAR.getBytes());
                        connectionInterface.writeData(COMMAND_MODE_CHAR.getBytes());
                        connectionInterface.writeData(COMMAND_MODE_CHAR.getBytes());
                        
                        // Wait some time to let the module generate a response.
                        Thread.sleep(TIMEOUT_ENTER_COMMAND_MODE);
                        
                        // Read data from the device (it should answer with 'OK\r').
                        int readBytes = connectionInterface.readData(readData);
                        if (readBytes < COMMAND_MODE_OK.length())
                                throw new TimeoutException();
                        
                        // Check if the read data is 'OK\r'.
                        String readString = new String(readData, 0, readBytes);
                        if (!readString.contains(COMMAND_MODE_OK))
                                return false;
                        
                        // Read data was 'OK\r'.
                        return true;
                } catch (IOException e) {
                        logger.error(e.getMessage(), e);
                } catch (InterruptedException e) {
                        logger.error(e.getMessage(), e);
                }
                return false;
        }
        
        /*
         * (non-Javadoc)
         * @see com.digi.xbee.api.AbstractXBeeDevice#addPacketListener(com.digi.xbee.api.listeners.IPacketReceiveListener)
         */
        @Override
        public void addPacketListener(IPacketReceiveListener listener) {
                super.addPacketListener(listener);
        }
        
        /*
         * (non-Javadoc)
         * @see com.digi.xbee.api.AbstractXBeeDevice#removePacketListener(com.digi.xbee.api.listeners.IPacketReceiveListener)
         */
        @Override
        public void removePacketListener(IPacketReceiveListener listener) {
                super.removePacketListener(listener);
        }
        
        /*
         * (non-Javadoc)
         * @see com.digi.xbee.api.AbstractXBeeDevice#addDataListener(com.digi.xbee.api.listeners.IDataReceiveListener)
         */
        @Override
        public void addDataListener(IDataReceiveListener listener) {
                super.addDataListener(listener);
        }
        
        /*
         * (non-Javadoc)
         * @see com.digi.xbee.api.AbstractXBeeDevice#removeDataListener(com.digi.xbee.api.listeners.IDataReceiveListener)
         */
        @Override
        public void removeDataListener(IDataReceiveListener listener) {
                super.removeDataListener(listener);
        }
        
        /*
         * (non-Javadoc)
         * @see com.digi.xbee.api.AbstractXBeeDevice#addIOSampleListener(com.digi.xbee.api.listeners.IIOSampleReceiveListener)
         */
        @Override
        public void addIOSampleListener(IIOSampleReceiveListener listener) {
                super.addIOSampleListener(listener);
        }
        
        /*
         * (non-Javadoc)
         * @see com.digi.xbee.api.AbstractXBeeDevice#removeIOSampleListener(com.digi.xbee.api.listeners.IIOSampleReceiveListener)
         */
        @Override
        public void removeIOSampleListener(IIOSampleReceiveListener listener) {
                super.removeIOSampleListener(listener);
        }
        
        /*
         * (non-Javadoc)
         * @see com.digi.xbee.api.AbstractXBeeDevice#addModemStatusListener(com.digi.xbee.api.listeners.IModemStatusReceiveListener)
         */
        @Override
        public void addModemStatusListener(IModemStatusReceiveListener listener) {
                super.addModemStatusListener(listener);
        }
        
        /*
         * (non-Javadoc)
         * @see com.digi.xbee.api.AbstractXBeeDevice#removeModemStatusListener(com.digi.xbee.api.listeners.IModemStatusReceiveListener)
         */
        @Override
        public void removeModemStatusListener(IModemStatusReceiveListener listener) {
                super.removeModemStatusListener(listener);
        }
        
        /**
         * Sends asynchronously the provided data to the XBee device of the network 
         * corresponding to the given 64-bit address.
         * 
         * <p>Asynchronous transmissions do not wait for answer from the remote 
         * device or for transmit status packet.</p>
         * 
         * @param address The 64-bit address of the XBee that will receive the data.
         * @param data Byte array containing the data to be sent.
         * 
         * @throws InterfaceNotOpenException if this device connection is not open.
         * @throws NullPointerException if {@code address == null} or 
         *                              if {@code data == null}.
         * @throws XBeeException if there is any XBee related exception.
         * 
         * @see #sendData(RemoteXBeeDevice, byte[])
         * @see #sendData(XBee64BitAddress, byte[])
         * @see #sendData(XBee64BitAddress, XBee16BitAddress, byte[])
         * @see #sendDataAsync(RemoteXBeeDevice, byte[])
         * @see #sendDataAsync(XBee64BitAddress, XBee16BitAddress, byte[])
         * @see com.digi.xbee.api.models.XBee64BitAddress
         */
        protected void sendDataAsync(XBee64BitAddress address, byte[] data) throws XBeeException {
                // Verify the parameters are not null, if they are null, throw an exception.
                if (address == null)
                        throw new NullPointerException("Address cannot be null");
                if (data == null)
                        throw new NullPointerException("Data cannot be null");
                
                // Check if device is remote.
                if (isRemote())
                        throw new OperationNotSupportedException("Cannot send data to a remote device from a remote device.");
                
                logger.debug(toString() + "Sending data asynchronously to {} >> {}.", address, HexUtils.prettyHexString(data));
                
                XBeePacket xbeePacket;
                switch (getXBeeProtocol()) {
                case RAW_802_15_4:
                        xbeePacket = new TX64Packet(getNextFrameID(), address, XBeeTransmitOptions.NONE, data);
                        break;
                default:
                        xbeePacket = new TransmitPacket(getNextFrameID(), address, XBee16BitAddress.UNKNOWN_ADDRESS, 0, XBeeTransmitOptions.NONE, data);
                }
                sendAndCheckXBeePacket(xbeePacket, true);
        }
        
        /**
         * Sends asynchronously the provided data to the XBee device of the network 
         * corresponding to the given 64-bit/16-bit address.
         * 
         * <p>Asynchronous transmissions do not wait for answer from the remote 
         * device or for transmit status packet.</p>
         * 
         * @param address64Bit The 64-bit address of the XBee that will receive the 
         *                     data.
         * @param address16Bit The 16-bit address of the XBee that will receive the 
         *                     data. If it is unknown the 
         *                     {@code XBee16BitAddress.UNKNOWN_ADDRESS} must be 
         *                     used.
         * @param data Byte array containing the data to be sent.
         * 
         * @throws InterfaceNotOpenException if this device connection is not open.
         * @throws NullPointerException if {@code address64Bit == null} or 
         *                              if {@code address16Bit == null} or
         *                              if {@code data == null}.
         * @throws XBeeException if a remote device is trying to send data or 
         *                       if there is any other XBee related exception.
         * 
         * @see #sendData(RemoteXBeeDevice, byte[])
         * @see #sendData(XBee64BitAddress, byte[])
         * @see #sendData(XBee64BitAddress, XBee16BitAddress, byte[])
         * @see #sendDataAsync(RemoteXBeeDevice, byte[])
         * @see #sendDataAsync(XBee64BitAddress, byte[])
         * @see com.digi.xbee.api.models.XBee16BitAddress
         * @see com.digi.xbee.api.models.XBee64BitAddress
         */
        protected void sendDataAsync(XBee64BitAddress address64Bit, XBee16BitAddress address16Bit, byte[] data) throws XBeeException {
                // Verify the parameters are not null, if they are null, throw an exception.
                if (address64Bit == null)
                        throw new NullPointerException("64-bit address cannot be null");
                if (address16Bit == null)
                        throw new NullPointerException("16-bit address cannot be null");
                if (data == null)
                        throw new NullPointerException("Data cannot be null");
                
                // Check if device is remote.
                if (isRemote())
                        throw new OperationNotSupportedException("Cannot send data to a remote device from a remote device.");
                
                logger.debug(toString() + "Sending data asynchronously to {}[{}] >> {}.", 
                                address64Bit, address16Bit, HexUtils.prettyHexString(data));
                
                XBeePacket xbeePacket = new TransmitPacket(getNextFrameID(), address64Bit, address16Bit, 0, XBeeTransmitOptions.NONE, data);
                sendAndCheckXBeePacket(xbeePacket, true);
        }
        
        /**
         * Sends the provided data to the provided XBee device asynchronously 
         * choosing the optimal send method depending on the protocol of the local 
         * XBee device.
         * 
         * <p>Asynchronous transmissions do not wait for answer from the remote 
         * device or for transmit status packet.</p>
         * 
         * @param remoteXBeeDevice The XBee device of the network that will receive the 
         *                   data.
         * @param data Byte array containing the data to be sent.
         * 
         * @throws InterfaceNotOpenException if this device connection is not open.
         * @throws NullPointerException if {@code remoteXBeeDevice == null} or 
         *                              if {@code data == null}.
         * @throws XBeeException if there is any XBee related exception.
         * 
         * @see #sendData(RemoteXBeeDevice, byte[])
         * @see #sendData(XBee64BitAddress, byte[])
         * @see #sendData(XBee64BitAddress, XBee16BitAddress, byte[])
         * @see #sendDataAsync(XBee64BitAddress, byte[])
         * @see #sendDataAsync(XBee64BitAddress, XBee16BitAddress, byte[])
         * @see RemoteXBeeDevice
         */
        public void sendDataAsync(RemoteXBeeDevice remoteXBeeDevice, byte[] data) throws XBeeException {
                if (remoteXBeeDevice == null)
                        throw new NullPointerException("Remote XBee device cannot be null");
                
                switch (getXBeeProtocol()) {
                case ZIGBEE:
                case DIGI_POINT:
                        if (remoteXBeeDevice.get64BitAddress() != null && remoteXBeeDevice.get16BitAddress() != null)
                                sendDataAsync(remoteXBeeDevice.get64BitAddress(), remoteXBeeDevice.get16BitAddress(), data);
                        else
                                sendDataAsync(remoteXBeeDevice.get64BitAddress(), data);
                        break;
                case RAW_802_15_4:
                        if (this instanceof Raw802Device) {
                                if (remoteXBeeDevice.get64BitAddress() != null)
                                        ((Raw802Device)this).sendDataAsync(remoteXBeeDevice.get64BitAddress(), data);
                                else
                                        ((Raw802Device)this).sendDataAsync(remoteXBeeDevice.get16BitAddress(), data);
                        } else
                                sendDataAsync(remoteXBeeDevice.get64BitAddress(), data);
                        break;
                case DIGI_MESH:
                default:
                        sendDataAsync(remoteXBeeDevice.get64BitAddress(), data);
                }
        }
        
        /**
         * Sends the provided data to the XBee device of the network corresponding 
         * to the given 64-bit address.
         * 
         * <p>This method blocks till a success or error response arrives or the 
         * configured receive timeout expires.</p>
         * 
         * <p>The receive timeout is configured using the {@code setReceiveTimeout}
         * method and can be consulted with {@code getReceiveTimeout} method.</p>
         * 
         * <p>For non-blocking operations use the method 
         * {@link #sendDataAsync(XBee64BitAddress, byte[])}.</p>
         * 
         * @param address The 64-bit address of the XBee that will receive the data.
         * @param data Byte array containing the data to be sent.
         * 
         * @throws InterfaceNotOpenException if this device connection is not open.
         * @throws NullPointerException if {@code address == null} or 
         *                              if {@code data == null}.
         * @throws TimeoutException if there is a timeout sending the data.
         * @throws XBeeException if there is any other XBee related exception.
         * 
         * @see #getReceiveTimeout()
         * @see #setReceiveTimeout(int)
         * @see #sendData(RemoteXBeeDevice, byte[])
         * @see #sendData(XBee64BitAddress, XBee16BitAddress, byte[])
         * @see #sendDataAsync(RemoteXBeeDevice, byte[])
         * @see #sendDataAsync(XBee64BitAddress, byte[])
         * @see #sendDataAsync(XBee64BitAddress, XBee16BitAddress, byte[])
         * @see com.digi.xbee.api.models.XBee64BitAddress
         */
        protected void sendData(XBee64BitAddress address, byte[] data) throws TimeoutException, XBeeException {
                // Verify the parameters are not null, if they are null, throw an exception.
                if (address == null)
                        throw new NullPointerException("Address cannot be null");
                if (data == null)
                        throw new NullPointerException("Data cannot be null");
                
                // Check if device is remote.
                if (isRemote())
                        throw new OperationNotSupportedException("Cannot send data to a remote device from a remote device.");
                
                logger.debug(toString() + "Sending data to {} >> {}.", address, HexUtils.prettyHexString(data));
                
                XBeePacket xbeePacket;
                switch (getXBeeProtocol()) {
                case RAW_802_15_4:
                        xbeePacket = new TX64Packet(getNextFrameID(), address, XBeeTransmitOptions.NONE, data);
                        break;
                default:
                        xbeePacket = new TransmitPacket(getNextFrameID(), address, XBee16BitAddress.UNKNOWN_ADDRESS, 0, XBeeTransmitOptions.NONE, data);
                }
                sendAndCheckXBeePacket(xbeePacket, false);
        }
        
        /**
         * Sends the provided data to the XBee device of the network corresponding 
         * to the given 64-bit/16-bit address.
         * 
         * <p>This method blocks till a success or error response arrives or the 
         * configured receive timeout expires.</p>
         * 
         * <p>The receive timeout is configured using the {@code setReceiveTimeout}
         * method and can be consulted with {@code getReceiveTimeout} method.</p>
         * 
         * <p>For non-blocking operations use the method 
         * {@link #sendDataAsync(XBee64BitAddress, XBee16BitAddress, byte[])}.</p>
         * 
         * @param address64Bit The 64-bit address of the XBee that will receive the 
         *                     data.
         * @param address16Bit The 16-bit address of the XBee that will receive the 
         *                     data. If it is unknown the 
         *                     {@code XBee16BitAddress.UNKNOWN_ADDRESS} must be 
         *                     used.
         * @param data Byte array containing the data to be sent.
         * 
         * @throws InterfaceNotOpenException if this device connection is not open.
         * @throws NullPointerException if {@code address64Bit == null} or 
         *                              if {@code address16Bit == null} or
         *                              if {@code data == null}.
         * @throws TimeoutException if there is a timeout sending the data.
         * @throws XBeeException if a remote device is trying to send data or 
         *                       if there is any other XBee related exception.
         * 
         * @see #getReceiveTimeout()
         * @see #setReceiveTimeout(int)
         * @see #sendData(RemoteXBeeDevice, byte[])
         * @see #sendData(XBee64BitAddress, byte[])
         * @see #sendDataAsync(RemoteXBeeDevice, byte[])
         * @see #sendDataAsync(XBee64BitAddress, byte[])
         * @see #sendDataAsync(XBee64BitAddress, XBee16BitAddress, byte[])
         * @see com.digi.xbee.api.models.XBee16BitAddress
         * @see com.digi.xbee.api.models.XBee64BitAddress
         */
        protected void sendData(XBee64BitAddress address64Bit, XBee16BitAddress address16Bit, byte[] data) throws TimeoutException, XBeeException {
                // Verify the parameters are not null, if they are null, throw an exception.
                if (address64Bit == null)
                        throw new NullPointerException("64-bit address cannot be null");
                if (address16Bit == null)
                        throw new NullPointerException("16-bit address cannot be null");
                if (data == null)
                        throw new NullPointerException("Data cannot be null");
                
                // Check if device is remote.
                if (isRemote())
                        throw new OperationNotSupportedException("Cannot send data to a remote device from a remote device.");
                
                logger.debug(toString() + "Sending data to {}[{}] >> {}.", 
                                address64Bit, address16Bit, HexUtils.prettyHexString(data));
                
                XBeePacket xbeePacket = new TransmitPacket(getNextFrameID(), address64Bit, address16Bit, 0, XBeeTransmitOptions.NONE, data);
                sendAndCheckXBeePacket(xbeePacket, false);
        }
        
        /**
         * Sends the provided data to the given XBee device choosing the optimal 
         * send method depending on the protocol of the local XBee device.
         * 
         * <p>This method blocks till a success or error response arrives or the 
         * configured receive timeout expires.</p>
         * 
         * <p>The receive timeout is configured using the {@code setReceiveTimeout}
         * method and can be consulted with {@code getReceiveTimeout} method.</p>
         * 
         * <p>For non-blocking operations use the method 
         * {@link #sendDataAsync(RemoteXBeeDevice, byte[])}.</p>
         * 
         * @param remoteXBeeDevice The XBee device of the network that will receive 
         *                         the data.
         * @param data Byte array containing the data to be sent.
         * 
         * @throws InterfaceNotOpenException if this device connection is not open.
         * @throws NullPointerException if {@code xbeeDevice == null} or 
         *                              if {@code data == null}.
         * @throws TimeoutException if there is a timeout sending the data.
         * @throws XBeeException if there is any other XBee related exception.
         * 
         * @see #getReceiveTimeout()
         * @see #setReceiveTimeout(int)
         * @see #sendData(XBee64BitAddress, byte[])
         * @see #sendData(XBee64BitAddress, XBee16BitAddress, byte[])
         * @see #sendDataAsync(RemoteXBeeDevice, byte[])
         * @see #sendDataAsync(XBee64BitAddress, byte[])
         * @see #sendDataAsync(XBee64BitAddress, XBee16BitAddress, byte[])
         * @see com.digi.xbee.api.RemoteXBeeDevice
         */
        public void sendData(RemoteXBeeDevice remoteXBeeDevice, byte[] data) throws TimeoutException, XBeeException {
                if (remoteXBeeDevice == null)
                        throw new NullPointerException("Remote XBee device cannot be null");
                
                switch (getXBeeProtocol()) {
                case ZIGBEE:
                case DIGI_POINT:
                        if (remoteXBeeDevice.get64BitAddress() != null && remoteXBeeDevice.get16BitAddress() != null)
                                sendData(remoteXBeeDevice.get64BitAddress(), remoteXBeeDevice.get16BitAddress(), data);
                        else
                                sendData(remoteXBeeDevice.get64BitAddress(), data);
                        break;
                case RAW_802_15_4:
                        if (this instanceof Raw802Device) {
                                if (remoteXBeeDevice.get64BitAddress() != null)
                                        ((Raw802Device)this).sendData(remoteXBeeDevice.get64BitAddress(), data);
                                else
                                        ((Raw802Device)this).sendData(remoteXBeeDevice.get16BitAddress(), data);
                        } else
                                sendData(remoteXBeeDevice.get64BitAddress(), data);
                        break;
                case DIGI_MESH:
                default:
                        sendData(remoteXBeeDevice.get64BitAddress(), data);
                }
        }
        
        /**
         * Sends the provided data to all the XBee nodes of the network (broadcast).
         * 
         * <p>This method blocks till a success or error transmit status arrives or 
         * the configured receive timeout expires.</p>
         * 
         * <p>The receive timeout is configured using the {@code setReceiveTimeout}
         * method and can be consulted with {@code getReceiveTimeout} method.</p>
         * 
         * @param data Byte array containing the data to be sent.
         * 
         * @throws InterfaceNotOpenException if this device connection is not open.
         * @throws NullPointerException if {@code data == null}.
         * @throws TimeoutException if there is a timeout sending the data.
         * @throws XBeeException if there is any other XBee related exception.
         * 
         * @see #getReceiveTimeout()
         * @see #setReceiveTimeout(int)
         */
        public void sendBroadcastData(byte[] data) throws TimeoutException, XBeeException {
                sendData(XBee64BitAddress.BROADCAST_ADDRESS, data);
        }
        
        /**
         * Sends asynchronously the provided data in application layer mode to the 
         * XBee device of the network corresponding to the given 64-bit address. 
         * Application layer mode means that you need to specify the application 
         * layer fields to be sent with the data.
         * 
         * <p>Asynchronous transmissions do not wait for answer from the remote 
         * device or for transmit status packet.</p>
         * 
         * @param address The 64-bit address of the XBee that will receive the data.
         * @param sourceEndpoint Source endpoint for the transmission.
         * @param destEndpoint Destination endpoint for the transmission.
         * @param clusterID Cluster ID used in the transmission.
         * @param profileID Profile ID used in the transmission.
         * @param data Byte array containing the data to be sent.
         * 
         * @throws IllegalArgumentException if {@code sourceEndpoint < 0} or 
         *                                  if {@code sourceEndpoint > 0xFF} or 
         *                                  if {@code destEndpoint < 0} or 
         *                                  if {@code destEndpoint > 0xFF} or 
         *                                  if {@code clusterID < 0} or 
         *                                  if {@code clusterID > 0xFFFF} or 
         *                                  if {@code profileID < 0} or 
         *                                  if {@code profileID > 0xFFFF}.
         * @throws InterfaceNotOpenException if this device connection is not open.
         * @throws NullPointerException if {@code address == null} or 
         *                              if {@code data == null}.
         * @throws XBeeException if there is any other XBee related exception.
         * 
         * @see #sendExplicitData(RemoteXBeeDevice, int, int, int, int, byte[])
         * @see #sendExplicitData(XBee64BitAddress, int, int, int, int, byte[])
         * @see #sendExplicitData(XBee64BitAddress, XBee16BitAddress, int, int, int, int, byte[])
         * @see #sendExplicitDataAsync(RemoteXBeeDevice, int, int, int, int, byte[])
         * @see #sendExplicitDataAsync(XBee64BitAddress, XBee16BitAddress, int, int, int, int, byte[])
         * @see com.digi.xbee.api.models.XBee64BitAddress
         */
        protected void sendExplicitDataAsync(XBee64BitAddress address, int sourceEndpoint, int destEndpoint, int clusterID, 
                        int profileID, byte[] data) throws XBeeException {
                if (address == null)
                        throw new NullPointerException("Address cannot be null");
                if (data == null)
                        throw new NullPointerException("Data cannot be null.");
                if (sourceEndpoint < 0 || sourceEndpoint > 0xFF)
                        throw new IllegalArgumentException("Source endpoint must be between 0 and 0xFF.");
                if (destEndpoint < 0 || destEndpoint > 0xFF)
                        throw new IllegalArgumentException("Destination endpoint must be between 0 and 0xFF.");
                if (clusterID < 0 || clusterID > 0xFFFF)
                        throw new IllegalArgumentException("Cluster ID must be between 0 and 0xFFFF.");
                if (profileID < 0 || profileID > 0xFFFF)
                        throw new IllegalArgumentException("Profile ID must be between 0 and 0xFFFF.");
                
                // Check if device is remote.
                if (isRemote())
                        throw new OperationNotSupportedException("Cannot send explicit data to a remote device from a remote device.");
                
                logger.debug(toString() + "Sending explicit data asynchronously to {} [{} - {} - {} - {}] >> {}.", address, HexUtils.integerToHexString(sourceEndpoint, 1), 
                                HexUtils.integerToHexString(destEndpoint, 1), HexUtils.integerToHexString(clusterID, 2), 
                                HexUtils.integerToHexString(profileID, 2), HexUtils.prettyHexString(data));
                
                XBeePacket xbeePacket = new ExplicitAddressingPacket(getNextFrameID(), address, XBee16BitAddress.UNKNOWN_ADDRESS, sourceEndpoint, destEndpoint, clusterID, profileID, 0, XBeeTransmitOptions.NONE, data);
                sendAndCheckXBeePacket(xbeePacket, true);
        }
        
        /**
         * Sends asynchronously the provided data in application layer mode to the 
         * XBee device of the network corresponding to the given 64-bit/16-bit 
         * address. Application layer mode means that you need to specify the 
         * application layer fields to be sent with the data.
         * 
         * <p>Asynchronous transmissions do not wait for answer from the remote 
         * device or for transmit status packet.</p>
         * 
         * @param address64Bit The 64-bit address of the XBee that will receive the 
         *                     data.
         * @param address16Bit The 16-bit address of the XBee that will receive the 
         *                     data. If it is unknown the 
         *                     {@code XBee16BitAddress.UNKNOWN_ADDRESS} must be 
         *                     used.
         * @param sourceEndpoint Source endpoint for the transmission.
         * @param destEndpoint Destination endpoint for the transmission.
         * @param clusterID Cluster ID used in the transmission.
         * @param profileID Profile ID used in the transmission.
         * @param data Byte array containing the data to be sent.
         * 
         * @throws IllegalArgumentException if {@code sourceEndpoint < 0} or 
         *                                  if {@code sourceEndpoint > 0xFF} or 
         *                                  if {@code destEndpoint < 0} or 
         *                                  if {@code destEndpoint > 0xFF} or 
         *                                  if {@code clusterID < 0} or 
         *                                  if {@code clusterID > 0xFFFF} or 
         *                                  if {@code profileID < 0} or 
         *                                  if {@code profileID > 0xFFFF}.
         * @throws InterfaceNotOpenException if this device connection is not open.
         * @throws NullPointerException if {@code address64Bit == null} or 
         *                              if {@code address16Bit == null} or 
         *                              if {@code data == null}.
         * @throws XBeeException if there is any other XBee related exception.
         * 
         * @see #sendExplicitData(RemoteXBeeDevice, int, int, int, int, byte[])
         * @see #sendExplicitData(XBee64BitAddress, int, int, int, int, byte[])
         * @see #sendExplicitData(XBee64BitAddress, XBee16BitAddress, int, int, int, int, byte[])
         * @see #sendExplicitDataAsync(RemoteXBeeDevice, int, int, int, int, byte[])
         * @see #sendExplicitDataAsync(XBee64BitAddress, int, int, int, int, byte[])
         * @see com.digi.xbee.api.models.XBee16BitAddress
         * @see com.digi.xbee.api.models.XBee64BitAddress
         */
        protected void sendExplicitDataAsync(XBee64BitAddress address64Bit, XBee16BitAddress address16Bit, int sourceEndpoint, 
                        int destEndpoint, int clusterID, int profileID, byte[] data) throws XBeeException {
                if (address64Bit == null)
                        throw new NullPointerException("64-bit address cannot be null.");
                if (address16Bit == null)
                        throw new NullPointerException("16-bit address cannot be null.");
                if (data == null)
                        throw new NullPointerException("Data cannot be null.");
                if (sourceEndpoint < 0 || sourceEndpoint > 0xFF)
                        throw new IllegalArgumentException("Source endpoint must be between 0 and 0xFF.");
                if (destEndpoint < 0 || destEndpoint > 0xFF)
                        throw new IllegalArgumentException("Destination endpoint must be between 0 and 0xFF.");
                if (clusterID < 0 || clusterID > 0xFFFF)
                        throw new IllegalArgumentException("Cluster ID must be between 0 and 0xFFFF.");
                if (profileID < 0 || profileID > 0xFFFF)
                        throw new IllegalArgumentException("Profile ID must be between 0 and 0xFFFF.");
                
                // Check if device is remote.
                if (isRemote())
                        throw new OperationNotSupportedException("Cannot send explicit data to a remote device from a remote device.");
                
                logger.debug(toString() + "Sending explicit data asynchronously to {}[{}] [{} - {} - {} - {}] >> {}.", address64Bit, address16Bit, 
                                HexUtils.integerToHexString(sourceEndpoint, 1), HexUtils.integerToHexString(destEndpoint, 1), 
                                HexUtils.integerToHexString(clusterID, 2), HexUtils.integerToHexString(profileID, 2), 
                                HexUtils.prettyHexString(data));
                
                XBeePacket xbeePacket = new ExplicitAddressingPacket(getNextFrameID(), address64Bit, address16Bit, sourceEndpoint, destEndpoint, clusterID, profileID, 0, XBeeTransmitOptions.NONE, data);
                sendAndCheckXBeePacket(xbeePacket, true);
        }
        
        /**
         * Sends asynchronously the provided data in application layer mode to the 
         * provided XBee device choosing the optimal send method depending on the 
         * protocol of the local XBee device. Application layer mode means that you 
         * need to specify the application layer fields to be sent with the data.
         * 
         * <p>Asynchronous transmissions do not wait for answer from the remote 
         * device or for transmit status packet.</p>
         * 
         * @param remoteXBeeDevice The XBee device of the network that will receive 
         *                         the data.
         * @param sourceEndpoint Source endpoint for the transmission.
         * @param destEndpoint Destination endpoint for the transmission.
         * @param clusterID Cluster ID used in the transmission.
         * @param profileID Profile ID used in the transmission.
         * @param data Byte array containing the data to be sent.
         * 
         * @throws IllegalArgumentException if {@code sourceEndpoint < 0} or 
         *                                  if {@code sourceEndpoint > 0xFF} or 
         *                                  if {@code destEndpoint < 0} or 
         *                                  if {@code destEndpoint > 0xFF} or 
         *                                  if {@code clusterID < 0} or 
         *                                  if {@code clusterID > 0xFFFF} or 
         *                                  if {@code profileID < 0} or 
         *                                  if {@code profileID > 0xFFFF}.
         * @throws InterfaceNotOpenException if this device connection is not open.
         * @throws NullPointerException if {@code remoteXBeeDevice == null} or 
         *                              if {@code data == null}.
         * @throws XBeeException if there is any other XBee related exception.
         * 
         * @see #sendExplicitData(RemoteXBeeDevice, int, int, int, int, byte[])
         * @see #sendExplicitData(XBee64BitAddress, int, int, int, int, byte[])
         * @see #sendExplicitData(XBee64BitAddress, XBee16BitAddress, int, int, int, int, byte[])
         * @see #sendExplicitDataAsync(XBee64BitAddress, int, int, int, int, byte[])
         * @see #sendExplicitDataAsync(XBee64BitAddress, XBee16BitAddress, int, int, int, int, byte[])
         * @see RemoteXBeeDevice
         */
        protected void sendExplicitDataAsync(RemoteXBeeDevice remoteXBeeDevice, int sourceEndpoint, int destEndpoint, 
                        int clusterID, int profileID, byte[] data) throws XBeeException {
                if (remoteXBeeDevice == null)
                        throw new NullPointerException("Remote XBee device cannot be null");
                
                switch (getXBeeProtocol()) {
                case ZIGBEE:
                case DIGI_POINT:
                        if (remoteXBeeDevice.get64BitAddress() != null && remoteXBeeDevice.get16BitAddress() != null)
                                sendExplicitDataAsync(remoteXBeeDevice.get64BitAddress(), remoteXBeeDevice.get16BitAddress(), sourceEndpoint, destEndpoint, clusterID, profileID, data);
                        else
                                sendExplicitDataAsync(remoteXBeeDevice.get64BitAddress(), sourceEndpoint, destEndpoint, clusterID, profileID, data);
                        break;
                case RAW_802_15_4:
                        throw new OperationNotSupportedException("802.15.4. protocol does not support explicit data transmissions.");
                case DIGI_MESH:
                default:
                        sendExplicitDataAsync(remoteXBeeDevice.get64BitAddress(), sourceEndpoint, destEndpoint, clusterID, profileID, data);
                }
        }
        
        /**
         * Sends the provided data in application layer mode to the XBee device of 
         * the network corresponding to the given 64-bit address. Application layer 
         * mode means that you need to specify the application layer fields to be 
         * sent with the data.
         * 
         * <p>This method blocks till a success or error response arrives or the 
         * configured receive timeout expires.</p>
         * 
         * <p>The receive timeout is configured using the {@code setReceiveTimeout}
         * method and can be consulted with {@code getReceiveTimeout} method.</p>
         * 
         * @param address The 64-bit address of the XBee that will receive the data.
         * @param sourceEndpoint Source endpoint for the transmission.
         * @param destEndpoint Destination endpoint for the transmission.
         * @param clusterID Cluster ID used in the transmission.
         * @param profileID Profile ID used in the transmission.
         * @param data Byte array containing the data to be sent.
         * 
         * @throws IllegalArgumentException if {@code sourceEndpoint < 0} or 
         *                                  if {@code sourceEndpoint > 0xFF} or 
         *                                  if {@code destEndpoint < 0} or 
         *                                  if {@code destEndpoint > 0xFF} or 
         *                                  if {@code clusterID < 0} or 
         *                                  if {@code clusterID > 0xFFFF} or 
         *                                  if {@code profileID < 0} or 
         *                                  if {@code profileID > 0xFFFF}.
         * @throws InterfaceNotOpenException if this device connection is not open.
         * @throws NullPointerException if {@code address == null} or 
         *                              if {@code data == null}.
         * @throws TimeoutException if there is a timeout sending the data.
         * @throws XBeeException if there is any other XBee related exception.
         * 
         * @see #getReceiveTimeout()
         * @see #sendExplicitData(RemoteXBeeDevice, int, int, int, int, byte[])
         * @see #sendExplicitData(XBee64BitAddress, XBee16BitAddress, int, int, int, int, byte[])
         * @see #setReceiveTimeout(int)
         * @see com.digi.xbee.api.models.XBee64BitAddress
         */
        protected void sendExplicitData(XBee64BitAddress address, int sourceEndpoint, int destEndpoint, int clusterID, 
                        int profileID, byte[] data) throws TimeoutException, XBeeException {
                if (address == null)
                        throw new NullPointerException("Address cannot be null");
                if (data == null)
                        throw new NullPointerException("Data cannot be null.");
                if (sourceEndpoint < 0 || sourceEndpoint > 0xFF)
                        throw new IllegalArgumentException("Source endpoint must be between 0 and 0xFF.");
                if (destEndpoint < 0 || destEndpoint > 0xFF)
                        throw new IllegalArgumentException("Destination endpoint must be between 0 and 0xFF.");
                if (clusterID < 0 || clusterID > 0xFFFF)
                        throw new IllegalArgumentException("Cluster ID must be between 0 and 0xFFFF.");
                if (profileID < 0 || profileID > 0xFFFF)
                        throw new IllegalArgumentException("Profile ID must be between 0 and 0xFFFF.");
                
                // Check if device is remote.
                if (isRemote())
                        throw new OperationNotSupportedException("Cannot send explicit data to a remote device from a remote device.");
                
                logger.debug(toString() + "Sending explicit data to {} [{} - {} - {} - {}] >> {}.", address, HexUtils.integerToHexString(sourceEndpoint, 1), 
                                HexUtils.integerToHexString(destEndpoint, 1), HexUtils.integerToHexString(clusterID, 2), 
                                HexUtils.integerToHexString(profileID, 2), HexUtils.prettyHexString(data));
                
                XBeePacket xbeePacket = new ExplicitAddressingPacket(getNextFrameID(), address, XBee16BitAddress.UNKNOWN_ADDRESS, sourceEndpoint, destEndpoint, clusterID, profileID, 0, XBeeTransmitOptions.NONE, data);
                sendAndCheckXBeePacket(xbeePacket, false);
        }
        
        /**
         * Sends the provided data in application layer mode to the XBee device of 
         * the network corresponding to the given 64-bit/16-bit address. 
         * Application layer mode means that you need to specify the application 
         * layer fields to be sent with the data.
         * 
         * <p>This method blocks till a success or error response arrives or the 
         * configured receive timeout expires.</p>
         * 
         * <p>The receive timeout is configured using the {@code setReceiveTimeout}
         * method and can be consulted with {@code getReceiveTimeout} method.</p>
         * 
         * @param address64Bit The 64-bit address of the XBee that will receive the 
         *                     data.
         * @param address16Bit The 16-bit address of the XBee that will receive the 
         *                     data. If it is unknown the 
         *                     {@code XBee16BitAddress.UNKNOWN_ADDRESS} must be 
         *                     used.
         * @param sourceEndpoint Source endpoint for the transmission.
         * @param destEndpoint Destination endpoint for the transmission.
         * @param clusterID Cluster ID used in the transmission.
         * @param profileID Profile ID used in the transmission.
         * @param data Byte array containing the data to be sent.
         * 
         * @throws IllegalArgumentException if {@code sourceEndpoint < 0} or 
         *                                  if {@code sourceEndpoint > 0xFF} or 
         *                                  if {@code destEndpoint < 0} or 
         *                                  if {@code destEndpoint > 0xFF} or 
         *                                  if {@code clusterID < 0} or 
         *                                  if {@code clusterID > 0xFFFF} or 
         *                                  if {@code profileID < 0} or 
         *                                  if {@code profileID > 0xFFFF}.
         * @throws InterfaceNotOpenException if this device connection is not open.
         * @throws NullPointerException if {@code address == null} or 
         *                              if {@code data == null}.
         * @throws TimeoutException if there is a timeout sending the data.
         * @throws XBeeException if there is any other XBee related exception.
         * 
         * @see #getReceiveTimeout()
         * @see #sendExplicitData(RemoteXBeeDevice, int, int, int, int, byte[])
         * @see #sendExplicitData(XBee64BitAddress, int, int, int, int, byte[])
         * @see #setReceiveTimeout(int)
         * @see com.digi.xbee.api.models.XBee16BitAddress
         * @see com.digi.xbee.api.models.XBee64BitAddress
         */
        protected void sendExplicitData(XBee64BitAddress address64Bit, XBee16BitAddress address16Bit, int sourceEndpoint, int destEndpoint, 
                        int clusterID, int profileID, byte[] data) throws TimeoutException, XBeeException {
                // Verify the parameters are not null, if they are null, throw an exception.
                if (address64Bit == null)
                        throw new NullPointerException("64-bit address cannot be null");
                if (address16Bit == null)
                        throw new NullPointerException("16-bit address cannot be null");
                if (data == null)
                        throw new NullPointerException("Data cannot be null.");
                if (sourceEndpoint < 0 || sourceEndpoint > 0xFF)
                        throw new IllegalArgumentException("Source endpoint must be between 0 and 0xFF.");
                if (destEndpoint < 0 || destEndpoint > 0xFF)
                        throw new IllegalArgumentException("Destination endpoint must be between 0 and 0xFF.");
                if (clusterID < 0 || clusterID > 0xFFFF)
                        throw new IllegalArgumentException("Cluster ID must be between 0 and 0xFFFF.");
                if (profileID < 0 || profileID > 0xFFFF)
                        throw new IllegalArgumentException("Profile ID must be between 0 and 0xFFFF.");
                
                // Check if device is remote.
                if (isRemote())
                        throw new OperationNotSupportedException("Cannot send explicit data to a remote device from a remote device.");
                
                logger.debug(toString() + "Sending explicit data to {}[{}] [{} - {} - {} - {}] >> {}.", address64Bit, address16Bit, 
                                HexUtils.integerToHexString(sourceEndpoint, 1), HexUtils.integerToHexString(destEndpoint, 1), 
                                HexUtils.integerToHexString(clusterID, 2), HexUtils.integerToHexString(profileID, 2), 
                                HexUtils.prettyHexString(data));
                
                XBeePacket xbeePacket = new ExplicitAddressingPacket(getNextFrameID(), address64Bit, address16Bit, sourceEndpoint, destEndpoint, clusterID, profileID, 0, XBeeTransmitOptions.NONE, data);
                sendAndCheckXBeePacket(xbeePacket, false);
        }
        
        /**
         * Sends the provided data to the given XBee device in application layer 
         * mode choosing the optimal send method depending on the protocol of the 
         * local XBee device. Application layer mode means that you need to specify 
         * the application layer fields to be sent with the data.
         * 
         * <p>This method blocks till a success or error response arrives or the 
         * configured receive timeout expires.</p>
         * 
         * <p>The receive timeout is configured using the {@code setReceiveTimeout}
         * method and can be consulted with {@code getReceiveTimeout} method.</p>
         * 
         * @param remoteXBeeDevice The XBee device of the network that will receive 
         *                         the explicit data.
         * @param sourceEndpoint Source endpoint for the transmission.
         * @param destEndpoint Destination endpoint for the transmission.
         * @param clusterID Cluster ID used in the transmission.
         * @param profileID Profile ID used in the transmission.
         * @param data Byte array containing the data to be sent.
         * 
         * @throws IllegalArgumentException if {@code sourceEndpoint < 0} or 
         *                                  if {@code sourceEndpoint > 0xFF} or 
         *                                  if {@code destEndpoint < 0} or 
         *                                  if {@code destEndpoint > 0xFF} or 
         *                                  if {@code clusterID < 0} or 
         *                                  if {@code clusterID > 0xFFFF} or 
         *                                  if {@code profileID < 0} or 
         *                                  if {@code profileID > 0xFFFF}.
         * @throws InterfaceNotOpenException if this device connection is not open.
         * @throws NullPointerException if {@code remoteXBeeDevice == null} or
         *                              if {@code data == null}.
         * @throws TimeoutException if there is a timeout sending the data.
         * @throws XBeeException if there is any other XBee related exception.
         * 
         * @see #getReceiveTimeout()
         * @see #sendExplicitData(XBee64BitAddress, int, int, int, int, byte[])
         * @see #sendExplicitData(XBee64BitAddress, XBee16BitAddress, int, int, int, int, byte[])
         * @see #setReceiveTimeout(int)
         * @see com.digi.xbee.api.RemoteXBeeDevice
         */
        protected void sendExplicitData(RemoteXBeeDevice remoteXBeeDevice, int sourceEndpoint, int destEndpoint, int clusterID, 
                        int profileID, byte[] data) throws TimeoutException, XBeeException {
                if (remoteXBeeDevice == null)
                        throw new NullPointerException("Remote XBee device cannot be null.");
                
                switch (getXBeeProtocol()) {
                case ZIGBEE:
                case DIGI_POINT:
                        if (remoteXBeeDevice.get64BitAddress() != null && remoteXBeeDevice.get16BitAddress() != null)
                                sendExplicitData(remoteXBeeDevice.get64BitAddress(), remoteXBeeDevice.get16BitAddress(), sourceEndpoint, destEndpoint, clusterID, profileID, data);
                        else
                                sendExplicitData(remoteXBeeDevice.get64BitAddress(), sourceEndpoint, destEndpoint, clusterID, profileID, data);
                        break;
                case RAW_802_15_4:
                        throw new OperationNotSupportedException("802.15.4. protocol does not support explicit data transmissions.");
                case DIGI_MESH:
                default:
                        sendExplicitData(remoteXBeeDevice.get64BitAddress(), sourceEndpoint, destEndpoint, clusterID, profileID, data);
                }
        }
        
        /**
         * Sends the provided data to all the XBee nodes of the network (broadcast) 
         * in application layer mode. Application layer mode means that you need to 
         * specify the application layer fields to be sent with the data.
         * 
         * <p>This method blocks till a success or error transmit status arrives or 
         * the configured receive timeout expires.</p>
         * 
         * <p>The receive timeout is configured using the {@code setReceiveTimeout}
         * method and can be consulted with {@code getReceiveTimeout} method.</p>
         * 
         * @param sourceEndpoint Source endpoint for the transmission.
         * @param destEndpoint Destination endpoint for the transmission.
         * @param clusterID Cluster ID used in the transmission.
         * @param profileID Profile ID used in the transmission.
         * @param data Byte array containing the data to be sent.
         * 
         * @throws IllegalArgumentException if {@code sourceEndpoint < 0} or 
         *                                  if {@code sourceEndpoint > 0xFF} or 
         *                                  if {@code destEndpoint < 0} or 
         *                                  if {@code destEndpoint > 0xFF} or 
         *                                  if {@code clusterID < 0} or 
         *                                  if {@code clusterID > 0xFFFF} or 
         *                                  if {@code profileID < 0} or 
         *                                  if {@code profileID > 0xFFFF}.
         * @throws InterfaceNotOpenException if this device connection is not open.
         * @throws NullPointerException if {@code remoteXBeeDevice == null} or
         *                              if {@code data == null}.
         * @throws TimeoutException if there is a timeout sending the data.
         * @throws XBeeException if there is any other XBee related exception.
         * 
         * @see #getReceiveTimeout()
         * @see #setReceiveTimeout(int)
         */
        protected void sendBroadcastExplicitData(int sourceEndpoint, int destEndpoint, int clusterID, int profileID, 
                        byte[] data) throws TimeoutException, XBeeException {
                if (getXBeeProtocol() == XBeeProtocol.RAW_802_15_4)
                        throw new OperationNotSupportedException("802.15.4. protocol does not support explicit data transmissions.");
                sendExplicitData(XBee64BitAddress.BROADCAST_ADDRESS, sourceEndpoint, destEndpoint, clusterID, profileID, data);
        }
        
        /**
         * Sends the given XBee packet and registers the given packet listener 
         * (if not {@code null}) to be notified when the answers is received.
         * 
         * <p>This is a non-blocking operation. To wait for the answer use 
         * {@code sendPacket(XBeePacket)}.</p>
         * 
         * @param packet XBee packet to be sent.
         * @param packetReceiveListener Listener for the operation, {@code null} 
         *                              not to be notified when the answer arrives.
         * 
         * @throws InterfaceNotOpenException if this device connection is not open.
         * @throws NullPointerException if {@code packet == null}.
         * @throws XBeeException if there is any other XBee related exception.
         * 
         * @see #sendPacket(XBeePacket)
         * @see #sendPacketAsync(XBeePacket)
         * @see com.digi.xbee.api.listeners.IPacketReceiveListener
         * @see com.digi.xbee.api.packet.XBeePacket
         */
        public void sendPacket(XBeePacket packet, IPacketReceiveListener packetReceiveListener) throws XBeeException {
                try {
                        sendXBeePacket(packet, packetReceiveListener);
                } catch (IOException e) {
                        throw new XBeeException("Error writing in the communication interface.", e);
                }
        }
        
        /**
         * Sends the given XBee packet asynchronously.
         * 
         * <p>This is a non-blocking operation that do not wait for the answer and 
         * is never notified when it arrives.</p>
         * 
         * <p>To be notified when the answer is received, use 
         * {@link #sendXBeePacket(XBeePacket, IPacketReceiveListener)}.</p>
         * 
         * @param packet XBee packet to be sent asynchronously.
         * 
         * @throws InterfaceNotOpenException if this device connection is not open.
         * @throws NullPointerException if {@code packet == null}.
         * @throws XBeeException if there is any other XBee related exception.
         * 
         * @see #sendXBeePacket(XBeePacket)
         * @see #sendXBeePacket(XBeePacket, IPacketReceiveListener)
         * @see com.digi.xbee.api.packet.XBeePacket
         */
        public void sendPacketAsync(XBeePacket packet) throws XBeeException {
                try {
                        super.sendXBeePacket(packet, null);
                } catch (IOException e) {
                        throw new XBeeException("Error writing in the communication interface.", e);
                }
        }
        
        /**
         * Sends the given XBee packet synchronously and blocks until the response 
         * is received or the configured receive timeout expires.
         * 
         * <p>The receive timeout is configured using the {@code setReceiveTimeout}
         * method and can be consulted with {@code getReceiveTimeout} method.</p>
         * 
         * <p>Use {@code sendXBeePacketAsync(XBeePacket)} or 
         * {@code #sendXBeePacket(XBeePacket, IPacketReceiveListener)} for 
         * non-blocking operations.</p>
         * 
         * @param packet XBee packet to be sent.
         * 
         * @return An {@code XBeePacket} object containing the response of the sent
         *         packet or {@code null} if there is no response.
         * 
         * @throws InterfaceNotOpenException if this device connection is not open.
         * @throws NullPointerException if {@code packet == null}.
         * @throws TimeoutException if there is a timeout sending the XBee packet.
         * @throws XBeeException if there is any other XBee related exception.
         * 
         * @see #getReceiveTimeout()
         * @see #sendXBeePacket(XBeePacket, IPacketReceiveListener)
         * @see #sendXBeePacketAsync(XBeePacket)
         * @see #setReceiveTimeout(int)
         * @see com.digi.xbee.api.packet.XBeePacket
         */
        public XBeePacket sendPacket(XBeePacket packet) throws TimeoutException, XBeeException {
                try {
                        return super.sendXBeePacket(packet);
                } catch (IOException e) {
                        throw new XBeeException("Error writing in the communication interface.", e);
                }
        }
        
        /**
         * Waits until a Modem Status packet with a reset status, 
         * {@code ModemStatusEvent.STATUS_HARDWARE_RESET} (0x00), or a watchdog 
         * timer reset, {@code ModemStatusEvent.STATUS_WATCHDOG_TIMER_RESET} (0x01),
         * is received or the timeout expires.
         * 
         * @return {@code true} if the Modem Status packet is received, 
         *                      {@code false} otherwise.
         * 
         * @see com.digi.xbee.api.models.ModemStatusEvent#STATUS_HARDWARE_RESET
         * @see com.digi.xbee.api.models.ModemStatusEvent#STATUS_WATCHDOG_TIMER_RESET
         */
        private boolean waitForModemResetStatusPacket() {
                modemStatusReceived = false;
                addModemStatusListener(resetStatusListener);
                synchronized (resetLock) {
                        try {
                                resetLock.wait(TIMEOUT_RESET);
                        } catch (InterruptedException e) { }
                }
                removeModemStatusListener(resetStatusListener);
                return modemStatusReceived;
        }
        
        /**
         * Custom listener for modem reset packets.
         * 
         * <p>When a Modem Status packet is received with status 
         * {@code ModemStatusEvent.STATUS_HARDWARE_RESET} or 
         * {@code ModemStatusEvent.STATUS_WATCHDOG_TIMER_RESET}, it 
         * notifies the object that was waiting for the reception.</p>
         * 
         * @see com.digi.xbee.api.listeners.IModemStatusReceiveListener
         * @see com.digi.xbee.api.models.ModemStatusEvent#STATUS_HARDWARE_RESET
         * @see com.digi.xbee.api.models.ModemStatusEvent#STATUS_WATCHDOG_TIMER_RESET
         */
        private IModemStatusReceiveListener resetStatusListener = new IModemStatusReceiveListener() {
                
                /*
                 * (non-Javadoc)
                 * @see com.digi.xbee.api.listeners.IModemStatusReceiveListener#modemStatusEventReceived(com.digi.xbee.api.models.ModemStatusEvent)
                 */
                @Override
                public void modemStatusEventReceived(ModemStatusEvent modemStatusEvent) {
                        if (modemStatusEvent == ModemStatusEvent.STATUS_HARDWARE_RESET
                                        || modemStatusEvent == ModemStatusEvent.STATUS_WATCHDOG_TIMER_RESET){
                                modemStatusReceived = true;
                                // Continue execution by notifying the lock object.
                                synchronized (resetLock) {
                                        resetLock.notify();
                                }
                        }
                }
        };
        
        /*
         * (non-Javadoc)
         * @see com.digi.xbee.api.AbstractXBeeDevice#reset()
         */
        @Override
        public void reset() throws TimeoutException, XBeeException {
                // Check connection.
                if (!connectionInterface.isOpen())
                        throw new InterfaceNotOpenException();
                
                logger.info(toString() + "Resetting the local module...");
                
                ATCommandResponse response = null;
                try {
                        response = sendATCommand(new ATCommand("FR"));
                } catch (IOException e) {
                        throw new XBeeException("Error writing in the communication interface.", e);
                }
                
                // Check if AT Command response is valid.
                checkATCommandResponseIsValid(response);
                
                // Wait for a Modem Status packet.
                if (!waitForModemResetStatusPacket())
                        throw new TimeoutException("Timeout waiting for the Modem Status packet.");
                
                logger.info(toString() + "Module reset successfully.");
        }
        
        /**
         * Reads new data received by this XBee device during the configured 
         * receive timeout.
         * 
         * <p>This method blocks until new data is received or the configured 
         * receive timeout expires.</p>
         * 
         * <p>The receive timeout is configured using the {@code setReceiveTimeout}
         * method and can be consulted with {@code getReceiveTimeout} method.</p>
         * 
         * <p>For non-blocking operations, register a {@code IDataReceiveListener} 
         * using the method {@link #addDataListener(IDataReceiveListener)}.</p>
         * 
         * @return An {@code XBeeMessage} object containing the data and the source 
         *         address of the remote node that sent the data. {@code null} if 
         *         this did not receive new data during the configured receive 
         *         timeout.
         * 
         * @throws InterfaceNotOpenException if this device connection is not open.
         * 
         * @see #readData(int)
         * @see #getReceiveTimeout()
         * @see #setReceiveTimeout(int)
         * @see #readDataFrom(RemoteXBeeDevice)
         * @see #readDataFrom(RemoteXBeeDevice, int)
         * @see com.digi.xbee.api.models.XBeeMessage
         */
        public XBeeMessage readData() {
                return readDataPacket(null, TIMEOUT_READ_PACKET);
        }
        
        /**
         * Reads new data received by this XBee device during the provided timeout.
         * 
         * <p>This method blocks until new data is received or the provided timeout 
         * expires.</p>
         * 
         * <p>For non-blocking operations, register a {@code IDataReceiveListener} 
         * using the method {@link #addDataListener(IDataReceiveListener)}.</p>
         * 
         * @param timeout The time to wait for new data in milliseconds.
         * 
         * @return An {@code XBeeMessage} object containing the data and the source 
         *         address of the remote node that sent the data. {@code null} if 
         *         this device did not receive new data during {@code timeout} 
         *         milliseconds.
         * 
         * @throws IllegalArgumentException if {@code timeout < 0}.
         * @throws InterfaceNotOpenException if this device connection is not open.
         * 
         * @see #readData()
         * @see #readDataFrom(RemoteXBeeDevice)
         * @see #readDataFrom(RemoteXBeeDevice, int)
         * @see com.digi.xbee.api.models.XBeeMessage
         */
        public XBeeMessage readData(int timeout) {
                if (timeout < 0)
                        throw new IllegalArgumentException("Read timeout must be 0 or greater.");
                
                return readDataPacket(null, timeout);
        }
        
        /**
         * Reads new data received from the given remote XBee device during the 
         * configured receive timeout.
         * 
         * <p>This method blocks until new data from the provided remote XBee 
         * device is received or the configured receive timeout expires.</p>
         * 
         * <p>The receive timeout is configured using the {@code setReceiveTimeout}
         * method and can be consulted with {@code getReceiveTimeout} method.</p>
         * 
         * <p>For non-blocking operations, register a {@code IDataReceiveListener} 
         * using the method {@link #addDataListener(IDataReceiveListener)}.</p>
         * 
         * @param remoteXBeeDevice The remote device to read data from.
         * 
         * @return An {@code XBeeMessage} object containing the data and the source
         *         address of the remote node that sent the data. {@code null} if 
         *         this device did not receive new data from the provided remote 
         *         XBee device during the configured receive timeout.
         * 
         * @throws InterfaceNotOpenException if this device connection is not open.
         * @throws NullPointerException if {@code remoteXBeeDevice == null}.
         * 
         * @see #readDataFrom(RemoteXBeeDevice, int)
         * @see #getReceiveTimeout()
         * @see #setReceiveTimeout(int)
         * @see #readData()
         * @see #readData(int)
         * @see RemoteXBeeDevice
         * @see com.digi.xbee.api.models.XBeeMessage
         */
        public XBeeMessage readDataFrom(RemoteXBeeDevice remoteXBeeDevice) {
                if (remoteXBeeDevice == null)
                        throw new NullPointerException("Remote XBee device cannot be null.");
                
                return readDataPacket(remoteXBeeDevice, TIMEOUT_READ_PACKET);
        }
        
        /**
         * Reads new data received from the given remote XBee device during the 
         * provided timeout.
         * 
         * <p>This method blocks until new data from the provided remote XBee 
         * device is received or the given timeout expires.</p>
         * 
         * <p>For non-blocking operations, register a {@code IDataReceiveListener} 
         * using the method {@link #addDataListener(IDataReceiveListener)}.</p>
         * 
         * @param remoteXBeeDevice The remote device to read data from.
         * @param timeout The time to wait for new data in milliseconds.
         * 
         * @return An {@code XBeeMessage} object containing the data and the source
         *         address of the remote node that sent the data. {@code null} if 
         *         this device did not receive new data from the provided remote 
         *         XBee device during {@code timeout} milliseconds.
         * 
         * @throws IllegalArgumentException if {@code timeout < 0}.
         * @throws InterfaceNotOpenException if this device connection is not open.
         * @throws NullPointerException if {@code remoteXBeeDevice == null}.
         * 
         * @see #readDataFrom(RemoteXBeeDevice)
         * @see #getReceiveTimeout()
         * @see #setReceiveTimeout(int)
         * @see #readData()
         * @see #readData(int)
         * @see RemoteXBeeDevice
         * @see com.digi.xbee.api.models.XBeeMessage
         */
        public XBeeMessage readDataFrom(RemoteXBeeDevice remoteXBeeDevice, int timeout) {
                if (remoteXBeeDevice == null)
                        throw new NullPointerException("Remote XBee device cannot be null.");
                if (timeout < 0)
                        throw new IllegalArgumentException("Read timeout must be 0 or greater.");
                
                return readDataPacket(remoteXBeeDevice, timeout);
        }
        
        /**
         * Reads a new data packet received by this XBee device during the provided 
         * timeout.
         * 
         * <p>This method blocks until new data is received or the given timeout 
         * expires.</p>
         * 
         * <p>If the provided remote XBee device is {@code null} the method returns 
         * the first data packet read from any remote device.
         * <br>
         * If the remote device is not {@code null} the method returns the first 
         * data package read from the provided device.
         * </p>
         * 
         * @param remoteXBeeDevice The remote device to get a data packet from. 
         *                         {@code null} to read a data packet sent by any 
         *                         remote XBee device.
         * @param timeout The time to wait for a data packet in milliseconds.
         * 
         * @return An {@code XBeeMessage} received by this device, containing the 
         *         data and the source address of the remote node that sent the 
         *         data. {@code null} if this device did not receive new data 
         *         during {@code timeout} milliseconds, or if any error occurs while
         *         trying to get the source of the message.
         * 
         * @throws InterfaceNotOpenException if this device connection is not open.
         * 
         * @see RemoteXBeeDevice
         * @see com.digi.xbee.api.models.XBeeMessage
         */
        private XBeeMessage readDataPacket(RemoteXBeeDevice remoteXBeeDevice, int timeout) {
                // Check connection.
                if (!connectionInterface.isOpen())
                        throw new InterfaceNotOpenException();
                
                XBeePacketsQueue xbeePacketsQueue = dataReader.getXBeePacketsQueue();
                XBeePacket xbeePacket = null;
                
                if (remoteXBeeDevice != null)
                        xbeePacket = xbeePacketsQueue.getFirstDataPacketFrom(remoteXBeeDevice, timeout);
                else
                        xbeePacket = xbeePacketsQueue.getFirstDataPacket(timeout);
                
                if (xbeePacket == null)
                        return null;
                
                // Obtain the remote device from the packet.
                RemoteXBeeDevice remoteDevice = null;
                try {
                        remoteDevice = dataReader.getRemoteXBeeDeviceFromPacket((XBeeAPIPacket)xbeePacket);
                        // If the provided device is not null, add it to the network, so the 
                        // device provided is the one that will remain in the network.
                        if (remoteXBeeDevice != null)
                                remoteDevice = getNetwork().addRemoteDevice(remoteXBeeDevice);
                        
                        // The packet always contains information of the source so the 
                        // remote device should never be null.
                        if (remoteDevice == null)
                                return null;
                        
                } catch (XBeeException e) {
                        logger.error(e.getMessage(), e);
                        return null;
                }
                
                // Obtain the data from the packet.
                byte[] data = null;
                
                switch (((XBeeAPIPacket)xbeePacket).getFrameType()) {
                        case RECEIVE_PACKET:
                                ReceivePacket receivePacket = (ReceivePacket)xbeePacket;
                                data = receivePacket.getRFData();
                                break;
                        case RX_16:
                                RX16Packet rx16Packet = (RX16Packet)xbeePacket;
                                data = rx16Packet.getRFData();
                                break;
                        case RX_64:
                                RX64Packet rx64Packet = (RX64Packet)xbeePacket;
                                data = rx64Packet.getRFData();
                                break;
                        default:
                                return null;
                        }
                
                // Create and return the XBee message.
                return new XBeeMessage(remoteDevice, data, ((XBeeAPIPacket)xbeePacket).isBroadcast());
        }
        
        /**
         * Reads new explicit data received by this XBee device during the 
         * configured receive timeout.
         * 
         * <p>This method blocks until new explicit data is received or the 
         * configured receive timeout expires.</p>
         * 
         * <p>The receive timeout is configured using the {@code setReceiveTimeout}
         * method and can be consulted with {@code getReceiveTimeout} method.</p>
         * 
         * <p>For non-blocking operations, register a 
         * {@code IExplicitDataReceiveListener} using the method 
         * {@link #addExplicitDataListener(IExplicitDataReceiveListener)}.</p>
         * 
         * @return An {@code ExplicitXBeeMessage} object containing the explicit 
         *         data, the source address of the remote node that sent the data 
         *         and other values related to the transmission. {@code null} if 
         *         this did not receive new explicit data during the configured 
         *         receive timeout.
         * 
         * @throws InterfaceNotOpenException if this device connection is not open.
         * 
         * @see #getReceiveTimeout()
         * @see #readExplicitData(int)
         * @see #readExplicitDataFrom(RemoteXBeeDevice)
         * @see #readExplicitDataFrom(RemoteXBeeDevice, int)
         * @see #setReceiveTimeout(int)
         * @see com.digi.xbee.api.models.ExplicitXBeeMessage
         */
        protected ExplicitXBeeMessage readExplicitData() {
                return readExplicitDataPacket(null, TIMEOUT_READ_PACKET);
        }
        
        /**
         * Reads new explicit data received by this XBee device during the provided 
         * timeout.
         * 
         * <p>This method blocks until new explicit data is received or the 
         * provided timeout expires.</p>
         * 
         * <p>For non-blocking operations, register a 
         * {@code IExplicitDataReceiveListener} using the method 
         * {@link #addExplicitDataListener(IExplicitDataReceiveListener)}.</p>
         * 
         * @param timeout The time to wait for new explicit data in milliseconds.
         * 
         * @return An {@code ExplicitXBeeMessage} object containing the explicit 
         *         data, the source address of the remote node that sent the data 
         *         and other values related to the transmission. {@code null} if 
         *         this device did not receive new explicit data during 
         *         {@code timeout} milliseconds.
         * 
         * @throws IllegalArgumentException if {@code timeout < 0}.
         * @throws InterfaceNotOpenException if this device connection is not open.
         * 
         * @see #readExplicitData()
         * @see #readExplicitDataFrom(RemoteXBeeDevice)
         * @see #readExplicitDataFrom(RemoteXBeeDevice, int)
         * @see com.digi.xbee.api.models.ExplicitXBeeMessage
         */
        protected ExplicitXBeeMessage readExplicitData(int timeout) {
                if (timeout < 0)
                        throw new IllegalArgumentException("Read timeout must be 0 or greater.");
                
                return readExplicitDataPacket(null, timeout);
        }
        
        /**
         * Reads new explicit data received from the given remote XBee device 
         * during the configured receive timeout.
         * 
         * <p>This method blocks until new explicit data from the provided remote 
         * XBee device is received or the configured receive timeout expires.</p>
         * 
         * <p>The receive timeout is configured using the {@code setReceiveTimeout}
         * method and can be consulted with {@code getReceiveTimeout} method.</p>
         * 
         * <p>For non-blocking operations, register a 
         * {@code IExplicitDataReceiveListener} using the method 
         * {@link #addExplicitDataListener(IExplicitDataReceiveListener)}.</p>
         * 
         * @param remoteXBeeDevice The remote device to read explicit data from.
         * 
         * @return An {@code ExplicitXBeeMessage} object containing the explicit 
         *         data, the source address of the remote node that sent the data 
         *         and other values related to the transmission. {@code null} if 
         *         this device did not receive new explicit data from the provided 
         *         remote XBee device during the configured receive timeout.
         * 
         * @throws InterfaceNotOpenException if this device connection is not open.
         * @throws NullPointerException if {@code remoteXBeeDevice == null}.
         * 
         * @see #getReceiveTimeout()
         * @see #readExplicitData()
         * @see #readExplicitData(int)
         * @see #readExplicitDataFrom(RemoteXBeeDevice, int)
         * @see #setReceiveTimeout(int)
         * @see RemoteXBeeDevice
         * @see com.digi.xbee.api.models.ExplicitXBeeMessage
         */
        protected ExplicitXBeeMessage readExplicitDataFrom(RemoteXBeeDevice remoteXBeeDevice) {
                if (remoteXBeeDevice == null)
                        throw new NullPointerException("Remote XBee device cannot be null.");
                
                return readExplicitDataPacket(remoteXBeeDevice, TIMEOUT_READ_PACKET);
        }
        
        /**
         * Reads new explicit data received from the given remote XBee device 
         * during the provided timeout.
         * 
         * <p>This method blocks until new explicit data from the provided remote 
         * XBee device is received or the given timeout expires.</p>
         * 
         * <p>For non-blocking operations, register a 
         * {@code IExplicitDataReceiveListener} using the method 
         * {@link #addExplicitDataListener(IExplicitDataReceiveListener)}.</p>
         * 
         * @param remoteXBeeDevice The remote device to read explicit data from.
         * @param timeout The time to wait for new explicit data in milliseconds.
         * 
         * @return An {@code ExplicitXBeeMessage} object containing the explicit 
         *         data, the source address of the remote node that sent the data 
         *         and other values related to the transmission. {@code null} if 
         *         this device did not receive new data from the provided remote 
         *         XBee device during {@code timeout} milliseconds.
         * 
         * @throws IllegalArgumentException if {@code timeout < 0}.
         * @throws InterfaceNotOpenException if this device connection is not open.
         * @throws NullPointerException if {@code remoteXBeeDevice == null}.
         * 
         * @see #getReceiveTimeout()
         * @see #readExplicitData()
         * @see #readExplicitData(int)
         * @see #readExplicitDataFrom(RemoteXBeeDevice)
         * @see #setReceiveTimeout(int)
         * @see RemoteXBeeDevice
         * @see com.digi.xbee.api.models.ExplicitXBeeMessage
         */
        protected ExplicitXBeeMessage readExplicitDataFrom(RemoteXBeeDevice remoteXBeeDevice, int timeout) {
                if (remoteXBeeDevice == null)
                        throw new NullPointerException("Remote XBee device cannot be null.");
                if (timeout < 0)
                        throw new IllegalArgumentException("Read timeout must be 0 or greater.");
                
                return readExplicitDataPacket(remoteXBeeDevice, timeout);
        }
        
        /**
         * Reads a new explicit data packet received by this XBee device during 
         * the provided timeout.
         * 
         * <p>This method blocks until new explicit data is received or the given 
         * timeout expires.</p>
         * 
         * <p>If the provided remote XBee device is {@code null} the method returns 
         * the first explicit data packet read from any remote device.
         * <br>
         * If the remote device is not {@code null} the method returns the first 
         * explicit data package read from the provided device.
         * </p>
         * 
         * @param remoteXBeeDevice The remote device to get an explicit data 
         *                         packet from. {@code null} to read an explicit 
         *                         data packet sent by any remote XBee device.
         * @param timeout The time to wait for an explicit data packet in 
         *                milliseconds.
         * 
         * @return An {@code XBeeMessage} received by this device, containing the 
         *         explicit data and the source address of the remote node that 
         *         sent the data. {@code null} if this device did not receive new 
         *         explicit data during {@code timeout} milliseconds.
         * 
         * @throws InterfaceNotOpenException if this device connection is not open.
         * 
         * @see RemoteXBeeDevice
         * @see com.digi.xbee.api.models.ExplicitXBeeMessage
         */
        private ExplicitXBeeMessage readExplicitDataPacket(RemoteXBeeDevice remoteXBeeDevice, int timeout) {
                // Check connection.
                if (!connectionInterface.isOpen())
                        throw new InterfaceNotOpenException();
                
                XBeePacketsQueue xbeePacketsQueue = dataReader.getXBeePacketsQueue();
                XBeePacket xbeePacket = null;
                
                if (remoteXBeeDevice != null)
                        xbeePacket = xbeePacketsQueue.getFirstExplicitDataPacketFrom(remoteXBeeDevice, timeout);
                else
                        xbeePacket = xbeePacketsQueue.getFirstExplicitDataPacket(timeout);
                
                if (xbeePacket == null)
                        return null;
                
                // Verify the packet is an explicit data packet.
                APIFrameType packetType = ((XBeeAPIPacket)xbeePacket).getFrameType();
                if (packetType != APIFrameType.EXPLICIT_RX_INDICATOR)
                        return null;
                
                // Obtain the necessary data from the packet.
                ExplicitRxIndicatorPacket explicitDataPacket = (ExplicitRxIndicatorPacket)xbeePacket;
                RemoteXBeeDevice remoteDevice = getNetwork().getDevice(explicitDataPacket.get64BitSourceAddress());
                if (remoteDevice == null) {
                        if (remoteXBeeDevice != null)
                                remoteDevice = remoteXBeeDevice;
                        else
                                remoteDevice = new RemoteXBeeDevice(this, explicitDataPacket.get64BitSourceAddress());
                        getNetwork().addRemoteDevice(remoteDevice);
                }
                int sourceEndpoint = explicitDataPacket.getSourceEndpoint();
                int destEndpoint = explicitDataPacket.getDestinationEndpoint();
                int clusterID = explicitDataPacket.getClusterID();
                int profileID = explicitDataPacket.getProfileID();
                byte[] data = explicitDataPacket.getRFData();
                
                // Create and return the XBee message.
                return new ExplicitXBeeMessage(remoteDevice, sourceEndpoint, destEndpoint, clusterID, profileID, data, ((XBeeAPIPacket)xbeePacket).isBroadcast());
        }
        
        /**
         * Configures the API output mode of the XBee device.
         * 
         * <p>The API output mode determines the format that the received data is 
         * output through the serial interface of the XBee device.</p>
         * 
         * @param apiOutputMode The API output mode to be set to the XBee device.
         * 
         * @throws InterfaceNotOpenException if this device connection is not open.
         * @throws NullPointerException if {@code apiOutputMode == null}.
         * @throws TimeoutException if there is a timeout configuring the API 
         *                          output mode.
         * @throws XBeeException if there is any other XBee related exception.
         * 
         * @see #getAPIOutputMode()
         * @see APIOutputMode
         */
        protected void setAPIOutputMode(APIOutputMode apiOutputMode) throws TimeoutException, XBeeException {
                if (apiOutputMode == null)
                        throw new NullPointerException("API output mode cannot be null.");
                
                setParameter("AO", new byte[]{(byte)apiOutputMode.getValue()});
        }
        
        /**
         * Returns the API output mode of the XBee device.
         * 
         * <p>The API output mode determines the format that the received data is 
         * output through the serial interface of the XBee device.</p>
         * 
         * @return The API output mode that the XBee device is configured with.
         * 
         * @throws InterfaceNotOpenException if this device connection is not open.
         * @throws TimeoutException if there is a timeout getting the API output 
         *                          mode from the device.
         * @throws XBeeException if there is any other XBee related exception.
         * 
         * @see #setAPIOutputMode(APIOutputMode)
         * @see APIOutputMode
         */
        protected APIOutputMode getAPIOutputMode() throws TimeoutException, XBeeException {
                byte[] apiOutputModeValue = getParameter("AO");
                
                return APIOutputMode.get(apiOutputModeValue[0]);
        }
        
        /*
         * (non-Javadoc)
         * @see com.digi.xbee.api.AbstractXBeeDevice#toString()
         */
        @Override
        public String toString() {
                String id = getNodeID() == null ? "" : getNodeID();
                String addr64 = get64BitAddress() == null || get64BitAddress() == XBee64BitAddress.UNKNOWN_ADDRESS ? 
                                "" : get64BitAddress().toString();
                
                if (id.length() == 0 && addr64.length() == 0)
                        return super.toString();
                
                StringBuilder message = new StringBuilder(super.toString());
                message.append(addr64);
                if (id.length() > 0) {
                        message.append(" (");
                        message.append(id);
                        message.append(")");
                }
                message.append(" - ");
                
                return message.toString();
        }
}