Getting Started¶

In order to use Graph L3, the sofware and hardware requirements should be met and the shared library (libgraphL3.so) should be built and linked in the users application.

Software Requirements¶

CentOS/RHEL 7.8 and Ubuntu 16.04 LTS
Xilinx RunTime (XRT) 2022.1
Xilinx FPGA Resource Manager (XRM) 2022.1

Hardware Requirements¶

Environment Setup¶

BASH version setup scripts are provided. Users should select their proper setup script depending on their shell version.

BASH:

source /LOCAL PATH to XRT/setup.sh
source /LOCAL PATH to XRM/setup.sh
source /LOCAL PATH to XRM/start_xrmd.sh

These scripts set up the following environment variables:

XILINX_XRT
- This points to /opt/xilinx/xrt/
XILINX_XRM
- This points to /opt/xilinx/xrm/

Build the dynamic library¶

In order to build libgraphL3.so, please follow the following steps:

cd xf_graph/L3/lib
./build_so.sh --target sw_emu/hw_emu/hw

Choose the target type and run the script. After the build is complete, libgraphL3.so should be available in Vitis_Libraries/graph/L3/lib

Run the testcases¶

There are many testcases provided for L3 APIs. In order to run testacses, please follow the following steps:

    cd xf_graph/L3/tests/cosineSimilaritySSDenseInt/
source /LOCAL PATH to VITIS/settings64.sh
export DEVICE=/LOCAL PATH to TARGET DEVICE/DEVICE.xpfm
    make run TARGET=sw_emu/hw_emu/hw

It will automatically build host.exe and xclbin file, then run the testcase of single sourse integer cosine similarity in dense graph. Other testcases could be performed by the same way.