Socket Interface Specification. MYTHEN Detector System. Version: 3.0.0, Document Version: 2
2/34
Страница 1: ...DECTRIS Ltd 5405 Baden Daettwil Switzerland www dectris com Socket Interface Specification MYTHEN Detector System Version 3 0 0 Document Version 2...
Страница 2: ...Socket Interface Specification MYTHEN Detector System Version 3 0 0 Document Version 2 2 34...
Страница 3: ...erver 11 5 2 Initialization 11 5 3 Settings 12 5 3 1 Predefined Settings 12 5 3 2 Setting Threshold and Energy 12 5 3 3 High frame rates 12 5 4 Acquisition control 12 5 5 Data corrections 13 5 6 Trigg...
Страница 4: ...ration notes 31 8 1 3 Legacy2 mode 31 8 2 Version 2 1 0 31 8 3 Version 2 0 5 31 8 4 Version 2 0 4 31 8 5 Version 2 0 3 32 8 6 Version 2 0 2 32 8 7 Version 2 0 1 32 8 8 Version 2 0 0 32 8 8 1 New Funct...
Страница 5: ...released 3 0 0 DV2 04 02 2016 ready for release DJ AM PT 1 2 Changes Version Date Changes 3 0 0 DV2 04 02 2016 New postal address 3 0 0 DV1 1 11 06 2013 Adapted CD 3 0 0 DV1 0 21 09 2012 Simplified op...
Страница 6: ...signed for the MYTHEN detector systems 2 1 Address and Support DECTRIS Ltd Taefernweg 1 5405 Baden Daettwil Switzerland Phone 41 56 500 21 02 Fax 41 56 500 21 01 Website www dectris com support Techni...
Страница 7: ...AC current Ground Functional earth 2 3 Explanation of Terms Term Description GUI Graphical User Interface DCS1 Detector Control System for 1 detector module DCS6 Detector Control System for up to 6 d...
Страница 8: ...from the use of this system DECTRIS Ltd is the sole owner of all user rights related to the contents of the manual in particular information images or materials unless otherwise indicated Without the...
Страница 9: ...the detector control system should not be blocked Power down the detector system before connecting or disconnecting any cable Before connecting the power supply to the mains supply check the supply vo...
Страница 10: ...on the system memory stick A spec implementation based on this socket interface is available from http www certif com To take advantage of new functionality and bug fixes it is possible to update to...
Страница 11: ...ed response length is reached In case of an error the server will respond with a negative number The meaning of the error codes can be found in section 7 2 5 2 Initialization First of all it should be...
Страница 12: ...e rate correction with the command ratecorrection 0 3 Disabling the server side flatfield correction with the command flatfieldcorrection 0 4 Using a UDP connection instead of the slower TCP connectio...
Страница 13: ...continuous trigger modes can be enabled by the trigen and conttrigen commands The timing of the measurements can be adjusted with the delbef and delafter commands The gating mode is turned on by the g...
Страница 14: ...dows C application with some comments are provided on the system memory stick They set up a socket connection to the DCS and read back the module serial numbers Afterwards a short acquisition is perfo...
Страница 15: ...lic type Description Describes the effect of the command Return Type Specifies the data type of the returned byte array If no return type is indicated the command returns an integer a zero indicating...
Страница 16: ...he position of the selected module or 65535 when all modules are selected int 1 get nmaxmodules Returns the maximal number of modules which can be connected to this MYTHEN system int 1 get nmodules Re...
Страница 17: ...Detector System Version 3 0 0 Document Version 2 17 34 initialization the number of active modules is set to the number of delivered modules reset Sets the detector back to default settings This comma...
Страница 18: ...ns the status of the DCS as a bit pattern Bit 0 Acquisition running Bit 3 Waiting for trigger Bit 16 No data available for readout empty buffer int 1 get time Returns the programmed exposure time of o...
Страница 19: ...ection to the data thereby allowing for maximal frame rate The example code in section 0 shows how to decode the raw data int NB NMOD NBITS NB 24 1280 16 640 8 320 4 160 start Starts an acquisition wi...
Страница 20: ...V float 1 get energymin Returns the minimal supported X ray energy in units of keV float 1 get kthresh Returns the threshold of the modules in keV float NMOD get kthreshmax Returns the maximal support...
Страница 21: ...to a suitable value The availability of Cr and Ag settings depends on the calibration of your system This command takes about two seconds per module After initialization settings for Cu X rays are lo...
Страница 22: ...ialization the flatfield correction is enabled get badchannelinterpolation Returns whether the bad channel interpolation is enabled 1 or not 0 int 1 get cutoff Returns the maximal count value before f...
Страница 23: ...in one frame get conttrig Returns whether the continuous trigger mode is enabled 1 or not 0 int 1 get delbef Returns the delay between a trigger signal and the start of the measurement long long 1 get...
Страница 24: ...ation MYTHEN Detector System Version 3 0 0 Document Version 2 24 34 trigen b 0 Disable 1 Enable Enables or disables the trigger mode The acquisition starts after the trigger signal Subsequent frames a...
Страница 25: ...nstructs the socket server to send back the content of the log file The length of the server response has to be inferred from the return value of the log stop command char testpattern Returns a test d...
Страница 26: ...ntical to the kthresh command and should no longer be used flipchannels b 0 Disable 1 Enable Enables or disables the flipping of the channel numbering In versions older than 2 0 the numbering was flip...
Страница 27: ...rsion 2 In this mode the possibility to select all modules is disabled the return size of some commands is 1 instead of NMOD the get settingsmode command works as before read Deprecated version of the...
Страница 28: ...Flatfield file not found 11 Bad channel file not found 12 Energy calibration file not found 13 Noise file not found 14 Trimbit file not found 15 Invalid format of the flatfield file 16 Invalid format...
Страница 29: ...ad out data response of the readoutraw command Output result array of size 1280 nmods with the number of counts of all channels void decodeRawReadout int nmods int nbits int data int result int chanpe...
Страница 30: ...energy Improved precision of the rate correction Many new commands to retrieve the state of the system get conttrig get cutoff get delafter get delbef get frames get gate get gates get inpol get modul...
Страница 31: ...system delivered with version 2 For example you will not see any differences in data acquired with StdCu and FastCu settings because these deprecated arguments are internally mapped to the same detec...
Страница 32: ...ed after the reset command since a reset now sets the number of modules to the number of delivered modules 8 5 Version 2 0 3 The server is now able to handle optimized high gain settings This change i...
Страница 33: ...version 1 3 0 take care of the following changes By default the automatic readout of the first frame in an acquisition is disabled The flipping of the channels is turned off after initializtion By de...
Страница 34: ...cuments are available through DECTRIS Ltd homepage https www dectris com technical_mythen html main_head_navigation Term Description Firmware Update Guide Firmware_Update MYTHEN V1_6 pdf Module Handli...
