Desarrollo de FPGA para Intel® oneAPI
Kits de herramientas con Visual Studio Code en Linux*
Guía del usuario

FPGA Development oneAPI Toolkits con Visual Studio Code en Linux

Desarrollo de FPGA para kits de herramientas Intel® oneAPI con Visual Studio Code en Linux
Puede integrar el kit de herramientas Intel® oneAPI Base con Visual Studio (VS) Code en Linux* para admitir un entorno de desarrollo de software perfecto. Puede usar código VS para el desarrollo de FPGA de la misma manera que lo usaría para CPU o GPU. El proceso es el mismo para configurar las variables de entorno de oneAPI, iniciar VS Code, crear un proyecto desde comoamparchivo y edición de código.
NOTA

• Si es usuario de Windows*, siga las instrucciones que aparecen en Desarrollo de un proyecto de Visual Studio Code* para el desarrollo SSH en el subsistema de Windows para Linux* para configurar su sistema y luego siga las instrucciones proporcionadas en este documento.
• Si estás trabajando con el Empezar | Intel® DevCloud, referirse a Usando VSCode | Intel® DevCloud que también describe cómo usar VS Code sampextensión del navegador en Intel® DevCloud, incluido el flujo de trabajo FPGA.
• Para configurar el entorno de su sistema y los ajustes para los kits de herramientas Intel oneAPI, instale el Configurador de entorno y lanzamiento para kits de herramientas Intel® oneAPI extensión para Visual Studio Code.

El flujo de desarrollo de FPGA implica los siguientes pasos:

1. Configuración de las variables de entorno.
2. Construya y ejecute la imagen de emulación utilizando el método de compilación rápida.
3. Generando y viewing el informe de optimización HTML estático.
4. Construyendo y ejecutando una imagen de hardware FPGA real.

Para obtener más información sobre este flujo de trabajo, consulte la Flujo FPGA sección de la Guía de programación Intel® oneAPI.
Prerrequisitos
Descargue e instale el siguiente software:

• Kit de herramientas básico de Intel® oneAPI
• Código de Visual Studio en Linux*

Configure las variables de entorno e inicie Visual Studio Code
Realice estos pasos para configurar las variables de entorno:

1. Abra una sesión de terminal.
2. Localice el script setvars.sh. La ubicación depende de su instalación de oneAPI y será una de las siguientes:
   • Si instaló como root o sudo, busque el script en el directorio raíz de su instalación de oneAPI, que normalmente es /opt/intel/oneapi.
   • Si no instaló como sudo o root, busque el script en el directorio ~/intel/oneapi/.
   • Si personalizó la carpeta de instalación, busque el script en su carpeta de instalación personalizada.
3. Ejecute el script setvars.sh desde la línea de comando usando el siguiente comando: fuente /setvars.sh
   Para obtener más información, consulte Establecer variables de entorno para el desarrollo de CLI.
4. En la misma sesión de terminal, inicie VS Code ejecutando el siguiente comando: code
   NOTA
   El beneficio de obtener el script oneAPI setvars.sh antes de iniciar VS Code es que todas las sesiones de terminal y procesos secundarios de VS Code incluyen la configuración del entorno de desarrollo oneAPI.

Instale oneAPI SampExtensión del navegador

Puedes navegar y descargar samparchivos en Visual Studio Code usando Sampla extensión del navegador. Realice estos pasos para instalar la extensión:

1. En VS Code, haga clic en el logotipo de Extensiones en la navegación izquierda.
2. Localice la extensión titulada Sample Browser para kits de herramientas Intel oneAPI o visite https://marketplace.visualstudio.com/publishers/intel-corporation para explorar las extensiones disponibles.
3. Haga clic en Instalar.
4. Después de instalar la extensión, haga clic en el icono de oneAPI para view una lista de s disponiblesamparchivos en el panel de navegación izquierdo.

Para una demostración rápida, consulte Explorando oneAPI Samples con la Sampel navegador en Visual Studio Code.

Cree y ejecute la imagen de emulación FPGA para una compilación rápida

La imagen de emulación FPGA es una compilación de ejecución rápida que puede ayudarle a lograr un código funcionalmente correcto. Para obtener información detallada, consulte Tipos de compilación FPGA en la Guía de programación Intel® oneAPI. Puedes compilar un FPGA básicoamparchivo al destino del emulador FPGA realizando lo siguiente:
NOTA
No todas las oneAPIampLos proyectos utilizan CMake. El archivo README.md file para cada unoample especifica cómo construir el sample. Para samparchivos que usan CMake, Intel® recomienda consultar la Extensión de herramientas CMake para estudio visual Artículo de código mantenido por Microsoft*.

1. En la sección FPGA > Tutoriales, coloque el cursor sobre Compile Flow samparchivo y haga clic en + para crear un proyecto.Se le promocionará para que seleccione una carpeta para guardar el proyecto.
2. Guarde el proyecto. Ahora está abierta una nueva sesión de VS Code con Compile Flow sampel.
3. Abra una terminal en VS Code.
4. Ejecute el comando cd para pasar al directorio de nivel superior del proyecto recién creado.
5. Ejecute el siguiente comando para crear un directorio llamado build: mkdir build
6. Ejecute el comando cd para pasar al directorio de compilación recién creado.
7. Ejecute el siguiente comando para construir el sample. La construcción del proyecto. files se escriben en el directorio de compilación. cmake..
8. Ejecute el siguiente comando para seleccionar el destino de compilación de la emulación: make fpga_emu
   NOTA Consulte el código FPGA sampel archivo LÉAME file para encontrar el objetivo correcto.
   Ahora debería observar un ejecutable llamado compile_flow.fpga_emu en su directorio. Usa esto file como ejecutable del emulador para el diseño.
9. Ejecute el siguiente comando para ejecutar el ejecutable del emulador: ./compile_flow.fpga_emu

Desarrollo de FPGA para kits de herramientas Intel® oneAPI con Visual Studio Code en Linux*

Generar y View el informe de optimización de FPGA

El informe de optimización de FPGA puede proporcionar detalles de alto nivel sobre el rendimiento de su aplicación incluso antes de ejecutar una imagen de hardware FPGA real.
NOTA
El informe lo genera el compilador Intel® oneAPI DPC++/C++ en forma de páginas HTML que puede view En un web navegador. Para obtener más información sobre el uso del informe de optimización de FPGA para lograr el mejor rendimiento, consulte la Review el informe.html sección en la Guía de optimización de FPGA para kits de herramientas Intel® oneAPI.

1. Asegúrese de estar en el directorio de compilación en la sesión del terminal VS Code.
2. Ejecute el siguiente comando para generar el informe: make report
3. Vaya al directorio compile_flow_report.prj/reports y busque el informe de optimización que generó. cd compilar_flujo_report.prj/reports
4. Utilice el siguiente comando para iniciar el informe en el navegador Mozilla Firefox*: firefox report.html

Construya y ejecute la imagen de hardware FPGA

En este paso, creará un ejecutable destinado a ejecutarse en un hardware FPGA real. Es posible que tarde varias horas en completarse. Referirse a Requisitos del sistema del compilador Intel ® oneAPI DPC++/C++ para conocer la configuración recomendada del sistema de compilación. Otras advertencias incluyen las siguientes:

• Para crear la imagen de hardware FPGA, ejecute el comando make fpga, que es el destino de creación no predeterminado. Consulte el código FPGA sampel archivo LÉAME file para pasos detallados.
• Para crear un ejecutable, debe instalar el software Intel® Quartus® Prime Pro Edition y los BSP por separado. Para obtener más información, consulte la Flujo de desarrollo de Intel® FPGA para oneAPI webPagina y Guía de instalación de los kits de herramientas Intel oneAPI para conocer los pasos para instalar el software.
• Para ejecutar el ejecutable, necesita un hardware FPGA en su sistema. Para obtener más información sobre cómo configurar el sistema, consulte Instalar software para Flujo de desarrollo de Intel® FPGA.

Referencias

• Explorando oneAPI Samples con la Sampel navegador en Visual Studio Code
• Explore SYCL* a través de Intel® FPGA Code SampLos
• Guía de instalación para kits de herramientas Intel® oneAPI
• Comience con la distribución Intel® para GDB* en el host del sistema operativo Linux*
• Comience con Intel® oneAPI Base Toolkit para Linux*
• Guía de programación de Intel® oneAPI
• Guía de optimización de FPGA para kits de herramientas Intel® oneAPI

Avisos y exenciones de responsabilidad
Las tecnologías Intel pueden requerir la activación de hardware, software o servicio habilitado.

Desarrollo de FPGA para kits de herramientas Intel® oneAPI con Visual Studio Code en Linux
Ningún producto o componente puede ser absolutamente seguro.
Sus costos y resultados pueden variar.
© Corporación Intel. Intel, el logotipo de Intel y otras marcas de Intel son marcas comerciales de Intel Corporation o sus subsidiarias. Otros nombres y marcas pueden reclamarse como propiedad de terceros.
Información sobre el producto y el rendimiento
El rendimiento varía según el uso, la configuración y otros factores. Obtenga más información en www.Intel.com/PerformanceIndex.
Aviso revisión #20201201
A menos que se indique lo contrario, el código exampLos archivos de este documento se le proporcionan bajo una licencia MIT, cuyos términos son los siguientes:
Copyright 2022 Corporación Intel®
Por la presente se concede permiso, sin cargo, a cualquier persona que obtenga una copia de este software y la documentación asociada. files (el “Software”), para tratar el Software sin restricción, incluyendo sin limitación los derechos para usar, copiar, modificar, fusionar, publicar, distribuir, sublicenciar y/o vender copias del Software, y para permitir que las personas a quienes se les proporciona el Software lo hagan, sujeto a las siguientes condiciones:
El aviso de derechos de autor anterior y este aviso de permiso se incluirán en todas las copias o partes sustanciales del Software.
EL SOFTWARE SE PROPORCIONA “TAL CUAL”, SIN GARANTÍA DE NINGÚN TIPO, EXPRESA O IMPLÍCITA, INCLUYENDO, ENTRE OTRAS, LAS GARANTÍAS DE COMERCIABILIDAD, IDONEIDAD PARA UN PROPÓSITO PARTICULAR Y NO INFRACCIÓN. EN NINGÚN CASO LOS AUTORES O TITULARES DE LOS DERECHOS DE AUTOR SERÁN RESPONSABLES DE NINGUNA RECLAMACIÓN, DAÑO U OTRA RESPONSABILIDAD, YA SEA EN UNA ACCIÓN CONTRACTUAL, EXTRACONTRACTUAL O DE OTRO MODO, QUE SURJA DE, A PARTIR DE O EN CONEXIÓN CON EL SOFTWARE O EL USO U OTRAS OPERACIONES EN EL SOFTWARE.

Documentos / Recursos

Intel FPGA Development oneAPI Toolkits con Visual Studio Code en Linux [pdf] Guía del usuario Desarrollo de FPGA kits de herramientas oneAPI con Visual Studio Code en Linux, desarrollo de kits de herramientas oneAPI con Visual Studio Code en Linux, kits de herramientas oneAPI con Visual Studio Code en Linux, Visual Studio Code en Linux, Studio Code en Linux, Code en Linux, Linux

Referencias

• Manual de usuario