SxRadioEvents.h

00001 /*
00002  / _____)             _              | |
00003 ( (____  _____ ____ _| |_ _____  ____| |__
00004  \____ \| ___ |    (_   _) ___ |/ ___)  _ \
00005  _____) ) ____| | | || |_| ____( (___| | | |
00006 (______/|_____)_|_|_| \__)_____)\____)_| |_|
00007     (C)2013 Semtech
00008 
00009 Description: Generic radio driver definition
00010 
00011 License: Revised BSD License, see LICENSE.TXT file include in the project
00012 
00013 Maintainer: Miguel Luis and Gregory Cristian
00014 */
00015 #ifndef __SXRADIOEVENTS_H__
00016 #define __SXRADIOEVENTS_H__
00017 
00018 /*!
00019  * \brief Radio driver callback functions
00020  */
00021 class SxRadioEvents
00022 {
00023 public:
00024     /*!
00025      * \brief  Tx Done callback prototype.
00026      */
00027     virtual void TxDone( void ) {}
00028     /*!
00029      * \brief  Tx Timeout callback prototype.
00030      */
00031     virtual void TxTimeout( void ) {}
00032     /*!
00033      * \brief Rx Done callback prototype.
00034      *
00035      * \param [IN] payload Received buffer pointer
00036      * \param [IN] size    Received buffer size
00037      * \param [IN] rssi    RSSI value computed while receiving the frame [dBm]
00038      * \param [IN] snr     Raw SNR value given by the radio hardware
00039      *                     FSK : N/A ( set to 0 )
00040      *                     LoRa: SNR value is two's complement in 1/4 dB
00041      */
00042     virtual void RxDone( uint8_t *payload, uint16_t size, int16_t rssi, int8_t snr ) {}
00043     /*!
00044      * \brief  Rx Timeout callback prototype.
00045      */
00046     virtual void RxTimeout( void ) {}
00047     /*!
00048      * \brief Rx Error callback prototype.
00049      */
00050     virtual void RxError( void ) {}
00051     /*!
00052      * \brief  FHSS Change Channel callback prototype.
00053      *
00054      * \param [IN] currentChannel   Index number of the current channel
00055      */
00056     virtual void FhssChangeChannel( uint8_t currentChannel ) {}
00057     /*!
00058      * \brief CAD Done callback prototype.
00059      *
00060      * \param [IN] channelActivityDetected  Channel Activity detected during the CAD
00061      */
00062     virtual void CadDone( bool channelActivityDetected ) {}
00063     /*!
00064      * \brief Mac Event callback prototype.
00065      */
00066     virtual void MacEvent( void ) {}
00067 
00068     virtual void LinkIdle(void) {}
00069 };
00070 
00071 #endif // __SXRADIOEVENTS_H__
00072 
00073