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.

imagen48.png

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.

imagen2.png

Selector de dispositivos

imagen60.png

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

imagen41.png

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).

imagen4.png

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

imagen8.png

imagen56.png

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

imagen19.png

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

imagen43.png

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

imagen5.pngimagen6.png

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

imagen5.png

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

imagen6.png

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

imagen33.png

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

Detener

imagen45.png

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

Espacio de trabajo seleccionado

imagen24.png

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.

imagen14.png

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.

imagen34.png

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.

imagen17.png


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

imagen57.png

Proyectos Acciones

imagen47.png

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, consulta 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

imagen37.pngimagen62.png

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

imagen25.png

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

imagen7.png

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

imagen12.png

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

imagen23.png

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

imagen20.png

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.

imagen29.png

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.

imagen44.png

VEX Brain está vinculado a un controlador VEX

imagen10.png

VEX Brain no está vinculado a un controlador VEX

imagen52.png

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

Capturas de pantalla

imagen50.png

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)

imagen39.png

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

imagen28.png

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.

imagen54.png

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

imagen58.png

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.

imagen49.png

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

imagen30.png

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

imagen22.png

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.

imagen31.png

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

imagen36.png

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

imagen21.png

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

imagen11.png

Terminal de registro

imagen13.png

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

Terminal interactiva

imagen16.png

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.

imagen32.png

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

imagen42.png

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

imagen27.png

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

imagen9.png

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".

imagen18.png

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

imagen46.png

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.

imagen63.png

Inicio del SDK del proyecto Cpp

NO EDITE ESTA CONFIGURACIÓN.

imagen1.png

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.

imagen3.png

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.

imagen61.png

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.

imagen51.png

Inicio del proyecto

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

imagen38.png

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.

imagen53.png

Inicio del SDK de Python

NO EDITE ESTA CONFIGURACIÓN.

imagen59.png

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).

imagen55.png

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

imagen15.png

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.

imagen35.png

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

imagen26.png

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: