Rola Ansible Xilinx XRT

Ta rola Ansible instaluje Xilinx XRT, który jest potrzebny do uruchamiania aplikacji opartych na urządzeniach FPGA firmy Xilinx.

Wymagania

Na docelowym hoście wymagane jest kompatybilne urządzenie FPGA firmy Xilinx.

Rola wymaga uruchomienia z uprawnieniami root na docelowym hoście.

Zmienne roli

• xilinx_xrt_install: Jeśli true, zainstaluj XRT. Domyślnie true.
• xilinx_xrt_version: Wersja Xilinx XRT do zainstalowania. Domyślnie najnowsza dostępna.
• xilinx_xrt_from_src: Jeśli true, zainstaluj XRT ze źródeł zamiast pakietów dostarczonych przez Xilinx. Domyślnie false.
• xilinx_xrt_env: Środowisko specyficzne dla XRT. Obsługiwane wartości: aws, azure. Jeśli nie określono, domyślnie klasyczne środowisko Xilinx XRT.
• xilinx_xrt_platforms: Lista platform FPGA. Jeśli określono, zainstaluj powiązane pakiety platformy docelowej. Obsługiwane wartości na liście: u50, u55c, u200, u250, u280.
• xilinx_xrt_ensure_compatible_kernel: Jeśli true, upewnij się, że zainstalowany kernel systemu Linux jest kompatybilny. Domyślnie false.
• xilinx_xrt_bashrc: Jeśli true, dodaj źródło skryptu konfiguracyjnego XRT do ~/.bashrc użytkownika. Domyślnie false.
• xilinx_xrt_check_fpga: Jeśli true, sprawdź, czy XRT jest poprawnie zainstalowane, próbując wykryć FPGA. Domyślnie false.
• xilinx_xrt_container: Ustaw na true, jeśli uruchamiasz rolę wewnątrz kontenera, aby uniknąć problemów z niezgodnością wersji kernelu. Domyślnie false.
• xilinx_xrt_rhel7_devtoolset: Alternatywna wersja zestawu narzędzi deweloperskich Red Hat do użycia w RHEL/CentOS 7, jeśli nie została zainstalowana przez skrypt instalacyjny zależności XRT. Nie dotyczy, jeśli xilinx_xrt_from_src jest false. Domyślnie 9.

AWS FPGA

Środowisko AWS wspiera dodatkowe zmienne związane z AWS FPGA.

Poniższe jest dostępne tylko, gdy xilinx_xrt_env jest ustawione na aws.

• aws_fpga_install: Jeśli true, zainstaluj biblioteki wykonawcze AWS FPGA. Domyślnie true.
• aws_fpga_src_install: Jeśli określono, zainstaluj źródła AWS FPGA w określonym katalogu. Domyślnie nie instaluj źródeł.
• aws_fpga_version: Wersja AWS FPGA do zainstalowania. Domyślnie najnowsza dostępna.
• aws_fpga_allow_non_root: Jeśli true, zezwól na dostęp do urządzeń FPGA wszystkim użytkownikom lub użytkownikom z określonej grupy. Zobacz aws_fpga_sdk_others. Domyślnie false.
• aws_fpga_sdk_others: Jeśli true, zezwól na dostęp do urządzeń FPGA wszystkim użytkownikom, w przeciwnym razie zezwól na dostęp użytkownikom w grupie określonej przez aws_fpga_sdk_group. Domyślnie false. Nie ma efektu, jeśli aws_fpga_allow_non_root jest false.
• aws_fpga_sdk_group: Nazwa grupy użytkowników, którzy mogą uzyskać dostęp do urządzeń FPGA. Domyślnie fpgauser. Nie ma efektu, jeśli aws_fpga_allow_non_root jest false lub aws_fpga_sdk_others jest true.
• aws_fpga_sdk_override_group: Jeśli true, nie zgłaszaj błędu, jeśli grupa określona przez aws_fpga_sdk_group już istnieje. Domyślnie false. Nie ma efektu, jeśli aws_fpga_allow_non_root jest false lub aws_fpga_sdk_others jest true.
• aws_fpga_driver: Jeśli określono, zainstaluj określony alternatywny sterownik. Jeśli nie określono, użyj domyślnego sterownika XOCL. Może to wymagać, aby xilinx_xrt_install było ustawione na False. Obsługiwane wartości: xdma.

Xilinx Video SDK

Dodatkowa zmienna związana z Xilinx Video SDK dla Alveo U30/AWS VT1.

• xilinx_video_sdk_install: Jeśli true, zainstaluj Xilinx video SDK. Domyślnie false.
• xilinx_video_sdk_version: Wersja Xilinx video SDK do zainstalowania. Domyślnie najnowsza dostępna.

Uwaga: xilinx_xrt_install automatycznie ustawiane jest na false przy instalacji Xilinx video SDK, ponieważ już zawiera XRT.

Przykładowy Playbook

Zawieranie przykładu, jak używać roli (na przykład z przekazywanymi zmiennymi jako parametry) jest zawsze pomocne dla użytkowników:

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

Zależności

Rola accelize.linux_kernel jest wymagana, jeśli xilinx_xrt_ensure_compatible_kernel jest ustawione na true.

Licencja

Copyright Accelize 2019, Apache 2.0

Licencje zainstalowanych komponentów:

• Licencja Xilinx XRT
• Licencja Xilinx Video SDK
• Licencja AWS FPGA

Ta rola Ansible nie jest popierana ani związana z firmami Xilinx ani AWS.

Informacje o autorze

Ta rola jest dostarczana przez Accelize.