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.
Componentes de la interfaz de usuario
Hay 3 componentes principales para la extensión de código VEX VS.
- Barra de herramientas
- Barra de actividades y barra lateral
- 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.
Selector de dispositivos
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.
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).
Cada elemento del dispositivo contiene el nombre del cerebro, la plataforma, el tipo de dispositivo y la información de la ruta del dispositivo.
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 ranuras permite al usuario elegir en qué ranura se descargará la extensión o reproducirá un programa de usuario.
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
El icono Construir/Descargar cambia las funciones si se conecta un cerebro VEX o un controlador VEX.
Si un dispositivo VEX no está conectado, se muestra el icono de compilación. Cuando se hace clic, el proyecto solo se compilará.
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
El icono de reproducción, cuando se hace clic, ejecuta el programa de usuario en la ranura seleccionada.
Detener
El icono de parada, cuando se hace clic, detiene un programa de usuario.
Espacio de trabajo seleccionado
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.
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.
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.
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
Acciones de proyectos
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 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 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 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 información del programa muestra una lista de todos los programas de usuario descargados en un VEX Brain.
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 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.
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.
VEX Brain está vinculado a un controlador VEX
VEX Brain no está vinculado a un controlador VEX
El controlador VEX V5 está conectado a un cerebro VEX V5
Capturas de pantalla
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)
Al hacer clic en el icono Corazón, la extensión descargará y ejecutará el programa de usuario Battery Medic.
Establecer nombre del cerebro
Al hacer clic en el ícono del lápiz junto al>nombre del sistema, un usuario puede establecer el nombre de un cerebro VEX.
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
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.
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
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
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.
Los VEXos se pueden actualizar haciendo clic en la flecha hacia arriba junto al icono de VEX Brain.
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
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
Terminal de registro
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 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.
Cómo acceder a la configuración de usuario de VEX
Haga clic en el engranaje en la esquina izquierda del código VS y aparecerá un menú contextual
En el menú contextual, haz clic en el elemento "Configuración" y aparecerá una página de configuración.
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".
Haga clic en el elemento de la lista "VEX".
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.
Inicio SDK de Cpp Project
NO EDITE ESTA CONFIGURACIÓN.
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.
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.
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.
Inicio del proyecto
Project Home establece el directorio de inicio predeterminado para un nuevo proyecto al completar el asistente Nuevo proyecto.
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.
Inicio del SDK de Python
NO EDITE ESTA CONFIGURACIÓN.
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).
Para acceder a la Ayuda de comandos de VEX, primero resalte el texto de la función a buscar.
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.
Si VEX Command Help encuentra una coincidencia exacta, aparecerá una nueva vista web con la documentación relevante.
Si varios documentos coinciden con el texto seleccionado, aparecerá un menú desplegable con una lista filtrada de la documentación relevante.