Simple-ZCU208-Example

Clone the GIT repository

$ 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

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

Go to the target directory and make the firmware:

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

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

Generate the .bit and .xsa files (refer to How to generate the RFSoC .BIT and .XSA files instructions).
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/2022.2/settings.sh

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

Creating Two Partitions. Refer to URL below

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

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

Power down the RFSoC board
Confirm the Mode SW2 [4:1] = 1110 (Mode Pins [3:0]). Note: Switch OFF = 1 = High; ON = 0 = Low.
Power up the RFSoC board
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

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 root@10.0.0.10:/boot/system.bit

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

ssh root@10.0.0.10 '/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

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

Go to software directory and lauch the GUI:

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

cisen/Simple-ZCU208-Example