MityDSP::tcDspClk1305G Class Reference

Instances of this class handle an interface to the frequency-adjustable HW clock core, based upon Appendix G of RFC-1305 (NTP). More...

#include <core/DspClk1305G.h>

List of all members.

Classes
struct	alarm_queue
	Structure for alarm queue. More...
Public Types
typedef void(*	tfAlarmCallback )(unsigned int, void *)
	prototype for the alarm callbacks.
Public Member Functions
	tcDspClk1305G (void *apAddress)
	This constructor is used to open a tcDspClk1305G interface.
virtual	~tcDspClk1305G ()
	This destructor is used to close up and free the resources tied to the associated RTC-1305G clock interface.
bool	getTime (unsigned int &arSecs, unsigned int &arNanoSecs)
	Returns the seconds and nanoseconds fields from the RTC-1305 clock.
bool	setTime (unsigned int anSecs, unsigned int anNanoSecs)
	Sets the current seconds and nanoseconds fields of the RTC-1305 clock.
int	adjFreq (int anPPB)
	Adjusts the clock frequency by the given parts-per-billion.
int	getFreq (void)
	Returns the total clock frequency adjustment in parts-per-billion.
int	setFreq (int anPPB)
	Sets the total clock frequency adjustment in parts-per-billion.
unsigned int	setAlarm (unsigned int anSecs, unsigned int anNanoSecs, tfAlarmCallback afCallback, void *apUserData)
	Schedules an alarm at the provided time.
bool	cancelAlarm (unsigned int ahAlarmId)
	Removes a pending alarm from the queue.
Public Attributes
unsigned int	mnInterruptCount
	ISR counter (debug).
Static Public Attributes
static const int	gnMaxAdjPPB = 10000000
	maximum frequency adjustment, in parts-per-billion
Protected Types
typedef struct MityDSP::tcDspClk1305G::alarm_queue	tsAlarmQueue
	Structure for alarm queue.
Protected Member Functions
void	alarmInterrupt (void)
	Interrupt service routine for alarm interrupts.
void	scheduleAlarm (void)
	Internal method used to schedule the next alarm in the queue.
Static Protected Member Functions
static int	interrupt_dispatch (Arg arMyObject)
	Static interrupt dispatch routine.
Protected Attributes
volatile unsigned int *	mpBaseAddr
LCK_Handle	mhMutex
	mutex to serialize access
unsigned int	mnNominalSwallow
	the "nominal swallow count"
int	mnPPB
	accumulated parts-per-billion adjustment
volatile tsAlarmQueue *	mpAlarmQueue
	queue of pending alarms
unsigned short	mnMyIntMask
	core interrupt mask
int	mnMyIntLevel
	core interrupt level
int	mnMyIntVector
	core interrupt vector
Static Protected Attributes
static const int	gnMaxPD = 1048575
	max prescaler divider
static const int	gnMinPPB = 954
	minimum possible PPB adjustment
static const unsigned int	gnCLK_LSB = 200
	LSB of nanoseconds field.

Detailed Description

Instances of this class handle an interface to the frequency-adjustable HW clock core, based upon Appendix G of RFC-1305 (NTP).

See also:: tcDspClk1305G Page

Member Typedef Documentation

typedef void(* MityDSP::tcDspClk1305G::tfAlarmCallback)(unsigned int, void *)

prototype for the alarm callbacks.

typedef struct MityDSP::tcDspClk1305G::alarm_queue MityDSP::tcDspClk1305G::tsAlarmQueue [protected]

Structure for alarm queue.

Constructor & Destructor Documentation

tcDspClk1305G::tcDspClk1305G ( void * apAddress )

This constructor is used to open a tcDspClk1305G interface.

The clock is initialized to time zero, and is immediately available for use.

Parameters:

[in] apAddress Base Address of ADC core.

Returns:: None.

See also:: DspClk1305G.h

tcDspClk1305G::~tcDspClk1305G ( ) [virtual]

This destructor is used to close up and free the resources tied to the associated RTC-1305G clock interface.

Returns:: None.

See also:: DspClk1305G.h

Member Function Documentation

bool tcDspClk1305G::getTime	(	unsigned int &	arSecs,
		unsigned int &	arNanoSecs
	)

Returns the seconds and nanoseconds fields from the RTC-1305 clock.

The fields are latched so there's no rollover concerns to be addressed.

Parameters:

`[out]`	arSecs	Reference to the seconds field to fill.
`[out]`	arNanoSecs	Reference to the nsec field to fill.

Returns:: True.

See also:: DspClk1305G.h

bool tcDspClk1305G::setTime	(	unsigned int	anSecs,
		unsigned int	anNanoSecs
	)

Sets the current seconds and nanoseconds fields of the RTC-1305 clock.

Parameters:

`[in]`	anSecs	Seconds value to set.
`[in]`	anNanoSecs	Nanoseconds value to set.

Returns:: True.

See also:: DspClk1305G.h

int tcDspClk1305G::adjFreq ( int anPPB )

Adjusts the clock frequency by the given parts-per-billion.

Parameters:

[in] anPPB Adjustment to the current parts-per-billion setting.

Returns:: Total PPB setting.

See also:: DspClk1305G.h

int tcDspClk1305G::getFreq ( void )

Returns the total clock frequency adjustment in parts-per-billion.

Returns:: Total PPB setting.

See also:: DspClk1305G.h

int tcDspClk1305G::setFreq ( int anPPB )

Sets the total clock frequency adjustment in parts-per-billion.

Parameters:

[in] anPPB Absolute parts-per-billion setting.

Returns:: Actual current PPB setting.

See also:: DspClk1305G.h

unsigned int tcDspClk1305G::setAlarm	(	unsigned int	anSecs,
		unsigned int	anNanoSecs,
		tfAlarmCallback	afCallback,
		void *	apUserData
	)

Schedules an alarm at the provided time.

Alarm will trigger immediately if time is past. If other alarms are pending, the new alarm will be added to a queue of alarms at the appropriate point.

Parameters:

`[in]`	anSecs	Seconds alarm value to set.
`[in]`	anNanoSecs	Nanoseconds alarm value to set.
`[in]`	afCallback	The function to call when the alarm occurs.
`[in]`	apUserData	An argument to be supplied with the callback.

Returns:: Handle associated with this alarm

See also:: DspClk1305G.h

bool tcDspClk1305G::cancelAlarm ( unsigned int ahAlarmId )

Removes a pending alarm from the queue.

Parameters:

[in] ahAlarmId Handle of alarm to remove (returned by setAlarm)

Returns:: True if removed, false if handle not in queue.

See also:: DspClk1305G.h

int tcDspClk1305G::interrupt_dispatch ( Arg ahMyObject ) [static, protected]

Static interrupt dispatch routine.

Required because of the hidden this pointer associated with a member function, which cannot be passed directly to the interrupt dispatcher.

Parameters:

[in] ahMyObject The "this->" pointer for the instance of tcDspClk1305G associated with this ISR.

Returns:: 0

void tcDspClk1305G::alarmInterrupt ( void ) [protected]

Interrupt service routine for alarm interrupts.

The ISR reads and disables any pending interrupts. The callback associated with the alarm is activated. The next alarm in the queue (if any) is then scheduled.

"Interrupt-ness" is taken care of by the 'dispatcher' in DSP/BIOS. Installed by the constructor.

void tcDspClk1305G::scheduleAlarm ( void ) [protected]

Internal method used to schedule the next alarm in the queue.

If there is no alarm pending, alarms are left disabled.