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.

Captura de tela da interface da extensão do VS Code para V5, mostrando recursos e ferramentas disponíveis para desenvolvedores aprimorarem sua experiência de codificação.

Componentes da IU

Existem 3 componentes principais na extensão do código VEX VS.

  1. Barra de ferramentas
  2. Barra de atividades e barra lateral
  3. 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.

Captura de tela da interface da extensão do VS Code para V5, mostrando recursos e ferramentas disponíveis para desenvolvedores, com seções destacadas para facilitar a navegação e o uso.

Seletor de dispositivos

Captura de tela da interface da extensão do VS Code para V5, mostrando recursos e ferramentas disponíveis para os usuários aprimorarem sua experiência de desenvolvimento.

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.

Captura de tela da interface do V5 VS Code Extension, mostrando recursos e ferramentas disponíveis para desenvolvedores que usam a plataforma VEX Robotics.

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

Captura de tela da interface da extensão do VS Code para V5, mostrando recursos e ferramentas disponíveis para aprimorar os fluxos de trabalho de desenvolvimento.

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.

Captura de tela da extensão do VS Code para V5, mostrando a interface e os recursos projetados para melhorar a eficiência da codificação e o suporte ao desenvolvimento do V5.

Captura de tela da interface da extensão do VS Code para V5, mostrando recursos e ferramentas disponíveis para desenvolvedores, incluindo trechos de código, opções de depuração e funcionalidades de gerenciamento de projetos.

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

Captura de tela da interface do V5 VS Code Extension, mostrando recursos e ferramentas disponíveis para desenvolvimento do V5, incluindo trechos de código e opções de depuração.

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.

Captura de tela da interface da extensão do VS Code para V5, mostrando recursos e ferramentas disponíveis para desenvolvimento V5, incluindo trechos de código e opções de gerenciamento de projetos.

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

Captura de tela da interface da extensão do VS Code para V5, mostrando recursos e ferramentas disponíveis para desenvolvedores, com foco em melhorar a produtividade e o gerenciamento de código.Captura de tela da interface da extensão do VS Code para V5, mostrando recursos e ferramentas disponíveis para desenvolvedores, incluindo opções de edição de código e funcionalidades de gerenciamento de projetos.

O ícone Build/Download altera as funções se um VEX Brain ou um VEX Controller estiver conectado.

Captura de tela da interface da extensão do VS Code para V5, mostrando recursos e ferramentas disponíveis para desenvolvedores, com foco em melhorar a produtividade e o gerenciamento de código.

Se um dispositivo VEX não estiver conectado, o ícone de construção será mostrado. Quando clicado, o projeto apenas será compilado.

Captura de tela da interface da extensão do VS Code para V5, mostrando recursos e ferramentas disponíveis para desenvolvedores, incluindo opções de edição de código e funcionalidades de gerenciamento de projetos.

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

Captura de tela da extensão do VS Code para V5, mostrando sua interface de usuário e recursos, incluindo ferramentas de edição de código e integração com robótica VEX.

O ícone de reprodução, quando clicado, executa o programa do usuário no slot selecionado.

Parar

Captura de tela da interface da extensão do VS Code para V5, mostrando recursos e ferramentas disponíveis para desenvolvedores que usam a plataforma V5.

O ícone de parada, quando clicado, interrompe um programa do usuário.

Espaço de trabalho selecionado

Captura de tela da extensão do VS Code para V5, mostrando sua interface de usuário e recursos, incluindo ferramentas de edição de código e opções de categoria V5, projetadas para aprimorar a experiência de desenvolvimento.

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.

Captura de tela da interface da extensão do VS Code para V5, mostrando recursos e funcionalidades relevantes para a descrição da categoria V5, incluindo ferramentas de edição de código e opções para desenvolvedores.

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.

Captura de tela da interface da extensão do VS Code para V5, mostrando recursos e ferramentas disponíveis para desenvolvedores, incluindo opções de edição e depuração de código.

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.

Captura de tela da interface da extensão do VS Code para V5, mostrando recursos e ferramentas disponíveis para desenvolvedores, incluindo opções de edição e depuração de código.


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

Captura de tela da extensão do VS Code para V5, mostrando sua interface de usuário e recursos relacionados à descrição da categoria V5, incluindo ferramentas de edição de código e opções de navegação.

Ações de Projetos

Captura de tela da interface do V5 VS Code Extension, mostrando recursos e funcionalidades para melhorar a experiência de codificação com a robótica VEX.

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.

Para mais informações sobre como criar um novo projeto, este artigo!

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

Captura de tela da extensão do VS Code para V5, mostrando sua interface e recursos, incluindo ferramentas de edição de código e funcionalidades específicas do V5.Captura de tela da interface da extensão de código VEX V5 no Visual Studio Code, mostrando os principais recursos e opções disponíveis para programar sistemas de robótica V5.

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

Captura de tela da interface da extensão do VS Code para V5, mostrando recursos e ferramentas disponíveis para desenvolvedores na categoria V5.

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

Captura de tela da interface da extensão do VS Code para V5, mostrando recursos e ferramentas disponíveis para desenvolvedores, incluindo trechos de código e opções de depuração.

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

Captura de tela da interface da extensão do VS Code para V5, mostrando recursos e ferramentas disponíveis para desenvolvedores que trabalham com projetos V5.

As informações do programa exibem uma lista de todos os programas de usuário baixados em um VEX Brain.

Captura de tela da interface da extensão do VS Code para V5, mostrando recursos e ferramentas disponíveis para desenvolvedores, incluindo trechos de código e opções de integração.

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

Captura de tela da interface do V5 VS Code Extension, mostrando recursos e ferramentas disponíveis para desenvolvimento do V5, incluindo trechos de código e opções de configuração.

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.

Captura de tela da interface da extensão do VS Code para V5, mostrando recursos e ferramentas disponíveis para desenvolvedores que trabalham com projetos V5.

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.

Captura de tela da interface da extensão do VS Code para V5, mostrando recursos e ferramentas disponíveis para desenvolvedores que trabalham com a VEX Robotics, incluindo opções de edição e depuração de código.

VEX Brain está vinculado a um controlador VEX

Captura de tela da interface da extensão do VS Code para V5, mostrando recursos e funcionalidades relevantes para desenvolvedores que usam a plataforma V5.

VEX Brain não está vinculado a um controlador VEX

Captura de tela da interface da extensão do VS Code para V5, mostrando os principais recursos e ferramentas disponíveis para desenvolvedores aprimorarem sua experiência de codificação.

O controlador VEX V5 está conectado a um cérebro VEX V5

Capturas de tela

Captura de tela da interface da extensão do VS Code para V5, mostrando vários recursos e ferramentas disponíveis para desenvolvedores aprimorarem sua experiência de codificação.

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)

Captura de tela da extensão do VS Code para V5, mostrando sua interface e recursos, incluindo ferramentas de edição de código e opções de integração de robótica VEX.

Ao clicar no ícone Coração, a extensão baixará e executará o programa do usuário Battery Medic.

Definir nome do cérebro

Captura de tela da extensão do VS Code para V5, mostrando a interface do usuário e os recursos projetados para melhorar a eficiência da codificação e o gerenciamento de projetos no desenvolvimento de robótica VEX.

Ao clicar no ícone de lápis próximo ao nome do sistema>, um usuário pode definir o nome de um VEX Brain.

Captura de tela da interface da extensão do VS Code para V5, mostrando recursos e ferramentas disponíveis para programação de robótica VEX, incluindo opções de edição e depuração de código.

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

Captura de tela da interface da extensão do VS Code para V5, mostrando recursos e ferramentas disponíveis para desenvolvedores que trabalham com projetos V5.

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.

Captura de tela da extensão do VS Code para V5, mostrando a interface do usuário e recursos relevantes para o desenvolvimento da categoria V5, incluindo ferramentas de edição de código e opções de integração.

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

Captura de tela da interface da extensão do VS Code para V5, mostrando recursos e ferramentas disponíveis para desenvolvedores, incluindo opções de edição de código e funcionalidades de gerenciamento de projetos.

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

Captura de tela da interface da extensão do VS Code para V5, mostrando recursos e ferramentas disponíveis para desenvolvedores, incluindo opções de edição de código e recursos de integração.

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.

Captura de tela da interface da extensão do VS Code para V5, mostrando recursos e funcionalidades para melhorar a experiência de codificação, incluindo menus e opções de ferramentas.

VEXos pode ser atualizado clicando na seta para cima ao lado do ícone VEX Brain.

Captura de tela da extensão do VS Code para V5, mostrando sua interface de usuário e recursos, incluindo ferramentas de edição de código e opções de integração para uma experiência de desenvolvimento aprimorada.

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

Captura de tela da interface da extensão do VS Code para V5, mostrando recursos e ferramentas disponíveis para desenvolvedores, incluindo trechos de código e opções de gerenciamento de projetos.

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

Captura de tela da interface da extensão do VS Code para V5, mostrando recursos e ferramentas disponíveis para desenvolvedores, incluindo trechos de código e opções de gerenciamento de projetos.

Terminal de registro

Captura de tela da interface da extensão do VS Code para V5, mostrando recursos e ferramentas disponíveis para desenvolvimento V5, incluindo opções de edição e depuração de código.

O Log Terminal exibe saída de compilação, erro de compilação e resultados de download.

Terminal interativo

Captura de tela da interface da extensão do VS Code para V5, mostrando recursos e ferramentas disponíveis para desenvolvimento de robótica VEX, incluindo opções de edição e depuração de código.

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.

Captura de tela da interface da extensão do VS Code para V5, mostrando recursos e ferramentas disponíveis para desenvolvedores, incluindo trechos de código e opções de gerenciamento de projetos.

Como acessar as configurações do usuário VEX

Captura de tela da interface da extensão do VS Code para V5, mostrando recursos e opções disponíveis para os usuários aprimorarem sua experiência de codificação com a robótica VEX.

Clique na engrenagem no canto esquerdo do VS Code e um menu de contexto aparecerá

Captura de tela da interface da extensão do VS Code para V5, mostrando recursos e ferramentas disponíveis para desenvolvedores na categoria V5.

No menu de contexto, clique no item “Configurações” e uma página de configurações aparecerá.

Captura de tela da interface da extensão do VS Code para V5, mostrando recursos e ferramentas disponíveis para desenvolvedores, incluindo opções de edição de código e funcionalidades específicas do VEX.

Na visualização de lista à esquerda, clique no item “Extensões”. Em seguida, role até o final e encontre o item denominado “VEX”.

Captura de tela da interface da extensão do VS Code para V5, mostrando recursos e ferramentas disponíveis para desenvolvedores, incluindo opções de edição de código e funcionalidades de gerenciamento de projetos.

Clique no item da lista “VEX”.

Captura de tela da extensão do VS Code para V5, exibindo recursos e funcionalidades relevantes para a descrição da categoria V5, incluindo elementos da interface do usuário e trechos de código.

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.

Captura de tela da interface da extensão do VS Code para V5, mostrando recursos e ferramentas disponíveis para desenvolvedores que trabalham com projetos V5.

Página inicial do SDK do projeto Cpp

NÃO EDITE ESTA CONFIGURAÇÃO.

Captura de tela da interface da extensão do VS Code para V5, mostrando recursos e ferramentas disponíveis para desenvolvedores, incluindo opções de edição e depuração de código.

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.

Captura de tela da interface da extensão do VS Code para V5, mostrando recursos e ferramentas disponíveis para desenvolvedores, incluindo trechos de código, opções de depuração e ferramentas de gerenciamento de projetos.

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.

Captura de tela da interface da extensão do VS Code para V5, mostrando recursos e ferramentas disponíveis para desenvolvedores, incluindo opções de edição e depuração de código.

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.

Captura de tela da extensão do VS Code para V5, mostrando sua interface e recursos, projetada para aumentar a eficiência da codificação e otimizar os processos de desenvolvimento para usuários que trabalham com projetos V5.

Página inicial do projeto

Project Home define o diretório inicial padrão para um novo projeto ao concluir o assistente New Project.

Captura de tela da interface da extensão do VS Code para V5, mostrando recursos e ferramentas disponíveis para desenvolvedores, incluindo opções de edição e depuração de código.

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.

Captura de tela da extensão do VS Code para V5, mostrando sua interface de usuário e recursos, incluindo ferramentas de edição de código e funcionalidades específicas do VEX.

Página inicial do SDK Python

NÃO EDITE ESTA CONFIGURAÇÃO.

Captura de tela da interface do V5 VS Code Extension, mostrando recursos e ferramentas disponíveis para desenvolvimento do V5, incluindo trechos de código e opções de gerenciamento de projetos.

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

Captura de tela da extensão do VS Code para V5, mostrando sua interface de usuário e recursos, incluindo ferramentas de edição de código e opções de integração para programação de robótica VEX.

Para acessar a Ajuda do Comando VEX, primeiro destaque o texto da função a ser pesquisada.

Captura de tela da interface da extensão do VS Code para V5, mostrando recursos e ferramentas disponíveis para desenvolvedores, incluindo trechos de código e opções de depuração.

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.

Captura de tela da interface da extensão do VS Code para V5, exibindo recursos e ferramentas disponíveis para desenvolvedores, incluindo trechos de código e opções de gerenciamento de projetos.

Se o VEX Command Help encontrar uma correspondência exata, um novo webview aparecerá com a documentação relevante.

Captura de tela da interface da extensão do VS Code para V5, mostrando recursos e ferramentas disponíveis para desenvolvedores, incluindo trechos de código e opções de gerenciamento de projetos.

Se vários documentos corresponderem ao texto selecionado, um menu suspenso aparecerá com uma lista filtrada de documentação relevante.

For more information, help, and tips, check out the many resources at VEX Professional Development Plus

Last Updated: