SLS Detector Package 6.0.0 released on xx.10.2021 (Major Release) =================================================================== This document describes the differences between 6.0.0 and 5.2.0 releases. CONTENTS -------- 1. New or Changed Features 2. Resolved Issues 3. Known Issues 4. Firmware Requirements 5. Download, Documentation & Support 1. New or Changed Features ========================== Client ------ 1. [Jungfrau] Chip version Features for chipv1.1 incorporated Command line: chipversion, API: getchipVersion gets chip version (1.0 or 1.1) chipv1.1 requires config_jungfrau.txt on detector server. 2. [Jungfrau] Chip configuration (only chipv1.1) powering on the chip and changing settings will configure the chip. Hence, required before acquisition. 3. [Jungfrau] Settings and Gain mode Settings can be gain0 and highgain0. Gain mode can be dynamicgain, forceswitchg1, forceswitchg2, fixg1, fixg2, fixg0. fixg0 must be used with EXTRA caution as you can damage the detector. Changing settings also changes dac values of 3 dacs () and reconfigures chip (only v1.1) 4. [Jungfrau] Storage cells (only chipv1.1) Additional number of storage cells not applicable for chipv1.1. Storage cell start is only allowed from 0 - 3 for chipv1.1 (0 - 15 for chipv1.0). 5. [Gotthard2][Jungfrau] Filter Resistor Command line: filterresistor, API: getFilterResistor/ setFilterResistor Previous Command: filter, setFilter/ getFilter Set Filter resistor. Increasing values for increasing resistance. [Jungfrau] only for chipv1.1. Options: [0|1]. Default is 1. [Gotthard2] Options: [0|1|2|3]. Default is 0. 6. [Jungfrau] Filter cell (only chipv1.1) Command line: filtercell, API: getFilterCell/ setFilterCell Set filter cell. Options: [0-12]. Advanced user command. 7. [Jungfrau] Comparator disable time (only chipv1.1) Command line: comp_disable_time, API: getComparatorDisableTime/ setComparatorDisableTime One can customize the period to disable comparator. 8. [Eiger][Jungfrau] Flip rows Command line: fliprows, API: getFlipRows/ setFlipRows Previous command: flippeddatax, setBottom/ getBottom [Jungfrau] Flips rows in detector only for HW v2.0. slsReceiver and slsDetectorGui will not flip them again. [Eiger] same as before. 9. [Eiger][Jungfrau] Read n rows Command line: readnrows, API: getReadNRows/ setReadNRows Previous Command: readnlines, getPartialReadout/ setPartialReadout [Eiger] same as before [Jungfrau] Options: 8 - 512, multiples of 8. Default is 512. 10. [Gotthard2][Jungfrau] Current source Command line: currentsource, API: getCurrentSource, setCurrentSource Enable or disable current source. Default is disabled. [Gotthard2] Can only enable or disable. [Jungfrau] Can choose to fix, select source and choose normal or low current. Normal/ low only for chipv1.1. Select source is 0-63 for chipv1.0 and a 64 bit mask for chipv1.1. 11. Default dac Command line: defaultdac, API: getDefaultDac/ setDefaultDac change default value of a dac [Jungfrau][Mythen3] Also change default value of dac for particular setting. 12. Reset dacs Command line: resetdacs, API: resetToDefaultDacs Previous command: defaultdacs Resets dacs to their default values or hard coded values. 13. [Mythen3] Gain Capacitance Command line: gaincaps, API: getGainCaps/ setGainCaps Set various gain capacitances. 14. [Gotthard2] Veto Streaming from chip Command line: veto, API: getVeto/ setVeto This command used to mean veto streaming from detector. Now, it means veto streaming from chip (New feature). Default is disabled. 15. [Gotthard2] Veto streaming from detector Command line: vetostream, API: getVetoStream, setVetoStream Options: None, local link interface, 10 10GbE, Both Default: None 16. [Gotthard2] Veto algorithm Command line: vetoalg, API: getVetoAlgorithm/ setVetoAlgorithm Set veto algorithm for each interface. Options: hits, raw 17. [Eiger][Gotthard2][Mythen3] Module ID Command line: moduleid, API: getModuleId Previous command (Eiger only): serialnumber, getSerialNumber Unique id read from txt file on detector and streamed out in udp header. 18. [Gotthard2] Command line: dbitpipeline, API: getDBITPipeline/ setDBITPipeline Set pipeline to latch digital bits. Options: 0-7 Detector servers ---------------- 1. [Gotthard2] Bad Channels moved to a new register 2. [Gotthard2] Updated config file in detector server Virtual servers ---------------- 1. Artifical pixel values increasing by every packet, instead of every pixel. 2. Resolved Issues ================== Detector Servers ---------------- 1. [Gotthard2] Tolerance in time parameters. Eg. 220 ns was being set to 215 ns, instead of 222ns. 1. [Jungfrau] Stopping in trigger mode and then switching to auto timing mode blocks data streaming from detector. Workaround fix made in detector server to reset core until next firmware release. setting number of udp interfaces from 1 to 2, didnt get image in gui 3. Firmware Requirements ======================== Eiger ===== Compatible version : 08.09.2020 (v27) Jungfrau ======== Compatible version : 31.08.2021 (v1.2, PCB v1.0) : 10.09.2021 (v2.2, PCB v2.0) Gotthard ======== Compatible version : 08.02.2018 (50um and 25um Master) : 09.02.2018 (25 um Slave) Mythen3 ======= Compatible version : 10.09.2021 (development) Gotthard2 ========= Compatible version : 27.05.2021 (development) Moench ====== Compatible version : 05.10.2020 (v1.0) Ctb === Compatible version : 05.10.2020 (v1.0) Detector Upgrade ================ The following can be upgraded remotely: Eiger via bit files Jungfrau via command <.pof> Mythen3 via command <.rbf> Gotthard2 via command <.rbf> Moench via command <.pof> Ctb via command <.pof> The following cannot be upgraded remotely: Gotthard Instructions available at https://slsdetectorgroup.github.io/devdoc/firmware.html and https://slsdetectorgroup.github.io/devdoc/serverupgrade.html 5. Known Issues =============== Receiver -------- 1. It does not handle readnrows or partial readout. Only the summary is adjusted to print in red. However, it will still write complete images with missing data padded. Roi will be implemented in future that can be complimented with this feature to remove the additional data in files. 2. Round robin is not implemented in receiver side, ie. one cannot configure more than 1 receiver at a time. This will/might be done in the future. 6. Download, Documentation & Support ==================================== Download -------- The Source Code: https://github.com/slsdetectorgroup/slsDetectorPackage Documentation ------------- Installation: https://slsdetectorgroup.github.io/devdoc/installation.html# Firmware Upgrade: https://slsdetectorgroup.github.io/devdoc/firmware.html Detector Server upgrade: https://slsdetectorgroup.github.io/devdoc/serverupgrade.html Detector Simulators: https://slsdetectorgroup.github.io/devdoc/virtualserver.html Consuming slsDetectorPackage: https://slsdetectorgroup.github.io/devdoc/consuming.html API Examples: https://github.com/slsdetectorgroup/api-examples Command Line Documentation: https://slsdetectorgroup.github.io/devdoc/commandline.html Quick Start Guide: https://slsdetectorgroup.github.io/devdoc/quick_start_guide.html C++ API Documentation: https://slsdetectorgroup.github.io/devdoc/detector.html C++ API Example: https://slsdetectorgroup.github.io/devdoc/examples.html# Python API Documentation: https://slsdetectorgroup.github.io/devdoc/pygettingstarted.html Python API Example: https://slsdetectorgroup.github.io/devdoc/pyexamples.html Receivers (including custom receiver): https://slsdetectorgroup.github.io/devdoc/receivers.html https://slsdetectorgroup.github.io/devdoc/slsreceiver.html TroubleShooting: https://slsdetectorgroup.github.io/devdoc/troubleshooting.html Further Documentation: https://www.psi.ch/en/detectors/documentation Info on Releases: https://www.psi.ch/en/detectors/software Support ------- dhanya.thattil@psi.ch erik.frojdh@psi.ch