oc-utils

OpenCAPI Utils, abbreviated as oc-utils, is a scripts repository to program the flash, reset card, reload flash and debug.

Contributing

This is an open-source project. We greatly appreciate your contributions and collaboration. Before contributing to this project, please read and agree to the rules in

• CONTRIBUTING.md

Usage

Compile:

• make: make command will compile all the source codes.
• make install/make uninstall: Copy/Remove the executable scripts in /bin, then you can call following scripts (without .sh suffix) anywhere. This is an optional step.

Scripts:

• oc-flash-script.sh primary.bin secondary.bin: Write binary files to FLASH and reloads the FPGA with this binary. You can select which card will be flashed according to the OpenCAPI card connection node.
• oc-reload.sh: Reload the image from FLASH to FPGA core. Note this is the last step of oc-flash-script process.
• oc-reset.sh: Reset one CARD as you select (Sent reset signal to FPGA). You should be aware that this is only a reset operation for a specific OpenCAPI card.
• oc-list-cards.sh: List the recorded card programming information (might not be accurate if cards have been physically exchanged).

Add "-h" to get more options for above scripts.

Example:

After git clone this repository, call oc-flash-script and oc-reload to refresh the FPGA bitstream online.

make
sudo ./oc-flash-script.sh primary.bin secondary.bin
sudo ./oc-reload.sh

For some systems, a cold reboot is required to get the new FPGA bitstream work:

sudo ./oc-flash-script.sh primary.bin secondary.bin
sudo reboot

Note:

Online updating had been verified on following FPGA cards with OC-Accel bitstreams:

• AD9V3
• AD9H3 (VU33P and VU35P)
• AD9H7
• BW250SOC

on System FP5290G2, IC922, S924 and AC922 with specific firmware (skiboot) and OS kernels.

Contact your technical support team for more information.