This Ansible role install the Xilinx XRT that is required to run Xilinx FPGA devices based applications.
A compatible Xilinx FPGA device is required on the target host.
The role requires to be run as root on the target host.
- xilinx_xrt_install: If
true
, install XRT. Default totrue
. - xilinx_xrt_version: Xilinx XRT version to install. Default to the latest available.
- xilinx_xrt_from_src: If
true
, install XRT from sources instead of Xilinx provided packages. Default tofalse
. - xilinx_xrt_env: XRT specific environment.
Supported values:
aws
,azure
. If not specified, default to the classical Xilinx XRT environment. - xilinx_xrt_ensure_compatible_kernel: If
true
, ensure the Linux kernel installed is compatible. Default totrue
. - xilinx_xrt_bashrc: If
true
, add the source of the XRT setup script to the user~/.bashrc
. Default tofalse
. - xilinx_xrt_check_fpga: If
true
, check if XRT is properly installed by trying to detect FPGA. Default tofalse
. - xilinx_xrt_container: Set this to
true
if running the role inside a container to avoid kernel version mismatch issues. Default tofalse
. - xilinx_xrt_rhel7_devtoolset: Fallback Red Hat Developer Toolset version to use on RHEL/CentOS 7 if not installed by XRT provided dependencies install script.
No effect if xilinx_xrt_from_src is
false
. Default to9
.
AWS environment support extra variables associated to AWS FPGA.
The following is only available when xilinx_xrt_env is set to aws
.
- aws_fpga_install: If
true
, install AWS FPGA runtime libraries. Default totrue
. - aws_fpga_src_install: If specified, install AWS FPGA sources in the specified directory. Default is to not install sources.
- aws_fpga_version: AWS FPGA version to install. Default to the latest available.
- aws_fpga_allow_non_root: If
true
, allow FPGA devices access to users in the group specified by aws_fpga_sdk_group. Default tofalse
. - aws_fpga_sdk_group: Name of the group of users that can access to FPGA devices.
Default to
fpgauser
. No effect if aws_fpga_allow_non_root isfalse
. - aws_fpga_sdk_override_group: If true, do not raise error if the group specified by aws_fpga_sdk_group already exists.
Default to
false
. No effect if aws_fpga_allow_non_root isfalse
. - aws_fpga_driver: If specified, install the specified alternate driver.
If not specified use the default XOCL driver.
This may require xilinx_xrt_install set to
False
. Supported values:xdma
.
Including an example of how to use your role (for instance, with variables passed in as parameters) is always nice for users too:
- hosts: servers
become: true
roles:
- role: accelize.xilinx_xrt
The role accelize.linux_kernel is required if xilinx_xrt_ensure_compatible_kernel is set to true
.
Copyright Accelize 2019, Apache 2.0
Installed components licences:
This Ansible role is not endorsed or affiliated by Xilinx or AWS.
This role is provided by Accelize.