DRV802_15_4.h

Go to the documentation of this file.

/*******************************************************************************
 *
 * Copyright (c) 2008-2010
 * Michael Schulze <mschulze@ivs.cs.uni-magdeburg.de>
 * Thomas Kiebel <kiebel@ivs.cs.uni-magdeburg.de>
 * All rights reserved.
 *
 *    Redistribution and use in source and binary forms, with or without
 *    modification, are permitted provided that the following conditions
 *    are met:
 *
 *    * Redistributions of source code must retain the above copyright
 *      notice, this list of conditions and the following disclaimer.
 *
 *    * Redistributions in binary form must reproduce the above copyright
 *      notice, this list of conditions and the following disclaimer in
 *      the documentation and/or other materials provided with the
 *      distribution.
 *
 *    * Neither the name of the copyright holders nor the names of
 *      contributors may be used to endorse or promote products derived
 *      from this software without specific prior written permission.
 *
 *
 *    THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS
 *    IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
 *    TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
 *    PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
 *    OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
 *    SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
 *    LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
 *    DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
 *    THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
 *    (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
 *    OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 *
 *
 * $Id$
 *
 ******************************************************************************/

#ifndef __DRV802_15_4_h__
#define __DRV802_15_4_h__

#include "case/Delegate.h"
#include "debug.h"

namespace device {
    namespace nic {
        namespace ieee802_15_4 {

            template <class RFLayer>
            class DRV802_15_4 {
                public:
                    typedef DRV802_15_4 type;
                    typedef wsn::dll::mac::MACReceiveData  mob_t;
                private:
                    RFLayer _rflayer;

                    void rfReceiveCallback(const mob_t& rxData) {
                        // trigger interrupt after receiving data
                        //TODO if ( !(rx_Interrupt.isEmpty()) ) {
                        if ( rx_Interrupt ) {
                            rx_Interrupt(rxData);
                        }
                    }

                    void rfErrorCallback(const wsn::dll::mac::ErrorData<uint8_t>& errData) {
                        //TODO need there be an action if the error callback is triggered?
                    }

                public:
                    DRV802_15_4() {}
                    ~DRV802_15_4() {}

                    void init() {
                        // Register our receive callback at the MAC layer object
                        _rflayer.rx_Interrupt.template bind<type, &type::rfReceiveCallback>(this);
                        // Register our error callback at the MAC layer object
                        _rflayer.error_Interrupt.template bind<type, &type::rfErrorCallback>(this);

                        _rflayer.init(SHORT_ADDR, PAN_ID, COMM_CHANNEL);
                    }

                    void send(const uint8_t* buffer, uint8_t size) {
                        TRACE_FUNCTION;
                        // asserts if data size corresponds to payload size of communication layer
                        if ( size > _rflayer.getMaxPayload() ) {
                            ::logging::log::emit< ::logging::Error>()
                                    << PROGMEMSTRING("Payload size violation sending DATA RF")
                                    << ::logging::log::endl;
                            return;
                        }

                        // transmit buffer
                        if (!(_rflayer.send(buffer, size, DESTINATION))) {
                            ::logging::log::emit< ::logging::Error>()
                                    << PROGMEMSTRING("MAC transmission failed!")
                                    << ::logging::log::endl;
                            //TODO need there be an error response if transmission failed?
                        }
                    }

                    famouso::util::Delegate<const mob_t&> rx_Interrupt;

                    famouso::util::Delegate<> tx_Interrupt;
            };
        } /* namespace ieee802_15_4 */
    } /* namespace nic */
} /* namespace device */

#endif