gFEX-v2.2.0

• Add script to resize the rootfs to take up the full size of the partition during the boot sequence, format the SD card in such a way that it uses all available space
• Added Simone's log-manager to help manage the size of logfiles. Set to tar logfiles when they reach 30GB in size or every 90 days.
• Add a script that can load firmware on the zFPGA during the boot sequence of the board (defaults to not loading firmware, but can be modified to do so)
• Update opc server code to commit 7955b6ac of opc-ua-gfex-milkyway-server, includes datapoints on disk/cpu/memory utilization (WinCCOA side of DCS still needs to be updated to do this)
• Update gfex on-board software to commit b57ef707 of gfex-register-access

gFEX-v2.1.1

• Added chrony ntp manager to improve data/time management on board
• new goldent (default) zynq bitfile included in the boot.bin which is loaded on boot of the gFEX board
  • includes a fix for the OS->IPMC temperature connection
  • if the OS doesn't update the temperatures, the zFPGA will send a default value of 0 to the IPMC
• gfex-register-access updated to latest commit e4ed467e, which includes recent register map changes.

gFEX-v2.1.0

• Update to ironman to fix RMW packet errors
• Loads zFPGA golden bitfile on boot
• Includes OPCUA server dependencies and runs the server on boot of the board

gFEX-v2.0.0

Built With:

• Vivado 2020.2
• python 3.7
• gfex-register-access 8e2ffc89
• gFEX firmware XSA file 09e1095b

Major Changes:

• All logfiles moved to /logs
• gfex-register-access add to OS in /software
• ironman run on boot of the board, with output stored in logs/ironman.log
• i2c_hardware.json in /logs is where all i2c sensors are read to
• The values are taken from this .json and then sent to the GPIO in the PL where the IPMC can access them. Temperature log stored in /logs/temp.log
• gFEX OS built with new Vivado 2020.2 workflow which uses the XSA file from the firmware build to define the device tree of the processing system. Will require an OS update when the processing system changes in the hardware design (this happens infrequently).

gFEX-v4-v1.3

OS Changes

• Argparse python module added properly (was added by hand previously)
• Device Tree changes incorporated for GPIO used to interface with the CERN IPMC card for temperature monitoring
• Temperature monitoring script runs on boot of the board and collects temperature information which is summarized and sent to the GPIO where the IPMC firmware can access it.

OS Files

CERN STF Board:

OS Build Record

Poky: c83e52cef05db827d526fd62439718fb88931379
openembedded-core: 3638cb32ba9ba32b4d498fc31ab7fdf82f0d2495
meta-xilinx: 7935ef724cd7359ed97e6ae3d90ebc8f07dd7e1f
meta-openembedded: eae996301d9c097bcbeb8046f08041dc82bb62f8
Please refer to the gFEX-v4-v1.0 release for instructions on how to update the OS.

gFEX-v4-v1.2

OS Changes

• Ironman has been updated to the most recent version.
• Temperature monitoring and automatic shutdown also added.
• The script runs on boot of the board and monitors the temperature based on the threshold set in /etc/init.d/init_auto_shutdown/constants.py
• This threshold can be edited by changing this value and restarting the board.
• Outputs temperature readings to /etc/init.d/init_auto_shutdown/temp.log

OS Files

• CERN Board: https://cernbox.cern.ch/index.php/s/IWuyywt8sb7qKPX
• BNL Board: https://cernbox.cern.ch/index.php/s/QxsHr8rwd2i9phb
• Chicago Board: https://cernbox.cern.ch/index.php/s/N1lnvQxjwUYPYfV

OS Build Record

• Poky: 5f660914cd7eec8117efccdf1eb29c466b4e74f7
• openembedded-core: 3638cb32ba9ba32b4d498fc31ab7fdf82f0d2495
• meta-xilinx: 7935ef724cd7359ed97e6ae3d90ebc8f07dd7e1f
• meta-openembedded: eae996301d9c097bcbeb8046f08041dc82bb62f8

Please refer to the gFEX-v4-v1.0 release for instructions on how to update the OS.

gFEX-v4-v1.1

OS Changes

• init-clock is functional and added. So the clock chip is initialized

OS Files

• CERN Board: https://cernbox.cern.ch/index.php/s/Qt1LWUmsSajzedZ
• BNL Board: https://cernbox.cern.ch/index.php/s/7utGHrpFc4eqZeK
• Chicago Board: https://cernbox.cern.ch/index.php/s/v2nrp6eflFHIou6

Please refer to gFEX-v4-v1.0 for instructions on how to update the OS.

gFEX-v4-v1.0

Instructions for Updating the gFEX OS

Note: If possible it is always good to use a new SD card, so we have a version of the OS that definitely works in case of problems.

OS Files
CERN Board: https://cernbox.cern.ch/index.php/s/d6SJ6Lt9QExfo0V
BNL Board: https://cernbox.cern.ch/index.php/s/9uKKZcDDGM3PESI

• Download the tar files attached to this release and extract them to your machine
• Turn off the board and remove the current SD card.
• Plug the SD Card into a windows computer using an SD card reader
• If possible, eject this SD Card and insert a new SD card so we have a backup of the OS. Otherwise continue with the current SD Card.

Using Terminal:

• Go to the terminal and navigate to the location of the core-image-gfex-gfex-prototype4.wic
• In the terminal run diskutil list to find the same of your SD card. It should look something like /dev/diskN.
• Then rundiskutil unmountDisk /dev/diskN where /dev/diskN is the name of your SD card/ This will unmount the SD card from the filesystem.
• Then run dd if=core-image-gfex-gfex-prototype4.wic of=/dev/rdiskN bs=1m This command will flash the image to the SD card. It will take a *little time, and there's absolutely no output until it completes, so don't be worried if you don't see anything.
• Remaining instructions below Windows instructions

For Windows/Mac/Linux:

• Open balenaEtcher (Can be downloaded here: https://www.balena.io/etcher/)
• Make sure the SD card is selected as the device
• Click the select button and locate the core-image-gfex-gfex-prototype4.wic file. Make sure "All Files" is selected in the file type options box in Windows Explorer, otherwise the .wic image may not show up.
• The Rufus settings should automatically be fine. Double check that your SD card is selected as the device, and select the .wic image as the Boot selection.
• Click start, and wait for the process to complete.

General Finishing Instructions:

• When balenaEtcher or the dd command has finished, copy the BOOT.BIN from the tarball you downloaded earlier to the SD Card
• Copy the system.dtb from the tarball you downloaded earlier to the SD Card with the updated OS.
• Eject the SD card from the computer.
• Plug the SD card into the board, and the board should now boot with the updated OS.