6.6. bora user guide

bora takes its name from Borá, which is a small town and municipality located in the state of São Paulo in Brazil.

The OmpSs-2@FPGA releases are automatically installed in the server. They are available through a module file for each target architecture. This document describes how to load and use the modules to compile an example application. Once the modules are loaded, the workflow in the server should be the same as in the Docker images.

6.6.1. General remarks

  • The OmpSs-2@FPGA toolchain is installed in a version folder under the /opt/bsc/ directory.

  • Third-party libraries required to run some programs are installed in the corresponding folder under the /opt/lib/ directory.

  • The rest of the software (Xilinx toolchain, modules, etc.) is installed under the /tools/ directory.

6.6.2. Logging into the system

bora is accessible at IP 84.88.51.137:

ssh 84.88.51.137

Also, this can be automated by adding a bora host into ssh config:

Host bora
    HostName 84.88.51.137

6.6.3. Module structure

The ompss-2 modules are:

  • ompss-2/x86_64/*[release version]*

This will automatically load the default Vivado version, although an arbitrary version can be loaded before ompss:

module load vivado/2024.2 ompss-2/x86_64/git

To list all available modules in the system run:

module avail

6.6.4. Build applications

To generate an application binary and bitstream, you could refer to Compile OmpSs-2@FPGA programs as the steps are general enough.

Note that the appropriate modules need to be loaded. See Module structure.