---

GLAST/LAT > DAQ and FSW > FSW > Doxygen Index > LCI / dev

Constituent: lci     Tag: mcp750

---

         

---

cue.c File Reference

Routines that act upon the cue structure. More...

#include "LCI/LCI_msgs.h"
#include "cue_p.h"
#include "LEM/msg_macros.h"
#include "MSG/MSG_pubdefs.h"
#include "PBS/MBA.h"
#include "PBS/WUT.h"
#include "PBS/SEM.h"
#include <string.h>

Include dependency graph for cue.c:

Functions
static WUT_cb_status	cue_wut_cb (void *prm, WUT_tmr *wut)
	Timer callback.
LCI_cue *	LCI_newCue (void)
	Create a new cue.
unsigned	LCI_deleteCue (LCI_cue *cue)
	Delete a cue.
void	LCI_clearCue (LCI_cue *cue)
	Clear a cue.
unsigned	LCI_waitCue (LCI_cue *cue, unsigned timeout)
	Wait for a cue to complete or time out.
void	LCI_signalCue (LCI_cue *cue)
	Signal cue completion.
void	LCI_clearCueCounts (LCI_cue *cue)
	Clear cue counters.
void	LCI_getCueCounts (LCI_cue *cue, unsigned int *nWait, unsigned int *nSignal, unsigned int *nTimeout)
	Get cue counters.

---

Detailed Description

Routines that act upon the cue structure.

Author:

James Swain & Owen Saxton

The order of calling the functions presented here should be LCI_newCue LCI_clearCue --> LCI_waitCue --> In another task --> LCI_signalCue : Repeat as necessary : LCI_deleteCue

Id

cue.c,v 1.3 2007/04/17 22:57:54 saxton Exp

---

Function Documentation

WUT_cb_status cue_wut_cb (  void *  prm, WUT_tmr *  wut )  [static]

Timer callback. This routine is called back when the wake-up timer goes off. It sets the end state to LCI_CUE_TIMEDOUT and gives the semaphore Parameters: prm  Pointer to the LCI_cue structure wut  Pointer to the wake-up timer Return values: WUT_K_STATE_CHANGE_YES

void LCI_clearCue (  LCI_cue *  cue  )

Clear a cue. This routine puts the cue into a known cleared state, ready for the next wait. Parameters: cue  Pointer to an allocated, initialised cue structure (from LCI_newCue)

void LCI_clearCueCounts (  LCI_cue *  cue  )

Clear cue counters. This routine zeroes the counts of waits, signals and timeouts. Parameters: cue  Pointer to a cue being used.

unsigned LCI_deleteCue (  LCI_cue *  cue  )

Delete a cue. This routine destroys the semaphore and wake-up timer and then frees the memory associated with the cue structure Parameters: cue  Pointer to an initialised cue structure (make sure that it is not currently running!) Return values: LCI_SUCCESS  if all goes well LCI_WUTDFAIL  if the wake-up timer could not be destroyed, because it was in a bad state

void LCI_getCueCounts (  LCI_cue *  cue, unsigned int *  nWait, unsigned int *  nSignal, unsigned int *  nTimeout )

Get cue counters. This routine obtains the counts of waits, signals and timeouts since the last time the cue was cleared. Parameters: cue  Pointer to a cue being used. nWait  Address of an integer to receive the number of wait calls, or NULL if not needed. nSignal  Address of an integer to receive the number of signal calls, or NULL if not needed. nTimeout  Address of an integer to receive the number of timeouts, or NULL if not needed.

LCI_cue* LCI_newCue (  void   )

Create a new cue. This routine allocates memory for the cue structure then creates the timer and semaphore to be held by the structure Returns: Pointer to an allocated and initialised cue structure, or NULL if there is an error.

void LCI_signalCue (  LCI_cue *  cue  )

Signal cue completion. This routine signals completion by setting the end state to LCI_CUE_SIGNALED and giving the semaphore Parameters: cue  Pointer to a cue that is being waited upon

unsigned LCI_waitCue (  LCI_cue *  cue, unsigned  timeout )

Wait for a cue to complete or time out. This routine starts the wake-up timer and takes the semaphore Parameters: cue  Pointer to an allocated, initialised cue structure (from LCI_newCue) timeout  Time, in microseconds, until the call times out. Return values: LCI_CUE_SIGNALED  Another task called signal LCI_CUE_TIMEDOUT  If the timer expired before the cue was signalled. LCI_CUE_FAILED  Timer failed to start (because of incorrect state)

---