Simple-ZCU208-Example

Clone the GIT repository

Install git large filesystems (git-lfs) in your .gitconfig (1-time step per unix environment)

$ git lfs install

Clone the git repo with git-lfs enabled

$ git clone --recursive https://github.com/slaclab/Simple-ZCU208-Example.git

Note: recursive flag used to initialize all submodules within the clone

How to generate the RFSoC .BIT and .XSA files

1. Setup Xilinx PATH and licensing (if on SLAC AFS network) else requires Vivado install and licensing on your local machine

$ source Simple-ZCU208-Example/firmware/vivado_setup.sh

2. Go to the target directory and make the firmware:

$ cd Simple-ZCU208-Example/firmware/targets/SimpleZcu208Example/
$ make

3. Optional: Review the results in GUI mode

$ make gui

The .bit and .XSA files are dumped into the SimpleZcu208Example/image directory:

$ ls -lath SimpleZcu208Example/images/
total 47M
drwxr-xr-x 5 ruckman re 2.0K Feb  7 07:13 ..
drwxr-xr-x 2 ruckman re 2.0K Feb  4 21:15 .
-rw-r--r-- 1 ruckman re  14M Feb  4 21:15 SimpleZcu208Example-0x01000000-20220204204648-ruckman-90df89c.xsa
-rw-r--r-- 1 ruckman re  33M Feb  4 21:14 SimpleZcu208Example-0x01000000-20220204204648-ruckman-90df89c.bit

How to build Petalinux images

1. Generate the .bit and .xsa files (refer to How to generate the RFSoC .BIT and .XSA files instructions).

2. Setup Xilinx licensing and petalinux software (if on SLAC AFS network) else requires Xilinx & petalinux install on your local machine

# These setup scripts assume that you are on SLAC network
$ source Simple-ZCU208-Example/firmware/vivado_setup.sh
$ source /path/to/petalinux/2023.2/settings.sh

3. Go to the target directory and run the CreatePetalinuxProject.sh script with arg pointing to path of .XSA file:

$ cd Simple-ZCU208-Example/firmware/targets/SimpleZcu208Example/
$ source CreatePetalinuxProject.sh images/SimpleZcu208Example-0x01000000-20220204204648-ruckman-90df89c.xsa

How to make the SD memory card for the first time

1. Creating Two Partitions. Refer to URL below

https://xilinx-wiki.atlassian.net/wiki/x/EYMfAQ

2. Copy For the boot images, simply copy the files to the FAT partition. This typically will include system.bit, BOOT.BIN, image.ub, and boot.scr. Here's an example:

Note: Assumes SD memory FAT32 is /dev/sde1 in instructions below

sudo mkdir -p boot
sudo mount /dev/sde1 boot
sudo cp Simple-ZCU208-Example/firmware/build/petalinux/SimpleZcu208Example/images/linux/system.bit boot/.
sudo cp Simple-ZCU208-Example/firmware/build/petalinux/SimpleZcu208Example/images/linux/BOOT.BIN   boot/.
sudo cp Simple-ZCU208-Example/firmware/build/petalinux/SimpleZcu208Example/images/linux/image.ub   boot/.
sudo cp Simple-ZCU208-Example/firmware/build/petalinux/SimpleZcu208Example/images/linux/boot.scr   boot/.
sudo sync boot/
sudo umount boot

3. Power down the RFSoC board

4. Confirm the Mode SW2 [4:1] = 1110 (Mode Pins [3:0]). Note: Switch OFF = 1 = High; ON = 0 = Low.

5. Power up the RFSoC board

6. Confirm that you can ping the boot after it boots up

How to remote update the firmware bitstream

• Assumes the DHCP assigned IP address is 10.0.0.10

1. Using "scp" to copy your .bit file to the SD memory card on the RFSoC. Here's an example:

ssh-keygen -f "$HOME/.ssh/known_hosts" -R "10.0.0.10" # https://jira.slac.stanford.edu/browse/ESRFOC-54
scp SimpleZcu208Example-0x01000000-20220204204648-ruckman-90df89c.bit [email protected]:/boot/system.bit

2. Send a "sync" and "reboot" command to the RFSoC to load new firmware: Here's an example:

ssh [email protected] '/bin/sync; /sbin/reboot'

How to install the Rogue With Anaconda

https://slaclab.github.io/rogue/installing/anaconda.html

How to run the Rogue GUI

• Assumes the DHCP assigned IP address is 10.0.0.10

1. Setup the rogue environment (if on SLAC AFS network) else install rogue (recommend Anaconda method) on your local machine

$ source Simple-ZCU208-Example/software/setup_env_slac.sh

2. Go to software directory and lauch the GUI:

$ cd Simple-ZCU208-Example/software
$ python scripts/devGui.py --ip 10.0.0.10