Primeiros Passos com a Vespa

Introdução

Adquiriu a sua Vespa e não sabe como começar a usá-la? Não se preocupe, estamos aqui para te ajudar!

Neste tutorial mostraremos como instalar o driver USB para o reconhecimento da placa, a Arduino IDE, o pacote de placas ESP32 na Arduino IDE, a biblioteca desenvolvida para a placa e como gravar o primeiro código nela.

Instalação do Driver da Vespa

O primeiro passo para utilizar a Vespa é reconhecê-la em seu computador como uma porta serial. Para isso, você provavelmente precisará instalar o driver USB do conversor USB/UART da Vespa no seu computador. Siga então os passos do tutorial disponível no botão a seguir.

Tutorial de Instalação do Driver

A Vespa utiliza o mesmo conversor USB/UART que a BlackBoard UNO V2.0, portanto basta seguir o procedimento contido no botão acima para instalar o driver da placa no seu computador.

Instalação da Arduino IDE

Agora que o driver USB da placa está instalado e a placa está sendo corretamente reconhecida no seu computador, está na hora de instalar o programa onde os códigos da placa serão criados e com o qual gravaremos ela.

A Arduino IDE, assim como todas as outras ferramentas que serão instaladas neste capítulo, é completamente gratuita e, para baixá-la, basta acessar o link contido no botão abaixo.

Download da Arduino IDE

Ao acessar a página do botão acima, role um pouco a página para baixo até encontrar uma seção de "Downloads", como na imagem a seguir.

secao_download_arduino_ide — Seção de Download da Arduino IDE

Ao encontrar essa seção, selecione a opção de download para o sistema operacional do seu computador.

Observação: embora a Arduino IDE disponibilize uma versão pela própria Microsoft Store, evite utilizar esta versão se você estiver utilizando um computador com Windows, pois ela é famosa por conter diversos erros de funcionamento que podem comprometer o seu uso. Portanto, para esse sistema operacional, opte pela versão compactada ("ZIP File").

Observação: embora a Arduino IDE possa ser instalada diretamente pelo terminal em sistemas operacionais Linux, a versão disponível nesta instalação geralmente possui diversos erros de funcionamento, portanto evite utilizá-la.

Um detalhe importante que deve ser lembrado é que, embora a versão da Arduino IDE na imagem seja a 1.8.15 (tirada no momento em que esse capítulo foi desenvolvido), a Arduino IDE está sempre em atualização e a versão mais atual e estável disponível no momento em que você está realizando esse capítulo pode ser diferente. Não se preocupe quanto a este detalhe, pois isso não irá influenciar no funcionamento da Vespa.

Após selecionar a opção de download para o seu sistema operacional, será aberta uma janela de doação, como na imagem abaixo.

Descricao Breve da Imagem — Janela de Doação para a Arduino IDE

Essa doação não é obrigatória, mas é oferecida para ajudar a manter o projeto da Arduino IDE gratuito. Caso você não queira contribuir nesse momento, selecione a opção "Just Download", como demarcado em vermelho acima, para prosseguir com o download gratuito. Caso esteja interessado em contribuir com uma doação ao projeto, selecione o valor que deseja contribuir (em dólar), selecione a opção "Contribute & Download" ao lado, então siga os passos para o pagamento.

Windows e macOS

A instalação da Arduino IDE em computadores Windows e macOS é basicamente a mesma, já que se tratam de arquivos compactados. Após finalizar o download do arquivo no seu computador, descompacte o arquivo baixado no diretório de sua preferência (clique com o botão direito do mouse sobre o arquivo e selecione a opção "Extrair tudo"), como na próxima imagem, por exemplo.

descompactacao_arduino_ide — Descompactação da Arduino IDE

Assim que a extração estiver concluída, abra a pasta gerada, e então busque pelo aplicativo "arduino", como demarcado na imagem a seguir.

Este aplicativo é a Arduino IDE, então basta abrí-lo.

Se preferir, você pode criar um atalho deste aplicativo e mover o atalho para um diretório de mais fácil acesso no seu computador, como, por exemplo, no menu "Iniciar".

Linux

Em computadores Linux, além de descompactar o arquivo baixado do site da Arduino, também é necessário executar o arquivo install.sh pelo terminal de comandos (lembrando que é necessário acessar o diretório da pasta para isso). Além disso, para que o seu usuário tenha permissão de acesso às portas USB do computador, é necessário enviar o comando sudo usermod -a -G dialout <username> (lembrando de alterar o parâmetro <username> pelo nome do seu usuário no sistema), caso contrário não será possível gravar um código para a Vespa.

Instalação do Pacote de Placas ESP32

Agora que a placa está sendo corretamente reconhecida em seu computador, abra a Arduino IDE instalada anteriormente para que possamos instalar o pacote de placas ESP32. Com a Arduino IDE aberta, acesse as suas "Preferências" através do caminho da imagem abaixo. Se preferir, você pode simplesmente pressionar as teclas "Ctrl+vírgula" para abri-lo.

caminho_preferencias_arduino_ide — Caminho "Preferências" na Arduino IDE

Com as preferências abertas, copie e cole o link https://espressif.github.io/arduino-esp32/package_esp32_index.json no campo "URLs Adicionais para Gerenciador de Placas", como na imagem a seguir.

link_adicional_associado_gerenciador_placas — Link Adicional Associado ao "Gerenciador de Placas"

Com o link adicionado, temos que acessar o "Gerenciador de Placas" através do caminho abaixo.

caminho_gerenciador_placas — Caminho para o "Gerenciador de Placas"

Com o "Gerenciador de Placas" aberto, digite "esp32" na barra de pesquisa para encontrar o pacote da próxima imagem.

pacote_placas_esp32_encontrado — Pacote de Placas ESP32 Encontrado

Com este pacote na lista, pressione o botão "Instalar" para iniciar a instalação da última versão do pacote de placas. Esta instalação deve demorar um minuto e, quando ela estiver concluída, será apresentada a etiqueta "Instalado" ao lado do nome do pacote, como na imagem a seguir.

instalacao_concluida — Instalação Concluída

Após a instalação, será possível observar que a lista de modelos de placas da Arduino IDE ficou ainda maior, contendo diversas versões de placas ESP32, como na próxima imagem.

lista_placas_esp32 — Lista de Placas ESP32

O modelo de placa que deve ser selecionado para a Vespa é o "ESP32 Dev Module", portanto você pode deixá-lo pré-selecionado se quiser, e não são necessárias outras configurações nas opções da placa.

Instalação da Biblioteca

Para facilitar o controle dos motores e de outras funcionalidades da placa, foi desenvolvida uma biblioteca específica para a Vespa. Para instalá-la, acesse o "Gerenciador de Bibliotecas" da Arduino IDE, seguindo o caminho da imagem a seguir. Se preferir, você pode simplesmente pressionar as teclas "Ctrl+Shift+I" para abri-lo.

caminho_gerenciador_bibliotecas — Caminho para o "Gerenciador de Bibliotecas"

Isso fará que seja aberta uma janela como na imagem abaixo.

gerenciador_bibliotecas_aberto — "Gerenciador de Bibliotecas" Aberto

Com essa janela, digite "vespa" no campo de pesquisa da janela, e então pressione "Enter". Nesse momento será listada a biblioteca de controle dos periféricos da Vespa, como na próxima imagem.

biblioteca_encontrada — Biblioteca Encontrada

Com esta opção listada, pressione o botão "Instalar" demarcado acima e aguarde alguns instantes. A biblioteca será instalada e, quando a instalação for finalizada, será apresentado o ícone "Instalado" ao lado do nome dela, como na imagem a seguir.

biblioteca_instalada — Biblioteca Instalada

Gravação do Primeiro Código

Assim como na grande maioria das outras placas microcontroladas, o primeiro código que gravaremos na Vespa é o famoso "Blink". Para isso, temos que primeiramente configurar a IDE para o modelo de placa utilizado para a gravação. Como foi mencionado anteriormente, o modelo de placa da Vespa é o "ESP32 Dev Module", portanto selecione-o. Não é necessário fazer qualquer alteração nas configurações pré-feitas do modelo selecionado, porém aproveite que o menu "Ferramentas" da IDE está aberto e selecione a porta COM correspondente à Vespa no seu computador, como na imagem abaixo.

arduino_ide_configurada — Arduino IDE Configurada

Com a IDE configurada, abra o exemplo "Blink" da biblioteca instalada anteriormente, seguindo o caminho da imagem abaixo.

caminh_exemplo_blink — Caminho Exemplo "Blink"

Com o código aberto, pressione o botão de carregar da IDE e aguarde alguns instantes. O código será compilado e então carregado para a placa. Assim que a gravação for finalizada, será exibida a mensagem "Done Uploading", como na imagem abaixo.

Juntamente com essa mensagem, será possível observar que o LED L da Vespa está piscando de 1 em 1 segundo, como no GIF a seguir.

Resultado Final

Indo Além

Na biblioteca instalada neste tutorial também existem outros códigos de exemplo de uso da placa para demonstrar todas as suas funcionalidades. Em outros tutoriais específicos sobre a placa mostramos diversas possibilidades de uso.

Conclusão

Neste tutorial vimos os passos iniciais necessários para a gravação de códigos na Vespa e gravamos o primeiro código de exemplo da sua biblioteca.

Solução de Problemas

Se você continuar com dificuldades para carregar o código para a placa após verificar as soluções abaixo, envie um e-mail para suporte@robocore.net para que possamos te ajudar da melhor maneira possível.

A Arduino IDE retornou "Failed to execute script esptool the selected serial port Failed to execute script esptool does not exist or your board is not connected"

Caso você receba esta mensagem ao tentar carregar o código para a placa, é sinal que a porta serial selecionada não está correta, portanto acesse o "Gerenciador de Dispositivos" do seu computador para verificar qual é a porta serial correspondente da sua placa.

A Arduino IDE retornou "A fatal error occurred: Failed to connect to ESP32: Timed out waiting for packet header"

Esta mensagem é retornada pela IDE quando a placa não responde à tentativa de conexão com o computador. Tente novamente, porém desta vez pressione e mantenha pressionado o botão "BOOT" no momento em que a mensagem "Connecting..." for exibida. Além disso, certifique-se que o modelo de placa na aba "Ferramentas" está corretamente selecionado como "ESP32 Dev Module".

A Arduino IDE retornou "python executable file not found in $PATH"

Isso pode ocorrer no macOS e indica que o sistema operacional não encontrou a ferramenta Python correta. Nesse caso, abra o terminal do computador (basta digitar "terminal" na barra de pesquisa) e enviar o comando sed -i -e 's/=python /=python3 /g' ~/Library/Arduino15/packages/esp32/hardware/esp32/*/platform.txt.

Comentários

Para fazer comentários é necessário estar logado. Efetuar login.

Você ainda nao é cadastrado? Cadastre-se agora!

nandagas9
date

Enviado 2025-06-08 18:51:31

Preciso de ajuda. Meu robô esta ligando mas não esta conectando a via bluetooth. Oque faço?

carlos.oliveira
date

Enviado 2025-06-09 08:55:51
nandagas9

Olá! Poderia nos fornecer mais detalhes sobre o robô que está utilizando? Ele é um modelo desenvolvido por nós? Qual código está sendo usado para realizar os testes?

Além disso, você chegou a testar algum exemplo nativo de Bluetooth (como os disponíveis na Arduino IDE) para validar o funcionamento da placa?

csenn2003
date

Enviado 2025-05-16 10:44:25

código para sensor de refletância robocore e ligações na placa.

carlos.oliveira
date

Enviado 2025-05-16 10:49:48
csenn2003

Infelizmente, não temos um código pronto e aberto para a aplicação mencionada. Uma alternativa seria adquirir a chave de acesso do Kit Explorer ( https://www.robocore.net/tutoriais-kits-didaticos/chave-tutorial-kit-robo-explorer ). No manual deste kit, há capítulos em que utilizamos a Vespa tanto para seguir linha quanto para evitar colisões. Embora sejam projetos e códigos separados, você pode tentar unificá-los para criar a aplicação desejada.

csenn2003
date

Enviado 2025-05-16 10:38:42

Estou montando um robô com a placa vespa e gostaria de saber em quais pinos faço a ligação do sensor ultrassonico e tambem do arrays de sensores de vocês  para seguidor de linha e se possivel um codigo para seguidor de linha com obstaculos

carlos.oliveira
date

Enviado 2025-05-16 10:49:01
csenn2003

Olá! A imagem com a disposição dos pinos ( https://d229kd5ey79jzj.cloudfront.net/1439/vespa_esquematica-01.jpg ) pode ser utilizada como referência para o desenvolvimento do seu projeto.

Talvez seja interessante utilizar os pinos S1 a S4 para a ligação do sensor ultrassônico, já que são pinos que operam em 5 V. Sobre os demais sensores, isso dependerá das características específicas de cada sensor e do seu projeto.

flavio_romero_muniz
date

Enviado 2025-05-12 14:29:26

É normal a porta do ChannelB (no arquivo .motors) ser a mesma porta do LED (porta 15) em vez da porta do motor? Estou com problemas no Platform.io para ligar o motor B

carlos.oliveira
date

Enviado 2025-05-12 17:11:42
flavio_romero_muniz

Olá! Os pinos do canal B do motor e do LED de uso geral são diferentes: D4 e D27 correspondem ao canal do motor B, enquanto D15 é utilizado para o LED de uso geral. Para validar o funcionamento da placa, você pode utilizar a Arduino IDE. Além disso, a imagem da disposição dos pinos ( https://d229kd5ey79jzj.cloudfront.net/1439/vespa_esquematica-01.jpg ) pode ser usada como referência.

fernandafreitasg
date

Enviado 2025-04-23 09:47:36

Esses tutoriais estão desatualizados ou falta didática. Estamos na versão Arduino IDE 2.3.6 e não estamos conseguindo instalar o Vespa. Estou na gravação do primeiro código e não consigo prosseguir. Não é possível entender sobre essa parte de porta serial, porta COM etc porque está totalmente diferente o tutorial com o software.

carlos.oliveira
date

Enviado 2025-04-23 10:05:02
fernandafreitasg

Olá! A Arduino IDE recebe atualizações com frequência, o que pode causar algumas mudanças visuais e dificultar o processo de atualização de nossos tutoriais. No entanto, o procedimento de configuração e gravação do código continua o mesmo.

Você poderia nos informar em qual parte do tutorial está enfrentando dificuldades? O passo a passo de instalação do driver foi seguido corretamente? A placa está sendo reconhecida pelo computador?

carlos.oliveira
date

Enviado 2025-04-23 10:05:14
fernandafreitasg

Se preferir, você também pode enviar um e-mail para suporte@robocore.net juntamente com algumas capturas de tela e uma breve descrição do problema ou dúvida. Dessa forma, conseguiremos entender melhor a situação e ajudá-lo da melhor maneira possível!

cacoromas28
date

Enviado 2024-11-05 19:41:05

Boa noite , tudo bem com voces ? 

Gostaria de saber se é possível por uma antena na vespa para mais alcance ?

luan.ferreira
date

Enviado 2024-11-06 08:25:55
cacoromas28

Olá! Infelizmente não há uma forma direta de colocar uma antena para aumentar o alcance do ESP32 da Vespa.

PedroSegundo
date

Enviado 2024-07-31 13:09:32

Precisam atualizar essas dicas. Muitas atualizações aconteceram.

carlos.oliveira
date

Enviado 2024-07-31 13:32:46
PedroSegundo

Olá! Agradecemos pelo seu feedback! A possibilidade de uma atualização deste tutorial será analisada. Se tiver alguma dúvida ou problema, estamos à disposição para ajudar.

SURFROP
date

Enviado 2024-06-09 18:05:45

exit status 1

Compilation error: exit status 1

ESTÁ DANDO ESSE ERRO , ALGUÉM PODE ME AJUDA

carlos.oliveira
date

Enviado 2024-06-10 12:36:09
SURFROP

Olá! As bibliotecas de base do ESP32 foram atualizadas recentemente e muitas coisas mudaram. Devido a isso, diversas bibliotecas que utilizam as ferramentas do ESP32 apresentam erros de compilação e necessitam ser atualizadas. Estamos atualizando nossa biblioteca e, como ainda estamos em processo de atualização, sugiro que faça um downgrade do pacote de placas do ESP32 para a versão v2.0.17.

rodrigo99xz
date

Enviado 2024-05-11 22:55:17

Estou com um duvida, observei que existe duas entrada VIN e GND, gostaria de saber como faço para alimentar a placa por bateria, quais as compatíveis e qual a faixa de tensão e corrente que posso usar.

carlos.oliveira
date

Enviado 2024-05-13 08:43:44
rodrigo99xz

Olá! É possível utilizar uma bateria externa para alimentar a Vespa através das entradas VIN e GND, no entanto, é recomendável que a Vespa seja alimentada pelo borne de alimentação. Qualquer bateria que possua uma tensão entre 7 e 11 V pode ser usada para a alimentação da Vespa.

guerinopalhares
date

Enviado 2024-05-05 19:37:11

Eu adquiri o kit robô explorer deluxe a algum tempo e estou tentando configurar a IDE do Arduino, seguindo o exemplo da página https://www.robocore.net/tutoriais/primeiros-passos-com-vespa 
Eu instalei a IDE 1.8.19 do Arduino, configurei a placa da ESP32, baixei o exemplo do Blink, mas a porta COM não estava habilitada para seleção. Eu instalei uma nova porta COM multiporta, reiniciei o computador, e mesmo assim, não apareceu a alternativa para selecionar a porta. 
Solicito ajuda para resolver este problema.
OBS: O meu computador é Windows 10.

carlos.oliveira
date

Enviado 2024-05-06 08:30:38
guerinopalhares

Olá! Se o driver ( https://www.robocore.net/tutoriais/instalacao-driver-da-blackboard ) e o pacote de placas foram instalados sem erros, conforme os tutoriais, se possível, peço que teste a placa com outro cabo USB e/ou com outro computador. Além disso, verifique quais portas COM são exibidas no gerenciador de dispositivos ao conectar a placa. Caso o problema persista, peço por gentileza que envie um e-mail para suporte@robocore.net juntamente com uma captura de tela do gerenciador de dispositivos e algumas fotos da placa, desta maneira podemos lhe auxiliar melhor.