#include <stdlib.h>
#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	hposc_insertions_t

struct	hposc_param_t

Macros
#define	RTC_CV_TO_MS(x) (( 1000 * ( x )) >> 16 )

#define	RTC_CV_TO_US(x) (( 1000000 * ( x )) >> 16 )

#define	D1OFFSET_25C (-16)

#define	D2OFFSET_85C (-23)

#define	D3OFFSET_n40C (5)

#define	HPOSC_COEFF_BITS (20)

#define	HPOSC_COEFF0_BITS (16)

#define	HPOSC_D_BITS (30)

#define	HPOSC_COEFF0_SHIFT (HPOSC_COEFF_BITS - HPOSC_COEFF0_BITS)

#define	HPOSC_SHIFT1 (2*HPOSC_COEFF_BITS - HPOSC_D_BITS)

#define	HPOSC_DC_BIAS (100000)

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	multiplyColumns (int64_t v1, int64_t v2, int64_t *pBuf, uint8_t shift)

static int64_t	findDenominator (int64_t col0, int64_t col1, int64_t *col2)

static int64_t	findNumerator (int32_t pInput, int64_t pBuf)

static void	findHposcCoefficients (int32_t pInput, int64_t col0, int64_t col1, int64_t col2, hposc_param_t *pParam)

static void	findHposcPc (int64_t pCoeff, uint8_t pBits, int32_t pTemp, uint8_t nTemp, int64_t pOutput)

static void	readTempAndFreq (uint32_t regAddr, int32_t pTemp, int32_t pdFreq, int32_t deltaFreq)

void	OSC_HPOSCInitializeFrequencyOffsetParameters (void)
	HPOSC initialization function. Must always be called before using HPOSC. More...

void	OSC_HPOSC_Debug_InitFreqOffsetParams (HposcDebugData_t *pDebugData)
	Debug function to calculate the HPOSC polynomials for experimental data sets. More...

void	OSC_HPOSCInitializeSingleInsertionFreqOffsParams (uint32_t measFieldAddress)
	Special HPOSC initialization function for single temperature compensation. 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 OscHfGlobals_t	oscHfGlobals

int32_t	_hposcCoeffs [4] = {0}

Macro Definition Documentation

#define D1OFFSET_25C (-16)

Referenced by OSC_HPOSCInitializeFrequencyOffsetParameters().

#define D2OFFSET_85C (-23)

Referenced by OSC_HPOSCInitializeFrequencyOffsetParameters().

#define D3OFFSET_n40C (5)

Referenced by OSC_HPOSCInitializeFrequencyOffsetParameters().

#define HPOSC_COEFF0_BITS (16)

Referenced by findHposcCoefficients(), and OSC_HPOSCRelativeFrequencyOffsetGet().

#define HPOSC_COEFF0_SHIFT (HPOSC_COEFF_BITS - HPOSC_COEFF0_BITS)

Referenced by findHposcCoefficients(), and OSC_HPOSCRelativeFrequencyOffsetGet().

#define HPOSC_COEFF_BITS (20)

Referenced by findDenominator(), findHposcCoefficients(), and findHposcPc().

#define HPOSC_D_BITS (30)

Referenced by findHposcCoefficients().

#define HPOSC_DC_BIAS (100000)

Referenced by findHposcCoefficients().

#define HPOSC_SHIFT1 (2*HPOSC_COEFF_BITS - HPOSC_D_BITS)

Referenced by findDenominator(), and findHposcCoefficients().

#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 int64_t findDenominator	(	int64_t *	col0,
		int64_t *	col1,
		int64_t *	col2
	)

static

Referenced by findHposcCoefficients().

 {
     int64_t tmp, tmpBuf[6];
 
     multiplyColumns(col1, col2, tmpBuf, HPOSC_SHIFT1); // Keep HPOSC_D_BITS precision
 
     tmp = (tmpBuf[0]*col0[0] - tmpBuf[1]*col0[0] - tmpBuf[2]*col0[1] +
            tmpBuf[3]*col0[1] + tmpBuf[4]*col0[2] - tmpBuf[5]*col0[2]) >> HPOSC_COEFF_BITS;
 
     return tmp;
 }

Here is the call graph for this function:

static void findHposcCoefficients	(	int32_t *	pInput,
		int64_t *	col0,
		int64_t *	col1,
		int64_t *	col2,
		hposc_param_t *	pParam
	)

static

Referenced by OSC_HPOSC_Debug_InitFreqOffsetParams(), OSC_HPOSCInitializeFrequencyOffsetParameters(), and OSC_HPOSCInitializeSingleInsertionFreqOffsParams().

 {
     int64_t d,c0,c1,c2,cn,tmpBuf[6];
     int32_t inputBuf[3];
     uint8_t i;
 
     if(col1 == NULL) /* 1 insertion */
     {
         inputBuf[0] = pInput[0] - HPOSC_DC_BIAS;
         c0 = (((int64_t)inputBuf[0] << HPOSC_D_BITS) / col0[0]);
         c1 = 0;
         c2 = 0;
     }
     else /* 3 insertion */
     {
         /* Apply DC bias to input data */
         for(i = 0; i < 3; i++)
         {
             inputBuf[i] = pInput[i] - HPOSC_DC_BIAS;
         }
 
         /* Solve intermediate parameters, d: HPOSC_D_BITS, c: HPOSC_COEFF_BITS*2 bits */
         d = findDenominator(col0, col1, col2);
 
         multiplyColumns(col1, col2, tmpBuf, 0);
         cn = findNumerator(inputBuf, tmpBuf);
         c0 = cn / d;
 
         multiplyColumns(col0, col2, tmpBuf, 0);
         cn = -1*findNumerator(inputBuf, tmpBuf);
         c1 = cn / d;
 
         multiplyColumns(col0, col1, tmpBuf, 0);
         cn = findNumerator(inputBuf, tmpBuf);
         c2 = cn / d;
     }
 
     /* Compute TCF polynomial coefficients */
     for(i = 0; i < 4; i++)
     {
         cn = (((pParam->pu0c[i]*c0) >> (pParam->pu0b[i] - HPOSC_COEFF_BITS)) +
               ((pParam->pu1c[i]*c1) >> (pParam->pu1b[i] - HPOSC_COEFF_BITS)) +
               ((pParam->pu2c[i]*c2) >> (pParam->pu2b[i] - HPOSC_COEFF_BITS))) >> HPOSC_SHIFT1;
 
         if(i<3)
         {
             _hposcCoeffs[3-i] = cn;
         }
         else
         {
             _hposcCoeffs[0] = (cn >> HPOSC_COEFF0_SHIFT) + ((int64_t)HPOSC_DC_BIAS << HPOSC_COEFF0_BITS); // p[0] is combined with the DC bias
         }
     }
 }

Here is the call graph for this function:

static void findHposcPc	(	int64_t *	pCoeff,
		uint8_t *	pBits,
		int32_t *	pTemp,
		uint8_t	nTemp,
		int64_t *	pOutput
	)

static

Referenced by OSC_HPOSC_Debug_InitFreqOffsetParams(), OSC_HPOSCInitializeFrequencyOffsetParameters(), and OSC_HPOSCInitializeSingleInsertionFreqOffsParams().

 {
     uint8_t i;
     int32_t t1,t2,t3;
 
     for(i = 0; i < nTemp; i++)
     {
         t1 = pTemp[i];
         t2 = t1*t1;
         t3 = t2*t1;
 
         pOutput[i] = (((int64_t)pCoeff[0]*t3)>>(pBits[0]-HPOSC_COEFF_BITS)) + (((int64_t)pCoeff[1]*t2)>>(pBits[1]-HPOSC_COEFF_BITS)) +
                      (((int64_t)pCoeff[2]*t1)>>(pBits[2]-HPOSC_COEFF_BITS)) + (((int64_t)pCoeff[3]   )>>(pBits[3]-HPOSC_COEFF_BITS));
     }
 }

static int64_t findNumerator	(	int32_t *	pInput,
		int64_t *	pBuf
	)

static

Referenced by findHposcCoefficients().

 {
     int64_t tmp;
 
     tmp = ((int64_t)pInput[0]*pBuf[0]) - ((int64_t)pInput[0]*pBuf[1]) - ((int64_t)pInput[1]*pBuf[2]) +
           ((int64_t)pInput[1]*pBuf[3]) + ((int64_t)pInput[2]*pBuf[4]) - ((int64_t)pInput[2]*pBuf[5]);
 
     return tmp;
 }

static void multiplyColumns	(	int64_t *	v1,
		int64_t *	v2,
		int64_t *	pBuf,
		uint8_t	shift
	)

static

Referenced by findDenominator(), and findHposcCoefficients().

 {
     pBuf[0] = (v1[1]*v2[2]) >> shift;
     pBuf[1] = (v1[2]*v2[1]) >> shift;
     pBuf[2] = (v1[0]*v2[2]) >> shift;
     pBuf[3] = (v1[2]*v2[0]) >> shift;
     pBuf[4] = (v1[0]*v2[1]) >> shift;
     pBuf[5] = (v1[1]*v2[0]) >> shift;
 }

static void readTempAndFreq	(	uint32_t	regAddr,
		int32_t *	pTemp,
		int32_t *	pdFreq,
		int32_t	deltaFreq
	)

static

Referenced by OSC_HPOSC_Debug_InitFreqOffsetParams(), OSC_HPOSCInitializeFrequencyOffsetParameters(), and OSC_HPOSCInitializeSingleInsertionFreqOffsParams().

 {
     uint32_t insertionData = HWREG(regAddr);
 
     /* temp_stored = Temperature - 27, offset by -27C */
     *pTemp = (((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 ));
 
     /* dFreq_stored = round( (Freq/12e6 - 1) * 2^22 ), 12MHz is the ideal frequency */
     *pdFreq = (((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 ));
     *pdFreq = *pdFreq + deltaFreq;
 }

Variable Documentation

int32_t _hposcCoeffs[4] = {0}

Referenced by findHposcCoefficients(), and OSC_HPOSCRelativeFrequencyOffsetGet().

OscHfGlobals_t oscHfGlobals

static

Data Structures

Macros

Functions

Variables

Macro Definition Documentation

Function Documentation

Variable Documentation