Rôle Ansible Xilinx XRT

Ce rôle Ansible installe le Xilinx XRT qui est nécessaire pour exécuter des applications basées sur des dispositifs FPGA Xilinx.

Exigences

Un dispositif FPGA Xilinx compatible est requis sur l'hôte cible.

Le rôle doit être exécuté en tant que root sur l'hôte cible.

Variables du rôle

• xilinx_xrt_install : Si true, installer XRT. Par défaut, c'est true.
• xilinx_xrt_version : Version de Xilinx XRT à installer. Par défaut, c'est la dernière version disponible.
• xilinx_xrt_from_src : Si true, installer XRT à partir des sources au lieu des paquets fournis par Xilinx. Par défaut, c'est false.
• xilinx_xrt_env : Environnement spécifique à XRT. Valeurs supportées : aws, azure. Si non spécifié, par défaut c'est l’environnement classique de Xilinx XRT.
• xilinx_xrt_platforms : Liste des plateformes FPGA. Si spécifié, installer les paquets de la plateforme de déploiement correspondante. Valeurs supportées dans la liste : u50, u55c, u200, u250, u280.
• xilinx_xrt_ensure_compatible_kernel : Si true, s'assurer que le noyau Linux installé est compatible. Par défaut, c'est false.
• xilinx_xrt_bashrc : Si true, ajouter le chemin du script d'installation de XRT à ~/.bashrc de l'utilisateur. Par défaut, c'est false.
• xilinx_xrt_check_fpga : Si true, vérifier si XRT est correctement installé en essayant de détecter le FPGA. Par défaut, c'est false.
• xilinx_xrt_container : Mettre ceci à true si le rôle est exécuté à l'intérieur d'un conteneur pour éviter les problèmes de compatibilité de version du noyau. Par défaut, c'est false.
• xilinx_xrt_rhel7_devtoolset : Version de l'ensemble d'outils de développement Red Hat à utiliser sur RHEL/CentOS 7 si elle n'est pas installée par le script d'installation des dépendances fournies par XRT. N'a aucun effet si xilinx_xrt_from_src est false. Par défaut, c'est 9.

FPGA AWS

L'environnement AWS prend en charge des variables supplémentaires associées à AWS FPGA.

Les points suivants ne sont disponibles que lorsque xilinx_xrt_env est défini sur aws.

• aws_fpga_install : Si true, installer les bibliothèques d'exécution FPGA AWS. Par défaut, c'est true.
• aws_fpga_src_install : Si spécifié, installer les sources AWS FPGA dans le répertoire spécifié. La valeur par défaut est de ne pas installer les sources.
• aws_fpga_version : Version AWS FPGA à installer. Par défaut, c'est la dernière version disponible.
• aws_fpga_allow_non_root : Si true, permettre aux périphériques FPGA l'accès à tous les utilisateurs ou utilisateurs d'un groupe spécifique. Voir aws_fpga_sdk_others. Par défaut, c'est false.
• aws_fpga_sdk_others : Si true, permettre aux périphériques FPGA l'accès à tous les utilisateurs, sinon, permettre l'accès aux utilisateurs du groupe spécifié par aws_fpga_sdk_group. Par défaut, c'est false. N'a aucun effet si aws_fpga_allow_non_root est false.
• aws_fpga_sdk_group : Nom du groupe d'utilisateurs qui peuvent accéder aux périphériques FPGA. Par défaut, c'est fpgauser. N'a aucun effet si aws_fpga_allow_non_root est false ou aws_fpga_sdk_others est true.
• aws_fpga_sdk_override_group : Si true, ne pas lever d'erreur si le groupe spécifié par aws_fpga_sdk_group existe déjà. Par défaut, c'est false. N'a aucun effet si aws_fpga_allow_non_root est false ou aws_fpga_sdk_others est true.
• aws_fpga_driver : Si spécifié, installer le pilote alternatif spécifié. Si non spécifié, utiliser le pilote par défaut XOCL. Cela peut nécessiter que xilinx_xrt_install soit défini sur False. Valeurs supportées : xdma.

Xilinx Video SDK

Variable supplémentaire associée à Xilinx Video SDK pour Alveo U30/AWS VT1.

• xilinx_video_sdk_install : Si true, installer le SDK vidéo Xilinx. Par défaut, c'est false.
• xilinx_video_sdk_version : Version du SDK vidéo Xilinx à installer. Par défaut, c'est la dernière version disponible.

Note : xilinx_xrt_install est automatiquement défini sur false avec le SDK vidéo Xilinx car il contient déjà XRT.

Exemple de Playbook

Voici un exemple de la manière d'utiliser votre rôle (par exemple, avec des variables passées en tant que paramètres) :

- hôtes : serveurs
  devenir : vrai  
  rôles :
     - rôle : accelize.xilinx_xrt

Dépendances

Le rôle accelize.linux_kernel est requis si xilinx_xrt_ensure_compatible_kernel est défini sur true.

Licence

Copyright Accelize 2019, Apache 2.0

Licences des composants installés :

• Licence Xilinx XRT
• Licence Xilinx Video SDK
• Licence AWS FPGA

Ce rôle Ansible n'est pas approuvé ni affilié à Xilinx ou AWS.

Informations sur l'auteur

Ce rôle est fourni par Accelize.