mirror of
https://github.com/slsdetectorgroup/slsDetectorPackage.git
synced 2025-04-23 06:50:02 +02:00
88 lines
2.7 KiB
C++
88 lines
2.7 KiB
C++
#ifndef SLS_RECEIVER_USERS_H
|
|
#define SLS_RECEIVER_USERS_H
|
|
|
|
#include <stdio.h>
|
|
#include <stdint.h>
|
|
|
|
|
|
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
|