ARA ROOT Test BEd Software

AraEvent/araStructures.h

Go to the documentation of this file.

#ifndef ARA_STRUCTURES_H
#define ARA_STRUCTURES_H
#include "araDefines.h"

#define ARA_STRUCTURES_VERSION 1

//Enumerations


typedef enum {
    PRI_FORCED = 0,
    PRI_CALIB = 1,
    PRI_1 = 1,
    PRI_2,
    PRI_3,
    PRI_4,
    PRI_TIMEOUT,
    PRI_6, 
    PRI_7,
    PRI_8,
    PRI_PAYLOAD
} PriorityCode;

//Structures


typedef struct {
    unsigned short numBytes;
    unsigned char verId;
  //    unsigned int checksum;
} GenericHeader_t;


typedef struct {

  unsigned char trigType;     
  unsigned short ppsNum;      
  unsigned short deadTime1;   
  unsigned short deadTime2;   
  unsigned short trigPattern; // trigger pattern: bits 0-8 - facet triggers | bit 9 - deep L1 | bit 10 - shallow L1 | bit 11 - unused | bit 12 - global trigger
  unsigned short rovdd[3];    // [0] - LSW of Rb clock counter | [1] - MSW of Rb clock counter | [2] - DAC voltage for LAB C
  unsigned short rcoCount[3]; // RCO counter for LAB chips
} AraTriggerMonitorStruct_t;


typedef struct {

    unsigned char chanId;   // chan+9*LAB3

    unsigned char chipIdFlag; // Bits 0,1 chipNum; Bit 3 hitBus wrap; 4-7 hitBusOff

    unsigned char firstHitbus; // If wrappedHitbus=0 data runs, lastHitbus+1

    unsigned char lastHitbus; //to firstHitbus-1 inclusive

} AraRawRFChannelHeader_t;


typedef struct {
    AraRawRFChannelHeader_t header;
    unsigned short data[MAX_NUMBER_SAMPLES];
} RFChannelFull_t;


typedef struct {
    AraRawRFChannelHeader_t header;
    short xMax;
    short xMin;
    float mean; 
    float rms; 
    short data[MAX_NUMBER_SAMPLES]; 
} RFChannelPedSubbed_t;


typedef struct {
  unsigned short temp[8]; 
} TemperatureDataStruct_t;


typedef struct {
  unsigned short discone[8]; 
  unsigned short batwing[8]; 
} RFPowerDataStruct_t;


typedef struct {
  unsigned short dac[6][4]; 
} DACDataStruct_t;


typedef struct {    
  unsigned short discone[8];
  unsigned short batPlus[8];
  unsigned short batMinus[8];
  unsigned short trigL1[12];
  unsigned short global;
} SimpleScalerStruct_t;





typedef struct {
    unsigned char chanId;   
    unsigned short chipEntries;
    float pedMean[MAX_NUMBER_SAMPLES];
    float pedRMS[MAX_NUMBER_SAMPLES]; 
} LabChipChannelPedStruct_t;


//Telemetry Structs (may be used for onboard storage)


typedef struct {
  unsigned int unixTime;       
  unsigned int unixTimeUs;     


  int gpsSubTime;    
  unsigned int eventNumber;    
  unsigned short calibStatus;   
  unsigned char priority; 


  unsigned char errorFlag; 
  //unsigned char surfSlipFlag; ///< Sync Slip between SURF 2-9 and SURF 1
  
} AraEventHeader_t;



typedef struct {
    GenericHeader_t gHdr;
    unsigned int eventNumber;
    RFChannelFull_t waveform;
} RawWaveformPacket_t;


typedef struct {
    GenericHeader_t gHdr;
    unsigned int eventNumber;
    unsigned int whichPeds;
    RFChannelPedSubbed_t waveform;
} PedSubbedWaveformPacket_t;


typedef struct {
    GenericHeader_t gHdr;
    unsigned int eventNumber;
    RFChannelFull_t waveform[CHANNELS_PER_CHIP];
} RawRFPacket_t;


typedef struct {
    GenericHeader_t gHdr;
    unsigned int eventNumber;
    unsigned int whichPeds;
    RFChannelPedSubbed_t waveform[CHANNELS_PER_CHIP];
} PedSubbedRFPacket_t;



typedef struct {
    GenericHeader_t gHdr;
    unsigned int eventNumber;
} EncodedRFPacketHeader_t;


typedef struct {
    GenericHeader_t gHdr;
    unsigned int eventNumber;
    unsigned int whichPeds;
} BaseWavePacketHeader_t;


typedef struct {    
  TemperatureDataStruct_t temp;
  RFPowerDataStruct_t rfPow;
  DACDataStruct_t dac;
  SimpleScalerStruct_t scaler;
} AraHkDataStruct_t;

typedef struct {
  unsigned int unixTime;
  unsigned int unixTimeUs;
  unsigned int eventNumber;
  unsigned int errorFlag;
} AraHkDataHeader_t;


typedef struct {
    GenericHeader_t gHdr;
    unsigned int unixTimeStart;
    unsigned int unixTimeEnd;
    LabChipChannelPedStruct_t chan[NUM_DIGITIZED_CHANNELS];
} FullLabChipPedStruct_t;


// On-board structs


typedef struct {
  GenericHeader_t gHdr;
  AraEventHeader_t hd;
  //  unsigned int eventNumber;    /* Global event number */
  RFChannelFull_t channel[NUM_DIGITIZED_CHANNELS];
  AraTriggerMonitorStruct_t trig;
  AraHkDataStruct_t hk;
} AraEventBody_t;


typedef struct {
  GenericHeader_t gHdr;
  AraHkDataHeader_t hd;
  AraTriggerMonitorStruct_t trig;
  AraHkDataStruct_t hk;
} AraHkBody_t;



typedef struct {
  GenericHeader_t gHdr;
  unsigned int eventNumber;    /* Global event number */
  unsigned int whichPeds; 
  RFChannelPedSubbed_t channel[NUM_DIGITIZED_CHANNELS];
  AraHkDataStruct_t hk;
} PedSubbedEventBody_t;


typedef struct {
    unsigned int unixTime;
    unsigned int subTime;
} GpsSubTime_t;

//Prioritizer Utility Structs
#ifndef DOXYGEN_SHOULD_SKIP_THIS



typedef struct {
  unsigned short eventLinks[NUM_PRIORITIES]; 
  unsigned short hkLinks[21]; 
} QueueStruct_t;


typedef struct {
  unsigned int utime[NUM_PROCESSES];
  unsigned int stime[NUM_PROCESSES];
  unsigned int vsize[NUM_PROCESSES];
} ProcessInfo_t;



typedef struct {
    GenericHeader_t gHdr;
    unsigned int unixTime; 
    unsigned int eventNumber; 
    unsigned int runNumber; 
} RunStart_t;


// these are syntactic sugar to help us keep track of bit shifts 
typedef int Fixed3_t; 
typedef int Fixed6_t; 
typedef int Fixed8_t; 


/*    FOR THREE STRUCTS THAT FOLLOW
      valid samples==-1 prior to unwinding 
*/


typedef struct {
     int data[MAX_NUMBER_SAMPLES];
     int valid_samples; 
} LogicChannel_t;


typedef struct {
     Fixed3_t data[MAX_NUMBER_SAMPLES];
     Fixed3_t baseline;
     short valid_samples;
} TransientChannel3_t;


typedef struct {
     Fixed6_t data[MAX_NUMBER_SAMPLES];
     short valid_samples;
} TransientChannel6_t;


typedef struct {
     Fixed8_t data[MAX_NUMBER_SAMPLES];
     Fixed8_t baseline;
     short valid_samples;
} TransientChannel8_t;


typedef struct {
     float data[MAX_NUMBER_SAMPLES];
     short valid_samples;
} TransientChannelF_t;


typedef struct {
     float data[MAX_NUMBER_SAMPLES];
     short valid_samples;
     float RMSall;
     float RMSpre;
} TransientChannelFRMS_t;


typedef struct {
     TransientChannel3_t ch[NUM_DIGITIZED_CHANNELS]; 
} AnitaTransientBody3_t; /* final corrected transient type 
                            used to calculate power */

typedef struct {
     TransientChannel6_t ch[NUM_DIGITIZED_CHANNELS]; 
} AnitaPowerBody6_t; /* power from squaring an AnitaTransientBody3 */


typedef struct {
     TransientChannel8_t ch[NUM_DIGITIZED_CHANNELS]; 
} AnitaTransientBody8_t; /* used for pedestal subtraction, unwrapping, 
                            averaging, and gain correction */

typedef struct {
     TransientChannelF_t ch[NUM_DIGITIZED_CHANNELS]; 
} AnitaTransientBodyF_t;


typedef struct {
     TransientChannel6_t S0,S1,S2,S3;
} AnitaStokes6_t;
#endif //DOXYGEN_SHOULD_SKIP_THIS

#endif /* ARA_STRUCTURES_H */

---

UCL HEP Home   

UHE Neutrino Home   

ARA ROOT Software

Main  

Download  

Branches

3.13  

3.12  

3.11  

3.10  

3.9  

3.8  

3.7  

3.6  

3.5  

3.4  

3.3  

3.2  

TestBed