Introduction

This confluence page describes how to build the firmware.  For this project, there are two flavors of firmware: "Simple" and "PGP".

Licensing

If you are building on a SLAC server:

$ cd /u1/ExampleRceProject/firmware

$ source setup_env.csh

If you are building on a remote server, you (or your IT department) will be responsible for setting up the FLEX_LM licensing server and install Vivado software

Creating a build output directory

$ cd /u1/ExampleRceProject/firmware

$ mkdir build

Building SimpleDpm

This is a simple example firmware that has no high speed IOs interfaces. DMA[2:1] are configured as loopback channels.  The outbound DMA[0] channel is terminated to prevent back pressure if sent from software.  The inbound DMA[0] channel is connnected to a SimpleBlockDiagram.png

The following are the steps to building the firmware .bit image file:

$ cd /u1/ExampleRceProject/firmware/target/SimpleDpm/

$ make

Building SimpleDtm

The following are the steps to building the firmware .bit image file:

$ cd /u1/ExampleRceProject/firmware/target/SimpleDtm/

$ make

Building PgpDpm

$ cd /u1/ExampleRceProject/firmware/target/PgpDpm/

$ make

Building PgpDtm

The following are the steps to building the firmware .bit image file:

$ cd /u1/ExampleRceProject/firmware/target/PgpDtm/

$ make

Updating the .bit image on the SD memory card

The .bit image on the SD memory card can be updated using the following commands:

$ scp $TARGET_PATH root@$IP_ADDRESS:/mnt/boot/fpga.bit

$ ssh root@$IP_ADDRESS

# sync

# reboot

Where $TARGET_PATH is the path to the new .bit file and $IP_ADDRESS is the IP address of the RCE that you want to update.  The "sync" command synchronizes the SD memory card.