slsDetectorPackage/RELEASE.txt

SLS Detector Package Patch Release 6.1.2 released on 14.11.2022
===============================================================

This document describes the differences between v6.1.2 and v6.1.1.   



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



1. Resolved Issues
==================

    Detector Server
    ---------------
    
    1.  [Jungfrau, Moench, Ctb]
        Updating kernel was not enough to ensure seamless programming of FPGA.
        nCe signal now made high before programming blackfin.

        Updating the on-board detector server to this version is recommended 
        before updating firmware for future releases.

        Also removed the unnecessary test to check if it is allowed to update 
        kernel or on-board detector server, depending on the current kernel 
        version.

    2.  [Eiger] Stop command freezes server (apparent in large detectors) 
        Stop command sometimes did not receive processing done signal from 
        firmware. A workaround is implemented in software until fixed in 
        firmware. After 1 s, it will check status and throw if it is still
        running.

    3.  [Eiger] Quad Trimbits or threshold
        Loading trimbits or setting threshold will throw an incorrect exception
        for a quad as the left and right register values will not match. The fix 
        only sets and monitors right fpga for chip trim signals in quad.

    4.  [Eiger] Minor refactoring
        Inconsistent reads between left and right register for read/write 
        register commands now give clear error messages.

        Fixed some minor functions returned empty error messages when failing.



2.  On-board Detector Server Compatibility
==========================================

    Eiger       6.1.2
    Jungfrau    6.1.2
    Gotthard    6.1.0
    Mythen3     6.1.0
    Gotthard2   6.1.0
    Moench      6.1.2
    Ctb         6.1.2
    
    On-board Detector Server Upgrade
    ================================
    From v6.1.0 (without tftp):
        Using command 'updatedetectorserver'
    From 5.0.0 (with tftp):
        Using command 'copydetectorserver'

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


3. Firmware Requirements
========================
        
    Note: No change to 6.1.1.


    Eiger
    =====  
    Compatible version : 08.10.2021 (v29)
    
    Jungfrau
    ========       
    Compatible version : 31.08.2021 (v1.2, PCB v1.0) 
                       : 08.10.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 (v1.1)

    Gotthard2
    =========
    Compatible version : 27.05.2021 (v0.1)

    Moench
    ======
    Compatible version : 05.10.2020 (v1.0)

    Ctb
    ===
    Compatible version : 05.10.2020 (v1.0)

    Detector Firmware Upgrade
    =========================
    The following can be upgraded remotely:
    Eiger      via bit files
    Jungfrau   via 'programfpga' command <.pof>
    Mythen3    via 'programfpga' command <.rbf>
    Gotthard2  via 'programfpga' command <.rbf> 
    Moench     via 'programfpga' command <.pof>
    Ctb        via 'programfpga' command <.pof>

    The following cannot be upgraded remotely:
    Gotthard   

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



4. Kernel Requirements
======================

    Note: No change to 6.1.1.


    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#
        
    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