RF.h

Go to the documentation of this file.

/*
 * Copyright (c) 2015-2016, Texas Instruments Incorporated
 * 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 Texas Instruments Incorporated nor the names of
 *    its 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.
 */
#ifndef ti_drivers_rf__include
#define ti_drivers_rf__include

#ifdef __cplusplus
extern "C" {
#endif

#include <stdint.h>
#include <stdbool.h>
#include <ti/sysbios/BIOS.h>
#include <ti/sysbios/knl/Clock.h>
#include <ti/sysbios/knl/Semaphore.h>

#ifdef DEVICE_FAMILY
    #undef DEVICE_FAMILY_PATH
    #define DEVICE_FAMILY_PATH(x) <ti/devices/DEVICE_FAMILY/x>
#else
    #error "You must define DEVICE_FAMILY at the project level as one of cc26x0, cc26x0r2, cc13x0, etc."
#endif

#include DEVICE_FAMILY_PATH(driverlib/rf_common_cmd.h)
#include DEVICE_FAMILY_PATH(driverlib/rf_prop_cmd.h)

#define   RF_EventCmdDone             (1<<0)   
#define   RF_EventLastCmdDone         (1<<1)   
#define   RF_EventTxDone              (1<<4)   
#define   RF_EventTXAck               (1<<5)   
#define   RF_EventTxCtrl              (1<<6)   
#define   RF_EventTxCtrlAck           (1<<7)   
#define   RF_EventTxCtrlAckAck        (1<<8)   
#define   RF_EventTxRetrans           (1<<9)   
#define   RF_EventTxEntryDone         (1<<10)  
#define   RF_EventTxBufferChange      (1<<11)  
#define   RF_EventRxOk                (1<<16)  
#define   RF_EventRxNOk               (1<<17)  
#define   RF_EventRxIgnored           (1<<18)  
#define   RF_EventRxEmpty             (1<<19)  
#define   RF_EventRxCtrl              (1<<20)  
#define   RF_EventRxCtrlAck           (1<<21)  
#define   RF_EventRxBufFull           (1<<22)  
#define   RF_EventRxEntryDone         (1<<23)  
#define   RF_EventDataWritten         (1<<24)  
#define   RF_EventNDataWritten        (1<<25)  
#define   RF_EventRxAborted           (1<<26)  
#define   RF_EventRxCollisionDetected (1<<27)  
#define   RF_EventModulesUnlocked     (1<<29)  
#define   RF_EventInternalError       (uint32_t)(1<<31)   
#define   RF_EventMdmSoft             0x0000002000000000  

#define   RF_EventCmdCancelled        0x1000000000000000  
#define   RF_EventCmdAborted          0x2000000000000000  
#define   RF_EventCmdStopped          0x4000000000000000  
#define   RF_EventCmdError            0x8000000000000000  
#define   RF_EventRatCh               0x0800000000000000  
#define   RF_EventPowerUp             0x0400000000000000  

#define   RF_EventError               0x0200000000000000  
#define   RF_EventCmdPreempted        0x0100000000000000  
#define   RF_EventRadioFree           0x0080000000000000  

#define RF_CTRL_SET_INACTIVITY_TIMEOUT            0

#define RF_CTRL_UPDATE_SETUP_CMD                  1

#define RF_CTRL_SET_POWERUP_DURATION_MARGIN       2

#define RF_CTRL_SET_RAT_RTC_ERR_TOL_VAL           3

// Other defines
#define   RF_GET_RSSI_ERROR_VAL       (-128)   
#define   RF_CMDHANDLE_FLUSH_ALL      (-1)     
#define   RF_ALLOC_ERROR              (-2)     
#define   RF_ERROR_INVALID_RFMODE     (-256)   
#define   RF_ERROR_CMDFS_SYNTH_PROG   (-257)   

#define RF_NUM_SCHEDULE_MAP_ENTRIES        5   
#define RF_NUM_SCHEDULE_ACCESS_ENTRIES     2   
#define RF_NUM_SCHEDULE_COMMAND_ENTRIES    (RF_NUM_SCHEDULE_MAP_ENTRIES - RF_NUM_SCHEDULE_ACCESS_ENTRIES) 

#define RF_SCH_CMD_EXECUTION_TIME_UNKNOWN  0   


typedef rfc_radioOp_t RF_Op;


typedef struct {
    uint8_t rfMode;             
    void (*cpePatchFxn)(void);  
    void (*mcePatchFxn)(void);  
    void (*rfePatchFxn)(void);  
} RF_Mode;


typedef enum {
    RF_PriorityHighest = 2, 
    RF_PriorityHigh    = 1, 
    RF_PriorityNormal  = 0, 
} RF_Priority;

typedef enum {
    RF_StatBusyError,          
    RF_StatRadioInactiveError, 
    RF_StatCmdDoneError,       
    RF_StatInvalidParamsError, 
    RF_StatError   = 0x80,     
    RF_StatCmdDoneSuccess,     
    RF_StatCmdSch,             
    RF_StatSuccess             
} RF_Stat;

typedef uint64_t RF_EventMask;

typedef union {
    rfc_command_t                   commandId; 
    rfc_CMD_RADIO_SETUP_t           common;    
    rfc_CMD_PROP_RADIO_SETUP_t      prop;      
    rfc_CMD_PROP_RADIO_DIV_SETUP_t  prop_div;  
} RF_RadioSetup;


typedef int16_t RF_CmdHandle;

typedef struct RFCC26XX_HWAttrs {
    uint8_t         hwiCpe0Priority;  
    uint8_t         hwiHwPriority;    
    uint8_t         swiCpe0Priority;  
    uint8_t         swiHwPriority;    
} RFCC26XX_HWAttrs;

typedef struct {
    struct {
        uint32_t            nInactivityTimeout;     
        RF_Mode*            pRfMode;                
        RF_RadioSetup*      pOpSetup;               
        uint32_t            nPowerUpDuration;       
        bool                bPowerUpXOSC;           
        bool                bUpdateSetup;           
        uint16_t            nPowerUpDurationMargin; 
        void*               pPowerCb;               
        void*               pErrCb;                 
    } clientConfig;
    struct {
        struct {
            rfc_CMD_FS_t        cmdFs;              
        } mode_state;                               
        Semaphore_Struct        semSync;            
        RF_EventMask volatile   eventSync;          
        void*                   pCbSync;            
        RF_EventMask            unpendCause;        
        Clock_Struct            clkInactivity;      
        Clock_Struct            clkReqAccess;       
        RF_CmdHandle volatile   chLastPosted;       
        bool                    bYielded;           
    } state;
} RF_Object;


typedef RF_Object* RF_Handle;

typedef enum {
    RF_GET_CURR_CMD,                              
    RF_GET_AVAIL_RAT_CH,                          
    RF_GET_RADIO_STATE,                           
    RF_GET_SCHEDULE_MAP,                          
} RF_InfoType;

typedef struct {
    RF_Object*   pClient;                          
    uint32_t     startTime;                        
    uint32_t     endTime;                          
    RF_Priority  priority;                         
} RF_ScheduleMapElement;

typedef struct {
    RF_ScheduleMapElement  accessMap[RF_NUM_SCHEDULE_ACCESS_ENTRIES];    
    RF_ScheduleMapElement  commandMap[RF_NUM_SCHEDULE_COMMAND_ENTRIES];  
} RF_ScheduleMap;

typedef union {
    RF_CmdHandle ch;                              
    uint16_t     availRatCh;                      
    bool         bRadioState;                     
    void         *pScheduleMap;                   
} RF_InfoVal;

typedef void (*RF_Callback)(RF_Handle h, RF_CmdHandle ch, RF_EventMask e);


typedef struct {
    uint32_t    nInactivityTimeout;      
    uint32_t    nPowerUpDuration;        
    RF_Callback pPowerCb;                
    RF_Callback pErrCb;                  
    bool        bPowerUpXOSC;            
    uint16_t    nPowerUpDurationMargin;  
} RF_Params;

typedef struct {
    uint32_t    endTime;           
    RF_Priority priority;          
}RF_ScheduleCmdParams;

typedef struct {
    uint32_t    duration;          
    uint32_t    startTime;         
    RF_Priority priority;          
}RF_AccessParams;

extern RF_Handle RF_open(RF_Object *pObj, RF_Mode *pRfMode, RF_RadioSetup *pOpSetup, RF_Params *params);


extern void RF_close(RF_Handle h);


extern uint32_t RF_getCurrentTime(void);


extern RF_CmdHandle RF_postCmd(RF_Handle h, RF_Op* pOp, RF_Priority ePri, RF_Callback pCb, RF_EventMask bmEvent);

extern RF_CmdHandle RF_scheduleCmd(RF_Handle h, RF_Op* pOp, RF_ScheduleCmdParams *pSchParams, RF_Callback pCb, RF_EventMask bmEvent);

extern RF_EventMask RF_pendCmd(RF_Handle h, RF_CmdHandle ch, RF_EventMask bmEvent);


extern RF_EventMask RF_runCmd(RF_Handle h, RF_Op* pOp, RF_Priority ePri, RF_Callback pCb, RF_EventMask bmEvent);

extern RF_EventMask RF_runScheduleCmd(RF_Handle h, RF_Op* pOp, RF_ScheduleCmdParams *pSchParams, RF_Callback pCb, RF_EventMask bmEvent);

extern RF_Stat RF_cancelCmd(RF_Handle h, RF_CmdHandle ch, uint8_t mode);


extern RF_Stat RF_flushCmd(RF_Handle h, RF_CmdHandle ch, uint8_t mode);

extern RF_Stat RF_runImmediateCmd(RF_Handle h, uint32_t* pCmdStruct);

extern RF_Stat RF_runDirectCmd(RF_Handle h, uint32_t cmd);

extern void RF_yield(RF_Handle h);

extern void RF_Params_init(RF_Params *params);

extern RF_Stat RF_getInfo(RF_Handle h, RF_InfoType type, RF_InfoVal *pValue);

extern int8_t RF_getRssi(RF_Handle h);

extern RF_Op* RF_getCmdOp(RF_Handle h, RF_CmdHandle cmdHnd);

extern int8_t RF_ratCompare(RF_Handle h, rfc_CMD_SET_RAT_CMP_t* pCmdStruct, \
                            uint32_t compareTime, RF_Callback pRatCb);

extern int8_t RF_ratCapture(RF_Handle h, uint16_t config, RF_Callback  pRatCb);

extern RF_Stat RF_ratHwOutput(RF_Handle h, uint16_t config);

extern RF_Stat RF_ratDisableChannel(RF_Handle h, int8_t ratChannelNum);

extern RF_Stat RF_control(RF_Handle h, int8_t ctrl, void *args);

extern RF_Stat RF_requestAccess(RF_Handle h, RF_AccessParams *pParams);

// Do not interfere with the app if they include the family Hwi module
#undef ti_sysbios_family_arm_m3_Hwi__nolocalnames

#ifdef __cplusplus
}
#endif

#endif /* ti_drivers_rf__include */