Library to easily communicate with XBee modules.

Fork of XBeeLib by Digi International Inc.

IO/IOSampleDM.h

Committer:
hbujanda
Date:
2016-07-28
Revision:
6:06522f3a6642

File content as of revision 6:06522f3a6642:

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

#ifndef _IO_IOSAMPLEDM_H_
#define _IO_IOSAMPLEDM_H_

#define MAX_IO_SAMPLE_DM_LEN   (2 + 2 * 5)

namespace XBeeLib {

/** Class to handle the incoming IO Data Samples in ZigBee modules */
class IOSampleDM {
    public:
        /** Class constructor
         *  @param raw_data The IO Sample data, as returned by an "IS" command response or in the IoSampleRxZBDM (0x92) frames
         *  @param size size (in bytes) of raw_data.
         */
        IOSampleDM(const uint8_t* const raw_data = NULL, size_t size = 0);

        /** Class destructor */
        ~IOSampleDM();

        /** get_dio - read the value of a DIO configured as digital input
         *
         *  @param line DIO line being read
         *  @param val pointer where the DIO value read will be stored
         *  @returns
         *     Success if the operation was successful,
         *     Failure otherwise
         */
        RadioStatus get_dio(XBeeDM::IoLine line, DioVal* const dio_value) const;

        /** get_adc - read the value of the espcified ADC line
         *
         *  @param line ADC line being read
         *  @param val pointer where the value read from the ADC will be stored
         *  @returns
         *     Success if the operation was successful,
         *     Failure otherwise
         */
        RadioStatus get_adc(XBeeDM::IoLine line, uint16_t* const val) const;

        /** is_valid - checks if the IOSampleDM object has at least one DIO or ADC sample.
         *  @returns true if valid, false otherwise
         */
        inline bool is_valid()
        {
            return _digital_mask != 0 || _analog_mask != 0;
        }

    protected:
        uint16_t _digital_mask;
        uint8_t _analog_mask;
        uint8_t _sampled_data[MAX_IO_SAMPLE_DM_LEN];
        uint8_t _sampled_data_size;

        inline uint16_t get_digital_channels(void) const;
};

}   /* namespace XBeeLib */

#endif /* _IO_IOSAMPLEDM_H_ */