Compare commits
4 Commits
master
...
superfemto
| Author | SHA1 | Date |
|---|---|---|
 Harald Welte
|
e638ea5ccb | |
|
Harald Welte
|
d6306ba828 | |
|
Harald Welte
|
78cd9080dd | |
|
Harald Welte
|
64629b1ed2 |
|
|
@ -167,26 +167,6 @@ void GsmL1Dbg_DumpBuffer( uint32_t u32Level,
|
|||
uint32_t u32Length,
|
||||
uint8_t *pu8Buffer );
|
||||
|
||||
/****************************************************************************
|
||||
* Function : GsmL1Dbg_DumpRxBurst
|
||||
************************************************************************//**
|
||||
*
|
||||
* Dump a RxBurst
|
||||
*
|
||||
* @param [in] u32Level
|
||||
* Verbosity level of the printed message.
|
||||
*
|
||||
* @param [in] prxBurst
|
||||
* Pointer to the dumped RX burst
|
||||
*
|
||||
* @return
|
||||
* None.
|
||||
*
|
||||
* @ingroup gsm_common_debug
|
||||
*
|
||||
***************************************************************************/
|
||||
void GsmL1Dbg_DumpRxBurst( uint32_t u32Level, GsmL1_RxBurst_t *prxBurst );
|
||||
|
||||
#ifdef __cplusplus
|
||||
}
|
||||
#endif // extern "C"
|
||||
|
|
|
|||
|
|
@ -1,101 +0,0 @@
|
|||
#ifndef GSML1LINK_H__
|
||||
#define GSML1LINK_H__
|
||||
|
||||
#ifdef __cplusplus
|
||||
extern "C" {
|
||||
#endif // __cplusplus
|
||||
|
||||
/****************************************************************************
|
||||
* Includes *
|
||||
****************************************************************************/
|
||||
|
||||
#include "gsml1serv.h"
|
||||
|
||||
#include "gsml1prim.h"
|
||||
#include "gsml1const.h"
|
||||
#include "gsml1types.h"
|
||||
|
||||
/****************************************************************************
|
||||
* Types *
|
||||
****************************************************************************/
|
||||
|
||||
/****************************************************************************
|
||||
* Public Functions *
|
||||
****************************************************************************/
|
||||
|
||||
/****************************************************************************
|
||||
* Function : GsmL1Link_Init
|
||||
************************************************************************//**
|
||||
*
|
||||
* Initialise the GSM layer 1 library.
|
||||
*
|
||||
* @return
|
||||
* GsmL1_Status_Success or the error code
|
||||
*
|
||||
* @ingroup gsml1_api_services
|
||||
*
|
||||
****************************************************************************/
|
||||
GsmL1_Status_t GsmL1Link_Init( void );
|
||||
|
||||
/****************************************************************************
|
||||
* Function : GsmL1Link_SetExternalServices
|
||||
************************************************************************//**
|
||||
*
|
||||
* Set every services provided to the layer 1 by external libraries
|
||||
*
|
||||
* @param [in] pL3ProvidedServices
|
||||
* Points to a structure containing all Layer 3 external services
|
||||
*
|
||||
* @param [in] pL2ProvidedServices
|
||||
* Points to a structure containing all Layer 3 external services
|
||||
*
|
||||
* @param [in] pPhyRfProvidedServices
|
||||
* Points to a structure containing all PhyRf external services
|
||||
*
|
||||
* @return
|
||||
* GsmL1_Status_Success or the error code
|
||||
*
|
||||
* @ingroup gsml1_api_services
|
||||
*
|
||||
****************************************************************************/
|
||||
GsmL1_Status_t GsmL1Link_SetExternalServices( Gsm_L3ProvidedServices_t *pL3ProvidedServices,
|
||||
Gsm_L2ProvidedServices_t *pL2ProvidedServices,
|
||||
Gsm_PhyRfProvidedServices_t *pPhyRfProvidedServices );
|
||||
|
||||
/****************************************************************************
|
||||
* Function : GsmL1Link_GetProvidedServices
|
||||
************************************************************************//**
|
||||
*
|
||||
* Return a strucuture containing all service functions pointer provided
|
||||
* by the physical link layer library to the external context.
|
||||
*
|
||||
* @param [out] pPhyLinkProvidedServices
|
||||
* Points to a structure of all GSM layer 1 library services function pointer.
|
||||
*
|
||||
* @return
|
||||
* GsmL1_Status_Success or the error code
|
||||
*
|
||||
* @ingroup gsml1_api_services
|
||||
*
|
||||
****************************************************************************/
|
||||
GsmL1_Status_t GsmL1Link_GetProvidedServices( Gsm_PhyLinkProvidedServices_t *pPhyLinkProvidedServices );
|
||||
|
||||
/****************************************************************************
|
||||
* Function : GsmL1Link_Close
|
||||
************************************************************************//**
|
||||
*
|
||||
* Close the GSM layer 1 instance and free every allocated ressources.
|
||||
*
|
||||
* @return
|
||||
* GsmL1_Status_Success or the error code
|
||||
*
|
||||
* @ingroup gsml1_api_services
|
||||
*
|
||||
****************************************************************************/
|
||||
GsmL1_Status_t GsmL1Link_Close( void );
|
||||
|
||||
#ifdef __cplusplus
|
||||
}
|
||||
#endif // extern "C"
|
||||
|
||||
#endif // GSML1_H__
|
||||
|
|
@ -179,13 +179,13 @@ typedef struct GsmL1_MphCloseCnf_t
|
|||
****************************************************************************/
|
||||
typedef struct GsmL1_MphConnectReq_t
|
||||
{
|
||||
HANDLE hLayer3; ///< Handle to a layer 3 entity
|
||||
HANDLE hLayer1; /**< Handle to the layer1 on which the
|
||||
physical channel is connected. */
|
||||
HANDLE hLayer3; ///< Handle to a layer 3 entity
|
||||
HANDLE hLayer1; /**< Handle to the layer1 on which the
|
||||
physical channel is connected. */
|
||||
|
||||
uint8_t u8Tn; ///< Time-slot [0..7]
|
||||
GsmL1_LogChComb_t logChComb; /**< Logical channel multiplexing
|
||||
over the physical channel */
|
||||
uint8_t u8Tn; ///< Time-slot [0..7]
|
||||
GsmL1_LogChComb_t logChComb; /**< Logical channel multiplexing
|
||||
over the physical channel */
|
||||
|
||||
} GsmL1_MphConnectReq_t;
|
||||
|
||||
|
|
|
|||
|
|
@ -1,87 +0,0 @@
|
|||
#ifndef GSML1RF_H__
|
||||
#define GSML1RF_H__
|
||||
|
||||
/****************************************************************************
|
||||
* Includes *
|
||||
****************************************************************************/
|
||||
#include <stdint.h>
|
||||
#include "gsml1serv.h"
|
||||
|
||||
/****************************************************************************
|
||||
* Defines *
|
||||
****************************************************************************/
|
||||
|
||||
#define GSML1RF_NOCHANGE 2 ///< Do not modify RX or TX device in the FPGA side
|
||||
#define GSML1RF_ENABLE 1 ///< Enable RX or TX device in the FPGA side
|
||||
#define GSML1RF_DISABLE 0 ///< Disable RX or TX device in the FPGA side
|
||||
|
||||
|
||||
/****************************************************************************
|
||||
* Public functions *
|
||||
****************************************************************************/
|
||||
|
||||
/****************************************************************************
|
||||
* Function : GsmL1Rf_Init
|
||||
************************************************************************//**
|
||||
*
|
||||
* Initialize the PhyRf library.
|
||||
*
|
||||
* @return
|
||||
* GsmL1_Status_Success or an error code otherwise.
|
||||
*
|
||||
* @ingroup gsml1_api_phyrf
|
||||
*
|
||||
****************************************************************************/
|
||||
GsmL1_Status_t GsmL1Rf_Init( void );
|
||||
|
||||
/****************************************************************************
|
||||
* Function : GsmL1Rf_Close
|
||||
************************************************************************//**
|
||||
*
|
||||
* Uninitialize the PhyRf library.
|
||||
*
|
||||
* @return
|
||||
* GsmL1_Status_Success or an error code otherwise.
|
||||
*
|
||||
* @ingroup gsml1_api_phyrf
|
||||
*
|
||||
****************************************************************************/
|
||||
void GsmL1Rf_Close( void );
|
||||
|
||||
/****************************************************************************
|
||||
* Function : GsmL1Rf_GetProvidedServices
|
||||
************************************************************************//**
|
||||
*
|
||||
* Used to retrieve a structure of every services provided by the PhyRf layer.
|
||||
*
|
||||
* @param [out] pPhyRfProvidedServices
|
||||
* Points to a structure of every services provided by the PhyRf layer
|
||||
*
|
||||
* @return
|
||||
* GsmL1_Status_Success or an error code otherwise.
|
||||
*
|
||||
* @ingroup gsml1_api_phyrf
|
||||
*
|
||||
****************************************************************************/
|
||||
GsmL1_Status_t GsmL1Rf_GetProvidedServices( Gsm_PhyRfProvidedServices_t *pPhyRfProvidedServices );
|
||||
|
||||
/****************************************************************************
|
||||
* Function : GsmL1Rf_IsInitialized
|
||||
************************************************************************//**
|
||||
*
|
||||
* Used to determinate if the PhyRf library is initialized
|
||||
*
|
||||
* @return
|
||||
* 1 if initialized, 0 otherwise
|
||||
*
|
||||
* @ingroup gsml1_api_phyrf
|
||||
*
|
||||
****************************************************************************/
|
||||
uint8_t GsmL1Rf_IsInitialized( void );
|
||||
|
||||
|
||||
#ifdef __cplusplus
|
||||
}
|
||||
#endif // extern "C"
|
||||
|
||||
#endif // GSML1PHYRF_H__
|
||||
|
|
@ -1,135 +0,0 @@
|
|||
#ifndef GSML1SERV_H__
|
||||
#define GSML1SERV_H__
|
||||
|
||||
#ifdef __cplusplus
|
||||
extern "C" {
|
||||
#endif // __cplusplus
|
||||
|
||||
/****************************************************************************
|
||||
* Includes *
|
||||
****************************************************************************/
|
||||
#include "gsml1const.h"
|
||||
#include "gsml1types.h"
|
||||
#include "gsml1prim.h"
|
||||
|
||||
/****************************************************************************
|
||||
* Struct : PhyRf_ExternalServices_t
|
||||
************************************************************************//**
|
||||
*
|
||||
* All external services provided from the PhyLink Layer to the PhyRf layer.
|
||||
*
|
||||
* @ingroup gsml1_api_phyrf
|
||||
*
|
||||
****************************************************************************/
|
||||
typedef struct PhyRf_ExternalServices_t
|
||||
{
|
||||
GsmL1_Status_t (*pfRecvBurst) ( HANDLE hPhyLink, GsmL1_RxBurst_t *pRxBurst );
|
||||
GsmL1_Status_t (*pfUpdateTn) ( HANDLE hPhyLink, uint32_t u32Fn, uint8_t u8Tn );
|
||||
|
||||
} PhyRf_ExternalServices_t;
|
||||
|
||||
/****************************************************************************
|
||||
* typedef : Gsm_L3ProvidedServices_t
|
||||
************************************************************************//**
|
||||
*
|
||||
* Structure which contains a function pointer to every service provided
|
||||
* by the Gsm Layer 3 library.
|
||||
*
|
||||
* @ingroup gsml1_api_services
|
||||
*
|
||||
***************************************************************************/
|
||||
typedef struct Gsm_L3ProvidedServices
|
||||
{
|
||||
GsmL1_Status_t (*pfMphCnf)( GsmL1_Prim_t *pPrim );
|
||||
GsmL1_Status_t (*pfMphInd)( GsmL1_Prim_t *pPrim );
|
||||
|
||||
} Gsm_L3ProvidedServices_t;
|
||||
|
||||
/****************************************************************************
|
||||
* typedef : Gsm_L2ProvidedServices_t
|
||||
************************************************************************//**
|
||||
*
|
||||
* Structure which contains a function pointer to every service provided
|
||||
* by the Gsm Layer 2 library.
|
||||
*
|
||||
* @ingroup gsml1_api_services
|
||||
*
|
||||
***************************************************************************/
|
||||
typedef struct Gsm_L2ProvidedServices_t
|
||||
{
|
||||
GsmL1_Status_t (*pfPhCnf)( GsmL1_Prim_t *pPrim );
|
||||
GsmL1_Status_t (*pfPhInd)( GsmL1_Prim_t *pPrim );
|
||||
|
||||
} Gsm_L2ProvidedServices_t;
|
||||
|
||||
/****************************************************************************
|
||||
* typedef : Gsm_PhyLinkProvidedServices_t
|
||||
************************************************************************//**
|
||||
*
|
||||
* Structure which contains a function pointer to every service provided
|
||||
* by the physical link layer library.
|
||||
*
|
||||
* @ingroup gsml1_api_services
|
||||
*
|
||||
***************************************************************************/
|
||||
typedef struct Gsm_PhyLinkProvidedServices_t
|
||||
{
|
||||
// Services provided to the layer 3
|
||||
GsmL1_Status_t (*pfMphReq)( GsmL1_Prim_t *pPrim );
|
||||
|
||||
// Services provided to the Layer 2
|
||||
GsmL1_Status_t (*pfPhReq)( GsmL1_Prim_t *pPrim );
|
||||
|
||||
// Services provided to the physical radio frequency layer
|
||||
GsmL1_Status_t (*pfRecvBurst) ( HANDLE hDevice, GsmL1_RxBurst_t *pRxBurst );
|
||||
GsmL1_Status_t (*pfUpdateTn) ( HANDLE hDevice, uint32_t u32Fn, uint8_t u8Tn );
|
||||
|
||||
} Gsm_PhyLinkProvidedServices_t;
|
||||
|
||||
/****************************************************************************
|
||||
* typedef : Gsm_PhyRfProvidedServices_t
|
||||
************************************************************************//**
|
||||
*
|
||||
* Structure which contains a function pointer to every service provided
|
||||
* by the PhyRf library.
|
||||
*
|
||||
* @ingroup gsml1_api_services
|
||||
*
|
||||
***************************************************************************/
|
||||
typedef struct Gsm_PhyRfProvidedServices_t
|
||||
{
|
||||
// Services provided from the physical radio frequency layer
|
||||
GsmL1_Status_t (*pfInitDevice) ( PhyRf_ExternalServices_t *pPhyRfExternalServices,
|
||||
GsmL1_DevType_t devType,
|
||||
GsmL1_FreqBand_t freqBand,
|
||||
uint16_t u16Arfcn,
|
||||
float fTxPowerLevel,
|
||||
uint8_t u8NbTsc,
|
||||
HANDLE hPhyLink,
|
||||
HANDLE *hPhyRf );
|
||||
|
||||
void (*pfCloseDevice ) ( HANDLE hPhyRfDevice );
|
||||
|
||||
GsmL1_Status_t (*pfSendBurst ) ( HANDLE hPhyRfDevice, GsmL1_TxBurst_t *pTxBurst );
|
||||
|
||||
GsmL1_Status_t (*pfConfigTs ) ( HANDLE hPhyRfDevice,
|
||||
uint8_t u8Tn,
|
||||
uint8_t u8EnableRx,
|
||||
uint8_t u8EnableTxAutoDummy );
|
||||
|
||||
GsmL1_Status_t (*pfSetTxPowerLevel) ( HANDLE hPhyRfDevice,
|
||||
float fTxPowerLevel );
|
||||
|
||||
GsmL1_Status_t (*pfSetNbTsc) ( HANDLE hPhyRfDevice,
|
||||
uint8_t u8NbTsc );
|
||||
|
||||
// Services provided by the physical RF layer to the FPGA layer
|
||||
void (*pfNewTnIsr) ( void );
|
||||
|
||||
} Gsm_PhyRfProvidedServices_t;
|
||||
|
||||
#ifdef __cplusplus
|
||||
}
|
||||
#endif // extern "C"
|
||||
|
||||
#endif // GSMSERVICES_H__
|
||||
|
|
@ -30,121 +30,6 @@
|
|||
***************************************************************************/
|
||||
typedef uint32_t HANDLE;
|
||||
|
||||
/****************************************************************************
|
||||
* typedef : GsmL1_RxBurst
|
||||
************************************************************************//**
|
||||
*
|
||||
* Individual physical channel message received from the demodulator.
|
||||
*
|
||||
* @ingroup gsml1_api_types
|
||||
*
|
||||
***************************************************************************/
|
||||
#ifdef QUAD_BAND__ // Quad-Band
|
||||
typedef struct GsmL1_RxBurst_t
|
||||
{
|
||||
uint32_t u32Sync; ///< Synchronization word (Word 1)
|
||||
|
||||
uint32_t u22Fn : 24; ///< Frame number (Word 2 [0-23])
|
||||
uint32_t u8Tn : 8; ///< Time slot number (Word 2 [24-32])
|
||||
|
||||
uint32_t u8DeviceId : 8; ///< Device Id ( Word 3 [0-7] )
|
||||
uint32_t u8AgcScaleFactor : 8; ///< Agc Gain applied to the burst sample is 2^(AGC_SCALE_FACTOR) ( Word 3 [8 - 15] )
|
||||
uint32_t u16RfAtten :16; ///< RF attenuator ( Word 3 [16 - 31] )
|
||||
|
||||
uint32_t u8BurstType : 8; ///< Burst type ( Word 4 [0-7] )
|
||||
uint32_t u8RfSync : 8; ///< RF synchronization flag ( Word 4 [8 - 15] )
|
||||
int32_t i16Offset : 16; ///< Burst offset ( Word 4 [16-31] )
|
||||
|
||||
float fRssi; ///< Received signal strength indicator in femtowatt( Word 5 )
|
||||
|
||||
union
|
||||
{
|
||||
float fLQ; ///< Link quality ( Word 6 [0 - 31] )
|
||||
float fTsRssi; ///< Received training sequence signal strength indicator in femtowatt( Word 6 )
|
||||
} u;
|
||||
|
||||
uint32_t u16XCorr : 16; ///< Correlation result ( Word 7 [0 - 15] )
|
||||
uint32_t u16Arfcn : 16; ///< Arfcn (Set by the PhyRf layer ( Word 8 [0 - 15] )
|
||||
|
||||
GsmL1_Dir_t dir; ///< Direction ( Word 8 [0 - 31] )
|
||||
//uint32_t u16Arfcn : 16; ///< Arfcn (Set by the PhyRf layer ( Word 8 [0 - 15] )
|
||||
//uint32_t : 16; ///< Reserved bits ( Word 8, [16 - 31] )
|
||||
|
||||
int8_t pi8Burst[148]; ///< Burst data (148 bytes)
|
||||
|
||||
} GsmL1_RxBurst_t;
|
||||
#else // DCS-1800
|
||||
typedef struct GsmL1_RxBurst_t
|
||||
{
|
||||
uint32_t u32Sync; ///< Synchronization word (Word 1)
|
||||
|
||||
uint32_t u22Fn : 24; ///< Frame number (Word 2 [0-23])
|
||||
uint32_t u8Tn : 8; ///< Time slot number (Word 2 [24-32])
|
||||
|
||||
uint32_t u16DeviceId :16; ///< Device Id ( Word 3 [0-15] )
|
||||
uint32_t u8AgcScaleFactor : 8; ///< Agc Gain applied to the burst sample is 2^(AGC_SCALE_FACTOR) ( Word 3 [16 - 23] )
|
||||
uint32_t u8RfAtten : 8; ///< RF attenuator ( Word 3 [24 - 31] )
|
||||
|
||||
uint32_t u8BurstType : 8; ///< Burst type ( Word 4 [0-7] )
|
||||
uint32_t u8RfSync : 8; ///< RF synchronization flag ( Word 4 [8 - 15] )
|
||||
int32_t i16Offset : 16; ///< Burst offset ( Word 4 [16-31] )
|
||||
|
||||
float fRssi; ///< Received signal strength indicator in femtowatt( Word 5 )
|
||||
|
||||
union
|
||||
{
|
||||
float fLQ; ///< Link quality ( Word 6 [0 - 31] )
|
||||
float fTsRssi; ///< Received training sequence signal strength indicator in femtowatt( Word 6 )
|
||||
} u;
|
||||
|
||||
uint32_t u16XCorr : 16; ///< Correlation result ( Word 7 [0 - 15] )
|
||||
uint32_t u16Arfcn : 16; ///< Arfcn (Set by the PhyRf layer ( Word 8 [0 - 15] )
|
||||
|
||||
GsmL1_Dir_t dir; ///< Direction ( Word 8 [0 - 31] )
|
||||
//uint32_t u16Arfcn : 16; ///< Arfcn (Set by the PhyRf layer ( Word 8 [0 - 15] )
|
||||
//uint32_t : 16; ///< Reserved bits ( Word 8, [16 - 31] )
|
||||
|
||||
int8_t pi8Burst[148]; ///< Burst data (148 bytes)
|
||||
|
||||
} GsmL1_RxBurst_t;
|
||||
#endif
|
||||
|
||||
/****************************************************************************
|
||||
* typedef : GsmL1_TxBurst
|
||||
************************************************************************//**
|
||||
*
|
||||
* Individual physical channel message transmitted to the demodulator.
|
||||
*
|
||||
* @ingroup gsml1_api_types
|
||||
*
|
||||
* @note The [LB] tag means that this field is set in Dsp/Fpga loopback only
|
||||
***************************************************************************/
|
||||
typedef struct GsmL1_TxBurst_t
|
||||
{
|
||||
uint32_t u32Sync; ///< Synchronization word (Word 1 [0 - 31] )
|
||||
|
||||
uint32_t u22Fn : 24; ///< Frame number (Word 2 [0-23])
|
||||
uint32_t u8Tn : 8; ///< Time slot number (Word 2 [24-32])
|
||||
|
||||
uint32_t u16DeviceId : 16; ///< Fpga device Id (Word 3 [0 - 15] )
|
||||
uint32_t : 16; ///< Reserved bits ( Word 3 [16 - 31] )
|
||||
|
||||
uint32_t u8BurstType : 8; ///< Burst type ( Word 4 [0-7] )
|
||||
uint32_t : 24; ///< Reserved bits ( Word 4 [8-31] )
|
||||
|
||||
uint32_t u32SubCh : 32; ///< Reserved bits ( Word 5 )
|
||||
|
||||
uint32_t : 32; ///< Reserved bits ( Word 6 )
|
||||
|
||||
uint32_t u16Arfcn : 16; ///< [LB] Absolute radio frequency channel number ( Word 8 [ 16-31 ] )
|
||||
uint32_t : 16; ///< Reserved word ( Word 8 [ 0-15 ] )
|
||||
|
||||
GsmL1_Dir_t dir; ///< Direction ( Word 8 [0 - 31] )
|
||||
|
||||
int8_t pi8Burst[148]; ///< Burst data (148 bytes)
|
||||
|
||||
} GsmL1_TxBurst_t;
|
||||
|
||||
/****************************************************************************
|
||||
* typedef : GsmL1_LogChParam_t
|
||||
************************************************************************//**
|
||||
|
|
|
|||
|
|
@ -13,7 +13,7 @@
|
|||
#include "gsml1const.h"
|
||||
|
||||
#define SUPERFEMTO_API(x,y,z) ((x << 16) | (y << 8) | z)
|
||||
#define SUPERFEMTO_API_VERSION SUPERFEMTO_API(0,1,0)
|
||||
#define SUPERFEMTO_API_VERSION SUPERFEMTO_API(2,1,0)
|
||||
|
||||
/****************************************************************************
|
||||
* Const *
|
||||
|
|
@ -42,23 +42,54 @@ typedef GsmL1_Status_t SuperFemto_Status_t;
|
|||
****************************************************************************/
|
||||
typedef enum SuperFemto_PrimId_t
|
||||
{
|
||||
SuperFemto_PrimId_SystemInfoReq, ///< Request system information
|
||||
SuperFemto_PrimId_SystemInfoCnf, ///< Confirm system information
|
||||
SuperFemto_PrimId_SystemFailureInd, ///< System failure indication
|
||||
SuperFemto_PrimId_ActivateRfReq, ///< Request activation of the RF section
|
||||
SuperFemto_PrimId_ActivateRfCnf, ///< Confirm activation of the RF section
|
||||
SuperFemto_PrimId_DeactivateRfReq, ///< Request deactivation of the RF section
|
||||
SuperFemto_PrimId_DeactivateRfCnf, ///< Confirm deactivation of the RF section
|
||||
SuperFemto_PrimId_SetTraceFlagsReq, ///< Set the verbosity of the system
|
||||
SuperFemto_PrimId_RfClockInfoReq, ///< Request information about the RF clock sub-system
|
||||
SuperFemto_PrimId_RfClockInfoCnf, ///< Returns the RF clock sub-system information
|
||||
SuperFemto_PrimId_RfClockSetupReq, ///< Configure the RF clock sub-system
|
||||
SuperFemto_PrimId_RfClockSetupCnf, ///< Confirm the configuration of the RF clock sub-system
|
||||
SuperFemto_PrimId_Layer1ResetReq, ///< Trigger a reset of the GSM layer 1 library
|
||||
SuperFemto_PrimId_Layer1ResetCnf, ///< Confirm that the GSM layer 1 library was reset
|
||||
SuperFemto_PrimId_SystemInfoReq, ///< REQ: System information
|
||||
SuperFemto_PrimId_SystemInfoCnf, ///< CNF: System information
|
||||
SuperFemto_PrimId_SystemFailureInd, ///< IND: System failure indication
|
||||
SuperFemto_PrimId_ActivateRfReq, ///< REQ: Activation of the RF section
|
||||
SuperFemto_PrimId_ActivateRfCnf, ///< CNF: Activation of the RF section
|
||||
SuperFemto_PrimId_DeactivateRfReq, ///< REQ: Deactivation of the RF section
|
||||
SuperFemto_PrimId_DeactivateRfCnf, ///< CNF: Deactivation of the RF section
|
||||
SuperFemto_PrimId_SetTraceFlagsReq, ///< REQ: Set the verbosity of the system
|
||||
SuperFemto_PrimId_RfClockInfoReq, ///< REQ: Information about the RF clock sub-system
|
||||
SuperFemto_PrimId_RfClockInfoCnf, ///< CNF: Returns the RF clock sub-system information
|
||||
SuperFemto_PrimId_RfClockSetupReq, ///< REQ: Configure the RF clock sub-system
|
||||
SuperFemto_PrimId_RfClockSetupCnf, ///< CNF: Confirm the configuration of the RF clock sub-system
|
||||
SuperFemto_PrimId_Layer1ResetReq, ///< REQ: Trigger a reset of the GSM layer 1 library
|
||||
SuperFemto_PrimId_Layer1ResetCnf, ///< CNF: Confirm that the GSM layer 1 library was reset
|
||||
SuperFemto_PrimId_GetTxCalibTblReq, ///< REQ: Get the TX gain calibration table
|
||||
SuperFemto_PrimId_GetTxCalibTblCnf, ///< CNF: Returns TX gain calibration table
|
||||
SuperFemto_PrimId_SetTxCalibTblReq, ///< REQ: Set the TX gain calibration table
|
||||
SuperFemto_PrimId_SetTxCalibTblCnf, ///< CNF: Confirm the use of the new TX gain calibration table
|
||||
SuperFemto_PrimId_GetRxCalibTblReq, ///< REQ: Get the RX level calibration table
|
||||
SuperFemto_PrimId_GetRxCalibTblCnf, ///< CNF: Returns RX level calibration table
|
||||
SuperFemto_PrimId_SetRxCalibTblReq, ///< REQ: Set the RX level calibration table
|
||||
SuperFemto_PrimId_SetRxCalibTblCnf, ///< CNF: Confirm the use of the new RX level calibration table
|
||||
SuperFemto_PrimId_NUM
|
||||
} SuperFemto_PrimId_t;
|
||||
|
||||
/****************************************************************************
|
||||
* Enum : SuperFemto_ClkSrcId_t
|
||||
************************************************************************//**
|
||||
*
|
||||
* Clock source intifiers.
|
||||
*
|
||||
* @ingroup superfemto_api
|
||||
*
|
||||
****************************************************************************/
|
||||
typedef enum SuperFemto_ClkSrcId_t
|
||||
{
|
||||
// RF Diagnostic Primitives
|
||||
SuperFemto_ClkSrcId_None = 0, ///< None
|
||||
SuperFemto_ClkSrcId_Ocxo, ///< Optional on-board OCXO
|
||||
SuperFemto_ClkSrcId_Tcxo, ///< Optional on-board TCXO
|
||||
SuperFemto_ClkSrcId_External, ///< Multi-Trx external clock
|
||||
SuperFemto_ClkSrcId_GpsPps, ///< GPS PPS
|
||||
SuperFemto_ClkSrcId_Trx, ///< TRX clock
|
||||
SuperFemto_ClkSrcId_Rx, ///< RX clock
|
||||
SuperFemto_ClkSrcId_Edge, ///< Debug edge connector clock
|
||||
SuperFemto_ClkSrcId_NetList ///< Network listening
|
||||
|
||||
} SuperFemto_ClkSrcId_t;
|
||||
|
||||
/****************************************************************************
|
||||
* Types *
|
||||
|
|
@ -91,6 +122,12 @@ typedef struct SuperFemto_SystemInfoCnf
|
|||
uint8_t build; ///< FPGA firmware build version number
|
||||
} fpgaVersion;
|
||||
|
||||
struct
|
||||
{
|
||||
uint8_t rev; ///< Board reversion number
|
||||
uint8_t option; ///< Board option number
|
||||
} boardVersion;
|
||||
|
||||
} SuperFemto_SystemInfoCnf_t;
|
||||
|
||||
/****************************************************************************
|
||||
|
|
@ -119,6 +156,12 @@ typedef struct SuperFemto_SystemFailureInd
|
|||
***************************************************************************/
|
||||
typedef struct SuperFemto_ActivateRfReq
|
||||
{
|
||||
// Timing source (FN/TN)
|
||||
struct
|
||||
{
|
||||
uint8_t u8TimSrc; ///< Timing source (0:Slave/Get timing from remote master BTS, 1:Master/Generates its own timing)
|
||||
} timing;
|
||||
|
||||
// Message queue options
|
||||
struct {
|
||||
uint8_t u8UseTchMsgq; ///< Set to '1' to use a separate MSGQUEUE for TCH primitives
|
||||
|
|
@ -129,14 +172,14 @@ typedef struct SuperFemto_ActivateRfReq
|
|||
struct
|
||||
{
|
||||
int iClkCor; ///< Clock correction value in PPB.
|
||||
uint8_t u8ClkSrc; ///< Clock source (0:None, 1:OCXO, 2:TCXO, 3:External, 4:GPS PPS, 5:reserved, 6:RX)
|
||||
SuperFemto_ClkSrcId_t clkSrc; ///< Clock source (0:None, 1:OCXO, 2:TCXO, 3:External, 4:GPS PPS, 5:reserved, 6:RX, 7:Edge)
|
||||
} rfTrx;
|
||||
|
||||
// RX RF clock options
|
||||
struct
|
||||
{
|
||||
int iClkCor; ///< Clock calibration value in PPB.
|
||||
uint8_t u8ClkSrc; ///< Clock source (0:None, 1:OCXO, 2:TCXO, 3:External, 4:GPS PPS, 5:TRX, 6:reserved)
|
||||
SuperFemto_ClkSrcId_t clkSrc; ///< Clock source (0:None, 1:OCXO, 2:TCXO, 3:External, 4:GPS PPS, 5:TRX, 6:reserved, 7:Edge)
|
||||
} rfRx;
|
||||
|
||||
} SuperFemto_ActivateRfReq_t;
|
||||
|
|
@ -215,19 +258,19 @@ typedef struct SuperFemto_RfClockSetupReq
|
|||
struct
|
||||
{
|
||||
int iClkCor; ///< Clock correction value in PPB.
|
||||
uint8_t u8ClkSrc; ///< Clock source (0:None, 1:OCXO, 2:TCXO, 3:External, 4:GPS PPS, 5:reserved, 6:RX)
|
||||
SuperFemto_ClkSrcId_t clkSrc; ///< Clock source (0:None, 1:OCXO, 2:TCXO, 3:External, 4:GPS PPS, 5:reserved, 6:RX, 7:Edge)
|
||||
} rfTrx;
|
||||
|
||||
// RX RF clock options
|
||||
struct
|
||||
{
|
||||
int iClkCor; ///< Clock calibration value in PPB.
|
||||
uint8_t u8ClkSrc; ///< Clock source (0:None, 1:OCXO, 2:TCXO, 3:External, 4:GPS PPS, 5:TRX, 6:reserved)
|
||||
SuperFemto_ClkSrcId_t clkSrc; ///< Clock source (0:None, 1:OCXO, 2:TCXO, 3:External, 4:GPS PPS, 5:TRX, 6:reserved, 7:Edge)
|
||||
} rfRx;
|
||||
|
||||
// RF clock calibration
|
||||
struct {
|
||||
uint8_t u8ClkSrc; ///< Reference clock source (0:Off, 1:OCXO, 2:TCXO, 3:External, 4:GPS PPS, 5:reserved, 6:reserved, 7:NL)
|
||||
SuperFemto_ClkSrcId_t clkSrc; ///< Reference clock source (0:Off, 1:OCXO, 2:TCXO, 3:External, 4:GPS PPS, 5:reserved, 6:reserved, 7:Edge, 8:NL)
|
||||
} rfTrxClkCal;
|
||||
|
||||
} SuperFemto_RfClockSetupReq_t;
|
||||
|
|
@ -263,19 +306,19 @@ typedef struct SuperFemto_RfClockInfoCnf
|
|||
struct
|
||||
{
|
||||
int iClkCor; ///< Clock correction value in PPB.
|
||||
uint8_t u8ClkSrc; ///< Clock source (0:None, 1:OCXO, 2:TCXO, 3:External, 4:GPS PPS, 5:reserved, 6:RX)
|
||||
SuperFemto_ClkSrcId_t clkSrc; ///< Clock source (0:None, 1:OCXO, 2:TCXO, 3:External, 4:GPS PPS, 5:reserved, 6:RX, 7:Edge)
|
||||
} rfTrx;
|
||||
|
||||
// RX RF clock options
|
||||
struct
|
||||
{
|
||||
int iClkCor; ///< Clock calibration value in PPB.
|
||||
uint8_t u8ClkSrc; ///< Clock source (0:None, 1:OCXO, 2:TCXO, 3:External, 4:GPS PPS, 5:TRX, 6:reserved)
|
||||
SuperFemto_ClkSrcId_t clkSrc; ///< Clock source (0:None, 1:OCXO, 2:TCXO, 3:External, 4:GPS PPS, 5:TRX, 6:reserved, 7:Edge)
|
||||
} rfRx;
|
||||
|
||||
// RF clock calibration
|
||||
struct {
|
||||
uint8_t u8ClkSrc; ///< Reference clock source (0:Off, 1:OCXO, 2:TCXO, 3:External, 4:GPS PPS, 5:reserved, 6:reserved, 7:NL)
|
||||
SuperFemto_ClkSrcId_t clkSrc; ///< Reference clock source (0:Off, 1:OCXO, 2:TCXO, 3:External, 4:GPS PPS, 5:reserved, 6:reserved, 7:Edge, 8:NL)
|
||||
|
||||
int iClkErr; ///< RF clock error (PPB).
|
||||
int iClkErrRes; ///< Clock error resolution (PPT).
|
||||
|
|
@ -291,7 +334,7 @@ typedef struct SuperFemto_RfClockInfoCnf
|
|||
*
|
||||
* @ingroup superfemto_api_prim_sys
|
||||
*
|
||||
****************************************************************************/
|
||||
****************************************************************************/
|
||||
typedef struct SuperFemto_Layer1ResetReq
|
||||
{
|
||||
uint32_t u32Reserved;
|
||||
|
|
@ -306,13 +349,169 @@ typedef struct SuperFemto_Layer1ResetReq
|
|||
*
|
||||
* @ingroup superfemto_api_prim_sys
|
||||
*
|
||||
****************************************************************************/
|
||||
****************************************************************************/
|
||||
typedef struct SuperFemto_Layer1ResetCnf
|
||||
{
|
||||
GsmL1_Status_t status;
|
||||
|
||||
} SuperFemto_Layer1ResetCnf_t;
|
||||
|
||||
/****************************************************************************
|
||||
* Struct : SuperFemto_GetTxCalibTblReq_t
|
||||
************************************************************************//**
|
||||
*
|
||||
* Structure is used to get the TX gain calibration table.
|
||||
*
|
||||
* @ingroup superfemto_api_prim_sys
|
||||
*
|
||||
****************************************************************************/
|
||||
typedef struct SuperFemto_GetTxCalibTblReq
|
||||
{
|
||||
GsmL1_FreqBand_t freqBand; ///< GSM Frequency band
|
||||
|
||||
} SuperFemto_GetTxCalibTblReq_t;
|
||||
|
||||
/****************************************************************************
|
||||
* Struct : SuperFemto_GetTxCalibTblCnf_t
|
||||
************************************************************************//**
|
||||
*
|
||||
* Structure is used to returns the TX gain calibration table.
|
||||
*
|
||||
* TX_Gain = m[band] x (fTxPowerLevel + fGainCorrVsArfcn[band][arfcn]) + b[band]
|
||||
*
|
||||
* @ingroup superfemto_api_prim_sys
|
||||
*
|
||||
****************************************************************************/
|
||||
typedef struct SuperFemto_GetTxCalibTblCnf
|
||||
{
|
||||
GsmL1_Status_t status;
|
||||
GsmL1_FreqBand_t freqBand; ///< GSM Frequency band
|
||||
|
||||
float fGain[80]; ///< Gain setting for output level from +50dBm to -29 dBm
|
||||
float fGainCorrVsArfcn[374]; /**< Gain correction (in dBm) for each ARFCN
|
||||
for GSM-850 : 0=128, 1:129, ..., 123:251, [124-373]:unused
|
||||
for GSM-900 : 0=955, 1:956, ..., 70:1, ..., 317:956, [318-373]:unused
|
||||
for DCS-1800: 0=512, 1:513, ..., 373:885
|
||||
for PCS-1900: 0=512, 1:513, ..., 298:810, [299-373]:unused */
|
||||
} SuperFemto_GetTxCalibTblCnf_t;
|
||||
|
||||
/****************************************************************************
|
||||
* Struct : SuperFemto_SetTxCalibTblReq_t
|
||||
************************************************************************//**
|
||||
*
|
||||
* Structure is used to set the TX gain calibration table.
|
||||
*
|
||||
* TX_Gain = m[band] x (fTxPowerLevel + fGainCorrVsArfcn[band][arfcn]) + b[band]
|
||||
*
|
||||
* @ingroup superfemto_api_prim_sys
|
||||
*
|
||||
****************************************************************************/
|
||||
typedef struct SuperFemto_SetTxCalibTblReq
|
||||
{
|
||||
GsmL1_FreqBand_t freqBand; ///< GSM Frequency band
|
||||
|
||||
float fGain[80]; ///< Gain setting for output level from +50dBm to -29 dBm
|
||||
float fGainCorrVsArfcn[374]; /***< Gain correction (in dBm) for each ARFCN
|
||||
for GSM-850 : 0=128, 1:129, ..., 123:251, [124-373]:unused
|
||||
for GSM-900 : 0=955, 1:956, ..., 70:1, ..., 317:956, [318-373]:unused
|
||||
for DCS-1800: 0=512, 1:513, ..., 373:885
|
||||
for PCS-1900: 0=512, 1:513, ..., 298:810, [299-373]:unused */
|
||||
} SuperFemto_SetTxCalibTblReq_t;
|
||||
|
||||
/****************************************************************************
|
||||
* Struct : SuperFemto_SetTxCalibTblCnf_t
|
||||
************************************************************************//**
|
||||
*
|
||||
* Structure is used to confirm the use of the new TX gain calibration table.
|
||||
*
|
||||
* @ingroup superfemto_api_prim_sys
|
||||
*
|
||||
****************************************************************************/
|
||||
typedef struct SuperFemto_SetTxCalibTblCnf
|
||||
{
|
||||
GsmL1_Status_t status;
|
||||
GsmL1_FreqBand_t freqBand; ///< GSM Frequency band
|
||||
} SuperFemto_SetTxCalibTblCnf_t;
|
||||
|
||||
/****************************************************************************
|
||||
* Struct : SuperFemto_GetRxCalibTblReq_t
|
||||
************************************************************************//**
|
||||
*
|
||||
* Structure is used to get the RX level calibration table.
|
||||
*
|
||||
* @ingroup superfemto_api_prim_sys
|
||||
*
|
||||
****************************************************************************/
|
||||
typedef struct SuperFemto_GetRxCalibTblReq
|
||||
{
|
||||
GsmL1_FreqBand_t freqBand; ///< GSM Frequency band
|
||||
uint8_t bUplink; ///< Direction (0:Downlink, 1:Uplink)
|
||||
|
||||
} SuperFemto_GetRxCalibTblReq_t;
|
||||
|
||||
/****************************************************************************
|
||||
* Struct : SuperFemto_GetRxCalibTblCnf_t
|
||||
************************************************************************//**
|
||||
*
|
||||
* Structure is used to returns the RX level calibration table.
|
||||
*
|
||||
* RSSI = RxLevel + fRssiCorrVsArfcn[band][arfcn]
|
||||
*
|
||||
* @ingroup superfemto_api_prim_sys
|
||||
*
|
||||
****************************************************************************/
|
||||
typedef struct SuperFemto_GetRxCalibTblCnf
|
||||
{
|
||||
GsmL1_Status_t status;
|
||||
GsmL1_FreqBand_t freqBand; ///< GSM Frequency band
|
||||
uint8_t bUplink; ///< Direction (0:Downlink, 1:Uplink)
|
||||
|
||||
float fRssiCorrVsArfcn[374]; /***< RSSI correction (in dBm) for each ARFCN
|
||||
for GSM-850 : 0=128, 1:129, ..., 123:251, [124-373]:unused
|
||||
for GSM-900 : 0=955, 1:956, ..., 70:1, ..., 317:956, [318-373]:unused
|
||||
for DCS-1800: 0=512, 1:513, ..., 373:885
|
||||
for PCS-1900: 0=512, 1:513, ..., 298:810, [299-373]:unused */
|
||||
} SuperFemto_GetRxCalibTblCnf_t;
|
||||
|
||||
/****************************************************************************
|
||||
* Struct : SuperFemto_SetRxCalibTblReq_t
|
||||
************************************************************************//**
|
||||
*
|
||||
* Structure is used to set the RX level calibration table.
|
||||
*
|
||||
* RSSI = RxLevel + fRssiCorrVsArfcn[band][arfcn]
|
||||
*
|
||||
* @ingroup superfemto_api_prim_sys
|
||||
*
|
||||
****************************************************************************/
|
||||
typedef struct SuperFemto_SetRxCalibTblReq
|
||||
{
|
||||
GsmL1_FreqBand_t freqBand; ///< GSM Frequency band
|
||||
uint8_t bUplink; ///< Direction (0:Downlink, 1:Uplink)
|
||||
|
||||
float fRssiCorrVsArfcn[374]; /***< RSSI correction (in dBm) for each ARFCN
|
||||
for GSM-850 : 0=128, 1:129, ..., 123:251, [124-373]:unused
|
||||
for GSM-900 : 0=955, 1:956, ..., 70:1, ..., 317:956, [318-373]:unused
|
||||
for DCS-1800: 0=512, 1:513, ..., 373:885
|
||||
for PCS-1900: 0=512, 1:513, ..., 298:810, [299-373]:unused */
|
||||
} SuperFemto_SetRxCalibTblReq_t;
|
||||
|
||||
/****************************************************************************
|
||||
* Struct : SuperFemto_SetRxCalibTblCnf_t
|
||||
************************************************************************//**
|
||||
*
|
||||
* Structure is used to confirm the use of the new RX level calibration table.
|
||||
*
|
||||
* @ingroup superfemto_api_prim_sys
|
||||
*
|
||||
****************************************************************************/
|
||||
typedef struct SuperFemto_SetRxCalibTblCnf
|
||||
{
|
||||
GsmL1_Status_t status;
|
||||
GsmL1_FreqBand_t freqBand; ///< GSM Frequency band
|
||||
uint8_t bUplink; ///< Direction (0:Downlink, 1:Uplink)
|
||||
} SuperFemto_SetRxCalibTblCnf_t;
|
||||
|
||||
/****************************************************************************
|
||||
* Struct : SuperFemto_Primt_t
|
||||
************************************************************************//**
|
||||
|
|
@ -321,30 +520,38 @@ typedef struct SuperFemto_Layer1ResetCnf
|
|||
*
|
||||
* @ingroup superfemto_api_prim_sys
|
||||
*
|
||||
****************************************************************************/
|
||||
****************************************************************************/
|
||||
typedef struct SuperFemto_Prim
|
||||
{
|
||||
SuperFemto_PrimId_t id; ///< Primitive ID
|
||||
SuperFemto_PrimId_t id; ///< Primitive ID
|
||||
|
||||
union
|
||||
{
|
||||
SuperFemto_SystemInfoCnf_t systemInfoCnf; ///< Confirm system information
|
||||
SuperFemto_SysemFailureInd_t sysemFailureInd; ///< System failure indication
|
||||
SuperFemto_ActivateRfReq_t activateRfReq; ///< Request activation of the RF section
|
||||
SuperFemto_ActivateRfCnf_t activateRfCnf; ///< Confirm activation of the RF section
|
||||
SuperFemto_DeactivateRfCnf_t deactivateRfCnf; ///< Confirm deactivation of the RF section
|
||||
SuperFemto_SetTraceFlagsReq_t setTraceFlagsReq; ///< Set the verbosity of the system
|
||||
SuperFemto_RfClockInfoReq_t rfClockInfoReq; ///< Request information about the RF clock
|
||||
SuperFemto_RfClockInfoCnf_t rfClockInfoCnf; ///< Returns information about the RF clock
|
||||
SuperFemto_RfClockSetupReq_t rfClockSetupReq; ///< Setup the RF clock
|
||||
SuperFemto_RfClockSetupCnf_t rfClockSetupCnf; ///< Confirm the setup of the RF clock
|
||||
SuperFemto_Layer1ResetReq_t layer1ResetReq; ///< Request a reset of the layer 1 module
|
||||
SuperFemto_Layer1ResetCnf_t layer1ResetCnf; ///< Conrifm that the layer 1 module was reset
|
||||
SuperFemto_SystemInfoCnf_t systemInfoCnf; ///< CNF: System information
|
||||
SuperFemto_SysemFailureInd_t sysemFailureInd; ///< IND: System failure indication
|
||||
SuperFemto_ActivateRfReq_t activateRfReq; ///< REQ: Activation of the RF section
|
||||
SuperFemto_ActivateRfCnf_t activateRfCnf; ///< CNF: Activation of the RF section
|
||||
SuperFemto_DeactivateRfCnf_t deactivateRfCnf; ///< CNF: Deactivation of the RF section
|
||||
SuperFemto_SetTraceFlagsReq_t setTraceFlagsReq; ///< REQ: Set the verbosity of the system
|
||||
SuperFemto_RfClockInfoReq_t rfClockInfoReq; ///< REQ: Information about the RF clock sub-system
|
||||
SuperFemto_RfClockInfoCnf_t rfClockInfoCnf; ///< CNF: Returns the RF clock sub-system information
|
||||
SuperFemto_RfClockSetupReq_t rfClockSetupReq; ///< REQ: Configure the RF clock sub-system
|
||||
SuperFemto_RfClockSetupCnf_t rfClockSetupCnf; ///< CNF: Confirm the configuration of the RF clock sub-system
|
||||
SuperFemto_Layer1ResetReq_t layer1ResetReq; ///< REQ: Trigger a reset of the GSM layer 1 module
|
||||
SuperFemto_Layer1ResetCnf_t layer1ResetCnf; ///< CNF: Confirm that the GSM layer 1 module was reset
|
||||
SuperFemto_GetTxCalibTblReq_t getTxCalibTblReq; ///< REQ: Get the TX gain calibration table
|
||||
SuperFemto_GetTxCalibTblCnf_t getTxCalibTblCnf; ///< CNF: Returns TX gain calibration table
|
||||
SuperFemto_SetTxCalibTblReq_t setTxCalibTblReq; ///< REQ: Set the TX gain calibration table
|
||||
SuperFemto_SetTxCalibTblCnf_t setTxCalibTblCnf; ///< CNF: Confirm the use of the new TX gain calibration table
|
||||
SuperFemto_GetRxCalibTblReq_t getRxCalibTblReq; ///< REQ: Get the RX level calibration table
|
||||
SuperFemto_GetRxCalibTblCnf_t getRxCalibTblCnf; ///< CNF: Returns RX level calibration table
|
||||
SuperFemto_SetRxCalibTblReq_t setRxCalibTblReq; ///< REQ: Set the RX level calibration table
|
||||
SuperFemto_SetRxCalibTblCnf_t setRxCalibTblCnf; ///< CNF: Confirm the use of the new RX level calibration table
|
||||
} u;
|
||||
|
||||
} SuperFemto_Prim_t;
|
||||
|
||||
|
||||
|
||||
#ifdef _TMS320C6400
|
||||
|
||||
/****************************************************************************
|
||||
|
|
|
|||
Loading…
Reference in New Issue