/* * Timing.h * MPSLinkProcessor * * Created by Stephen Norum. * Copyright 2007 Stanford Linear Accelerator Center. All rights reserved. * */ #ifndef TIMING_H #define TIMING_H #ifdef __cplusplus extern "C" { #endif #include #include #if 0 #pragma mark - #pragma mark Constants #endif /**************************************************************************************** * Constants ***************************************************************************************/ #define MPSTimingInverseOf360Hz ((double) 1.0 / (double) 360) #define MPSTimingTimestampContinuityRangeLow (MPSTimingInverseOf360Hz - 0.2e-3) #define MPSTimingTimestampContinuityRangeHigh (1.0) #define MPSTimingEvrTimeoutInSeconds (0.04) enum MPSTimingValues { MPSTimingTimeslotCount = 6, /* Number of possible timestamps */ MPSTimingTimeslotNumberMin = 1, /* Minimum timestamp value */ MPSTimingTimeslotNumberMax = 6, /* Maximum timestamp value */ MPSTimingMaxNumberOfRelevantTimestamps = 3, /* The max number of old of timestamps considered valid by the MPS (past events) */ MPSTimingMaxNumberOfPipelinedValidTimestamps = 3, /* The max number of valid timestamps that will be queued */ MPSTimingMaxTimingDataQueueLength = 3 /* The max timing data queue length (current and future events) */ }; enum MPSTimingIndices { MPSTimingIndexCurrent = 0, MPSTimingIndexNext = 1, MPSTimingIndexAfterNext = 2 }; #if 0 #pragma mark - #pragma mark Structures #endif /**************************************************************************************** * Structures ***************************************************************************************/ struct MPSTimingDataStruct { epicsTimeStamp timestamp; epicsUInt32 pulseid; epicsUInt8 timeslot; epicsUInt8 beamRequested; epicsUInt8 burstPulseRequested; epicsUInt8 baseRate120Hz; epicsUInt8 baseRate60Hz; epicsUInt8 baseRate30Hz; epicsUInt8 baseRate10Hz; epicsUInt8 baseRate1Hz; }; typedef struct MPSTimingDataStruct MPSTimingData; struct MPSTimingDataNodeStruct { struct MPSTimingDataNodeStruct *prev; struct MPSTimingDataNodeStruct *next; MPSTimingData timingData; }; typedef struct MPSTimingDataNodeStruct MPSTimingDataNode; struct MPSTimingTimeslotsStruct { unsigned char baseRate120HzTimeslot1; unsigned char baseRate120HzTimeslot2; unsigned char baseRate60HzTimeslot; }; typedef struct MPSTimingTimeslotsStruct MPSTimingTimeslots; #if 0 #pragma mark - #pragma mark Prototypes #endif /**************************************************************************************** * Prototypes ***************************************************************************************/ int mpsPrintTimingData(MPSTimingData *td, unsigned int n); int setTimingDataToWorstCase(MPSTimingData *timingData); int mpsSetLclsTimeslots(epicsUInt8 baseRate120HzTimeslot1, epicsUInt8 baseRate120HzTimeslot2, epicsUInt8 baseRate60HzTimeslot); int intializeTiming(); int mpsSetTimingVerbosity(unsigned int newVerbosityLevel); int lockTimingMutexAndReturnIsRecentTimestamp(const epicsTimeStamp *aTimestamp); int updateRelevantTimestamps(epicsTimeStamp timestampeQueue[], epicsUInt8 timeslotQueue[]); int getTimeslotPipelineWithBeamRequests(epicsUInt8 *timeslots, epicsUInt8 *beamRequests); int getCurrentTimingData(MPSTimingData *data); int lockTimingMutexAndGetCurrentTimingData(MPSTimingData *data); int mpsTimingIsStable(epicsUInt32 *val); int mpsTimingSourceIsEvg(epicsUInt32 *val); #ifdef __cplusplus } #endif #endif