Skip to content

Scripts for host flashing, card reset and debug.

Notifications You must be signed in to change notification settings

OpenCAPI/oc-utils

Repository files navigation

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

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.

About

Scripts for host flashing, card reset and debug.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published