Gateware/Software for Direct-Sampling Beam Position Monitor

This repository contains both gateware and software for the Direct-Sampling Beam Position Monitor.

To build the gateware the following dependencies are needed:

• GNU Make
• Xilinx Vivado (2022.1 tested), available here
• Xilinx Vitis (2022.1 tested), available here

Make sure vivado and vitis are in PATH.

To build the software the following dependencies are needed:

• aarch64-none toolchain, bundled within Vitis

With the dependencies in place a simple make should be able to generate both gateware and software, plus the SD boot image .bin.

make

A suggestion in running the make command is to measure the time and redirect stdout/stderr to a file so you can inspect it later:

ARM_TOOLCHAIN_LOCATION=/media/Xilinx/Vivado/2022.1/Vitis/2022.1/gnu/aarch64/lin/aarch64-none
(time make PLATFORM=<PLATFORM_NAME> APP=<APP_NAME> CROSS_COMPILE=${ARM_TOOLCHAIN_LOCATION}/bin/aarch64-none-elf-; date) 2>&1 | tee make_output

For now the following combinations of PLATFORM and APP are supported:

So, for example, to generate the DSBPM application for the ZCU208 board:

ARM_TOOLCHAIN_LOCATION=/media/Xilinx/Vivado/2022.1/Vitis/2022.1/gnu/aarch64/lin/aarch64-none
(time make PLATFORM=zcu208 APP=dsbpm CROSS_COMPILE=${ARM_TOOLCHAIN_LOCATION}/bin/aarch64-none-elf-; date) 2>&1 | tee make_output

To deploy the gateware and the software we can use a variety of methods. For development, JTAG is being used. Remember to check the DIP switches on development boards and ensure the switches are set to JTAG mode and NOT SD Card mode.

The following script can download the gateware via JTAG:

cd gateware/scripts
xsct download_bit.tcl ../syn/dsbpm_zcu208/dsbpm_zcu208_top.bit

The following script can download the software via JTAG:

cd software/scripts
xsct download_elf.tcl ../../gateware/syn/dsbpm_zcu208/psu_init.tcl ../app/dsbpm/dsbpm_zcu208.elf

The following system parameters can be updated via TFTP:

• RF table
• Pilot Tone table
• System parameters
• Gateware + Software boot file (BOOT.bin)

An example of the parameters used can be found at: software/app/dsbpm/scripts/sysParms.csv

tftp -v -m binary <system IP> -c put sysParms.csv sysParms.csv

An example of the RF table can be found at: software/app/dsbpm/scripts/rfTableSR_81_328_bin_20_conjugate.csv

tftp -v -m binary <system IP> -c put <RF TABLE>.csv rfTable.csv

An example of the PT table can be found at: software/app/dsbpm/scripts/ptTableSR_81_328_11_19_bin_20_conjugate.csv

tftp -v -m binary <system IP> -c put <PT TABLE>.csv ptTable.csv

tftp -v -m binary <system IP> -c put BOOT.bin BOOT.bin

When copying BOOT.bin, the user needs to reboot the system via a power cycle or via the console boot command.

Another option to upgrade the image is to use the programFlash.sh script located at: software/app/dsbpm/scripts. The script will automatically readback the image file from the system and peform a byte-to-byte comparison to detect possible transmission errors.

cd software/app/dsbpm
sh ./scripts/programFlash.sh <system IP> [BOOT.bin filename]

If BOOT.bin filename is missing the current path is assumed.