Este artigo é uma visão geral da UI de extensão de código do VEX Visual Studio (interface do usuário). A extensão suporta o desenvolvimento de projetos C++ e Python para plataformas VEX IQ 2ª geração, EXP e V5.
Componentes da IU
Existem 3 componentes principais na extensão do código VEX VS.
- Barra de ferramentas
- Barra de atividades e barra lateral
- Painel Terminal
Barra de ferramentas
A barra de ferramentas oferece aos usuários uma maneira rápida de interagir com os projetos de extensão VEX VS Code , VEX Brains e VEX Controllers. A barra de ferramentas só fica ativa quando um projeto VEX válido está aberto em VS Code. Um projeto VEX válido é aquele criado ou importado pela extensão. Abrir um projeto VEXcode ou VEXcode Pro não é válido e precisará ser importado.
Seletor de dispositivos
O seletor de dispositivos tem duas funções principais. Primeiro, ele exibe um ícone de cérebro ou controlador representando o tipo de dispositivo VEX conectado.
Segundo, quando o ícone da lista de dispositivos é clicado, uma lista de seleção rápida aparece com todos os dispositivos VEX conectados. O usuário pode selecionar a qual dispositivo a extensão se conectará.
O dispositivo atualmente conectado sempre aparecerá no topo da lista seguido por todos os outros dispositivos classificados por tipo de dispositivo (Cérebro ou Controlador) e plataforma (IQ 2ª Geração, EXP e V5).
Cada item do dispositivo contém o nome do cérebro, a plataforma, o tipo de dispositivo e as informações do caminho do dispositivo.
Importante
Se um controlador estiver conectado a um computador, mas não tiver um link de rádio para um cérebro, nenhum nome de cérebro será exibido próximo ao item da lista ou ao ícone da barra de status da lista de dispositivos.
Seletor de Slot
O ícone do seletor de slot permite ao usuário escolher em qual slot a extensão irá baixar ou reproduzir um programa do usuário.
Quando o ícone do seletor de slot é clicado, uma lista de seleção rápida aparece com os slots de 1 a 8 do programa do usuário disponíveis.
Construir/Baixar
O ícone Build/Download altera as funções se um VEX Brain ou um VEX Controller estiver conectado.
Se um dispositivo VEX não estiver conectado, o ícone de construção será mostrado. Quando clicado, o projeto apenas será compilado.
Se um dispositivo VEX estiver conectado, o ícone de download será mostrado. Ao clicar, o projeto será compilado e, se for bem-sucedido, será baixado para o dispositivo VEX.
Jogar
O ícone de reprodução, quando clicado, executa o programa do usuário no slot selecionado.
Parar
O ícone de parada, quando clicado, interrompe um programa do usuário.
Espaço de trabalho selecionado
O VS Code oferece suporte a projetos de vários espaços de trabalho. O seletor de projetos permite aos usuários alternar entre projetos VEX quando existem vários dentro do espaço de trabalho.
Quando o ícone do seletor de projetos é clicado, uma lista de seleção rápida aparece com todos os projetos válidos.
Importante
Se um projeto não for válido, ele não será mostrado na lista de seleção rápida de projetos. Um projeto não é válido a menos que tenha sido criado ou importado pela extensão VEX VS Code.
Seletor de arquivo Python (somente Python)
Quando um projeto VEX python é selecionado, o seletor de arquivo python aparecerá na barra de ferramentas. Atualmente, Python para VEX oferece suporte apenas para downloads de arquivo único.
Quando o ícone é clicado, uma lista de seleção rápida aparece com todos os arquivos python localizados no diretório do espaço de trabalho.
O seletor de arquivo python permite ao usuário alternar entre arquivos de origem python (.py)
Barra de atividades e barra lateral VEX
Ações de Projetos
A barra de atividades vex contém a visualização Ações do projeto e a visualização Informações do dispositivo VEX.
A visualização de ações do projeto é usada para criar um novo projeto ou importar um projeto VEXcode ou VEXcode Pro existente.
As informações da versão também são exibidas nos cantos inferiores esquerdo e direito da visualização.
Importante
Se um projeto VEXcode ou VEXcode Pro estiver aberto no editor então não será considerado um projeto VEX válido, o projeto precisa ser importado usando o botão Importar na barra lateral do VEX.
Informações do dispositivo VEX
A visualização VEX Device Info oferece ao usuário uma visão geral do VEX Brain ou VEX Controller conectado. A versão do VEXos, o caminho da porta serial, o programa do usuário e as informações do dispositivo podem ser encontrados nesta visualização. Outras funções, como atualizações de firmware VEXos, capturas de tela, configuração do nome do cérebro e número da equipe de configurações, também podem ser executadas por meio desta visualização.
Informação do sistema
As informações do sistema fornecem uma breve visão geral de um dispositivo VEX conectado. Isso inclui a versão VEXos de um dispositivo, o nome do Brain, o número da equipe, o Brain ID e as informações da versão do tempo de execução do python.
Informações da porta serial
As informações da porta serial exibem o caminho do dispositivo para cada porta disponível para um dispositivo VEX. A maioria dos dispositivos VEX são enumerados como duas portas seriais. A porta serial de comunicação é usada para baixar programas e controlar as funções cerebrais. A porta serial do usuário é usada para transferir dados entre o aplicativo do usuário em execução no Brain e o computador host conectado via USB. O Controlador V5 é o único dispositivo VEX que possui apenas uma porta serial de Comunicação e nenhuma porta serial de Usuário.
Informações sobre programas
As informações do programa exibem uma lista de todos os programas de usuário baixados em um VEX Brain.
Cada item da lista de programas pode ser expandido para mostrar informações adicionais sobre cada programa do usuário, como localização do slot, nome do arquivo, tipo de idioma, tamanho do arquivo e hora do download.
Informações sobre dispositivos
As informações dos dispositivos mostram uma lista de todos os dispositivos de porta inteligente conectados a um VEX Brain. Cada item da lista mostra o número da porta inteligente e o tipo de dispositivo.
Cada item da lista de dispositivos pode ser expandido para mostrar informações de versão de firmware sobre cada dispositivo de porta inteligente.
O status vinculado do controlador é exibido quando conectado ao VEX Brain Device.
VEX Brain está vinculado a um controlador VEX
VEX Brain não está vinculado a um controlador VEX
O controlador VEX V5 está conectado a um cérebro VEX V5
Capturas de tela
Ao clicar no ícone da câmera, o usuário pode fazer e baixar uma captura de tela de um VEX Brain.
As capturas de tela só estão disponíveis quando conectado diretamente a um VEX Brain via USB
Medic de bateria (somente V5 Brain)
Ao clicar no ícone Coração, a extensão baixará e executará o programa do usuário Battery Medic.
Definir nome do cérebro
Ao clicar no ícone de lápis próximo ao nome do sistema>, um usuário pode definir o nome de um VEX Brain.
Depois que o ícone do lápis for clicado, uma caixa de entrada aparecerá na parte superior do editor do VS Code. Digite o novo nome do cérebro na caixa de entrada e pressione Enter para definir.
Definir número da equipe
Ao clicar no ícone de lápis próximo à equipe system->, um usuário pode definir o número da equipe para um VEX Brain.
Depois que o ícone do lápis for clicado, uma caixa de entrada aparecerá na parte superior do editor do VS Code. Digite o novo número da equipe na caixa de entrada e pressione Enter para definir.
Apagar programa do usuário
Ao clicar no ícone Trashcan próximo ao nome do projeto programas->, um usuário pode apagar um programa em um slot específico. IMPORTANTE, depois de apagar um programa, ele não poderá ser recuperado. Tenha cuidado ao usar este recurso.
Avisos de informações do dispositivo
Atualização VEXos
Quando a versão VEXos do VEX Brain está desatualizada, um ícone de mensagem de aviso aparece ao lado da versão VEXos e ambos os ícones do Brain ficam amarelos.
Para resolver este aviso, um usuário deve atualizar o VEXos para seu VEXos Brain.
VEXos pode ser atualizado clicando na seta para cima ao lado do ícone VEX Brain.
Além disso, uma caixa de notificação aparecerá no canto inferior direito do editor do VS Code quando o VEXos estiver desatualizado. Um usuário pode iniciar uma atualização do VEXos clicando no botão “Atualizar” ou clicar no botão “Ignorar” para pular a atualização do VEXos.
Cérebro não vinculado ao controlador conectado
O ícone do Controlador VEX ficará amarelo quando um Controlador VEX estiver conectado a um computador, mas não estiver vinculado a um VEX Brain.
Para resolver este aviso, um usuário deve vincular um Controlador VEX a um VEX Brain
Painel Terminal
A extensão de código VEX VS fornece dois terminais na inicialização, o Terminal de Log e o Terminal Interativo
Terminal de registro
O Log Terminal exibe saída de compilação, erro de compilação e resultados de download.
Terminal interativo
O Terminal Interativo tem duas funções, exibindo logs printf e enviando as teclas digitadas de volta para um programa do usuário. Para aproveitar as vantagens do terminal interativo, um cérebro ou controlador deve estar conectado a um computador executando a extensão de código VEX VS. A saída do terminal interativo é limpa por padrão após a construção e download de um programa de usuário.
Configurações do Usuário
As configurações do usuário são configurações globais que o código do Visual Studio oferece para cada extensão. As configurações do usuário são aplicadas a cada projeto de extensão VEX VS Code.
Como acessar as configurações do usuário VEX
Clique na engrenagem no canto esquerdo do VS Code e um menu de contexto aparecerá
No menu de contexto, clique no item “Configurações” e uma página de configurações aparecerá.
Na visualização de lista à esquerda, clique no item “Extensões”. Em seguida, role até o final e encontre o item denominado “VEX”.
Clique no item da lista “VEX”.
As configurações do usuário VEX aparecerão no painel direito.
Visão geral das configurações
Canal do controlador (somente controlador V5)
A configuração Controller Channel controla o tipo de canal de comunicação de rádio entre um V5 Brain e um V5 Controller.
Esta configuração se aplica apenas quando o VS Code está conectado a um controlador V5 via USB e o controlador está conectado a um V5 Brain via VEXnet. O usuário pode escolher entre canais de Download e Pit. Quando definido como Download, o rádio irá pular para um canal VEXnet de download assim que o download do programa do usuário for iniciado. O canal de download permite taxas de dados mais altas e downloads mais eficientes. Quando definido como Pit, o rádio permanecerá em um canal pit e o download demorará muito mais. Por padrão, essa configuração é definida como Download.
Página inicial do SDK do projeto Cpp
NÃO EDITE ESTA CONFIGURAÇÃO.
Caminho do conjunto de ferramentas Cpp
Cpp Toolchain Path define o caminho para o conjunto de ferramentas que é usado ao construir um projeto C++ VEX VS Code.
Habilitar terminal de usuário
A configuração Habilitar Terminal do Usuário permite que o ramal abra a porta serial do usuário quando um VEX Brain ou VEX Controller for detectado pelo ramal. A única exceção se aplica a um Controlador V5 que não enumera com uma porta serial do usuário.
Habilitar permite que a extensão se conecte a uma porta de usuário na inicialização e criará o Terminal Interativo. Se ativar for selecionado enquanto a extensão estiver em execução, a extensão tentará abrir a porta do usuário se um dispositivo estiver conectado.
Desabilitar impede que o ramal se conecte à porta do usuário na inicialização e não criará um Terminal Interativo. Se desabilitar for selecionado enquanto a extensão estiver em execução, a extensão fechará a porta do usuário e removerá o Terminal Interativo.
Tipo de construção do projeto
Project Build Type define como a extensão construirá um projeto C++. O usuário pode definir o tipo de construção como Construir ou Reconstruir.
Build só compila o projeto quando o Make detecta alguma alteração no código-fonte do projeto.
Rebuild limpa o diretório de construção do projeto e então cria o projeto. Esta opção normalmente é muito mais lenta.
Página inicial do projeto
Project Home define o diretório inicial padrão para um novo projeto ao concluir o assistente New Project.
Execute após o download
Executar após download , quando ativado, faz com que o programa do usuário seja executado após ser baixado para um VEX Brain.
Página inicial do SDK Python
NÃO EDITE ESTA CONFIGURAÇÃO.
Ajuda do Comando VEX
VEX Command Help permite acesso à documentação para funções específicas incluídas na API C++ e Python (Application Programming Interface). A documentação é específica para cada Plataforma VEX (IQ 2ª Geração, EXP, V5).
Para acessar a Ajuda do Comando VEX, primeiro destaque o texto da função a ser pesquisada.
Clique com o botão direito no texto selecionado e um menu de contexto aparecerá.
Próximo Clique na Ajuda do Comando VEX para acessar a documentação.
Se o VEX Command Help encontrar uma correspondência exata, um novo webview aparecerá com a documentação relevante.
Se vários documentos corresponderem ao texto selecionado, um menu suspenso aparecerá com uma lista filtrada de documentação relevante.