mirror of
https://github.com/slsdetectorgroup/slsDetectorPackage.git
synced 2025-04-25 15:50:03 +02:00
05f657c106
- removed getClientServerAPIVersion in server (not used) - removed rxr side (clientversion compatibility check), removed enum as well as it is now done on the client side. - versionAPI.h - GITBRANCH changed to RELEASE - dates for all API changed to "sem_version date". Scripts to compile servers modified for this. Empty "branch" name will end up with developer for sem_version. - Version class with constructor taking in the long version (APILIB date). Other member functions including concise(to get sem_version for new releases and date for old releases), - bypassing initial tests, also now bypasses the client-rxr compatibility check (at rx_hostname command) - previously, compatibility between client-det was ensuring both had the same detector API (eg. same APIJUNGFRAU) - Now, compatibility only checks APILIB (client side) and detector API(eg. APIJUNGFRAU) (detector side) have same major version. It only does backward compatibility test. Rest is upto user to ensure. - If server is from an older release, it will compare dates like previous implementation (APIJUNGFRAU from both client and det) - - previously, compatibility between client-rxr was ensuring both had the same APIRECEIVER - Now, compatibility only checks APILIB (client side) and APIRECEIVER (rxr side) have same major version. It only does backward compatibility test. Rest is upto user to ensure. - If rxr is from an older release, it will compare dates like previous implementation (APIRECEIVER from both client and rxr) - removed APIGUI, evalVersionVariables.sh, genVersionHeader.sh (not needed or not used) - clientVersion, rxrversion and detectorserverversion all return strings and not integers (in hex) anymore. Depending if it has semantic versioning, it will print that or the date if it is too old. - fixed in python (strings for versions) - check_version function in detector server changed to "initial checks" as it only checks server-firmware compatibility and initial server checks. Client compatibilities are moved to client side. - --version gives sem_version and date? Is date needed as well. The clientversion, detserverversion and rxrversion API gives only sem_version (no date) - - formatting
93 lines
2.9 KiB
C++
93 lines
2.9 KiB
C++
// SPDX-License-Identifier: LGPL-3.0-or-other
|
|
// Copyright (C) 2021 Contributors to the SLS Detector Package
|
|
#pragma once
|
|
#include "sls/sls_detector_defs.h"
|
|
#include <memory>
|
|
|
|
namespace sls {
|
|
|
|
class ClientInterface;
|
|
|
|
class Receiver : private virtual slsDetectorDefs {
|
|
|
|
public:
|
|
/**
|
|
* Constructor
|
|
* Starts up a Receiver server. Reads configuration file, options, and
|
|
* assembles a Receiver using TCP and UDP detector interfaces
|
|
* throws an exception in case of failure
|
|
* @param argc from command line
|
|
* @param argv from command line
|
|
*/
|
|
Receiver(int argc, char *argv[]);
|
|
|
|
/**
|
|
* Constructor
|
|
* Starts up a Receiver server. Reads configuration file, options, and
|
|
* assembles a Receiver using TCP and UDP detector interfaces
|
|
* throws an exception in case of failure
|
|
* @param tcpip_port_no TCP/IP port number
|
|
*/
|
|
Receiver(int tcpip_port_no = 1954);
|
|
|
|
~Receiver();
|
|
|
|
/**
|
|
* get get Receiver Version
|
|
\returns id
|
|
*/
|
|
std::string getReceiverVersion();
|
|
|
|
/**
|
|
* Start Acquisition Call back (slsMultiReceiver writes data if file write
|
|
* enabled) if registerCallBackRawDataReady or
|
|
* registerCallBackRawDataModifyReady registered, users get data callback
|
|
* arguments are:
|
|
* - file path
|
|
* - file name prefix
|
|
* - file index
|
|
* - image size in bytes
|
|
*/
|
|
void registerCallBackStartAcquisition(int (*func)(const std::string &,
|
|
const std::string &,
|
|
uint64_t, size_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,
|
|
* - pointer to data
|
|
* - image size in bytes
|
|
*/
|
|
void registerCallBackRawDataReady(void (*func)(sls_receiver_header &,
|
|
char *, size_t, void *),
|
|
void *arg);
|
|
|
|
/**
|
|
* Call back for raw data (modified)
|
|
* args to raw data ready callback are:
|
|
* - sls_receiver_header frame metadata,
|
|
* - pointer to data
|
|
* - revDatasize is the reference of data size in bytes.
|
|
* Can be modified to the new size to be written/streamed. (only smaller
|
|
* value allowed).
|
|
*/
|
|
void registerCallBackRawDataModifyReady(void (*func)(sls_receiver_header &,
|
|
char *, size_t &,
|
|
void *),
|
|
void *arg);
|
|
|
|
private:
|
|
std::unique_ptr<ClientInterface> tcpipInterface;
|
|
};
|
|
|
|
} // namespace sls
|