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.
Componentes de la interfaz de usuario
Hay 3 componentes principales en 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. Primero, muestra un ícono 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 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).
Cada elemento del dispositivo contiene información sobre el nombre del cerebro, la plataforma, el tipo de dispositivo y la ruta del dispositivo.
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 permite al usuario elegir en qué ranura 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 1 a 8 del programa de usuario disponibles.
Construir/Descargar
El ícono Construir/Descargar cambia de funciones si se conecta un VEX Brain o un VEX Controller.
Si un dispositivo VEX no está conectado, se muestra el icono de compilación. Al hacer clic, el proyecto solo se construirá.
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
Al hacer clic en el icono de reproducción, se ejecuta el programa de usuario en la ranura seleccionada.
Detener
Al hacer clic en el icono de detener, se detiene un programa de usuario.
Espacio de trabajo seleccionado
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.
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.
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.
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
Proyectos Acciones
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
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 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 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 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 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 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.
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.
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 í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)
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
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.
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
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.
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
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
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.
VEXos se puede actualizar haciendo clic en la flecha hacia arriba al lado del ícono VEX Brain.
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
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
Terminal de registro
La Terminal de registro muestra el resultado de la compilación, el error de compilación y los resultados de la descarga.
Terminal interactiva
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.
Cómo acceder a la configuración de usuario de VEX
Haga clic en el engranaje en la esquina izquierda de VS Code y aparecerá un menú contextual
En el menú contextual, haga 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 y busque el elemento denominado "VEX".
Haga clic en el elemento de la lista "VEX".
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.
Inicio del SDK del proyecto Cpp
NO EDITE ESTA CONFIGURACIÓN.
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.
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.
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.
Inicio del proyecto
Inicio del proyecto establece el directorio de inicio predeterminado para un nuevo proyecto al completar el asistente para 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 descargarlo en un VEX Brain.
Inicio del SDK de Python
NO EDITE ESTA CONFIGURACIÓN.
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).
Para acceder a la Ayuda del comando VEX, primero resalte el texto de la función que desea buscar.
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.
Si la Ayuda del comando VEX 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 documentación relevante.