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

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 el diseño completo de la interfaz de usuario de VEX VS Code. La barra de actividad y la barra lateral están 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 llena 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 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 VS Code con íconos de extensión VEX que se pueden usar para interactuar rápidamente con dispositivos y proyectos VEX conectados. Las características de VEX incluyen el Selector de dispositivos, el Selector de ranuras, el ícono de Descarga de compilación & , el ícono de Reproducir, el ícono de Detener, el Selector de proyectos y el Selector de archivos Python.

Selector de dispositivos

El icono del Selector de dispositivo está resaltado en la barra de herramientas de VS Code. En este ejemplo se lee VEX_EXP.

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, 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 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 lista de selección rápida que se muestra para proporcionar detalles. El elemento lee 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 lista de selección rápida que se muestra para proporcionar detalles. El artículo es un controlador V5, pero el fondo está en gris y no aparece ningún nombre de cerebro. Esto indica que este controlador no tiene un enlace de radio a un cerebro.

Elemento controlador V5 con 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 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 ranura 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, hay un proyecto de Python y un proyecto de C++ enumerados.

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 por la Extensión VEX 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 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 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 tiene opciones para crear e importar proyectos arriba, el menú Información del dispositivo VEX abajo 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

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 muestran un EXP Brain y sus programas descargados. La lista del controlador dice Controlador, no vinculado.La sección Información del dispositivo VEX se muestra nuevamente, pero ahora la lista del Controlador dice Controlador, vinculado.

La vista de información del dispositivo VEX le 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 y resaltan debajo de la carpeta Brain. 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 del tiempo de ejecución de Python.

Información del puerto serie

La carpeta del puerto serie y su contenido se muestran debajo de la carpeta Brain. La carpeta Puerto serie contiene datos sobre la conexión cableada del cerebro. Estos datos leen 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 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 Programas y su contenido se muestran debajo de la carpeta Brain. La carpeta Programas muestra todos los proyectos VEX descargados en el Brain. En este ejemplo, hay cuatro programas C/C++ descargados al 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 Brain, 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 el tiempo.

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 Brain. 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 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 dice 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 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 dice Controlador, atado.

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 hay un ícono 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 Indicador del dispositivo V5 Brain VEX y hay un ícono de Battery Medic mostrado junto a ella.

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 sitúa sobre la opción Nombre dentro de la carpeta Sistema y hay 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.

Aparecerá una ventana con el mensaje Establecer nombre de cerebro con un campo de texto y un mensaje debajo que dice Presione Entrar 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 hay un ícono 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 configurar el número de equipo con un campo de texto y un mensaje debajo que dice Presione Entrar 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 desplaza sobre un programa en la carpeta Programas y hay un ícono 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 ícono de la carpeta Brain y el ícono del indicador de dispositivo VEX se muestran en naranja, y hay un símbolo de peligro junto a la versión VEXos del sistema. Estas señales indican que la versión VEXos de Brain 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 obsoleta de Brain y hay un ícono de flecha hacia arriba que se muestra junto a ella.

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

Aparecerá la ventana de solicitud de actualización de VEXos con un mensaje que dice Actualización de VEXos disponible: 1.0.1.0. Fuente, extensión VEX. A continuación, 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 debajo de la carpeta VEX Device Indicator tiene un ícono naranja y dice Brain, not linked (Cerebro, no vinculado). Estas señales indican que no hay ningún VEX Brain 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 Terminal de VS Code está abierta y muestra la Terminal de registro VEX y la Terminal interactiva VEX.

Terminal de registro

Se abre la terminal de registro VEX de VS Code y se muestra el historial de uso de la extensión VEX. En este ejemplo, hay 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 VS Code VEX 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.

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

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

Ícono de configuración en la parte inferior de la barra de actividad de VS Code, ubicada 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 enumeradas. Se resalta una opción que dice Configuración y es la tercera opción en el 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 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 de usuario de VS Code se abre en la página 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 de canal del controlador mostrada. Esta opción tiene un menú desplegable que está configurado en Descargar de forma predeterminada. La descripción dice Establece 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 de 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 crear un proyecto C++ VEX VS Code.

Configuración de usuario de VEX con la cadena de herramientas Cpp: se muestra la opción Ruta. 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 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á configurado como Habilitar de manera predeterminada. La descripción dice Habilitar 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 de proyecto mostrada. Esta opción tiene un menú desplegable que está configurado en Construir de forma predeterminada. La descripción dice Establecer tipo de compilación de 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 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 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 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 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 de 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 resalta 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 del comando 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 VEX para ayudar a limitar 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: