Descripción general de la interfaz de usuario de la extensión VEX VS Code

Este artículo proporciona una descripción general de la interfaz de usuario (IU) de extensión de Visual Studio Code de VEX. La extensión admite el desarrollo de proyectos C++ y Python para plataformas VEX IQ 2nd Generation, EXP y V5.

Diseño de la interfaz de usuario de la extensión VEX VS Code

La interfaz de usuario de la extensión VEX Visual Studio Code se divide en cinco áreas principales: Barra de actividad, Barra lateral, Editor, Panel de terminal y Barra de herramientas.

Barra de actividades

La barra de actividades presenta una serie de íconos que nos permiten cambiar entre vistas y nos brinda indicadores adicionales específicos del contexto para el desarrollo del proyecto VEX.

Los íconos comunes utilizados para desarrollar un proyecto VEX en VS Code son:

• Icono de vista del explorador - Al hacer clic, Vista del explorador se abre en la barra lateral.
• Icono de vista de extensiones - Al hacer clic, se abre la Vista de extensiones en la barra lateral.
• Icono de vista VEX - Al hacer clic, se abre la vista VEX en la barra lateral.

Barra lateral

La barra lateral contiene diferentes vistas que nos permiten utilizar las herramientas integradas dentro de VS Code. Las vistas comunes de la barra lateral que se utilizan para realizar tareas para el desarrollo de proyectos VEX son Vista de extensión, Vista VEXy Vista del explorador.

Vista de extensión

La vista de extensión se utiliza para instalar y administrar las extensiones en VS Code. Para desarrollar software en las plataformas VEX IQ 2nd Generation, EXP y V5, necesitamos instalar la extensión VEX, la extensión C/C++ y la extensión Python.

Para obtener instrucciones paso a paso sobre cómo instalar la extensión VEX, la extensión C/C++y la extensión Python en VS Code, consulte este artículo.

Vista VEX

La vista VEX View nos permite desarrollar proyectos para VEX IQ 2.ª generación, EXP y V5 en VS Code. Hay tres categorías incluidas en la vista VEX: ACCIONES DEL PROYECTO, INFORMACIÓN DEL DISPOSITIVO VEX, y COMENTARIOS VEX.

• ACCIONES DEL PROYECTO
  Los botones debajo de ACCIONES DEL PROYECTO se utilizan para crear un nuevo proyecto VEX o importar un proyecto VEXcode existente.
  Para obtener instrucciones detalladas sobre cómo crear un proyecto VEX en VS Code, consulte este artículo para V5, este artículo para EXPy este artículo para IQ (2.º).

• INFORMACIÓN DEL DISPOSITIVO VEX
  La categoría INFORMACIÓN DEL DISPOSITIVO VEX nos proporciona una descripción general del dispositivo VEX conectado un cerebro VEX o un controlador VEX.
  
  

  

  
  Esta categoría indica el tipo de dispositivo VEX conectado y muestra la información del sistema Brain, el puerto serie, el programa descargado y los dispositivos conectados a los puertos inteligentes de VEX Brain. Nos permite capturar la pantalla del cerebro VEX, ver el registro de eventos del cerebro VEX, usar el V5 Battery Medic, establecer el nombre del cerebro y número de equipoy borrar el programa de usuario del cerebro VEX
  
  Cuando un VEX Brain está conectado a la computadora, la categoría INFORMACIÓN DEL DISPOSITIVO VEX muestra si un controlador VEX está vinculado al VEX Brain y nos permite actualizar el VEXos para el VEX Brain si la versión VEXos del VEX Brain está desactualizada.
  
  Cuando un controlador VEX está conectado a la computadora, la categoría INFORMACIÓN DEL DISPOSITIVO VEX muestra si un cerebro VEX está vinculado al controlador VEX y nos permite actualizar el VEXos para el controlador VEX si la versión VEXos del controlador VEX está desactualizada.
  
  Para obtener una descripción completa de la información del dispositivo y cómo utilizar las funciones en INFORMACIÓN DEL DISPOSITIVO VEX, consulte este artículo.

• COMENTARIOS DE VEX
  Podemos enviar comentarios a VEX escribiendo el mensaje en el cuadro de texto debajo de COMENTARIOS DE VEX y haciendo clic en el botón ENVIAR
  Para obtener información útil sobre el uso de VEX FEEDBACK en VS Code, consulte este artículo.
  
  

Vista del explorador

La vista del explorador se utiliza para explorar, abrir y administrar los archivos y carpetas del proyecto VEX en VS Code.

Editor

El Editor es el área principal para editar los archivos en VS Code. La extensión VEX VS Code habilita Intellisense/Linting tanto para C/C++ como para Python en el área del Editor para ayudarnos mientras desarrollamos el programa.

En el área del Editor, podemos acceder a información útil sobre una función específica pasando el mouse sobre el texto de la función o utilizando la Ayuda del comando VEX para acceder a la documentación de esta función incluida en la API de C++ y Python (Interfaz de programación de aplicaciones).

Para obtener instrucciones detalladas sobre el uso del comando VEX Help en VS Code, consulte este artículo.

Panel de terminales

La extensión VEX VS Code proporciona dos terminales al inicio: la terminal de registro y la terminal interactiva. 

• Terminal de registro : la Terminal de registro muestra la salida de la compilación, el error de compilación y los resultados de la descarga.
  
  

• Terminal interactivo - El terminal interactivo tiene dos funciones: mostrar registros de impresión y enviar pulsaciones de teclas sin procesar a un programa de usuario.
  
  

  

  
  
  Nota: Para utilizar la terminal interactiva, se debe conectar un cerebro o controlador a una computadora que ejecute la extensión VEX VS Code.
  Nota: La salida del terminal interactivo se borra de manera predeterminada después de crear y descargar un programa de usuario.

Barra de herramientas

La barra de herramientas presenta una serie de íconos que nos brindan una forma rápida de interactuar con proyectos de extensión VEX VS Code, VEX Brains y VEX Controllers.

Nota: La barra de herramientas solo está activa cuando hay un proyecto VEX válido abierto en VS Code. 

Nota: Un proyecto VEX válido es un proyecto creado o importado por la extensión. Los proyectos VEXcode o VEXcode Pro abiertos en el editor no se considerarán un proyecto VEX válido y deberán importarse.

Los iconos que aparecen en la barra de herramientas incluyen:

• Selector de dispositivo - El Selector de dispositivo muestra el ícono del dispositivo VEX conectado (un ícono de cerebro o un ícono de controlador )
  Nota: Si un controlador está conectado a la computadora, pero no tiene un enlace de radio a un cerebro, no se mostrará ningún nombre de cerebro junto al ícono del controlador.

• Icono de selector de ranuras - El icono de selector de nos permite elegir en qué ranura VEX Extension descargará o reproducirá un programa de usuario haciendo clic en él y seleccionando una de las ocho ranuras disponibles en VEX Brain de la lista de selección.
• Ícono de descarga de compilación & - Si hay un dispositivo VEX conectado, el Ícono de descarga se mostrará en la barra de herramientas. Al hacer clic, el proyecto se compilará y, si tiene éxito, se descargará al dispositivo VEX conectado.
• Ícono de reproducción - Al hacer clic, el Ícono de reproducción ejecuta el programa de usuario descargado en la ranura seleccionada en VEX Brain.
• Icono de parada - Al hacer clic, el Icono de parada detiene la ejecución del programa de usuario en VEX Brain.
• Selector de proyecto - El Selector de proyecto muestra el nombre del proyecto seleccionado. El ícono selector de proyecto nos permite cambiar entre proyectos VEX cuando existen varios dentro del espacio de trabajo haciendo clic en él y seleccionando un proyecto de la lista de selección.
• Selector de archivos Python (solo Python) - Cuando se selecciona un proyecto VEX Python, el Selector de archivos Python aparecerá en la barra de herramientas. El selector de archivos Python muestra el nombre del archivo Python seleccionado. Actualmente, Python para VEX solo admite descargas de archivos individuales.

Para obtener información útil sobre cómo utilizar las funciones de la barra de herramientas en VS Code, consulte este artículo.

Configuración de usuario de VEX

La configuración de usuario VEX nos permite configurar la extensión según nuestros propios requisitos. Las configuraciones de usuario son configuraciones globales que se aplican a cada proyecto de extensión de VEX VS Code. Podemos acceder a la Configuración de usuario VEX haciendo clic en el ícono de Configuración en VS Code y seleccionando los elementos correspondientes en los menús.

Las configuraciones de usuario de VEX para configurar la extensión VEX VS Code son:

• Canal del controlador (solo controlador V5) : establece el canal de radio del controlador V5 en Descargar o Pit. Esta configuración se aplica únicamente al enlace de radio VEXnet.

• Ruta de la cadena de herramientas Cpp : establece la ruta para la cadena de herramientas CPP.
• Habilitar terminal de usuario: habilita o deshabilita la extensión para abrir y mostrar datos desde el puerto de usuario.
• Entradas de registro : establece la cantidad de entradas de registro que se cargarán desde un VEX Brain.
• Tipo de compilación de proyecto : establece cómo la extensión compilará un proyecto C++.
• Inicio del proyecto : establece la ubicación predeterminada para nuevos proyectos.
• Ejecutar después de descargar : establece si el programa del usuario debe ejecutarse después de descargarse a un VEX Brain.
• Recuperación automática del sistema DFU : establece si el cerebro debe recuperarse automáticamente cuando se detecta un IQ2 o EXP en modo DFU.
• Habilitar servidor Websocket : habilita o deshabilita la extensión para iniciar el servidor Websocket.
• Dirección de host del servidor Websocket : establece la dirección de host del servidor Websocket.
• Puerto del servidor Websocket: establece el número de puerto del servidor Websocket

Para obtener información útil sobre cómo acceder y configurar la configuración de usuario de VEX, consulte este artículo.