osc.c File Reference

#include "../inc/hw_types.h"
#include "../inc/hw_ccfg.h"
#include "../inc/hw_fcfg1.h"
#include "aon_batmon.h"
#include "aon_rtc.h"
#include "osc.h"
#include "setup_rom.h"

Data Structures
struct	OscHfGlobals_t
struct	insertion_t

Macros
#define	RTC_CV_TO_MS(x)   (( 1000 * ( x )) >> 16 )
#define	RTC_CV_TO_US(x)   (( 1000000 * ( x )) >> 16 )
#define	D1OFFSET_p25C   -24
#define	D2OFFSET_p85C   -36
#define	D3OFFSET_m40C   18
#define	P3_POLYNOMIAL   -47
#define	N_INSERTIONS   3

Functions
void	OSCClockSourceSet (uint32_t ui32SrcClk, uint32_t ui32Osc)
	Configure the oscillator input to the a source clock. More...
uint32_t	OSCClockSourceGet (uint32_t ui32SrcClk)
	Get the source clock settings. More...
uint32_t	OSCHF_GetStartupTime (uint32_t timeUntilWakeupInMs)
	Returns maximum startup time (in microseconds) of XOSC_HF. More...
void	OSCHF_TurnOnXosc (void)
	Turns on XOSC_HF (but without switching to XOSC_HF). More...
bool	OSCHF_AttemptToSwitchToXosc (void)
	Switch to XOSC_HF if XOSC_HF is ready. More...
void	OSCHF_SwitchToRcOscTurnOffXosc (void)
	Switch to RCOSC_HF and turn off XOSC_HF. More...
void	OSC_AdjustXoscHfCapArray (int32_t capArrDelta)
	Adjust the XOSC HF cap array relative to the factory setting. More...
static void	InitializeMeasurmentSet (insertion_t *pInsertion, uint32_t registerAddress, int32_t deltaOffset, int32_t p3PolOffset)
static void	FindPolynomialsAndUpdateGlobals (insertion_t *pMeasurment)
void	OSC_HPOSC_Debug_InitFreqOffsetParams (HposcDebugData_t *pDebugData)
	Debug function to calculate the HPOSC polynomials for experimental data sets. More...
void	OSC_HPOSCInitializeFrequencyOffsetParameters (void)
	HPOSC initialization function. Must always be called before using HPOSC. More...
int32_t	OSC_HPOSCRelativeFrequencyOffsetGet (int32_t tempDegC)
	Calculate the temperature dependent relative frequency offset of HPOSC. More...
int16_t	OSC_HPOSCRelativeFrequencyOffsetToRFCoreFormatConvert (int32_t HPOSC_RelFreqOffset)
	Converts the relative frequency offset of HPOSC to the RF Core parameter format. More...
void	OSC_HPOSCRtcCompensate (int32_t relFreqOffset)
	Compensate the RTC increment based on the relative frequency offset of HPOSC. More...
uint32_t	OSCHF_DebugGetCrystalAmplitude (void)
	Get crystal amplitude (assuming crystal is running). More...
uint32_t	OSCHF_DebugGetExpectedAverageCrystalAmplitude (void)
	Get the expected average crystal amplitude. More...

Variables
static int16_t	_hpOscPolynomials [4]
static OscHfGlobals_t	oscHfGlobals

Macro Definition Documentation

#define D1OFFSET_p25C   -24

Referenced by OSC_HPOSCInitializeFrequencyOffsetParameters().

#define D2OFFSET_p85C   -36

Referenced by OSC_HPOSCInitializeFrequencyOffsetParameters().

#define D3OFFSET_m40C   18

Referenced by OSC_HPOSCInitializeFrequencyOffsetParameters().

#define N_INSERTIONS   3

Referenced by FindPolynomialsAndUpdateGlobals().

#define P3_POLYNOMIAL   -47

Referenced by FindPolynomialsAndUpdateGlobals(), and OSC_HPOSCInitializeFrequencyOffsetParameters().

#define RTC_CV_TO_MS

(

x

)

(( 1000 * ( x )) >> 16 )

Referenced by OSCHF_GetStartupTime().

#define RTC_CV_TO_US

(

x

)

(( 1000000 * ( x )) >> 16 )

Referenced by OSCHF_AttemptToSwitchToXosc(), and OSCHF_GetStartupTime().

Function Documentation

static void FindPolynomialsAndUpdateGlobals ( insertion_t *  pMeasurment )

static

Referenced by OSC_HPOSC_Debug_InitFreqOffsetParams(), and OSC_HPOSCInitializeFrequencyOffsetParameters().

{
   uint32_t loopCount      ;
   int32_t  polynomial_0   ;
   int32_t  polynomial_1   ;
   int32_t  polynomial_2   ;

   int32_t  Syi_     = 0   ;
   int32_t  Sxi_     = 0   ;
   int32_t  Sxi2_    = 0   ;
   int32_t  Sxiyi_   = 0   ;
   int32_t  Sxi2yi_  = 0   ;
   int32_t  Sxi3_    = 0   ;
   int32_t  Sxi4_    = 0   ;

   for ( loopCount = 0 ; loopCount < N_INSERTIONS ; loopCount++ ) {
      int32_t  x     ;
      int32_t  x2    ;
      int32_t  y     ;

      x  = pMeasurment[ loopCount ].temp   ;
      x2 = ( x * x );
      y  = pMeasurment[ loopCount ].dFreq  ;

      Syi_     += ( y         );
      Sxi_     += ( x         );
      Sxi2_    += ( x2        );
      Sxiyi_   += ( x  * y    );
      Sxi2yi_  += ( x2 * y    );
      Sxi3_    += ( x2 * x    );
      Sxi4_    += ( x2 * x2   );
   }

   int32_t  Sxx_     = ( Sxi2_   * N_INSERTIONS ) - ( Sxi_  * Sxi_  );
   int32_t  Sxy_     = ( Sxiyi_  * N_INSERTIONS ) - ( Sxi_  * Syi_  );
   int32_t  Sxx2_    = ( Sxi3_   * N_INSERTIONS ) - ( Sxi_  * Sxi2_ );
   int32_t  Sx2y_    = ( Sxi2yi_ * N_INSERTIONS ) - ( Sxi2_ * Syi_  );
   int32_t  Sx2x2_   = ( Sxi4_   * N_INSERTIONS ) - ( Sxi2_ * Sxi2_ );

   int32_t  divisor = ((((int64_t) Sxx_ * Sx2x2_ ) - ((int64_t) Sxx2_ * Sxx2_ )) + (1<<9)) >> 10 ;
   if ( divisor == 0 ) {
      polynomial_2 = 0 ;
      polynomial_1 = 0 ;
   } else {
      polynomial_2 = (((int64_t) Sx2y_ * Sxx_   ) - ((int64_t) Sxy_  * Sxx2_ )) / divisor ;
      polynomial_1 = (((int64_t) Sxy_  * Sx2x2_ ) - ((int64_t) Sx2y_ * Sxx2_ )) / divisor ;
   }
   polynomial_0 = ( Syi_ - (((( polynomial_1 * Sxi_ ) + ( polynomial_2 * Sxi2_ )) + (1<<9)) >> 10 )) / N_INSERTIONS ;
   polynomial_1 = ( polynomial_1 + (1<<6)) >> 7 ;

   _hpOscPolynomials[ 0 ] = polynomial_0  ;
   _hpOscPolynomials[ 1 ] = polynomial_1  ;
   _hpOscPolynomials[ 2 ] = polynomial_2  ;
   _hpOscPolynomials[ 3 ] = P3_POLYNOMIAL ;
}

static void InitializeMeasurmentSet ( insertion_t *  pInsertion, uint32_t  registerAddress, int32_t  deltaOffset, int32_t  p3PolOffset  )

static

Referenced by OSC_HPOSC_Debug_InitFreqOffsetParams(), and OSC_HPOSCInitializeFrequencyOffsetParameters().

{
   // Doing the following adjustment to the deltaFrequence before finding the polynomials P0, P1, P2
   // Dx = Dx + DxOFFSET - ((P3*Tx^3)/2^18)
   uint32_t insertionData  = HWREG( registerAddress );
   pInsertion->dFreq = (((int32_t)( insertionData << ( 32 - FCFG1_HPOSC_MEAS_1_HPOSC_D1_W - FCFG1_HPOSC_MEAS_1_HPOSC_D1_S )))
                                                  >> ( 32 - FCFG1_HPOSC_MEAS_1_HPOSC_D1_W ));
   pInsertion->temp  = (((int32_t)( insertionData << ( 32 - FCFG1_HPOSC_MEAS_1_HPOSC_T1_W - FCFG1_HPOSC_MEAS_1_HPOSC_T1_S )))
                                                  >> ( 32 - FCFG1_HPOSC_MEAS_1_HPOSC_T1_W ));
   pInsertion->dFreq = pInsertion->dFreq + deltaOffset - (( p3PolOffset * pInsertion->temp * pInsertion->temp * pInsertion->temp ) >> 18 );
}

Variable Documentation

int16_t _hpOscPolynomials[4]

static

Referenced by FindPolynomialsAndUpdateGlobals(), and OSC_HPOSCRelativeFrequencyOffsetGet().

OscHfGlobals_t oscHfGlobals

static