Use the Xilinx RunTime (XRT) shell to implement ESI services and build an
image or emulation package.
How to use this BSP:
- Wrap your top PyCDE module in `XrtBSP`.
- Run your script. This BSP will write a 'build package' to the output dir.
This package contains a Makefile.xrt.mk which (given a proper Vitis dev
environment) will compile a hw image or hw_emu image. It is a free-standing
build package -- you do not need PyCDE installed on the same machine as you
want to do the image build.
- To build the `hw` image, run 'make -f Makefile.xrt TARGET=hw'. If you want
an image which runs on an Azure NP-series instance, run the 'azure' target
(requires an Azure subscription set up with as per
https://learn.microsoft.com/en-us/azure/virtual-machines/field-programmable-gate-arrays-attestation).
This target requires a few environment variables to be set (which the Makefile
will tell you about).
- To build a hw emulation image, run make with TARGET=hw_emu.
- At "runtime" set XCL_EMULATION_MODE=hw_emu.
- Validated ONLY on Vitis 2023.1. Known to NOT work with Vitis <2022.1.
- Vitis spins up a number of jobs and can easily consume all available memory.
- Specify the JOBS make variable to limit the number of jobs.
- To adjust the desired clock frequency, set the FREQ (in MHz) make variable.
Definition at line 162 of file xrt.py.
References wrap().
