Main Page | Modules | Alphabetical List | Data Structures | Directories | File List | Data Fields | Globals | Related Pages | Search for 
examples / eventbuilder

ebuser.c File Reference

Detailed Description

The Event builder user file

Definition in file ebuser.c.

Go to the source code of this file.

Functions

INT eb_begin_of_run (INT, char *, char *)
INT eb_end_of_run (INT, char *)
INT eb_user (INT nfrag, BOOL mismatch, EBUILDER_CHANNEL *ebch, EVENT_HEADER *pheader, void *pevent, INT *dest_size)

Variables

INT lModulo = 100

Function Documentation

INT eb_begin_of_run (  INT  rn,
char *  UserField,
char *  error
) 
 

Hook to the event builder task at PreStart transition.

Parameters:
rn run number
UserField argument from /Ebuilder/Settings
error error string to be passed back to the system.
Returns:
EB_SUCCESS

Referenced by tr_start().

INT eb_end_of_run (  INT  rn,
char *  error
) 
 

Hook to the event builder task at completion of event collection after receiving the Stop transition.

Parameters:
rn run number
error error string to be passed back to the system.
Returns:
EB_SUCCESS

Referenced by close_buffers().

INT eb_user (  INT  nfrag,
BOOL  mismatch,
EBUILDER_CHANNEL *  ebch,
EVENT_HEADER *  pheader,
void *  pevent,
INT *  dest_size
) 
 

Hook to the event builder task after the reception of all fragments of the same serial number. The destination event has already the final EVENT_HEADER setup with the data size set to 0. It is than possible to add private data at this point using the proper bank calls.

The ebch[] array structure points to nfragment channel structure with the following content: 

typedef struct {
    char  name[32];         // Fragment name (Buffer name).
    DWORD serial;           // Serial fragment number.
    char *pfragment;        // Pointer to fragment (EVENT_HEADER *)
    ...
} EBUILDER_CHANNEL;

The correct code for including your own MIDAS bank is shown below where TID_xxx is one of the valid Bank type starting with TID_ for midas format or xxx_BKTYPE for Ybos data format. bank_name is a 4 character descriptor. pdata has to be declared accordingly with the bank type. Refers to the ebuser.c source code for further description.

It is not possible to mix within the same destination event different event format! 

  // Event is empty, fill it with BANK_HEADER
  // If you need to add your own bank at this stage

  bk_init(pevent);
  bk_create(pevent, bank_name, TID_xxxx, &pdata);
  *pdata++ = ...;
  *dest_size = bk_close(pevent, pdata);
  pheader->data_size = *dest_size + sizeof(EVENT_HEADER);

For YBOS format, use the following example.

  ybk_init(pevent);
  ybk_create(pevent, "EBBK", I4_BKTYPE, &pdata);
  *pdata++ = 0x12345678;
  *pdata++ = 0x87654321;
  *dest_size = ybk_close(pevent, pdata);
  *dest_size *= 4;
  pheader->data_size = *dest_size + sizeof(YBOS_BANK_HEADER);
Parameters:
nfrag Number of fragment.
mismatch Midas Serial number mismatch flag.
ebch Structure to all the fragments.
pheader Destination pointer to the header.
pevent Destination pointer to the bank header.
dest_size Destination event size in bytes.
Returns:
EB_SUCCESS

Definition at line 187 of file ebuser.c.

Referenced by source_scan().

INT ebuilder_exit (   ) 
 

INT ebuilder_init (   ) 
 

INT ebuilder_loop (   ) 
 

INT ebuser (  INT  ,
BOOL  mismatch,
EBUILDER_CHANNEL *  ,
EVENT_HEADER *  ,
void *  ,
INT * 
) 
 

INT read_scaler_event (  char *  pevent,
INT  off
) 
 

Definition at line 346 of file frontend.c.

Variable Documentation

BOOL debug
 

Definition at line 68 of file mfe.c.

INT display_period = 3000
 

Definition at line 32 of file ebuser.c.

EBUILDER_SETTINGS ebset
 

Definition at line 28 of file mevb.c.

Referenced by eb_user(), handFlush(), main(), source_booking(), source_scan(), and tr_start().

BOOL ebuilder_call_loop = FALSE
 

Definition at line 29 of file ebuser.c.

EQUIPMENT equipment[]
 

Initial value:

 {
   {"EB",                
    {1, 0,                   
     "SYSTEM",               
     0,                      
     0,                      
     "MIDAS",                
     TRUE,                   
     },
    },

  {""}
}

Definition at line 59 of file ebuser.c.

INT event_buffer_size = 10 * 10000
 

Definition at line 41 of file ebuser.c.

char* frontend_file_name = __FILE__
 

Definition at line 26 of file ebuser.c.

char* frontend_name = "Ebuilder"
 

Definition at line 23 of file ebuser.c.

INT lModulo = 100
 

Global var for testing passed at BOR.

Globals

Definition at line 45 of file ebuser.c.

Referenced by eb_begin_of_run().

INT max_event_size = 10000
 

Definition at line 35 of file ebuser.c.

INT max_event_size_frag = 5 * 1024 * 1024
 

Definition at line 38 of file ebuser.c.

Midas DOC Version 1.9.5 ---- PSI Stefan Ritt ----
Contributions: Pierre-Andre Amaudruz - Sergio Ballestrero - Suzannah Daviel - Doxygen - Peter Green - Qing Gu - Greg Hackman - Gertjan Hofman - Paul Knowles - Rudi Meier - Glenn Moloney - Dave Morris - John M O'Donnell - Konstantin Olchanski - Renee Poutissou - Tamsen Schurman - Andreas Suter - Jan M.Wouters - Piotr Adam Zolnierczuk