Releases: GSI-CS-CO/bel_projects
Timing Release - Fallout-v6.3.1
Fallout-v6.3.1
Important
- Please read ALL notes BEFORE you update your device(s)!
- Only gateware updates are available for SCU2 and SCU3!
- Timing stack update for all devices!
Release Notes
EB tools
- eb-info: Improved memory safety to enhance stability and prevent potential issues related to memory management.
- eb-reset: Implemented a force parameter for the FPGA reset functionality.
Saftlib v3.1.3
- Removed 10ms delay: Enhanced performance by removing the 10ms delay when the file descriptor (fd) is not immediately ready.
- Added signal(s) dropped counter: Introduced a counter to track the number of dropped signals, providing better monitoring and diagnostics.
SCU2/3
- MIL event error counter: Added a counter for MIL event errors, improving error tracking and diagnostics for more efficient troubleshooting.
- The default function generator firmware was removed from the SCU.
FPGA gateware and bel_projects in general
- This update includes various general improvements and performance optimizations under the hood. While these changes are not directly visible to the end user, they contribute to a smoother and more efficient experience.
GSI/FAIR
SL7 legacy RAM disk ("scuxl")
SL7 RTE: global/timing-rte-tg-fallout-v6-3-1-sl7
Example configuration:
$ user@aslXYZ:/common/export/nfsinit/scuxlabcd: ls -l
total 48K
drwxrwxr-x 2 user fesa 53 Jul 25 09:30 .
drwxrwxr-x 1101 root fesa 28K Jul 17 11:26 ..
lrwxrwxrwx 1 user bel 42 Jul 25 09:30 20_timing-rte -> ../global/timing-rte-tg-fallout-v6-3-1-sl7Yocto/Poky/FFOS RAM disk ("yocto")
Yocto disk: Just use the default yocto configuration.
$ user@aslXYZ:/common/tftp/csco/pxe/pxelinux.cfg: ls -l
lrwxrwxrwx 1 user bel 5 Aug 6 11:26 scuxlabcd -> yocto$ cat /etc/image_manifest
eb-tools core2_64 6.3.1+git0+1af37338ba
etherbone core2_64 2.1.3+git0+b53067e9be
saftbus core2_64 3.1.3+git0+29abe1be27
wishbone genericx86_64 6.3.0+git0+3ccd897531$ cat /etc/timestamp
20240726101145ASL/Rocky9 deployment
Can be found here: /common/export/timing-rte/tg-fallout-v6.3.1-rocky9
Using EB tools and Saftlib on ASL/Rocky9
Exports
export PATH=$PATH:/common/export/timing-rte/tg-fallout-v6-3-1-rocky9/bin
export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/common/export/timing-rte/tg-fallout-v6-3-1-rocky9/libUsage
$ which eb-info
/common/export/timing-rte/tg-fallout-v6-3-1-rocky9/bin/eb-info
$ eb-info tcp/scuxl0815.acc.gsi.de
Project : scu_control
Platform : scu3 +comexpress
FPGA model : Arria II GX (ep2agx125ef29c5)
Source info : zenith-5896
Build type : fallout-v6.3.1
Build date : Fri Jul 26 00:04:51 CEST 2024
Prepared by : Timing Group Jenkins
Prepared on : tsl021.acc.gsi.de
OS version : 5.14.0-427.24.1.el9_4.x86_64 x86_64 GNU/Linux
Quartus : Version 18.1.0 Build 625 09/12/2018 SJ Standard Edition
Packages
| Package | Git | Tag | Remark |
|---|---|---|---|
| Etherbone | https://ohwr.org/project/etherbone-core.git | v2.1.4 | cd api; ./autogen.sh; ./configure; make; make install |
| Etherbone tools | https://github.com/GSI-CS-CO/bel_projects.git | fallout-v6.3.1 | make tools; make tools-install |
| Saftlib | https://github.com/GSI-CS-CO/saftlib.git | v3.1.3 | ./autogen.sh; ./configure; make; make install |
| Kernel drivers | https://ohwr.org/project/fpga-config-space.git | v1.0.1 | cd pcie-wb; make; make install |
| FPGA gatewares | https://github.com/GSI-CS-CO/bel_projects.git | fallout-v6.3.1 | No libraries or binaries |
Gateware
For PMC / AMC / PEXP / EXPLODER5 / PEXARRIA5 / VETAR2A / VETAR2A-EE-BUTIS gateware please check the Fallout-v6.1.2 release page:
For SCU2 and SCU3 see "Assets".
Firmware
For the burst generator and function generator firmware, see "Assets".
Important Links
- Flashing guide: https://www-acc.gsi.de/wiki/Timing/TimingSystemHowFlashFTRNUser
- Using IOs: https://www-acc.gsi.de/wiki/Timing/TimingSystemHowSaftIoCtl
- Using Saftlib: https://github.com/GSI-CS-CO/saftlib/blob/master/README.md
- General FAQ: https://github.com/GSI-CS-CO/bel_projects/blob/master/README.md
Timing Release - Fallout-v6.2.1
Important
- Please read ALL notes BEFORE you update your device(s)!
- This is just a release for all SCU2/3 and SIO3 devices (gateware => FPGA image)
- You don't need to update your Timing RTE, keep using 6.2.0
- ESR users will need this gateware update (MIL master fix)
Full Release Notes
https://www-acc.gsi.de/wiki/Timing/TimingSystemFRelease
ASL Setup (Kernel Version 3.X)
Link: 20_timing-rte -> ../global/timing-rte-tg-fallout-v6.2.0
RAM-Disk: scuxl
Compilation
Check README.md file for additional information and make targets.
https://github.com/GSI-CS-CO/bel_projects.git cd bel_projects git checkout fallout-v6.2.1 make (optional) make saftlib
Gateware
For PMC / AMC / PEXP / EXPLODER5 / PEXARRIA5 / VETAR2A / VETAR2A-EE-BUTIS gateware please check the Fallout-v6.1.2 release page => https://github.com/GSI-CS-CO/bel_projects/releases/tag/fallout-v6.1.2
For SCU2 and SCU3 see "Assets"
Important Links
Flashing guide: https://www-acc.gsi.de/wiki/Timing/TimingSystemHowFlashFTRNUser
Saftlib starter guide: https://www-acc.gsi.de/wiki/Timing/TimingSystemHowSaftCtl
Using IOs: https://www-acc.gsi.de/wiki/Timing/TimingSystemHowSaftIoCtl
Known Bugs
Flashing
Flashing might fail sometimes on certain devices/combinations. If you have such a device please use this command to flash the timing receiver:
<VETAR2A/VETAR2A-EE-BUTIS/SCU2/SCU3>
eb-flash -s 0x40000 -w 3 dev/wbm{ID} {DEV_NAME}.rpd
<PEXP/PEXARRIA5/PMC/MICROTCA/EXPLODER5>
eb-flash -s 0x10000 -w 3 dev/wbm{ID} {DEV_NAME}.rpd
Known "bad" device <> host combinations
- PMC with MENA20X (flashing/eb-flash)
Timing Release - Fallout-v6.2.0
Important
Please read ALL notes BEFORE you update your device(s)!
Full Release Notes
https://www-acc.gsi.de/wiki/Timing/TimingSystemFRelease
ASL Setup (Kernel Version 3.X)
Link: 20_timing-rte -> ../global/timing-rte-tg-fallout-v6.2.0
RAM-Disk: scuxl
ASL Setup (Kernel Version 4.X)
Link: 20_timing-rte -> ../global/timing-rte-tg-fallout-v6.2.0-edge
RAM-Disk: scuxl_edge
Compilation
Check README.md file for additional information and make targets.
https://github.com/GSI-CS-CO/bel_projects.git cd bel_projects git checkout fallout-v6.2.0 make (optional) make saftlib
Gateware
For PMC / AMC / PEXP / EXPLODER5 / PEXARRIA5 / VETAR2A / VETAR2A-EE-BUTIS / SCU2 / SCU3 gateware please check the Fallout-v6.1.2 release page => https://github.com/GSI-CS-CO/bel_projects/releases/tag/fallout-v6.1.2
Important Links
Flashing guide: https://www-acc.gsi.de/wiki/Timing/TimingSystemHowFlashFTRNUser
Saftlib starter guide: https://www-acc.gsi.de/wiki/Timing/TimingSystemHowSaftCtl
Using IOs: https://www-acc.gsi.de/wiki/Timing/TimingSystemHowSaftIoCtl
Known Bugs
Flashing
Flashing might fail sometimes on certain devices/combinations. If you have such a device please use this command to flash the timing receiver:
<VETAR2A/VETAR2A-EE-BUTIS/SCU2/SCU3>
eb-flash -s 0x40000 -w 3 dev/wbm{ID} {DEV_NAME}.rpd
<PEXP/PEXARRIA5/PMC/MICROTCA/EXPLODER5>
eb-flash -s 0x10000 -w 3 dev/wbm{ID} {DEV_NAME}.rpd
Known "bad" device <> host combinations
- PMC with MENA20X (flashing/eb-flash)
Fallout-v6.1.2 - Release
Fallout-v6.1.2 - Release
Please read ALL notes BEFORE you update your device(s)!
Important: Update/flash (eb-flash) your device BEFORE you update the software stack (also known as TIMING RTE).
Gateware: See attached files "Assets"
Full Release Notes
https://www-acc.gsi.de/wiki/Timing/TimingSystemFRelease
ASL Setup (Kernel Version 3.X)
Link: 20_timing-rte -> ../global/timing-rte-tg-fallout-v6.1.2
RAM-Disk: scuxl
ASL Setup (Kernel Version 4.X)
Link: 20_timing-rte -> ../global/timing-rte-tg-fallout-v6.1.2-edge
RAM-Disk: scuxl_edge
Compilation
Check README.md file for additional information and make targets.
https://github.com/GSI-CS-CO/bel_projects.git cd bel_projects git checkout fallout-v6.1.2 make (optional) make saftlib
Important Links
Flashing guide: https://www-acc.gsi.de/wiki/Timing/TimingSystemHowFlashFTRNUser
Saftlib starter guide: https://www-acc.gsi.de/wiki/Timing/TimingSystemHowSaftCtl
Using IOs: https://www-acc.gsi.de/wiki/Timing/TimingSystemHowSaftIoCtl
Known Bugs
Saftlib
The exceptions in saftlib version (v2.4.3) for this release do not work! Programs will not correctly receive saftlib::Error when a driver function throws an exception. Workaround: use a different saftlib branch "fix-exceptions" (git commit b57d8e473f4)
Flashing
Flashing might fail sometimes on certain devices/combinations. If you have such a device please use this command to flash the timing receiver:
<VETAR2A/VETAR2A-EE-BUTIS/SCU2/SCU3>
eb-flash -s 0x40000 -w 3 dev/wbm{ID} {DEV_NAME}.rpd
<PEXP/PEXARRIA5/PMC/MICROTCA/EXPLODER5>
eb-flash -s 0x10000 -w 3 dev/wbm{ID} {DEV_NAME}.rpd
Known "bad" device <> host combinations
- PMC with MENA20X (flashing/eb-flash)
Fallout-v6.1.2-rc1 - Release Candidate #1
This release is identified as non-production ready!
Please read ALL notes BEFORE you update your device(s)!
Important: Update/flash (eb-flash) your device BEFORE you update the software stack (also known as TIMING RTE).
Gateware: See attached files "Assets"
Full Release Notes
https://www-acc.gsi.de/wiki/Timing/TimingSystemFRelease
ASL Setup (Kernel Version 3.X)
Link: 20_timing-rte -> ../global/timing-rte-tg-fallout-v6.1.2-rc1
RAM-Disk: scuxl
ASL Setup (Kernel Version 4.X)
Link: 20_timing-rte -> ../global/timing-rte-tg-fallout-v6.1.2-edge-rc1
RAM-Disk: scuxl_edge
Compilation
Check README.md file for additional information and make targets.
https://github.com/GSI-CS-CO/bel_projects.git cd bel_projects git checkout fallout-v6.1.2-rc1 make (optional) make saftlib
Known Bugs
Flashing
Flashing might fail sometimes on certain devices/combinations. If you have such a device please use this command to flash the timing receiver:
<VETAR2A/VETAR2A-EE-BUTIS/SCU2/SCU3>
eb-flash -s 0x40000 -w 3 dev/wbm{ID} {DEV_NAME}.rpd
<PEXP/PEXARRIA5/PMC/MICROTCA/EXPLODER5>
eb-flash -s 0x10000 -w 3 dev/wbm{ID} {DEV_NAME}.rpd
Known "bad" device <> host combinations
- PMC with MENA20X (flashing/eb-flash)
Fallout-v6.1.1-rc1 - Release Candidate #1
This release is identified as non-production ready!
Please read ALL notes BEFORE you update your device(s)!
Important: Update/flash (eb-flash) your device BEFORE you update the software stack (also known as TIMING RTE).
Gateware: See attached files "Assets"
Full Release Notes
https://www-acc.gsi.de/wiki/Timing/TimingSystemFRelease
ASL Setup (Kernel Version 3.X)
Link: 20_timing-rte -> ../global/timing-rte-tg-fallout-v6.1.1-rc1
RAM-Disk: scuxl
ASL Setup (Kernel Version 4.X)
Link: 20_timing-rte -> ../global/timing-rte-tg-fallout-v6.1.1-edge-rc1
RAM-Disk: scuxl_edge
Compilation
Check README.md file for additional information and make targets.
https://github.com/GSI-CS-CO/bel_projects.git cd bel_projects git checkout fallout-v6.1.1-rc1 make (optional) make saftlib
Known Bugs
Flashing
Flashing might fail sometimes on certain devices/combinations. If you have such a device please use this command to flash the timing receiver:
<VETAR2A/VETAR2A-EE-BUTIS/SCU2/SCU3>
eb-flash -s 0x40000 -w 3 dev/wbm{ID} {DEV_NAME}.rpd
<PEXP/PEXARRIA5/PMC/MICROTCA/EXPLODER5>
eb-flash -s 0x10000 -w 3 dev/wbm{ID} {DEV_NAME}.rpd
Known "bad" device <> host combinations
- PMC with MENA20X (flashing/eb-flash)
Fallout-v6.1.0-rc1 - Release Candidate #1
This release is identified as non-production ready!
Please read ALL notes BEFORE you update your device(s)!
Important: Update/flash (eb-flash) your device BEFORE you update the software stack (also known as TIMING RTE).
Gateware: See attached files "Assets"
Full Release Notes
https://www-acc.gsi.de/wiki/Timing/TimingSystemFRelease
ASL Setup (Kernel Version 3.X)
Link: 20_timing-rte -> ../global/timing-rte-tg-fallout-v6.1.0-rc1
RAM-Disk: scuxl
ASL Setup (Kernel Version 4.X)
Link: 20_timing-rte -> ../global/timing-rte-tg-fallout-v6.1.0-edge-rc1
RAM-Disk: scuxl_edge
Compilation
Check README.md file for additional information and make targets.
https://github.com/GSI-CS-CO/bel_projects.git cd bel_projects git checkout fallout-v6.1.0-rc1 make (optional) make saftlib
Known Bugs
Flashing
Flashing might fail sometimes on certain devices/combinations. If you have such a device please use this command to flash the timing receiver:
<VETAR2A/VETAR2A-EE-BUTIS/SCU2/SCU3>
eb-flash -s 0x40000 -w 3 dev/wbm{ID} {DEV_NAME}.rpd
<PEXP/PEXARRIA5/PMC/MICROTCA/EXPLODER5>
eb-flash -s 0x10000 -w 3 dev/wbm{ID} {DEV_NAME}.rpd
Known "bad" device <> host combinations
- PMC with MENA20X (flashing/eb-flash)
Fallout-v6.0.2-rc1 - Release Candidate #1
This release is identified as non-production ready!
Please read ALL notes BEFORE you update your device(s)!
Important: Update/flash (eb-flash) your device BEFORE you update the software stack (also known as TIMING RTE).
Gateware: See attached files "Assets"
Full Release Notes
https://www-acc.gsi.de/wiki/Timing/TimingSystemFRelease
ASL Setup (Kernel Version 3.X)
Link: 20_timing-rte -> ../global/timing-rte-tg-fallout-v6.0.2-rc1
RAM-Disk: scuxl
ASL Setup (Kernel Version 4.X)
Link: 20_timing-rte -> ../global/timing-rte-tg-fallout-v6.0.2-edge-rc1
RAM-Disk: scuxl_edge
Compilation
Check README.md file for additional information and make targets.
https://github.com/GSI-CS-CO/bel_projects.git cd bel_projects git checkout fallout-v6.0.2-rc1 make (optional) make saftlib
Known Bugs
Flashing
Flashing might fail sometimes on certain devices/combinations. If you have such a device please use this command to flash the timing receiver:
<VETAR2A/VETAR2A-EE-BUTIS/SCU2/SCU3>
eb-flash -s 0x40000 -w 3 dev/wbm{ID} {DEV_NAME}.rpd
<PEXP/PEXARRIA5/PMC/MICROTCA/EXPLODER5>
eb-flash -s 0x10000 -w 3 dev/wbm{ID} {DEV_NAME}.rpd
Known "bad" device <> host combinations
- PMC with MENA20X (flashing/eb-flash)
Fallout-v6.0.1 Release
Full Release Notes
https://www-acc.gsi.de/wiki/Timing/TimingSystemFRelease
ASL Setup (Kernel Version 3.X)
Link: 20_timing-rte -> ../global/timing-rte-tg-fallout-v6.0.1
RAM-Disk: scuxl
ASL Setup (Kernel Version 4.X)
Link: 20_timing-rte -> ../global/timing-rte-tg-fallout-v6.0.1-edge
RAM-Disk: scuxl_edge
Compilation
Check README.md file for additional information and make targets.
https://github.com/GSI-CS-CO/bel_projects.git cd bel_projects git checkout fallout-v6.0.1 make
Known Bugs
Flashing
Flashing might fail sometimes on certain devices/combinations. If you have such a device please use this command to flash the timing receiver:
<VETAR2A/VETAR2A-EE-BUTIS/SCU2/SCU3>
eb-flash -s 0x40000 -w 3 dev/wbm{ID} {DEV_NAME}.rpd
<PEXP/PEXARRIA5/PMC/MICROTCA/EXPLODER5>
eb-flash -s 0x10000 -w 3 dev/wbm{ID} {DEV_NAME}.rpd
Known "bad" device <> host combinations
- PMC with MENA20X (flashing/eb-flash)
Fallout-v6.0.0 Release
Full Release Notes
https://www-acc.gsi.de/wiki/Timing/TimingSystemFRelease
ASL Setup (Kernel Version 3.X)
Link: 20_timing-rte -> ../global/timing-rte-tg-fallout-v6.0.0
RAM-Disk: scuxl
ASL Setup (Kernel Version 4.X)
Link: 20_timing-rte -> ../global/timing-rte-tg-fallout-v6.0.0-edge
RAM-Disk: scuxl_edge
Compilation
Check README.md file for additional information and make targets.
https://github.com/GSI-CS-CO/bel_projects.git cd bel_projects git checkout fallout-v6.0.0 make
Known Bugs
Flashing
Flashing might fail sometimes on certain devices/combinations. If you have such a device please use this command to flash the timing receiver:
<VETAR2A/VETAR2A-EE-BUTIS/SCU2/SCU3>
eb-flash -s 0x40000 -w 3 dev/wbm{ID} {DEV_NAME}.rpd
<PEXP/PEXARRIA5/PMC/MICROTCA/EXPLODER5>
eb-flash -s 0x10000 -w 3 dev/wbm{ID} {DEV_NAME}.rpd
Known "bad" device <> host combinations
- PMC with MENA20X (flashing/eb-flash)