Descripción general de la interfaz de usuario de VS Code para V5

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

Captura de pantalla que muestra la interfaz de usuario completa de VEX VS Code. La barra de actividad y la barra lateral se encuentran en el lado izquierdo de la pantalla, la barra de herramientas y la terminal están en la parte inferior de la pantalla, y el editor ocupa el resto de la pantalla.

Componentes de la interfaz de usuario

Hay 3 componentes principales en la extensión de código VEX VS.

  1. Barra de herramientas
  2. Barra de actividades y barra lateral
  3. Panel de terminales

Barra de herramientas

La barra de herramientas ofrece a los usuarios una forma rápida de interactuar con los proyectos de extensión de VEX para VS Code: VEX Brains y VEX Controllers. La barra de herramientas solo está activa cuando hay un proyecto VEX válido abierto en VS Code. Un proyecto VEX válido es un proyecto creado o importado por la extensión. Abrir un proyecto VEXcode o VEXcode Pro no es válido y deberá importarse.

Barra de herramientas de VS Code con iconos de extensión VEX que permiten interactuar rápidamente con los dispositivos y proyectos VEX conectados. Las funciones de VEX incluyen el selector de dispositivos, el selector de ranuras, el icono de descarga de compilación & , el icono de reproducción, el icono de parada, el selector de proyectos y el selector de archivos Python.

Selector de dispositivos

El icono de Selector de dispositivos está resaltado en la barra de herramientas de VS Code. En este ejemplo se lee VEX_V5.

El selector de dispositivos tiene dos funciones principales. Primero, muestra un ícono de cerebro o controlador que representa el tipo de dispositivo VEX conectado.

Barra de búsqueda de VS Code con una lista de selección rápida de todos los dispositivos VEX conectados. En este ejemplo, aparecen listados un V5 Brain, un V5 Controller y un EXP Controller.

En segundo lugar, cuando se hace clic en el icono de la lista de dispositivos, aparece una lista de selección rápida con todos los dispositivos VEX conectados. El usuario puede seleccionar a qué dispositivo se conectará la extensión.
El dispositivo conectado actualmente siempre aparecerá en la parte superior de la lista seguido de todos los demás dispositivos ordenados por tipo de dispositivo (cerebro o controlador) y plataforma (IQ 2nd Generation, EXP y V5).

Barra de búsqueda de VS Code con un elemento de la lista de selección rápida que se muestra para proporcionar detalles. El elemento dice MyBrain, V5 Brain, User COM8, Comm COM7.

Cada elemento del dispositivo contiene información sobre el nombre del cerebro, la plataforma, el tipo de dispositivo y la ruta del dispositivo.

Barra de búsqueda de VS Code con un elemento de la lista de selección rápida que se muestra para proporcionar detalles. El artículo es un controlador V5, pero el fondo está atenuado y no aparece el nombre del dispositivo. Esto indica que este controlador no tiene conexión por radio con un cerebro.

El controlador V5 tiene un fondo azul para indicar que este controlador tiene conexión por radio con un cerebro.

Importante

Si un controlador está conectado a una computadora, pero no tiene un enlace de radio con un cerebro, no se mostrará ningún nombre de cerebro junto al elemento de la lista o al ícono de la barra de estado de la lista de dispositivos.

Selector de ranura

El icono del selector de ranuras está resaltado en la barra de herramientas de VS Code. En este ejemplo se lee Ranura 1.

El icono del selector de ranura permite al usuario elegir en qué ranura descargará la extensión o reproducirá un programa de usuario.

Barra de búsqueda de VS Code con una lista de selección rápida de todas las ranuras disponibles en el VEX Brain conectado. En este ejemplo, hay ocho espacios disponibles.

Cuando se hace clic en el icono del selector de ranuras, aparece una lista de selección rápida con las ranuras 1 a 8 del programa de usuario disponibles.

Construir/Descargar

Icono de construcción.Icono de descarga.

El ícono Construir/Descargar cambia de funciones si se conecta un VEX Brain o un VEX Controller.

Icono de construcción.

Si un dispositivo VEX no está conectado, se muestra el icono de compilación. Al hacer clic, el proyecto solo se construirá.

Icono de descarga.

Si hay un dispositivo VEX conectado, se muestra el icono de descarga. Al hacer clic, el proyecto se construirá y, si tiene éxito, se descargará al dispositivo VEX.

Jugar

Icono de reproducción.

Al hacer clic en el icono de reproducción, se ejecuta el programa de usuario en la ranura seleccionada.

Detener

Icono de parada.

Al hacer clic en el icono de detener, se detiene un programa de usuario.

Espacio de trabajo seleccionado

El selector de proyectos se muestra en la barra de herramientas de VS Code. En este ejemplo se lee EXPTestProject.

VS Code admite proyectos de múltiples espacios de trabajo. El selector de proyectos permite a los usuarios cambiar entre proyectos VEX cuando existen varios dentro del espacio de trabajo.

Barra de búsqueda de VS Code con una lista de selección rápida de proyectos VEX guardados. En este ejemplo, se muestra un proyecto de Python y un proyecto de C++.

Cuando se hace clic en el icono del selector de proyectos, aparece una lista de selección rápida con todos los proyectos válidos.

Importante
Si un proyecto no es válido, no se mostrará en la lista de selección rápida de proyectos. Un proyecto no es válido a menos que haya sido creado o importado mediante la extensión VEX para VS Code.

El icono del selector de archivos de Python se muestra en la barra de herramientas de VS Code. En este ejemplo se lee main.py.

Selector de archivos Python (solo Python)
Cuando se selecciona un proyecto VEX Python, el selector de archivos Python aparecerá en la barra de herramientas. Actualmente, Python para VEX solo admite descargas de archivos individuales.

Barra de búsqueda de VS Code con una lista de selección rápida de todos los archivos Python de este proyecto VEX. En este ejemplo, hay tres archivos Python, cada uno en una ubicación de archivo diferente.


Cuando se hace clic en el icono, aparece una lista de selección rápida con todos los archivos de Python ubicados en el directorio del espacio de trabajo.
El selector de archivos de Python permite al usuario cambiar entre archivos fuente de Python (.py)

Barra de actividades y barra lateral de VEX

Captura de pantalla que muestra la barra de actividad de VS Code y la barra lateral abiertas en la vista VEX. VEX View ofrece opciones para crear e importar proyectos en la parte superior, el menú Información del dispositivo VEX en la parte inferior y un menú de comentarios en la parte inferior.

Proyectos Acciones

Sección Acciones del proyecto de la vista de extensión VEX. Esta sección tiene dos botones que dicen "Nuevo proyecto" e "Importar proyecto".

La barra de actividad vex contiene la vista Acciones del proyecto y la vista Información del dispositivo VEX.

La vista de acciones del proyecto se utiliza para crear un nuevo proyecto o importar un proyecto VEXcode o VEXcode Pro existente.

Para obtener más información sobre cómo crear un nuevo proyecto, consulte este artículo!

La información de la versión también se muestra en las esquinas inferiores izquierda y derecha de la vista.

Importante
Si un proyecto VEXcode o VEXcode Pro está abierto en el editor, no se considerará un proyecto VEX válido; el proyecto debe importarse usando el botón Importar en la barra lateral de VEX.

Información del dispositivo VEX

En la sección Información del dispositivo VEX de la vista de extensión VEX se muestra una lista de todos los dispositivos conectados e información específica sobre cada uno de ellos. En este ejemplo se muestra un EXP Brain y los programas que ha descargado. En la lista de controladores aparece "Controlador, no vinculado".La sección Información del dispositivo VEX se muestra de nuevo, pero ahora la lista del controlador dice Controlador, vinculado.

La vista de información del dispositivo VEX brinda al usuario una descripción general del VEX Brain o VEX Controller conectado. En esta vista se puede encontrar la versión de VEXos, la ruta del puerto serie, el programa de usuario y la información del dispositivo. A través de esta vista también se pueden realizar otras funciones, como actualizaciones de firmware VEXos, capturas de pantalla, configuración del nombre del cerebro y número del equipo de configuración.

Información del sistema

La carpeta del sistema y su contenido se muestran resaltados debajo de la carpeta Cerebro. La carpeta del sistema contiene datos sobre el Cerebro, y los datos indican VEXos 1.0.1.0, nombre VEX_EXP, equipo 000000, ID 0EC83725 y Python 1.0.0.7.

La información del sistema proporciona una breve descripción general de un dispositivo VEX conectado. Esto incluye la versión VEXos de un dispositivo, el nombre de Brain, el número de equipo, el ID de Brain y la información de la versión del tiempo de ejecución de Python.

Información del puerto serie

La carpeta Puerto serie y su contenido se muestran debajo de la carpeta Cerebro. La carpeta Puerto Serie contiene datos sobre la conexión por cable del procesador. Estos datos corresponden a la comunicación COM167 y al usuario COM168.

La información del puerto serie muestra la ruta del dispositivo para cada puerto disponible para un dispositivo VEX. La mayoría de los dispositivos VEX se enumeran como dos puertos serie. El puerto serie de comunicación se utiliza para descargar programas y controlar las funciones cerebrales. El puerto serie de usuario se utiliza para transferir datos entre la aplicación de usuario que se ejecuta en Brain y la computadora host conectada mediante USB. El controlador V5 es el único dispositivo VEX que tiene solo un puerto serie de comunicación y ningún puerto serie de usuario.

Información de programas

La carpeta de programas y su contenido se muestran debajo de la carpeta Brain. La carpeta Programas muestra todos los proyectos VEX descargados en el dispositivo Brain. En este ejemplo, se han descargado cuatro programas C/C++ en el dispositivo Brain conectado.

La información del programa muestra una lista de todos los programas de usuario descargados en un VEX Brain.

La carpeta Programas y su contenido se muestran debajo de la carpeta Cerebro, ahora con la carpeta del primer proyecto abierta para mostrar su contenido. La carpeta del proyecto muestra datos sobre la ranura, el archivo, el tipo, el tamaño y la hora.

Cada elemento de la lista de programas se puede ampliar para mostrar información adicional sobre cada programa de usuario, como la ubicación de la ranura, el nombre del archivo, el tipo de idioma, el tamaño de archivo y la hora de descarga.

Información de dispositivos

La carpeta Dispositivos y su contenido se muestran debajo de la carpeta Cerebro. La carpeta Dispositivos muestra todos los dispositivos que están conectados al sistema Brain. En este ejemplo se enumeran 6 dispositivos, incluidos 4 motores, un dispositivo de 3 cables y una radio interna.

La información de los dispositivos muestra una lista de todos los dispositivos de puerto inteligente conectados a un VEX Brain. Cada elemento de la lista muestra el número de puerto inteligente y el tipo de dispositivo.

La carpeta Dispositivos y su contenido se muestran debajo de la carpeta Cerebro. En este ejemplo, se ha seleccionado un dispositivo Motor y su contenido muestra Tipo Motor, Versión 1.0.0.4, Arranque 1.0.2.0.

Cada elemento de la lista de dispositivos se puede ampliar para mostrar información de la versión del firmware sobre cada dispositivo de puerto inteligente.

El estado vinculado al controlador se muestra cuando se conecta al dispositivo VEX Brain.

El controlador aparece en la carpeta Dispositivos. Este controlador lee Controlador, vinculado.

VEX Brain está vinculado a un controlador VEX

El controlador aparece en la carpeta Dispositivos. Este controlador lee Controlador, no vinculado.

VEX Brain no está vinculado a un controlador VEX

El controlador aparece en la carpeta Dispositivos. Este controlador lee Controlador, conectado.

El controlador VEX V5 está conectado a un cerebro VEX V5

Capturas de pantalla

El cursor se encuentra sobre la carpeta Indicador de dispositivo VEX y se muestra un icono de cámara junto a ella.

Al hacer clic en el ícono de la cámara, un usuario puede tomar y descargar una captura de pantalla desde un VEX Brain.
Las capturas de pantalla solo están disponibles cuando se conecta directamente a un VEX Brain a través de USB

Battery Medic (solo cerebro V5)

El cursor se encuentra sobre la carpeta V5 Brain VEX Device Indicator y, junto a ella, se muestra un icono de Battery Medic.

Al hacer clic en el ícono del Corazón, la extensión descargará y ejecutará el programa de usuario de Battery Medic.

Establecer nombre del cerebro

El cursor se encuentra sobre la opción Nombre dentro de la carpeta Sistema y aparece un icono de lápiz junto a ella.

Al hacer clic en el ícono de lápiz al lado del nombre del sistema>, un usuario puede configurar el nombre de un VEX Brain.

Configure una ventana de solicitud de nombre de cerebro con un campo de texto y un mensaje debajo que diga Presione Enter para confirmar su entrada o Escape para cancelar.

Después de hacer clic en el ícono del Lápiz, aparecerá un cuadro de entrada en la parte superior del editor de VS Code. Escriba el nuevo nombre del cerebro en el cuadro de entrada y presione Intro para configurar.

Establecer número de equipo

El cursor se encuentra sobre la opción Equipo dentro de la carpeta Sistema y aparece un icono de lápiz junto a ella.

Al hacer clic en el ícono de lápiz al lado del equipo del sistema>, un usuario puede configurar el número de equipo para un VEX Brain.

Ventana de solicitud para establecer el número de equipo con un campo de texto y un mensaje debajo que dice Presione Enter para confirmar su entrada o Escape para cancelar.

Después de hacer clic en el ícono del Lápiz, aparecerá un cuadro de entrada en la parte superior del editor de VS Code. Escriba el nuevo número del equipo en el cuadro de entrada y presione Intro para configurar.

Borrar programa de usuario

El cursor se encuentra sobre un programa en la carpeta Programas y aparece un icono de papelera junto a él.

Al hacer clic en el ícono Papelera al lado de los programas->nombre del proyecto, un usuario puede borrar un programa en una ranura específica. IMPORTANTE, una vez que borra un programa, no se puede recuperar. Tenga cuidado al utilizar esta función.

Advertencias de información del dispositivo

Actualización de VEXos

El icono de la carpeta Brain y el icono del indicador del dispositivo VEX se muestran en color naranja, y hay un símbolo de peligro junto a la versión VEXos del sistema. Estas señales indican que la versión de VEXos del cerebro está desactualizada.

Cuando la versión VEXos de un VEX Brain está desactualizada, aparece un ícono de mensaje de advertencia junto a la versión VEXos y ambos íconos de Brain se vuelven amarillos.

Para resolver esta advertencia, el usuario debe actualizar VEXos para su VEXos Brain.

El cursor se encuentra sobre la carpeta de Brain, que está desactualizada, y se muestra un icono de flecha hacia arriba junto a ella.

VEXos se puede actualizar haciendo clic en la flecha hacia arriba al lado del ícono VEX Brain.

Actualizar la ventana de solicitud de VEXos con un mensaje que diga Actualización de VEXos disponible: 1.0.1.0. Fuente, extensión VEX. Más abajo, hay dos botones que dicen Actualizar e Ignorar.

También aparecerá un cuadro de notificación en la esquina inferior derecha del editor de VS Code cuando VEXos esté desactualizado. Un usuario puede iniciar una actualización de VEXos haciendo clic en el botón "Actualizar" o haciendo clic en el botón "Ignorar" para omitir la actualización de VEXos.

Cerebro no vinculado al controlador conectado

La carpeta Brain, ubicada debajo de la carpeta VEX Device Indicator, tiene un icono naranja y dice Brain, sin enlace. Estas señales indican que no hay ningún cerebro VEX conectado.

El ícono del Controlador VEX se volverá amarillo cuando un Controlador VEX esté conectado a una computadora, pero no esté vinculado a un VEX Brain.

Para resolver esta advertencia, un usuario debe vincular un controlador VEX a un cerebro VEX

Panel de terminales

La extensión de código VEX VS proporciona dos terminales al inicio, el terminal de registro y el terminal interactivo

La ventana del terminal de VS Code está abierta y muestra el terminal de registro de VEX y el terminal interactivo de VEX.

Terminal de registro

Se abre la terminal de registro de VEX de VS Code y muestra el historial de uso de la extensión VEX. En este ejemplo, aparecen mensajes que dicen Registro, Compilación de Windows para la plataforma vexexp, Descargar programa de usuario, Descarga finalizada.

La Terminal de registro muestra el resultado de la compilación, el error de compilación y los resultados de la descarga.

Terminal interactiva

Se abre la terminal interactiva VEX de VS Code y muestra un mensaje que dice "Hola mundo".

La Terminal interactiva tiene dos funciones: mostrar registros de impresión y enviar pulsaciones de teclas sin procesar a un programa de usuario. Para aprovechar el terminal interactivo, se debe conectar un cerebro o controlador a una computadora que ejecute la extensión de código VEX VS. La salida del terminal interactivo se borra de forma predeterminada después de crear y descargar un programa de usuario.

Ajustes de usuario

La configuración de usuario es una configuración global que Visual Studio Code ofrece para cada extensión. La configuración del usuario se aplica a cada proyecto de extensión de VEX VS Code.

Se abre la configuración de usuario de VS Code en la página de VEX, donde se puede personalizar el comportamiento de la extensión VEX Robotics.

Cómo acceder a la configuración de usuario de VEX

El icono de Configuración se encuentra en la parte inferior de la barra de actividad de VS Code, en la esquina inferior izquierda de la pantalla.

Haga clic en el engranaje en la esquina izquierda de VS Code y aparecerá un menú contextual

Menú contextual de configuración de VS Code con muchas opciones listadas. Se ha resaltado una opción que dice "Configuración" y es la tercera opción del menú, debajo de "Paleta de comandos" y "Perfiles".

En el menú contextual, haga clic en el elemento "Configuración" y aparecerá una página de configuración.

La ventana de configuración de VS Code está abierta y la categoría Extensiones está resaltada en la lista de navegación de la izquierda.

En la vista de lista de la izquierda, haga clic en el elemento "Extensiones". A continuación, desplácese hacia abajo y busque el elemento denominado "VEX".

La ventana de configuración de VS Code está abierta y el enlace a la página de VEX dentro de la categoría Extensiones está resaltado.

Haga clic en el elemento de la lista "VEX".

Se abre la configuración de usuario de VS Code en la página de VEX, donde se puede personalizar el comportamiento de la extensión VEX Robotics.

La configuración del usuario VEX aparecerá en el panel derecho.

Descripción general de la configuración

Canal del controlador (solo controlador V5)

La configuración del canal del controlador controla el tipo de canal de comunicación por radio entre un V5 Brain y un controlador V5.
Esta configuración solo se aplica cuando VS Code está conectado a un controlador V5 a través de USB y el controlador está conectado a un V5 Brain a través de VEXnet. El usuario puede elegir entre canales Download y Pit. Cuando se establece en Descargar, la radio saltará a un canal VEXnet de descarga una vez que se inicie la descarga de un programa de usuario. El canal de descarga permite velocidades de datos más altas y descargas más eficientes. Cuando se establece en Pit, la radio permanecerá en un canal de pit y la descarga tardará mucho más. De forma predeterminada, esta configuración está establecida en Descargar.

Configuración de usuario de VEX con la opción Canal del controlador mostrada. Esta opción tiene un menú desplegable que está configurado como Descargar por defecto. La descripción dice: Configura el canal de radio del controlador V5.

Inicio del SDK del proyecto Cpp

NO EDITE ESTA CONFIGURACIÓN.

Configuración de usuario de VEX con la opción Inicio del SDK de Cpp mostrada. Esta opción tiene un enlace que dice Editar en settings.json. La descripción dice NO EDITAR.

Ruta de la cadena de herramientas Cpp

Cpp Toolchain Path establece la ruta para la cadena de herramientas que se utiliza al compilar un proyecto C++ VEX VS Code.

Configuración de usuario de VEX con la opción Ruta de acceso de la cadena de herramientas Cpp mostrada. Esta opción tiene un campo de texto que representa la ruta del archivo.

Habilitar terminal de usuario

La configuración Habilitar terminal de usuario permite que la extensión abra el puerto serie del usuario cuando la extensión detecta un VEX Brain o un controlador VEX. La única excepción se aplica a un controlador V5 que no se enumera con un puerto serie de usuario.

Configuración de usuario de VEX con la opción "Habilitar terminal de usuario general" mostrada. Esta opción tiene un menú desplegable que está activado por defecto. La descripción dice: Habilita la extensión para abrir y mostrar datos desde el puerto de usuario.

Habilitar permite que la extensión se conecte a un puerto de usuario al inicio y creará la Terminal interactiva. Si se selecciona habilitar mientras la extensión se está ejecutando, la extensión intentará abrir el puerto de usuario si hay un dispositivo conectado.
Desactivar evita que la extensión se conecte al puerto de usuario al inicio y no crea una terminal interactiva. Si se selecciona desactivar mientras la extensión se está ejecutando, la extensión cerrará el puerto de usuario y eliminará la Terminal interactiva.

Tipo de construcción del proyecto

Project Build Type establece cómo la extensión creará un proyecto C++. El usuario puede configurar el tipo de compilación en Construir o Reconstruir.
Build solo construye el proyecto cuando Make detecta algún cambio en el código fuente del proyecto.
Rebuild limpia el directorio de compilación del proyecto y luego compila el proyecto. Esta opción normalmente es mucho más lenta.

Configuración de usuario de VEX con la opción Tipo de compilación del proyecto mostrada. Esta opción tiene un menú desplegable que está configurado en "Construir" por defecto. La descripción dice Establecer tipo de compilación del proyecto Cpp.

Inicio del proyecto

Inicio del proyecto establece el directorio de inicio predeterminado para un nuevo proyecto al completar el asistente para Nuevo proyecto.

Configuración de usuario de VEX con la opción Inicio del proyecto visible. Esta opción tiene un campo de texto que representa la ruta del archivo. La descripción dice: Establece la ubicación predeterminada para los nuevos proyectos.

Ejecutar después de la descarga

Ejecutar después de la descarga cuando está habilitado, hace que el programa de usuario se ejecute después de descargarlo en un VEX Brain.

Configuración de usuario de VEX con la opción "Ejecutar proyecto después de la descarga" mostrada. Esta opción tiene una casilla de verificación que aparece seleccionada en este ejemplo. La descripción dice: Configure si el programa de usuario debe ejecutarse después de la descarga.

Inicio del SDK de Python

NO EDITE ESTA CONFIGURACIÓN.

Configuración de usuario de VEX con la opción Inicio del SDK de Python mostrada. Esta opción tiene un enlace que dice Editar en settings.json. La descripción dice NO EDITAR.

Ayuda del comando VEX

La ayuda del comando VEX permite el acceso a la documentación para funciones específicas incluidas en la API (interfaz de programación de aplicaciones) de C++ y Python. La documentación es específica de cada plataforma VEX (IQ 2.ª generación, EXP, V5).

El comando C++ en el editor VS Code se ha resaltado con el cursor.

Para acceder a la Ayuda del comando VEX, primero resalte el texto de la función que desea buscar.

Se ha abierto el menú contextual del comando C++ y se ha resaltado la opción Ayuda del comando VEX.

Haga clic derecho en el texto seleccionado y aparecerá un menú contextual.
Siguiente Haga clic en VEX Command Help para acceder a la documentación.

La página de ayuda de comandos de VEX está abierta y muestra información y ejemplos del comando Brain Screen Print de C++.

Si la Ayuda del comando VEX encuentra una coincidencia exacta, aparecerá una nueva vista web con la documentación relevante.

Barra de búsqueda de VS Code con una lista de selección rápida de comandos VEX C++ coincidentes en la Ayuda de comandos de VEX para ayudar a acotar la búsqueda del usuario.

Si varios documentos coinciden con el texto seleccionado, aparecerá un menú desplegable con una lista filtrada de documentación relevante.

For more information, help, and tips, check out the many resources at VEX Professional Development Plus

Last Updated: