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://dl.espressif.com/dl/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!

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.

carlosdanieldev
date

Enviado 2024-02-14 14:14:44

acontece o mesmo erro quando eu troco de porta serial disponível quando eu coloco a placa:
esptool.py v4.5.1
Serial port /dev/cu.SLAB_USBtoUART
Connecting......................................

A fatal error occurred: Failed to connect to ESP32: No serial data received.
For troubleshooting steps visit: https://docs.espressif.com/projects/esptool/en/latest/troubleshooting.html
Failed uploading: uploading error: exit status 2

carlos.oliveira
date

Enviado 2024-02-14 14:28:56
carlosdanieldev

Quando o console da IDE apresentar a mensagem “Connecting....” ao carregar o código, tente apertar o botão “boot” da Vespa, e veja se o código carrega para a placa. Caso o erro persista, entre em contato conosco pelo e-mail suporte@robocore.net juntamente com uma captura de tela do erro apresentado.

carlosdanieldev
date

Enviado 2024-02-14 12:06:59

O código compila, mas não envia pra placa:
Using library WiFi at version 2.0.0 in folder: /Users/carlos/Library/Arduino15/packages/esp32/hardware/esp32/2.0.11/libraries/WiFi 
Using library AsyncTCP at version 1.1.1 in folder: /Users/carlos/Documents/documents/Arduino/libraries/AsyncTCP 
Using library ESP Async WebServer at version 1.2.3 in folder: /Users/carlos/Documents/documents/Arduino/libraries/ESP_Async_WebServer 
Using library FS at version 2.0.0 in folder: /Users/carlos/Library/Arduino15/packages/esp32/hardware/esp32/2.0.11/libraries/FS 
....... continua

carlos.oliveira
date

Enviado 2024-02-14 12:29:13
carlosdanieldev

Olá! A placa é reconhecida pelo computador? Caso a placa seja reconhecida, a porta COM foi selecionada na IDE? Além disso, o modelo de placa está selecionado como “ESP32 Dev Module”? Caso o erro persista, envie um e-mail para suporte@robocore.net juntamente com uma captura de tela do erro apresentado.

jacksonamerico
date

Enviado 2023-11-08 13:33:04

ola boa tarde, gostaria de ver com vcs, pq a minha placa vespa consta que a porta com3 não existe, sendo que instalei os drivers bonitinho tudo certinho

luan.ferreira
date

Enviado 2023-11-08 15:05:27
jacksonamerico

Olá! Neste caso, o cabo que está sendo usado possui a função de transferência de dados? Para validar isso, você pode testar o cabo com outros dispositivos. Pedimos isso, pois muitos cabos USB possuem apenas a função de alimentação, e para o reconhecimento da placa Vespa, é necessário que o cabo também tenha a função de transferência de dados.

silvanoz944
date

Enviado 2023-09-23 09:35:52

Olá.
Aparece esse erro..
fatal error: wiFi.h: No such file or directory
O que pode ser?

luan.ferreira
date

Enviado 2023-09-25 08:19:01
silvanoz944

Olá! Neste caso, a IDE está acusando a falta da biblioteca “wiFi.h”. Sendo assim, verifique se a placa foi selecionada corretamente como descrito no tutorial acima, e se a biblioteca que está tentando usar foi instalada corretamente, e está sendo incluída com o nome correto. Vale dizer que no tutorial acima não fazemos o uso da biblioteca mencionada.

j_paiva_jr
date

Enviado 2023-04-24 18:45:15

Boa noite!!!
No meu Linux Ubuntu apareceu a msg de erro: "python executable file not found in $PATH". O tutorial ensina como resolver no macOS, e como seria no ubuntu??
Obrigado!!

j_paiva_jr
date

Enviado 2023-04-24 23:11:05
j_paiva_jr

Já resolvi!!! Nada que uma pesquisa na internet não resolva......kkkkk

luan.ferreira
date

Enviado 2023-04-25 10:41:47
j_paiva_jr

Olá! Ficamos felizes em saber que o problema foi resolvido. Em caso de problemas ou dúvidas, entre em contato.