#ifndef SLS_RECEIVER_USERS_H #define SLS_RECEIVER_USERS_H #include #include class slsReceiver; /** @short Class for implementing the SLS data receiver in the users application. Callbacks can be defined for processing and/or saving data */ /** @libdoc slsReceiverUsers is a class that can be instantiated in the users software to receive the data from the detectors. Callbacks can be defined for processing and/or saving data ***********************************************/ class slsReceiverUsers { public: /** * Constructor * reads config file, creates socket, assigns function table * @param argc from command line * @param argv from command line * @param succecc socket creation was successfull */ slsReceiverUsers(int argc, char *argv[], int &success); /** Destructor */ ~slsReceiverUsers(); /** Close File and exits receiver server */ void closeFile(int p); /** * starts listening on the TCP port for client comminication \return 0 for success or 1 for FAIL in creating TCP server */ int start(); /** stops listening to the TCP & UDP port and exit receiver program*/ void stop(); /** get get Receiver Version \returns id */ int64_t getReceiverVersion(); /** @sort register calbback for starting the acquisition \param func callback to be called when starting the acquisition. Its arguments are filepath, filename, fileindex, datasize \returns 0 callback takes care of open,close,write file; 1 callback writes file, we have to open, close it; 2 we open, close, write file, callback does not do anything */ void registerCallBackStartAcquisition(int (*func)(char* filepath, char* filename, uint64_t fileindex, uint32_t datasize, void*),void *arg); /** @sort register callback for end of acquisition \param func end of acquisition callback. Argument nf is total frames caught \returns nothing */ void registerCallBackAcquisitionFinished(void (*func)(uint64_t nf, void*),void *arg); /** @sort register callback to be called when data are available (to process and/or save the data). \param func raw data ready callback. arguments are frameNumber, expLength, packetNumber, bunchId, timestamp, modId, xCoord, yCoord, zCoord, debug, roundRNumber, detType, version, dataPointer, dataSize, fileDescriptor \returns nothing */ void registerCallBackRawDataReady(void (*func)(uint64_t frameNumber, uint32_t expLength, uint32_t packetNumber, uint64_t bunchId, uint64_t timestamp, uint16_t modId, uint16_t xCoord, uint16_t yCoord, uint16_t zCoord, uint32_t debug, uint16_t roundRNumber, uint8_t detType, uint8_t version, char* datapointer, uint32_t datasize, FILE* filedescriptor, void*),void *arg); //receiver object slsReceiver* receiver; }; #endif