Checklist¶
Goal¶
The goals of the checklist are to:
Verify that your xbtest xclbin will work on your Alveo™ platform.
Customize xbtest for your platform. xbtest SW is generic and works with all platforms and thus requires being customized. This is done via a platform definition JSON file (this file is loaded by xbtest SW at execution).
The generation of the xclbin produces 2 sets of templates:
Platform definition JSON file:
xbtest_pfm_def_template.json
. See Fill platform definition JSON.Pre-canned tests:
test/*.json
. See Select pre-canned tests.
By doing this checklist, you will fill along your platform definition JSON file which will be used to particularize xbtest SW to your platform. You’ll be also required to run the pre-canned tests.
Important
The first initial run of pre-canned tests will report errors as the platform definition template contains standard thresholds (which you’ll update while filling the checklist).
If a default pre-canned test is failing, and it’s because a nominal setting is wrong. Then you should update the setting in platform definition JSON file. It’s an iterative process.
You should complete a new checklist for each xbtest package delivery.
Prerequisite¶
Some tests are run while completing your checklist.
These tests shall ideally be run on a DELL PowerEdge R740 or R7525 server set with 100% fan speed.
If other cards are present in the server, they shall not be used.
Released version of Xilinx Runtime (XRT) compatible with xbtest shall be used.
Steps¶
Follow the checklist instructions:
These instructions will guide you to complete your checklist by filling the following template (All <TBC>
will be replaced).
Refer to the following examples of checklist filled for various platforms: