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 apoya el desarrollo de proyectos C++ y Python para las plataformas VEX IQ 2nd Generation, EXP y V5.

Captura de pantalla que muestra el diseño completo de la interfaz de usuario de VEX VS Code. La barra de actividades y la barra lateral están en el lado izquierdo de la pantalla, la barra de herramientas y el terminal están en la parte inferior de la pantalla y el editor llena el resto de la pantalla.

Componentes de la interfaz de usuario

Hay 3 componentes principales para 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 VEX VS Code VEX Brains y VEX Controllers. La barra de herramientas solo está activa cuando un proyecto VEX válido está 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 código VS con iconos de extensión VEX que se pueden usar para interactuar rápidamente con 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 de Python.

Selector de dispositivos

El icono del selector de dispositivos está resaltado en la barra de herramientas Código VS. En este ejemplo se lee VEX_V5.

El selector de dispositivos tiene dos funciones principales. En primer lugar, muestra un icono 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, se enumeran un cerebro V5, un controlador V5 y un controlador EXP.

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 actual 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 de segunda generación, EXP y V5).

Barra de búsqueda de código VS con un elemento de 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 el nombre del cerebro, la plataforma, el tipo de dispositivo y la información de la ruta del dispositivo.

Barra de búsqueda de código VS con un elemento de lista de selección rápida que se muestra para proporcionar detalles. El elemento es un controlador V5, pero el fondo está atenuado y no hay un nombre de cerebro en la lista. Esto indica que este controlador no tiene un enlace de radio a un cerebro.

Elemento del controlador V5 con un fondo azul para indicar que este controlador tiene un enlace de radio a un cerebro.

Importante

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

Selector de ranura

El icono del selector de ranura está resaltado en la barra de herramientas del código VS. En este ejemplo se lee Ranura 1.

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

Barra de búsqueda de código VS con una lista de selección rápida de todas las ranuras disponibles en el cerebro VEX 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 disponibles del programa de usuario 1-8.

Compilar/Descargar

Icono de compilación.Icono de descarga.

El icono Construir/Descargar cambia las funciones si se conecta un cerebro VEX o un controlador VEX.

Icono de compilación.

Si un dispositivo VEX no está conectado, se muestra el icono de compilación. Cuando se hace clic, el proyecto solo se compilará.

Icono de descarga.

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

Jugar

Icono de reproducción.

El icono de reproducción, cuando se hace clic, ejecuta el programa de usuario en la ranura seleccionada.

Detener

Icono de parada.

El icono de parada, cuando se hace clic, detiene un programa de usuario.

Espacio de trabajo seleccionado

El Selector de proyectos se muestra en la barra de herramientas Código VS. En este ejemplo se lee EXPTestProject.

VS Code admite proyectos de espacios de trabajo múltiples. 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, hay un proyecto Python listado y un proyecto C++ listado.

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 del proyecto. Un proyecto no es válido a menos que haya sido creado o importado por la Extensión de Código VS de VEX.

El icono Selector de archivos de Python se muestra en la barra de herramientas Código VS. En este ejemplo se lee main.py.

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

Barra de búsqueda de código VS con una lista de selección rápida de todos los archivos Python en 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 de origen de python (.py)

Barra de actividad y barra lateral VEX

Captura de pantalla que muestra la barra de actividad del código VS y la barra lateral abierta a la vista VEX. VEX View tiene opciones para crear e importar proyectos arriba, el menú Información del dispositivo VEX a continuación y un menú de comentarios en la parte inferior.

Acciones de proyectos

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

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

La vista 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, consulta este artículo.

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

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

Información del dispositivo VEX

La sección Información del dispositivo VEX de la vista de extensión Vex se muestra con una lista de todos los dispositivos conectados e información específica sobre cada uno. En este ejemplo, se muestra un EXP Brain y sus programas descargados. El listado del controlador dice Controlador, no vinculado.La sección Información del dispositivo VEX se muestra de nuevo, pero ahora el listado del controlador dice Controlador, vinculado.

La vista de información del dispositivo VEX ofrece al usuario una visión general del cerebro VEX conectado o del controlador VEX. La versión de VEXos, la ruta del puerto serie, el programa de usuario y la información del dispositivo se pueden encontrar en esta vista. Otras funciones, como las actualizaciones de firmware de VEXos, las capturas de pantalla, la configuración del nombre del cerebro y el número de equipo de configuración, también se pueden realizar a través de esta vista.

Información del sistema

La carpeta del sistema y su contenido se muestran y resaltan debajo de la carpeta Cerebro. La carpeta del sistema tiene 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 de tiempo de ejecución de Python.

Información del puerto serie

La carpeta Serial Port y su contenido se muestran debajo de la carpeta Brain. La carpeta del puerto serie tiene datos sobre la conexión por cable del cerebro. Estos datos indican Comunicación COM167, 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 el cerebro y el equipo host conectado a través de 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 Programas y su contenido se muestran debajo de la carpeta Cerebro. La carpeta Programas muestra todos los proyectos VEX descargados en el Cerebro. En este ejemplo, hay cuatro programas C/C++ descargados en el cerebro conectado.

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

La carpeta de 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 expandir 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 del 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 cerebro. En este ejemplo, hay 6 dispositivos enumerados, 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 cerebro VEX. 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 dice Type Motor, Version 1.0.0.4, Boot 1.0.2.0.

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

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

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

VEX Brain está vinculado a un controlador VEX

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

VEX Brain no está vinculado a un controlador VEX

El controlador aparece debajo de la carpeta Dispositivos. Este controlador lee el controlador, atado.

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

Capturas de pantalla

El cursor se desplaza sobre la carpeta del indicador de dispositivo VEX y hay un icono de cámara que se muestra junto a él.

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

Batería Medic (solo cerebro V5)

El cursor se desplaza sobre la carpeta V5 Brain VEX Device Indicator y hay un icono de Battery Medic que se muestra junto a él.

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

Establecer nombre del cerebro

El cursor se desplaza sobre la opción Nombre dentro de la carpeta Sistema y se muestra un ícono de Lápiz junto a él.

Al hacer clic en el ícono del lápiz junto al>nombre del sistema, un usuario puede establecer el nombre de un cerebro VEX.

Establezca la ventana de aviso Nombre del cerebro con un campo de texto y un mensaje a continuación que diga Presione Intro para confirmar su entrada o Escape para cancelar.

Después de hacer clic en el icono del lápiz, aparecerá un cuadro de entrada en la parte superior del editor de código VS. Escriba el nuevo nombre del cerebro en el cuadro de entrada y presione enter para establecer.

Establecer número de equipo

El cursor se desplaza sobre la opción Equipo dentro de la carpeta Sistema y se muestra un ícono de Lápiz junto a él.

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

Establezca la ventana de solicitud del número de equipo con un campo de texto y un mensaje a continuación que diga Presione Enter para confirmar su entrada o Escape para cancelar.

Después de hacer clic en el icono del lápiz, aparecerá un cuadro de entrada en la parte superior del editor de código VS. Escriba el nuevo número de equipo en el cuadro de entrada y presione enter para establecerlo.

Borrar programa de usuario

El cursor se desplaza sobre un programa en la carpeta Programas y se muestra un icono de Papelera junto a él.

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

Advertencias de información del dispositivo

Actualización de VEXos

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

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

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

El cursor se desplaza sobre la carpeta de Brain desactualizada y hay un ícono de flecha hacia arriba que se muestra al lado.

Los VEXos se pueden actualizar haciendo clic en la flecha hacia arriba junto al icono de VEX Brain.

Ventana de aviso de actualización de VEXos con un mensaje que dice Actualización de VEXos disponible: 1.0.1.0. Fuente, VEX Extension. A continuación, hay dos botones que leen Actualizar e Ignorar.

También aparecerá un cuadro de notificación en la esquina inferior derecha del editor de código VS 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 Cerebro debajo de la carpeta Indicador de dispositivo VEX tiene un icono naranja y dice Cerebro, no vinculado. Estas señales indican que no hay un cerebro VEX conectado.

El icono del controlador VEX se volverá amarillo cuando un controlador VEX esté conectado a una computadora, pero no esté vinculado a un cerebro VEX.

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 en el arranque, el terminal de registro y el terminal interactivo

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

Terminal de registro

El terminal de registro VS Code VEX se abre y muestra el historial de uso de la extensión VEX. En este ejemplo, hay mensajes que leen Log, Windows build for platform vexexp, Download User Program, Download Finished.

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

Terminal interactivo

El terminal interactivo VS Code VEX se abre y muestra un mensaje que dice Hola mundo.

El terminal interactivo tiene dos funciones, mostrar registros printf 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 interactiva del terminal se borra de forma predeterminada después de crear y descargar un programa de usuario.

Configuración del usuario

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

La configuración del usuario de VS Code se abre 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

Icono de configuración en la parte inferior de la barra de actividad del código VS, ubicada en la esquina inferior izquierda de la pantalla.

Haga clic en el engranaje en la esquina izquierda del código VS y aparecerá un menú contextual

Menú contextual de configuración de código VS con muchas opciones enumeradas. Una opción que lee Configuración está resaltada y es la tercera opción en el menú, debajo de Paleta de comandos y Perfiles.

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

La ventana de configuración del código VS 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 hasta la parte inferior y encuentre el artículo etiquetado como "VEX".

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

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

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

La configuración de usuario de 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 de radio entre un cerebro V5 y un controlador V5.
Esta configuración solo se aplica cuando el código VS está conectado a un controlador V5 a través de USB y el controlador está conectado a un cerebro V5 a través de VEXnet. El usuario puede elegir entre los
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 mayores velocidades de datos y descargas más eficientes. Cuando se establece en Pit, la radio permanecerá en un canal Pit y la descarga tardará mucho más tiempo. 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 de forma predeterminada. La descripción dice Configura el canal de radio del controlador V5.

Inicio SDK de Cpp Project

NO EDITE ESTA CONFIGURACIÓN.

Configuración de usuario de VEX con la opción de inicio de 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 de Cpp

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

Configuración de usuario VEX con la opción Cpp Toolchain: Path mostrada. Esta opción tiene un campo de texto que representa una ruta de archivo.

Habilitar terminal de usuario

La configuración Habilitar terminal de usuario permite que la extensión abra el puerto serie de usuario cuando la extensión detecta un VEX Brain o un VEX Controller. 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á configurado para Habilitar de forma predeterminada. La descripción dice Habilitar 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 iniciar y creará el terminal interactivo. 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 iniciar y no creará un terminal interactivo. Si se selecciona deshabilitar mientras la extensión se está ejecutando, la extensión cerrará el puerto de usuario y eliminará el terminal interactivo.

Tipo de compilación del proyecto

El tipo de compilación del proyecto establece cómo la extensión compilará un proyecto de C++. El usuario puede establecer el tipo de compilación en Compilar o Reconstruir.
Build solo compila el proyecto cuando Make detecta cualquier cambio en el código fuente del proyecto.
Reconstruir limpia el directorio de compilación del proyecto y luego compila el proyecto. Esta opción suele ser mucho más lenta.

Configuración de usuario de VEX con la opción Tipo de compilación de proyecto mostrada. Esta opción tiene un menú desplegable que está configurado como Construir de forma predeterminada. La descripción dice Set Cpp Project Build Type.

Inicio del proyecto

Project Home establece el directorio de inicio predeterminado para un nuevo proyecto al completar el asistente Nuevo proyecto.

Configuración de usuario VEX con la opción Inicio del proyecto mostrada. Esta opción tiene un campo de texto que representa una ruta de 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 que se descargue en un VEX Brain.

Configuración de usuario VEX con la opción Ejecutar proyecto después de la descarga mostrada. Esta opción tiene una casilla de verificación que se muestra como seleccionada en este ejemplo. La descripción dice Establecer 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 de inicio de Python SDK mostrada. Esta opción tiene un enlace que dice Editar en settings.json. La descripción dice NO EDITAR.

Ayuda del comando VEX

VEX Command Help permite acceder a la documentación para funciones específicas incluidas en C++ y Python API (Application Programming Interface). La documentación es específica de cada plataforma VEX (IQ 2ª Generación, EXP, V5).

El comando C++ en el editor de código VS se ha resaltado con el cursor.

Para acceder a la Ayuda de comandos de VEX, primero resalte el texto de la función a 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.
A continuación, haga clic en el comando VEX Ayuda para acceder a la documentación.

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

Si VEX Command Help 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 VEX para ayudar a reducir la búsqueda del usuario.

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

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

Last Updated: