Skip to content

Bug Fix Release: 8.0.2
Compare
Choose a tag to compare
@thattil thattil released this 18 Sep 14:26
· 4 commits to main since this release
8.0.2
4880f87
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Learn about vigilant mode.

SLS Detector Package Bug Fix Release 8.0.2 released on 18.09.2024

This document describes the differences between v8.0.2 and v8.0.1

CONTENTS
--------
1           Resolved Issues
2           On-board Detector Server Compatibility
3           Firmware Requirements
4           Kernel Requirements
5           Download, Documentation & Support

1 Resolved Issues

Compilation
-----------


*   Rapidjson compilation with gcc 14
    Fixed a compile issue with gcc 14. Same fix in later commits to rapidjson.


Client
------


*   getenv("HOME") returning nullptr
    When this happens, especially for systemd, it segfaults. Protection 
    provided by using empty string in this case.


*   [Mythen3] Bad channel list for multi module
    Exception thrown when loading multi module bad channel file skipping 
    modules in between. Fixed.


*   [Gotthard2] Stopping a blocking acquisition
    A check added in v8.0.0 to catch slaves that might be in waiting forever
    also catches Gotthard2 25um slaves that might only be in waiting 
    temporarily. This is fixed with a 50ms sleep before checking again 
    (upto 1s). 


*   [Moench] Acquire finished processing call back
    New executable 'sls_detector_acquire_zmq' added to listen to all zmq 
    packets from post processor or external process to signal end of post 
    processing. Post processor refactoring of zmq socket creation added.


Gui / Callback
--------------


*   [Gotthard2] Stopping a blocking acquisition
    From the previous issue, call back for acquisition finished status gives 
    error for inconsistent states. Again, a check every 50ms upto 1s is 
    added to let go the temporarily waiting slave.


*   Different file paths
    Fixes file path resetting when different modules have different fpath set.


Receiver
--------


*   HDF5 fill value
    Fix the fill value to accomodate all datatypes.


Firmware
--------


*   [Moench] Overflow with exptime of 0
    Fixed overflow when subtracting 1 clock cycle from exptime.


On-board Detector Server
------------------------


*   [Moench] Few changes in Server:
    - Max shifts of adc clock changed from 240 to 200. 

    - Fixed overflow when subtracting 2 clock cycles from exptime of 0ms.

    - Default readout speed to half speed from quarter.

    - Change default ADC phase to 150 for full readout speed.

    - Change default vipre_cds dac from 800 to 1280.


*   [Mythen3] Change Clk divider from 10 (100MHz) to 20 (50MHz) at startup.


*   [Jungfrau] Fix for HW v1.0 boards for unreliable ADC 2
    Issues sometimes seen on some HW v 1.0 boards are fixed with phase 
    relationship of 120 degrees. HW v2.0 boards are not affected.
    

Documentation
-------------


*   Updated troubleshooting documentaion to check links and disable firewall


*   Excluded non UTF-8 encoded libzmq documents due to machine dependent 
    compilation issues.

2 On-board Detector Server Compatibility

Eiger       8.0.0
Jungfrau    8.0.2
Mythen3     8.0.2
Gotthard2   8.0.0
Gotthard    8.0.0
Moench      8.0.2
Ctb         8.0.0


On-board Detector Server Upgrade
--------------------------------

From v6.1.0 (without tftp):
    Using command 'updatedetectorserver'

Instructions available at
    https://slsdetectorgroup.github.io/devdoc/serverupgrade.html

3 Firmware Requirements

Eiger       02.10.2023 (v32)                    (updated in 7.0.3)

Jungfrau    20.09.2023 (v1.5, HW v1.0)          (updated in 8.0.0)
            21.09.2023 (v2.5, HW v2.0)          (updated in 8.0.0)

Mythen3     24.01.2023 (v1.4)                   (updated in 7.0.0)

Gotthard2   23.11.2022 (v0.3)                   (updated in 7.0.0)

Gotthard    08.02.2018 (50um and 25um Master)
            09.02.2018 (25 um Slave) 

Moench      26.10.2023 (v0.3.2)                 (updated in 8.0.2, 
                                                under development)

Ctb         28.08.2023 (v1.2)                   (updated in 8.0.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>

Gotthard cannot be upgraded remotely  

Except Eiger, 
    upgrade 
        using command 'programfpga' or

    udpate both server and firmware simultaneously
        using command 'update'


Instructions available at
    https://slsdetectorgroup.github.io/devdoc/firmware.html

4 Kernel Requirements

Blackfin 
--------
Latest version: Fri Oct 29 00:00:00 2021

Older ones will work, but might have issues with programming firmware via
the package.

Nios
-----
Compatible version: Mon May 10 18:00:21 CEST 2021

Kernel Upgrade
---------------
Eiger   via bit files
Others  via command

Commands: udpatekernel, kernelversion
Instructions available at
    https://slsdetectorgroup.github.io/devdoc/commandline.html
    https://slsdetectorgroup.github.io/devdoc/detector.html
    https://slsdetectorgroup.github.io/devdoc/pydetector.html

5 Download, Documentation & Support

Download
--------

The Source Code:
     https://github.com/slsdetectorgroup/slsDetectorPackage
        
Documentation
-------------

Installation:
    https://slsdetectorgroup.github.io/devdoc/installation.html

Quick Start Guide:
    https://slsdetectorgroup.github.io/devdoc/quick_start_guide.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

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

Detector UDP Header:
    https://slsdetectorgroup.github.io/devdoc/udpheader.html
    https://slsdetectorgroup.github.io/devdoc/udpdetspec.html

slsReceiver Zmq Format:
    https://slsdetectorgroup.github.io/devdoc/slsreceiver.html#zmq-json-header-format

TroubleShooting:
    https://slsdetectorgroup.github.io/devdoc/troubleshooting.html
    https://slsdetectorgroup.github.io/devdoc/troubleshooting.html#receiver-pc-tuning-options
    
Further Documentation:
    https://www.psi.ch/en/detectors/documentation
    
Info on Releases:
    https://www.psi.ch/en/detectors/software
Assets 2
Loading