Primeiros Passos com a BlackBoard Rocky

Introdução

Você adquiriu a sua BlackBoard Rocky 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.

Lista de Materiais

Para este tutorial você precisará dos seguintes itens:

Lista completa de produtos

comprar

BlackBoard Rocky

R$ 123,40 no PIX

Conversor USB x UART

R$ 44,55 no PIX

Cabo USB Micro B 80cm

R$ 9,40 no PIX

Instalação do Driver do Conversor USB x UART

O primeiro passo para utilizar a BlackBoard Rocky é fazer com que o Conversor USB x UART seja reconhecido em seu computador como uma porta serial. Para isso, você provavelmente precisará instalar o driver USB do conversor USB x UART no seu computador. O Conversor USB x UART utiliza o mesmo chip que a BlackBoard UNO V2.0. Portanto, basta seguir o procedimento contido no tutorial da BlackBoard UNO para instalar o driver corretamente. Pressione o botão a seguir para ir para o tutorial de instalação.

Instalação da Arduino IDE

Agora que o driver USB da placa está instalado e a placa está sendo reconhecida corretamente, é hora de instalar o programa, onde os códigos serão criados e gravados na placa. 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.

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.

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 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, recomendamos que você faça o download diretamente pelo site da Arduino.

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 2.3.4 (tirada no momento em que esse tutorial 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 tutorial pode ser diferente. Não se preocupe quanto a este detalhe, pois isso não irá influenciar no funcionamento da BlackBoard Rocky.

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

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

Para instalar a Arduino IDE em sistemas operacionais Windows, basta executar o arquivo baixado da página do software.

Após executar o arquivo baixado, siga as instruções exibidas na tela até concluir a instalação.

macOS

Para instalar a Arduino IDE em sistemas operacionais macOS, basta copiar o arquivo baixado para a pasta de aplicativos.

Linux

Para instalar a Arduino IDE em sistemas operacionais Linux, recomendamos que baixe o arquivo "AppImage 64 bits (X86-64)". Antes de abrir o arquivo, é necessário realizar as configurações a seguir:

1. Acesse o diretório onde o arquivo foi baixado;
2. Clique com o botão direito no arquivo e selecione "Propriedades".
3. Na aba "Permissões", marque a opção "Permitir execução de arquivo como programa".

Após isso, precisamos abrir a Arduino IDE, conectar a placa ao computador e verificar se ela é reconhecida corretamente: na Arduino IDE, vá até "Tools > Port" e veja se alguma porta serial aparece na lista, como na imagem abaixo:

Observação: Na imagem acima, a placa testada foi reconhecida como "ttyUSB0", mas a sua placa no seu computador pode ser reconhecida com outro número. Não se preocupe quanto a isso, pois o número da porta serial configurada para a sua placa não influencia no seu funcionamento, o importante é que ela esteja sendo reconhecida corretamente

Se nenhuma porta serial for exibida, pode ser necessário conceder permissão ao usuário do computador para acessar portas seriais. Para isso, siga os procedimentos abaixo.

Abra o terminal, execute o seguinte comando sudo nano /etc/udev/rules.d/99-arduino.rules , digite sua senha de administrador e aperte enter. Após isso, o editor nano será aberto, então adicione a seguinte regra:

SUBSYSTEMS=="usb", ATTRS{idVendor}=="2341", GROUP="plugdev", MODE="0666"

Quando a regra já estiver digitada, pressione "Ctrl+X" para sair do editor nano. Isso fará com que o editor pergunte se você deseja salvar o arquivo editado, como na próxima imagem:

Neste momento, pressione "S" no seu teclado e, então, pressione "Enter" para confirmar. Isso fará com que o arquivo seja salvo e você volte para o terminal. Feito isso, execute os seguintes comandos no terminal para aplicar as alterações:

sudo udevadm control --reload-rules sudo udevadm trigger sudo usermod -aG plugdev $USER

Com todos os comandos executados, reinicie o sistema operacional, abra a Arduino IDE e veja se agora alguma porta serial é listada.

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 abrir a janela.

Com as preferências abertas, copie o link abaixo e cole no campo "URLs Adicionais para Gerenciador de Placas", como na imagem a seguir.

Feito isso, pressione o botão "OK" das "Preferências" para salvar essa alteração, e então acesse o "Gerenciador de Placas" (botão do lado esquerdo da IDE que possui o formato de uma placa Arduino - demarcado na imagem abaixo).

Ao clicar neste botão, será aberta uma janela no lado esquerdo da janela da IDE exibindo os pacotes de placas disponíveis para instalação. Digite "esp32" no campo de pesquisa e então instale a opção feita pela "Espressif Systems". A instalação deve levar alguns minutos, e ao final será exibido que o pacote está instalado, assim como a opção de remoção do pacote, como na imagem abaixo.

Instalação da Biblioteca da BlackBoard Rocky

Agora que o pacote de placas ESP32 está instalado, vamos instalar a biblioteca da BlackBoard Rocky, que irá nos ajudar a controlar as funções da placa. Para isso, acesse o "Gerenciador de Bibliotecas" da IDE (o botão que parece quatro livros na lateral esquerda da IDE - demarcado na imagem abaixo).

Ao clicar sobre este botão, será aberta uma janela do lado esquerdo da placa (como ocorreu com o Gerenciador de Placas). Então digite "BlackBoard Rocky" no campo de pesquisa e instale a opção desenvolvida pela RoboCore. Após alguns instantes, a biblioteca estará instalada, como na imagem abaixo:

Gravação do Primeiro Código

Assim como na grande maioria das outras placas microcontroladas, o primeiro código que gravaremos na BlackBoard Rocky é o famoso "Blink", que inclusive é um dos exemplos da biblioteca da Rocky.

Conexão USB-UART

Antes de conectar o conversor USB-UART no seu computador e na Rocky, altere o jumper seletor de tensão de 5V (padrão) para 3,3V, e então conecte-o à Rocky. Neste momento, atente-se à polaridade do módulo e da placa. O pino de GND do conversor deve estar conectado no pino de GND da placa (o pino mais próximo do botão BOOT), como mostrado na imagem abaixo.

Após a conexão do conversor à placa, conecte o conversor ao seu computador utilizando o cabo USB Micro.

Configuração da IDE

Com o conversor USB-UART conectado à Rocky e ao seu computador, configure a Arduino IDE para que ela programe a porta COM correspondente ao conversor no seu computador, e o modelo de placa "ESP32 Dev Module", como na imagem abaixo.

Código

Como mencionado anteriormente, a própria biblioteca da Rocky já possui um exemplo "Blink" preparado para acionar o LED interno da placa a cada um segundo. Para acessá-lo, basta abrir o exemplo disponível da biblioteca, como na imagem abaixo:

Se preferir, você pode copiar o código abaixo:

/******************************************************************************* * RoboCore - Blink (v1.0) * * Blink the LED of the Rocky Board. * * Based on the example "Blink" by the Arduino team. * * * This file is part of the Rocky library by RoboCore ("RoboCore-Rocky-lib"). * * "RoboCore-Rocky-lib" is free software: you can redistribute it and/or modify * it under the terms of the GNU Lesser General Public License as published by * the Free Software Foundation, either version 3 of the License, or * (at your option) any later version. * * "RoboCore-Rocky-lib" is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * GNU Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public License * along with "RoboCore-Rocky-lib". If not, see <https://www.gnu.org/licenses/> *******************************************************************************/ // -------------------------------------------------- // Variables const int PIN_LED = 15; const int PAUSE_TIME = 1000; // [ms] // -------------------------------------------------- void setup() { // set the pin as an output pinMode(PIN_LED, OUTPUT); } // -------------------------------------------------- void loop() { digitalWrite(PIN_LED, HIGH); delay(PAUSE_TIME); digitalWrite(PIN_LED, LOW); delay(PAUSE_TIME); } // --------------------------------------------------

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 BlackBoard Rocky e gravamos o primeiro código de exemplo da sua biblioteca.

Solução de Problemas

Se encontrar dificuldades em executar o tutorial, tente as soluções abaixo ou entre em contato conosco através do e-mail suporte@robocore.net para que possamos te ajudar da melhor forma possível.