mirror of
https://github.com/slsdetectorgroup/slsDetectorPackage.git
synced 2025-04-23 06:50:02 +02:00
394 lines
8.6 KiB
C++
Executable File
394 lines
8.6 KiB
C++
Executable File
#pragma once
|
|
/********************************************//**
|
|
* @file slsReceiverTCPIPInterface.h
|
|
* @short interface between receiver and client
|
|
***********************************************/
|
|
|
|
|
|
#include "sls_detector_defs.h"
|
|
#include "receiver_defs.h"
|
|
|
|
class MySocketTCP;
|
|
class ServerInterface;
|
|
class slsReceiverImplementation;
|
|
#include "ServerSocket.h"
|
|
|
|
|
|
/**
|
|
*@short interface between receiver and client
|
|
*/
|
|
|
|
class slsReceiverTCPIPInterface : private virtual slsDetectorDefs {
|
|
private:
|
|
enum numberMode {DEC, HEX};
|
|
|
|
public:
|
|
|
|
/** Destructor */
|
|
virtual ~slsReceiverTCPIPInterface();
|
|
|
|
/**
|
|
* Constructor
|
|
* reads config file, creates socket, assigns function table
|
|
* throws an exception in case of failure to construct
|
|
* @param pn port number (defaults to default port number)
|
|
*/
|
|
|
|
slsReceiverTCPIPInterface(int pn=-1);
|
|
|
|
/**
|
|
* Starts listening on the TCP port for client comminication
|
|
\returns OK or FAIL
|
|
*/
|
|
int start();
|
|
|
|
/** stop listening on the TCP & UDP port for client comminication */
|
|
void stop();
|
|
|
|
|
|
/** gets version */
|
|
int64_t getReceiverVersion();
|
|
|
|
//***callback functions***
|
|
/**
|
|
* Call back for start acquisition
|
|
* callback arguments are
|
|
* filepath
|
|
* filename
|
|
* fileindex
|
|
* datasize
|
|
*
|
|
* return value is insignificant at the moment
|
|
* we write depending on file write enable
|
|
* users get data to write depending on call backs registered
|
|
*/
|
|
void registerCallBackStartAcquisition(int (*func)(char*, char*, uint64_t, uint32_t, void*),void *arg);
|
|
|
|
/**
|
|
* Call back for acquisition finished
|
|
* callback argument is
|
|
* total frames caught
|
|
*/
|
|
void registerCallBackAcquisitionFinished(void (*func)(uint64_t, void*),void *arg);
|
|
|
|
/**
|
|
* Call back for raw data
|
|
* args to raw data ready callback are
|
|
* sls_receiver_header frame metadata
|
|
* dataPointer is the pointer to the data
|
|
* dataSize in bytes is the size of the data in bytes.
|
|
*/
|
|
void registerCallBackRawDataReady(void (*func)(char* ,
|
|
char*, uint32_t, void*),void *arg);
|
|
|
|
/**
|
|
* Call back for raw data (modified)
|
|
* args to raw data ready callback are
|
|
* sls_receiver_header frame metadata
|
|
* dataPointer is the pointer to the data
|
|
* revDatasize is the reference of data size in bytes.
|
|
* Can be modified to the new size to be written/streamed. (only smaller value).
|
|
*/
|
|
void registerCallBackRawDataModifyReady(void (*func)(char* ,
|
|
char*, uint32_t &,void*),void *arg);
|
|
|
|
|
|
private:
|
|
|
|
/**
|
|
* Static function - Thread started which is a TCP server
|
|
* Called by start()
|
|
* @param this_pointer pointer to this object
|
|
*/
|
|
static void* startTCPServerThread(void *this_pointer);
|
|
|
|
|
|
/**
|
|
* Thread started which is a TCP server
|
|
* Called by start()
|
|
*/
|
|
void startTCPServer();
|
|
|
|
/** assigns functions to the fnum enum */
|
|
int function_table();
|
|
|
|
/** Decodes Function */
|
|
int decode_function(sls::DataSocket &socket);
|
|
|
|
/** function not implemented for specific detector */
|
|
void functionNotImplemented();
|
|
|
|
/** mode not implemented for specific detector */
|
|
void modeNotImplemented(std::string modename, int mode);
|
|
|
|
/** validate and set error */
|
|
template <typename T>
|
|
void validate(T arg, T retval, std::string modename, numberMode hex);
|
|
|
|
/** Unrecognized Function */
|
|
int M_nofunc(sls::DataSocket & socket);
|
|
|
|
|
|
|
|
/** Execute command */
|
|
int exec_command();
|
|
|
|
/** Exit Receiver Server */
|
|
int exit_server();
|
|
|
|
/** Locks Receiver */
|
|
int lock_receiver();
|
|
|
|
/** Get Last Client IP*/
|
|
int get_last_client_ip();
|
|
|
|
/** Set port */
|
|
int set_port();
|
|
|
|
/** Updates Client if different clients connect */
|
|
int update_client();
|
|
|
|
/** Sends the updated parameters to client */
|
|
int send_update();
|
|
|
|
/** get version, calls get_version */
|
|
int get_id();
|
|
|
|
/** Set detector type */
|
|
int set_detector_type();
|
|
|
|
/** set detector hostname */
|
|
int set_detector_hostname();
|
|
|
|
/** set roi */
|
|
int set_roi();
|
|
|
|
/** Set up UDP Details */
|
|
int setup_udp();
|
|
|
|
/** set acquisition period, frame number etc */
|
|
int set_timer();
|
|
|
|
/** set dynamic range */
|
|
int set_dynamic_range();
|
|
|
|
/** Sets the receiver streaming frequency */
|
|
int set_streaming_frequency();
|
|
|
|
/** Gets receiver status */
|
|
int get_status();
|
|
|
|
/** Start Receiver - starts listening to udp packets from detector */
|
|
int start_receiver();
|
|
|
|
/** Stop Receiver - stops listening to udp packets from detector*/
|
|
int stop_receiver();
|
|
|
|
/** Set File path */
|
|
int set_file_dir();
|
|
|
|
/** Set File name without frame index, file index and extension */
|
|
int set_file_name();
|
|
|
|
/** Set File index */
|
|
int set_file_index();
|
|
|
|
/** Gets frame index for each acquisition */
|
|
int get_frame_index();
|
|
|
|
/** Gets Total Frames Caught */
|
|
int get_frames_caught();
|
|
|
|
/** Resets Total Frames Caught */
|
|
int reset_frames_caught();
|
|
|
|
/** Enable File Write*/
|
|
int enable_file_write();
|
|
|
|
/** Enable Master File Write */
|
|
int enable_master_file_write();
|
|
|
|
/** enable compression */
|
|
int enable_compression();
|
|
|
|
/** enable overwrite */
|
|
int enable_overwrite();
|
|
|
|
/** enable 10Gbe */
|
|
int enable_tengiga();
|
|
|
|
/** set fifo depth */
|
|
int set_fifo_depth();
|
|
|
|
/** activate/ deactivate */
|
|
int set_activate();
|
|
|
|
/* Set the data stream enable */
|
|
int set_data_stream_enable();
|
|
|
|
/** Sets the steadming timer when frequency is set to 0 */
|
|
int set_streaming_timer();
|
|
|
|
/** enable flipped data */
|
|
int set_flipped_data();
|
|
|
|
/** set file format */
|
|
int set_file_format();
|
|
|
|
/** set position id */
|
|
int set_detector_posid();
|
|
|
|
/** set multi detector size */
|
|
int set_multi_detector_size();
|
|
|
|
/** set streaming port */
|
|
int set_streaming_port();
|
|
|
|
/** set streaming source ip */
|
|
int set_streaming_source_ip();
|
|
|
|
/** set silent mode */
|
|
int set_silent_mode();
|
|
|
|
/** enable gap pixels */
|
|
int enable_gap_pixels();
|
|
|
|
/** restream stop packet */
|
|
int restream_stop();
|
|
|
|
/** set additional json header */
|
|
int set_additional_json_header();
|
|
|
|
/** get additional json header */
|
|
int get_additional_json_header();
|
|
|
|
/** set udp socket buffer size */
|
|
int set_udp_socket_buffer_size();
|
|
|
|
/** get real udp socket buffer size */
|
|
int get_real_udp_socket_buffer_size();
|
|
|
|
/** set frames per file */
|
|
int set_frames_per_file();
|
|
|
|
/** check version compatibility */
|
|
int check_version_compatibility();
|
|
|
|
/** set frame discard policy */
|
|
int set_discard_policy();
|
|
|
|
/** set partial frame padding enable*/
|
|
int set_padding_enable();
|
|
|
|
/** set deactivated receiver padding enable */
|
|
int set_deactivated_padding_enable();
|
|
|
|
/** set readout flags */
|
|
int set_readout_flags();
|
|
|
|
/** set adc mask */
|
|
int set_adc_mask();
|
|
|
|
/** set receiver dbit list */
|
|
int set_dbit_list();
|
|
|
|
/** get receiver dbit list */
|
|
int get_dbit_list();
|
|
|
|
/** set dbit offset */
|
|
int set_dbit_offset();
|
|
|
|
|
|
/** detector type */
|
|
detectorType myDetectorType;
|
|
|
|
/** slsReceiverBase object */
|
|
slsReceiverImplementation *receiver;
|
|
|
|
/** Function List */
|
|
int (slsReceiverTCPIPInterface::*flist[NUM_REC_FUNCTIONS])();
|
|
|
|
/** Message */
|
|
char mess[MAX_STR_LENGTH];
|
|
|
|
/** success/failure */
|
|
int ret;
|
|
|
|
/** function index */
|
|
int fnum;
|
|
|
|
/** Lock Status if server locked to a client */
|
|
int lockStatus;
|
|
|
|
/** kill tcp server thread */
|
|
int killTCPServerThread;
|
|
|
|
/** thread for TCP server */
|
|
pthread_t TCPServer_thread;
|
|
|
|
/** tcp thread created flag*/
|
|
bool tcpThreadCreated;
|
|
|
|
/** port number */
|
|
int portNumber;
|
|
|
|
//***callback parameters***
|
|
/**
|
|
* Call back for start acquisition
|
|
* callback arguments are
|
|
* filepath
|
|
* filename
|
|
* fileindex
|
|
* datasize
|
|
*
|
|
* return value is insignificant at the moment
|
|
* we write depending on file write enable
|
|
* users get data to write depending on call backs registered
|
|
*/
|
|
int (*startAcquisitionCallBack)(char*, char*, uint64_t, uint32_t, void*);
|
|
void *pStartAcquisition;
|
|
|
|
/**
|
|
* Call back for acquisition finished
|
|
* callback argument is
|
|
* total frames caught
|
|
*/
|
|
void (*acquisitionFinishedCallBack)(uint64_t, void*);
|
|
void *pAcquisitionFinished;
|
|
|
|
|
|
/**
|
|
* Call back for raw data
|
|
* args to raw data ready callback are
|
|
* sls_receiver_header frame metadata
|
|
* dataPointer is the pointer to the data
|
|
* dataSize in bytes is the size of the data in bytes.
|
|
*/
|
|
void (*rawDataReadyCallBack)(char* ,
|
|
char*, uint32_t, void*);
|
|
|
|
/**
|
|
* Call back for raw data (modified)
|
|
* args to raw data ready callback are
|
|
* sls_receiver_header frame metadata
|
|
* dataPointer is the pointer to the data
|
|
* revDatasize is the reference of data size in bytes. Can be modified to the new size to be written/streamed. (only smaller value).
|
|
*/
|
|
void (*rawDataModifyReadyCallBack)(char* ,
|
|
char*, uint32_t &, void*);
|
|
|
|
void *pRawDataReady;
|
|
|
|
|
|
|
|
protected:
|
|
|
|
/** Socket */
|
|
MySocketTCP* mySock;
|
|
|
|
std::unique_ptr<sls::ServerSocket> server{nullptr};
|
|
|
|
/** client interface */
|
|
ServerInterface* interface;
|
|
};
|