End User Guide
This is a condensed version of what is provided in https://github.com/OpenCAPI/oc-accel. Assuming all tools are already installed, which is the case.
Compiling a bitfile on hal-fpga-x86
ssh into hal-fhga-x86 with -X to enable X forwarding. This also implies your client can receive X forwarding.
When a SNAP Config GUI shows up, select 3 items:
- Card Type (OpenCAPI3.0: AlphaData 9H3-35 (incl. VU35P with HBM) (under development))
- Action Type (HLS HelloWorld 1024b (Action to Host I/F =1024b))
- (~/ocse) OCSE_ROOT: Path to OpenCAPI Simulation Engine Root
Do not forget to save the configuration into config file and then exit.
Check file snap_env.sh script to make sure it has "export OCSE_ROOT=~/ocse".
You should see "HELLO WORLD_1024. THIS IS MY FIRST CAPI SNAP EXPERIENCE. IT'S REAL FUN."
This concludes the software simulation test.
To compile bitfile for FPGA
This will take an hour+ and eventually will produce an image in ~/oc-accel/hardware/build/Images/. Copy this image to the corresponding location on hal-fpga server, if the location already exists (see next section).
Executing on hal-fpga
ssh into hal-fpga.
At this point, scp compiled image from hal-fpga-x86:
And finally load bitfile and run the example:
Note that sudo is required for working with the card. Need to ask Yan to either add relevant users to sudoers, or to enable execution of specific tools with su privileges.