diff --git a/slsDetectorSoftware/.gitignore b/slsDetectorSoftware/.gitignore index 752a00776..6a4d1707d 100644 --- a/slsDetectorSoftware/.gitignore +++ b/slsDetectorSoftware/.gitignore @@ -1,3 +1,4 @@ *.o *~ -#*# \ No newline at end of file +#*# +slsDetectorClientDocs/ diff --git a/slsDetectorSoftware/slsDetector/slsDetectorCommand.cpp b/slsDetectorSoftware/slsDetector/slsDetectorCommand.cpp index ddabd858c..4bfdcc268 100644 --- a/slsDetectorSoftware/slsDetector/slsDetectorCommand.cpp +++ b/slsDetectorSoftware/slsDetector/slsDetectorCommand.cpp @@ -1635,21 +1635,21 @@ slsDetectorCommand::slsDetectorCommand(slsDetectorUtils *det) { /* settings dump/retrieve */ /*! \page config - - rx_printconfig prints the receiver configuration. Only get!" + - rx_printconfig prints the receiver configuration. Only get! */ descrToFuncMap[i].m_pFuncName="rx_printconfig"; descrToFuncMap[i].m_pFuncPtr=&slsDetectorCommand::cmdConfiguration; i++; /*! \page config - - parameters [fname] sets/saves detector parameters contained in fname. Normally once per different measurement." + - parameters [fname] sets/saves detector parameters contained in fname. Normally once per different measurement. */ descrToFuncMap[i].m_pFuncName="parameters"; descrToFuncMap[i].m_pFuncPtr=&slsDetectorCommand::cmdConfiguration; i++; /*! \page config - - setup [fname] sets/saves detector complete setup contained in fname (extensions automatically generated), including trimfiles, ff coefficients etc." + - setup [fname] sets/saves detector complete setup contained in fname (extensions automatically generated), including trimfiles, ff coefficients etc. */ descrToFuncMap[i].m_pFuncName="setup"; descrToFuncMap[i].m_pFuncPtr=&slsDetectorCommand::cmdConfiguration; @@ -1659,52 +1659,86 @@ slsDetectorCommand::slsDetectorCommand(slsDetectorUtils *det) { /* receiver functions */ /*! \page receiver Receiver commands - Commands to configure the receiver + Commands to configure the receiver. Not used in MYTHEN. + */ + + /*! \page receiver + - receiver [s] starts/stops the receiver to listen to detector packets. Gets status of receiver. Options: [start, stop]. */ descrToFuncMap[i].m_pFuncName="receiver"; descrToFuncMap[i].m_pFuncPtr=&slsDetectorCommand::cmdReceiver; i++; + /*! \page receiver + - r_online [i] sets/gets the receiver in online/offline mode. 1 is online, 0 is offline. Get is from shared memory. + */ descrToFuncMap[i].m_pFuncName="r_online"; descrToFuncMap[i].m_pFuncPtr=&slsDetectorCommand::cmdOnline; i++; - descrToFuncMap[i].m_pFuncName="r_checkonline"; - descrToFuncMap[i].m_pFuncPtr=&slsDetectorCommand::cmdOnline; + /*! \page receiver + - r_checkonline Checks the receiver if it is online/offline mode. Prints either 'All receiver online', '[List of all receiver hostname in offline mode] :Not all receiver online'. Only get! i++; + /*! \page receiver + - framescaught gets the number of frames caught by receiver. Average of all for multi-detector command. Only get! + */ descrToFuncMap[i].m_pFuncName="framescaught"; descrToFuncMap[i].m_pFuncPtr=&slsDetectorCommand::cmdReceiver; i++; + /*! \page receiver + - resetframescaught [i] resets the number of frames caught to 0. i can be any number. Use this if using status start, instead of acquire (this command is included). Only put! + */ descrToFuncMap[i].m_pFuncName="resetframescaught"; descrToFuncMap[i].m_pFuncPtr=&slsDetectorCommand::cmdReceiver; i++; + /*! \page receiver + - frameindex [i] gets the current frame index of receiver. Average of all for multi-detector command. Only get! + */ descrToFuncMap[i].m_pFuncName="frameindex"; descrToFuncMap[i].m_pFuncPtr=&slsDetectorCommand::cmdReceiver; i++; + /*! \page receiver + - r_lock [i] locks/unlocks the receiver to communicate with only this client. 1 locks, 0 unlocks. + */ descrToFuncMap[i].m_pFuncName="r_lock"; // descrToFuncMap[i].m_pFuncPtr=&slsDetectorCommand::cmdLock; i++; + /*! \page receiver + - r_lastclient gets the last client communicating with the receiver. Only get! + */ descrToFuncMap[i].m_pFuncName="r_lastclient"; // descrToFuncMap[i].m_pFuncPtr=&slsDetectorCommand::cmdLastClient; i++; + /*! \page receiver + - r_readfreq [i] sets/gets the stream frequency of data from receiver to client. i > 0 is the nth frame being streamed. 0 sets frequency to a default timer (200ms). + */ descrToFuncMap[i].m_pFuncName="r_readfreq"; // descrToFuncMap[i].m_pFuncPtr=&slsDetectorCommand::cmdReceiver; i++; + /*! \page test + - r_compression [i] sets/gets compression in receiver. 1 sets, 0 unsets. Not implemented. + */ descrToFuncMap[i].m_pFuncName="r_compression"; // descrToFuncMap[i].m_pFuncPtr=&slsDetectorCommand::cmdReceiver; i++; + /*! \page config + - tengiga [i] enables/disables 10GbE in system (detector & receiver). 1 enabled 10GbE, 0 enables 1GbE. Used in EIGER only. + */ descrToFuncMap[i].m_pFuncName="tengiga"; // descrToFuncMap[i].m_pFuncPtr=&slsDetectorCommand::cmdReceiver; i++; + /*! \page receiver + - rx_fifodepth [i] sets/gets receiver fifo (between Listener and Writer Threads) depth to i number of frames. Can improve listener packet loss, not if limited by writing. + */ descrToFuncMap[i].m_pFuncName="rx_fifodepth"; // descrToFuncMap[i].m_pFuncPtr=&slsDetectorCommand::cmdReceiver; i++; diff --git a/slsDetectorSoftware/slsDetectorClientDocs/html/acquisition.html b/slsDetectorSoftware/slsDetectorClientDocs/html/acquisition.html deleted file mode 100644 index a96418f67..000000000 --- a/slsDetectorSoftware/slsDetectorClientDocs/html/acquisition.html +++ /dev/null @@ -1,85 +0,0 @@ - - - -
- -Commands to control the acquisition
-returns
the detector status (string)- can be: running
, error
, transmitting
, finished
, waiting
or idle
; put
can be start
or stop
1
if the acquisition is active, 0
otherwise. Works when the acquisition is started in non-blocking mode. Only get!Commands to define scripts to be executed during the acquisition flow
-none
unsets.none
unsets.none
unsets.none
unsets.none
unsets.none
unsets.none
unsets.none
unsets.This page is for advanced users. Make sure you have first read the introduction.
-Commands to configure the detector. these commands are often left to the configuration file.
-put
argument is the hostname or IP adress. Returns the chained list of detector hostnames.i
from the multi-detector structure. Can be used for partial readout of the detector.put
adds the hostname (ot IP adress) at the end of the multi-detector structure. If used for a single controlled (i:) replaces the current hostname. Returns the list of the hostnames of the multi-detector structure.put
, configures the id of the detector structure. i is the detector position in a multi detector system and l is the id of the detector to be added.put
sets the position of the master of the acquisition (-1 if none). Returns the position of the master of the detector structure (-1 if none).none
, gating
, trigger
, complementary
. Mainly used by MYTHEN/GOTTHARD.off
, gate_in_active_high
, gate_in_active_low
, trigger_in_rising_edge
, trigger_in_falling_edge
, ro_trigger_in_rising_edge
, ro_trigger_in_falling_edge
, gate_out_active_high
, gate_out_active_low
, trigger_out_rising_edge
, trigger_out_falling_edge
, ro_trigger_out_rising_edge
, ro_trigger_out_falling_edge
. timing
is not auto
, then it is the number of frames per cycle/trigger.Commands to setup the data processing (mainly MYTHEN related)
-put
sets flatfield file to fn
(relative to ffdir
). returns the flatfield file name relative to ffdir
(string). Ifput
sets the deadtime correction constant in ns, -1 will set it to default tau of settings (0 unset).put
sets the badchannels file to fn
. returns the bad channels file name. Ifput
sets the angular conversion file to fn
. returns the angular conversion file name. IfThis program is intended to control the SLS detectors via command line interface. This is the only way to access all possible functionality of the detectors, however it is often recommendable to avoid changing the most advanced settings, rather leaving the task to configuration files, as when using the GUI or the API provided.
-The command line interface consists in four main functions:
-If you need control a single detector, the use of the command line interface does not need any additional arguments.
-For commands addressing a single controller of your detector, the command cmd should be called with the index i of the controller:
-sls_detector_clnt i:cmd
-where sls_detector_clnt is the text client (put, get, acquire, help).
-In case more than one detector is configured on the control PC, the command cmd should be called with their respective index j:
-sls_detector_clnt j-cmd
-where sls_detector_clnt is the text client (put, get, acquire, help).
-To address a specific controller i of detector j use:
-sls_detector_clnt j-i:cmd
-For additional questions concerning the indexing of the detector, please refer to the SLS Detectors FAQ documentation.
-The commands are sudivided into different pages depending on their functionalities:
-Commands to setup the network between client, detector and receiver
-none
disables. If used, use as last network command in configuring detector MAC.port
for the rest.rx_hostname
used. Must be first command to communicate with receiver.Commands to setup the file destination and format
-Commands to configure the receiver
-Commands to setup the settings of the detector
-settingsdir
standard
, fast
, highgain
, dynamicgain
, lowgain
, mediumgain
, veryhighgain
, lownoise
, dynamichg0
, fixgain1
, fixgain2
, forceswitchg1
, forceswitchg2
. threshold
or thresholdnotb
to pass to detector. Gets from detector.settings
.settings
.Commands to be used only for software debugging. Avoid using them!
-addr
with value
in hexadecimal format.addr
with value
in hexadecimal format. Only put!...-\newenvironment{DoxyPre}{% - \small% - \begin{alltt}% -}{% - \end{alltt}% - \normalsize% -} - -% Used by @code ... @endcode -\newenvironment{DoxyCode}{% - \footnotesize% - \verbatim% -}{% - \endverbatim% - \normalsize% -} - -% Used by @example, @include, @includelineno and @dontinclude -\newenvironment{DoxyCodeInclude}{% - \DoxyCode% -}{% - \endDoxyCode% -} - -% Used by @verbatim ... @endverbatim -\newenvironment{DoxyVerb}{% - \footnotesize% - \verbatim% -}{% - \endverbatim% - \normalsize% -} - -% Used by @verbinclude -\newenvironment{DoxyVerbInclude}{% - \DoxyVerb% -}{% - \endDoxyVerb% -} - -% Used by numbered lists (using '-#' or