Xilinx XRT Ansible Rolle

Diese Ansible-Rolle installiert Xilinx XRT, das benötigt wird, um Anwendungen zu betreiben, die auf Xilinx FPGA-Geräten basieren.

Anforderungen

Ein kompatibles Xilinx FPGA-Gerät wird auf dem Ziel-Host benötigt.

Die Rolle muss mit Root-Rechten auf dem Ziel-Host ausgeführt werden.

Rollenvariablen

• xilinx_xrt_install: Wenn true, wird XRT installiert. Standardmäßig true.
• xilinx_xrt_version: Zu installierende Xilinx XRT-Version. Standardmäßig die neueste verfügbare Version.
• xilinx_xrt_from_src: Wenn true, wird XRT aus dem Quellcode anstelle von Xilinx-Paketen installiert. Standardmäßig false.
• xilinx_xrt_env: XRT-spezifische Umgebung. Unterstützte Werte: aws, azure. Wenn nicht angegeben, wird die klassische Xilinx XRT-Umgebung verwendet.
• xilinx_xrt_platforms: Liste der FPGA-Plattformen. Wenn angegeben, werden die zugehörigen Pakete für die Zielplattform installiert. Unterstützte Werte in der Liste: u50, u55c, u200, u250, u280.
• xilinx_xrt_ensure_compatible_kernel: Wenn true, wird sichergestellt, dass der installierte Linux-Kernel kompatibel ist. Standardmäßig false.
• xilinx_xrt_bashrc: Wenn true, wird der Quelltext des XRT-Setup-Skripts zur Benutzerdatei ~/.bashrc hinzugefügt. Standardmäßig false.
• xilinx_xrt_check_fpga: Wenn true, wird überprüft, ob XRT ordnungsgemäß installiert ist, indem versucht wird, das FPGA zu erkennen. Standardmäßig false.
• xilinx_xrt_container: Setzen Sie dies auf true, wenn die Rolle innerhalb eines Containers ausgeführt wird, um Probleme mit der Kernelversion zu vermeiden. Standardmäßig false.
• xilinx_xrt_rhel7_devtoolset: Fallback-Version des Red Hat Developer Toolset, die auf RHEL/CentOS 7 verwendet wird, wenn sie nicht durch das Installationsskript der von XRT bereitgestellten Abhängigkeiten installiert ist. Hat keine Wirkung, wenn xilinx_xrt_from_src auf false steht. Standardmäßig 9.

AWS FPGA

Die AWS-Umgebung unterstützt zusätzliche Variablen für AWS FPGA.

Die folgenden Variablen sind nur verfügbar, wenn xilinx_xrt_env auf aws gesetzt ist.

• aws_fpga_install: Wenn true, werden die AWS FPGA-Laufzeitbibliotheken installiert. Standardmäßig true.
• aws_fpga_src_install: Wenn angegeben, werden die AWS FPGA-Quellen im angegebenen Verzeichnis installiert. Standardmäßig werden keine Quellen installiert.
• aws_fpga_version: Zu installierende AWS FPGA-Version. Standardmäßig die neueste verfügbare Version.
• aws_fpga_allow_non_root: Wenn true, dürfen FPGA-Geräte von allen Benutzern oder von Benutzern einer bestimmten Gruppe verwendet werden. Siehe aws_fpga_sdk_others. Standardmäßig false.
• aws_fpga_sdk_others: Wenn true, dürfen FPGA-Geräte von allen Benutzern verwendet werden, andernfalls nur von Benutzern in der Gruppe, die durch aws_fpga_sdk_group angegeben ist. Standardmäßig false. Hat keine Wirkung, wenn aws_fpga_allow_non_root auf false steht.
• aws_fpga_sdk_group: Name der Benutzergruppe, die auf FPGA-Geräte zugreifen kann. Standardmäßig fpgauser. Hat keine Wirkung, wenn aws_fpga_allow_non_root auf false oder aws_fpga_sdk_others auf true steht.
• aws_fpga_sdk_override_group: Wenn true, wird kein Fehler ausgegeben, wenn die durch aws_fpga_sdk_group angegebene Gruppe bereits existiert. Standardmäßig false. Hat keine Wirkung, wenn aws_fpga_allow_non_root auf false oder aws_fpga_sdk_others auf true steht.
• aws_fpga_driver: Wenn angegeben, wird der angegebene alternative Treiber installiert. Wenn nicht angegeben, wird der Standard-XOCL-Treiber verwendet. Dies kann erfordern, dass xilinx_xrt_install auf False gesetzt ist. Unterstützte Werte: xdma.

Xilinx Video SDK

Zusätzliche Variable, die mit dem Xilinx Video SDK für Alveo U30/AWS VT1 verbunden ist.

• xilinx_video_sdk_install: Wenn true, wird das Xilinx Video SDK installiert. Standardmäßig false.
• xilinx_video_sdk_version: Zu installierende Xilinx Video SDK-Version. Standardmäßig die neueste verfügbare.

Hinweis: xilinx_xrt_install wird automatisch auf false gesetzt, wenn das Xilinx Video SDK verwendet wird, da es bereits XRT enthält.

Beispiel Playbook

Es ist immer hilfreich für die Benutzer, ein Beispiel zu zeigen, wie man Ihre Rolle verwendet (z. B. mit übergebenen Parametern):

- hosts: servers
  become: true  
  roles:
     - role: accelize.xilinx_xrt

Abhängigkeiten

Die Rolle accelize.linux_kernel wird benötigt, wenn xilinx_xrt_ensure_compatible_kernel auf true gesetzt ist.

Lizenz

Copyright Accelize 2019, Apache 2.0

Lizenzen der installierten Komponenten:

• Xilinx XRT Lizenz
• Xilinx Video SDK Lizenz
• AWS FPGA Lizenz

Diese Ansible-Rolle wird nicht von Xilinx oder AWS unterstützt oder ist mit diesen verbunden.

Autoreninformation

Diese Rolle wird von Accelize bereitgestellt.