How to install the Software With Anaconda

• Step 1: Go to https://www.anaconda.com/download to get the latest version of anaconda. Example steps for installing anaconda are included below:
  $ cd /opt/slac

$ wget https://repo.anaconda.com/archive/Anaconda3-2020.07-Linux-x86_64.sh
$ bash Anaconda3-2020.07-Linux-x86_64.sh

• Step 2: Use the following command to add anaconda to your environment. This can be added to your .bash_profile.

$ source /opt/slac/anaconda3/etc/profile.d/conda.sh

• Step 3: Build the "snl-trans-FES" conda environment

$ conda create -n snltransfeskcu1500 -c tidair-packages -c conda-forge -c pydm-tag -c tidair-tag snltransfeskcu1500

How to reprogram the firmware on the KCU1500

Assumes you have completed "How to install the Software With Anaconda" section already

• Step 1: Load the snltransfeskcu1500 conda environment

$ source /opt/slac/anaconda3/etc/profile.d/conda.sh

$ conda activate snltransfeskcu1500

• Step 2: Program the KCU1500 PROMs

$ updatePcieFpga --path path_to_image_dir

• Step 3: reboot the machine

$ sudo reboot

How to run the baseline python software

Assumes you have completed "How to install the Software With Anaconda" and "How to reprogram the firmware on the KCU1500" sections already

• Step 1: Load the snltransfeskcu1500 conda environment

$ source /opt/slac/anaconda3/etc/profile.d/conda.sh

$ conda activate snltransfeskcu1500

• Step 2: Download the .h5 data file

$ wget https://slac.stanford.edu/~ruckman/TestDataCheck.h5

• Step 3: Run the baseline python software

$ fesGui --guiType None --h5Path TestDataCheck.h5

Required Updates To Driver

• Edit files in the driver to match this diff:

https://github.com/slaclab/aes-stream-drivers/compare/realtime...lock_cpu

The important changes are in the 5 edits in axis_gen2.c

The other changes are related to a kernel update which requires pr_warning to be replaced with pr_warn