Visão geral da interface do usuário do VS Code para EXP

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 ecrã que mostra o layout completo da interface do utilizador do VEX no VS Code. A barra de atividades e a barra lateral estão no lado esquerdo do ecrã, a barra de ferramentas e o terminal estão na parte inferior do ecrã, e o editor preenche o resto do ecrã.

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.

Barra de ferramentas VS Code com ícones de extensão VEX que podem ser utilizados para interagir rapidamente com dispositivos e projetos VEX ligados. As características do VEX incluem o Seletor de Dispositivo, o Seletor de Slot, o ícone de Download da Versão & , o ícone de Reproduzir, o ícone de Parar, o Seletor de Projeto e o Seletor de Ficheiros Python.

Seletor de dispositivos

O ícone do Seletor de Dispositivos está destacado na barra de ferramentas do VS Code. Neste exemplo, lê-se VEX_EXP.

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.

Barra de pesquisa do VS Code com uma lista de seleção rápida de todos os dispositivos VEX ligados. Neste exemplo, estão listados um V5 Brain, um V5 Controller e um EXP Controller.

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

A barra de pesquisa do VS Code apresenta um item da Lista de Seleção Rápida para fornecer detalhes. O item indica MyBrain, V5 Brain, User COM8, Comm COM7.

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.

A barra de pesquisa do VS Code apresenta um item da Lista de Seleção Rápida para fornecer detalhes. O artigo é um Controlador V5, mas o fundo está cinzento e não há nenhum nome de controlador listado. Isto indica que este Controlador não possui uma ligação rádio com um Cérebro.

Controlador V5 com fundo azul para indicar que este controlador possui uma ligação rádio com um módulo de controlo.

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 Slots está destacado na barra de ferramentas do VS Code. Neste exemplo, lê-se Slot 1.

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.

Barra de pesquisa do VS Code com uma lista de seleção rápida de todos os slots disponíveis no VEX Brain ligado. Neste exemplo, existem oito vagas disponíveis.

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

Ícone de construção.Ícone de download.

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

Ícone de construção.

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

Ícone de download.

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

Ícone de reprodução.

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

Parar

Ícone de parar.

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

Espaço de trabalho selecionado

O Seletor de Projetos é apresentado na barra de ferramentas do VS Code. Neste exemplo, lê-se EXPTestProject.

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.

Barra de pesquisa do VS Code com uma lista de seleção rápida de projetos VEX guardados. Neste exemplo, existe um projeto em Python e um projeto em C++ listados.

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.

O ícone do Seletor de Ficheiros Python é apresentado na barra de ferramentas do VS Code. Neste exemplo, lê o ficheiro main.py.

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.

Barra de pesquisa do VS Code com uma lista de seleção rápida de todos os ficheiros Python deste projeto VEX. Neste exemplo, existem três ficheiros Python, cada um num local diferente.


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 ecrã que mostra a barra de atividades do VS Code e a barra lateral abertas na vista VEX. O VEX View oferece opções para criar e importar projetos na parte superior, o menu Informações do dispositivo VEX na parte inferior e um menu de feedback na parte inferior.

Ações de Projetos

Secção Ações do Projeto da Visualização de Extensão VEX. Esta secção possui dois botões com os dizeres "Novo Projeto" e "Importar Projeto".

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

A secção Informações do dispositivo VEX na Visualização de extensão VEX apresenta uma lista de todos os dispositivos ligados e informações específicas sobre cada um deles. Neste exemplo, são mostrados um EXP Brain e os seus programas descarregados. A listagem do Controlador indica "Controlador", sem ligação.A secção de informações do dispositivo VEX é novamente apresentada, mas agora a listagem do controlador mostra "Controlador, ligado".

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

A pasta do sistema e o seu conteúdo são apresentados e destacados abaixo da pasta Brain. A pasta do sistema contém dados sobre o Brain, e os dados indicam VEXos 1.0.1.0, nome VEX_EXP, equipa 000000, id 0EC83725 e Python 1.0.0.7.

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

A pasta Serial Port e o seu conteúdo são mostrados por baixo da pasta Brain. A pasta Serial Port contém dados sobre a ligação com fios do Brain. Estes dados indicam a comunicação COM167 e o utilizador COM168.

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

A pasta Programas e o seu conteúdo são apresentados abaixo da pasta Cérebro. A pasta Programas mostra todos os projetos VEX descarregados no Brain. Neste exemplo, existem quatro programas em C/C++ descarregados para o Brain ligado.

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

A pasta "Programas" e o seu conteúdo são apresentados por baixo da pasta "Cérebro", agora com a pasta do primeiro projeto aberta para mostrar o seu conteúdo. A pasta do projeto apresenta dados sobre o Slot, Ficheiro, Tipo, Tamanho e Tempo.

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

A pasta Dispositivos e o seu conteúdo são apresentados abaixo da pasta Cérebro. A pasta Dispositivos mostra todos os dispositivos que estão ligados ao cérebro. Neste exemplo, existem 6 dispositivos listados, incluindo 4 motores, um dispositivo de 3 fios e um rádio interno.

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.

A pasta Dispositivos e o seu conteúdo são apresentados abaixo da pasta Cérebro. Neste exemplo, foi selecionado um dispositivo Motor e o seu conteúdo indica Tipo Motor, Versão 1.0.0.4, Arranque 1.0.2.0.

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.

O controlador está listado na pasta Dispositivos. Este controlador lê "Controlador", ligado.

VEX Brain está vinculado a um controlador VEX

O controlador está listado na pasta Dispositivos. Este controlador lê "Controlador", não está ligado.

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

O controlador está listado na pasta Dispositivos. Este controlador lê "Controlador, ligado".

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

Capturas de tela

O cursor está posicionado sobre a pasta "VEX Device Indicator" e é apresentado um ícone de câmara ao lado.

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)

O cursor está posicionado sobre a pasta "V5 Brain VEX Device Indicator" e é apresentado um ícone do Battery Medic ao lado.

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

Definir nome do cérebro

O cursor está posicionado sobre a opção Nome dentro da pasta Sistema e é apresentado um ícone de lápis ao lado da mesma.

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

Configure a janela de pedido do nome do cérebro com um campo de texto e uma mensagem por baixo que diga "Pressione Enter para confirmar a sua introdução ou Esc para cancelar".

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

O cursor está posicionado sobre a opção Equipa dentro da pasta Sistema e é apresentado um ícone de lápis ao lado da mesma.

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.

Exibir uma janela de pedido para definir o número da equipa com um campo de texto e uma mensagem abaixo que diz: Prima Enter para confirmar a sua entrada ou Escape para cancelar.

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

O cursor está posicionado sobre um programa na pasta Programas e é apresentado um ícone de um caixote do lixo ao lado.

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

O ícone da pasta Brain e o ícone do Indicador de Dispositivo VEX são apresentados a laranja, e existe um símbolo de perigo junto à versão do VEXos do sistema. Estes sinais indicam que a versão do VEXos do Brain está desatualizada.

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.

O cursor está posicionado sobre a pasta desatualizada do Brain e é apresentado um ícone de seta para cima ao lado.

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

Atualize a janela de aviso do VEXos com uma mensagem que diga "Atualização do VEXos disponível: 1.0.1.0". Fonte: Extensão VEX. Abaixo, existem dois botões com os dizeres "Atualizar" e "Ignorar".

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

A pasta "Brain" dentro da pasta "VEX Device Indicator" tem um ícone laranja e a inscrição "Brain, not linked". Estes sinais indicam que não existe nenhum dispositivo VEX Brain ligado.

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

A janela do Terminal do VS Code está aberta e apresenta o Terminal de Registo do VEX e o Terminal Interativo do VEX.

Terminal de registro

O terminal de registo VEX do VS Code é aberto e apresenta o histórico de utilização da extensão VEX. Neste exemplo, existem mensagens como "Log", "Compilação do Windows para a plataforma vexexp", "Download do programa do utilizador" e "Download concluído".

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

Terminal interativo

O terminal interativo VEX do VS Code é aberto e apresenta a mensagem "Olá, Mundo!".

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.

As Definições do Utilizador do VS Code são abertas na página VEX, onde o comportamento da Extensão de Robótica VEX pode ser personalizado.

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

O ícone de definições encontra-se na parte inferior da barra de atividades do VS Code, localizada no canto inferior esquerdo do ecrã.

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

Menu de contexto das definições do VS Code com várias opções listadas. A opção "Definições" está destacada e é a terceira opção do menu, abaixo de "Paleta de Comandos" e "Perfis".

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

A janela de definições do VS Code está aberta e a categoria Extensões está realçada na lista de navegação à esquerda.

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

A janela de definições do VS Code está aberta e o link da página VEX dentro da categoria Extensões está selecionado.

Clique no item da lista “VEX”.

As Definições do Utilizador do VS Code são abertas na página VEX, onde o comportamento da Extensão de Robótica VEX pode ser personalizado.

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.

Definições de utilizador VEX com a opção Canal do Controlador apresentada. Esta opção tem um menu suspenso que está definido como "Download" por defeito. A descrição diz: Define o canal de rádio do controlador V5.

Página inicial do SDK do projeto Cpp

NÃO EDITE ESTA CONFIGURAÇÃO.

Definições de utilizador VEX com a opção Cpp SDK Home apresentada. Esta opção tem um link que diz "Editar em settings.json". A descrição diz: NÃO EDITAR.

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.

Definições de utilizador VEX com a opção Path do conjunto de ferramentas C++ apresentada. Esta opção possui um campo de texto que representa o caminho de um ficheiro.

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.

Definições de utilizador VEX com a opção Geral Ativar Terminal do Utilizador apresentada. Esta opção tem um menu suspenso que está definido como Ativado por defeito. A descrição diz: Ative a extensão para abrir e apresentar os dados da porta do utilizador.

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.

Definições do utilizador VEX com a opção Tipo de compilação do projeto apresentada. Esta opção tem um menu suspenso que está definido como "Compilar" por defeito. A descrição diz: Definir tipo de compilação do projeto C++.

Página inicial do projeto

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

Definições do utilizador VEX com a opção Página Inicial do Projeto apresentada. Esta opção possui um campo de texto que representa o caminho de um ficheiro. A descrição diz: Define a localização predefinida para novos projetos.

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.

Definições do utilizador VEX com a opção "Executar projeto após o download" apresentada. Esta opção possui uma caixa de seleção que é mostrada como selecionada neste exemplo. A descrição diz: Define se o programa do utilizador deve ser executado após o download.

Página inicial do SDK Python

NÃO EDITE ESTA CONFIGURAÇÃO.

Definições de utilizador VEX com a opção Python SDK Home apresentada. Esta opção tem um link que diz "Editar em settings.json". A descrição diz: NÃO EDITAR.

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

O comando C++ no editor VS Code foi destacado com o cursor.

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

O menu de contexto do comando C++ foi aberto e a opção Ajuda do Comando VEX está selecionada.

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.

A página de ajuda do comando VEX está aberta e apresenta informações e exemplos sobre o comando Brain Screen Print em C++.

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

A barra de pesquisa do VS Code possui uma lista de seleção rápida com os comandos VEX C++ correspondentes na Ajuda de Comandos VEX, ajudando o utilizador a refinar a sua pesquisa.

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: