Primeiros Passos com a BlackBoard Edge


This tutorial is not available in English



Introdução

Você adquiriu a sua BlackBoard Edge 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 e como gravar o primeiro código nela.

Lista de Materiais

Observação: a BlackBoard Edge é vendida "sozinha", portanto é necessário adquirir um cabo Micro USB separadamente se não possuir um.

Instalação do Driver USB

Antes de gravarmos o primeiro código na BlackBoard Edge, precisamos fazer com que ela seja reconhecida pelo seu computador, e talvez seja necessária a instalação do driver USB para isso.

Verificação do Reconhecimento da Placa

Antes de instalar manualmente o driver USB no seu computador, é recomendado verificar se a sua placa está sendo reconhecida por ele, pois é possível que o driver seja instalado automaticamente ou até que já esteja instalado. Levando isso em conta, se a sua placa for reconhecida por este teste inicial, não instale o driver seguindo os passos da seção de instalação mais adiante neste tutorial, pois é possível que a instalação de um driver duplicado gere algum mal funcionamento no seu computador.

Se a sua placa for reconhecida corretamente, é sinal que o driver USB necessário já foi instalado automaticamente ou já estava instalado em seu computador, portanto você já pode carregar um código para a placa.

Windows

Para verificar o reconhecimento em um computador Windows, conecte a sua BlackBoard Edge no seu computador, abra o "Gerenciador de Dispositivos" do sistema, expanda a lista de portas COM e verifique se um dispositivo é adicionado à esta lista, como na imagem a seguir.

reconhecida-windows
Placa Reconhecida no Windows

Vale lembrar que, na imagem acima, a placa testada foi reconhecida como "COM10", mas a sua placa no seu computador pode ser reconhecida com outro número (geralmente entre 3 e 254). 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.

macOS

Para computadores macOS, acesse o "Relatório do Sistema", abra a pasta "USB" no diretório de "Hardware" e observe se algum dispositivo é adicionado à esta pasta ao conectar a placa ao computador. Em computadores macOS, a BlackBoard Edge é reconhecida como um número de 32 dígitos no campo "Serial Number", como na imagem abaixo, por exemplo (na Arduino IDE será apresentado como "/dev/cu.usbserial-x", sendo "x" o "Serial Number" da placa).

reconhecida-macos
Placa Reconhecida no macOS

Vale lembrar que, na imagem acima, a placa testada foi reconhecida como "9c2d52c3670deb11bf884b10732f1568", 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.

Linux

Para verificar o reconhecimento em um computador Linux, abra o terminal de comandos e envie o comando dmesg | grep tty com a BlackBoard Edge recém conectada à uma porta USB, como na imagem abaixo. Em computadores Linux, a placa é reconhecida como "ttyUSBx" (sendo "x" geralmente 0 ou 1), como demarcado na imagem abaixo, por exemplo.

Como o comando mencionado anteriormente é um comando de kernel, ele deve ser compatível com a grande maioria das distribuições Linux. Mas se ele não for compatível com o seu computador, busque na documentação do seu sistema operacional qual comando utilizar para realizar esse teste.

reconhecida-linux
Placa Reconhecida no Linux

Vale lembrar que, 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.

Instalação do Driver

Se a sua placa não for reconhecida "de primeira" como nos passos acima, não se preocupe, pois é possível instalar o driver USB para a sua placa manualmente com os passos descritos abaixo.

Atenção: computadores Linux com kernel de versão 3.X ou mais atual não necessitam da instalação dos drivers deste tutorial, pois eles já são instalados de fábrica.

Primeiramente, desconecte a placa e baixe o arquivo compactado com o driver compatível com o sistema operacional do seu computador através dos botões abaixo.

Download do Driver para Windows 10 e 11 Download do Driver para Windows 8.1, 8 e 7 Download do Driver para macOS

Windows 10 e 11

Com o arquivo baixado, descompacte-o. Para isso, você pode utilizar programas voltados para essa função, como o 7Zip, por exemplo, que é gratuito. Para extrair o conteúdo da pasta, basta selecioná-la, então clicar com o botão direito do mouse e selecionar a opção "Extrair tudo...".

Para os computadores com Windows 10 ou 11, não há arquivos ".exe", portanto localize o arquivo "silabser.inf", selecione-o, clique com o botão direito do mouse sobre ele e então selecione a opção "Instalar", como na imagem abaixo. Lembrando que o arquivo deve estar acessível para o sistema operacional, ou seja, é necessário extrair a pasta baixada em um diretório do computador (como a "Área de Trabalho", por exemplo).

execucao-instalador
Execução do Instalador do Driver (Windows 10 e 11)

Assim que a instalação for finalizada, é recomendado reiniciar o computador para que o driver seja iniciado corretamente. Após a reinicialização, a sua placa já será reconhecida como uma porta serial, como mostrado na seção anterior.

Windows 7, 8 e 8.1

Com o arquivo baixado, descompacte-o. Para isso, você pode utilizar programas voltados para essa função, como o 7Zip, por exemplo, que é gratuito. Para extrair o conteúdo da pasta, basta selecioná-la, então clicar com o botão direito do mouse e selecionar a opção "Extrair tudo...".

Com os arquivos descompactados, basta executar o instalador como "Administrador", mesmo sendo o único usuário. Para isso, basta clicar com o botão direito do mouse sobre o arquivo descompactado, e então selecionar a opção "Executar como administrador", como na próxima imagem. Para sistemas com arquitetura de 64 bits, execute a opção "x64", e para sistemas com arquitetura de 32 bits, execute a opção "x86".

execucao-instalador
Execução do Instalador do Driver como "Administrador" (Windows 7, 8 e 8.1)

Assim que o instalador for iniciado, siga os passos para a instalação e aguarde alguns instantes. Assim que a instalação for finalizada, será apresentada uma mensagem que o driver está pronto para uso, como na imagem abaixo.

instalacao-finalizada
Instalação Finalizada

Assim que a instalação for finalizada, é recomendado reiniciar o computador para que o driver seja iniciado corretamente. Após a reinicialização, a sua placa já será reconhecida como uma porta serial, como mostrado na seção anterior.

macOS

O arquivo compactado para computadores macOS possui apenas um arquivo no formato "DMG", portanto basta executá-lo (não é necessária a execução como "root") após descompactar a pasta em um diretório acessível do computador.

Assim que a instalação for finalizada, é recomendado reiniciar o computador para que o driver seja iniciado corretamente. Após a reinicialização, a sua placa já será reconhecida como uma porta serial, como mostrado na seção anterior.

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.

Caso já tenha a Arduino IDE instalada no seu computador, não é necessário seguir os passos desta seção.

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.

download-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 2.0.3 (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 BlackBoard Edge. Isso também é válido para versões mais antigas da Arduino IDE.

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

doacao-ide
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-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.

aplicativo-ide
Aplicativo "arduino"

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 na BlackBoard Edge.

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, ou pressione "Ctrl+vírgula".

caminho-preferencias
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-adicionado
Link Adicional Associado ao "Gerenciador de Placas"

Com o link adicionado, acesse o "Gerenciador de Placas" disponível na aba lateral da Arduino IDE (seção com o botão no formato de um Arduino UNO). Caso esteja utilizando uma versão anterior à 2.0 da Arduino IDE, siga o caminho da imagem a seguir.

gerenciador-placas
Caminho para o "Gerenciador de Placas" (Arduino IDE antes da 2.0)

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

pacote-esp32
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.

pacote-instalado
Instalação Concluída

Este procedimento é basicamente o mesmo para a Arduino IDE 2.0 e versões anteriores, com a diferença sendo apenas por onde o pacote é instalado.

Gravação do Primeiro Código

Com o pacote de placas instalado, e a placa sendo reconhecida corretamente pelo seu computador, está na hora de gravar o famoso "Blink" para a sua BlackBoard Edge. Para isso, clique sobre a janela de seleção de placas na IDE (deve estar configurada para "Arduino UNO"), e então selecione a opção mostrando a porta serial correspondente à sua placa no seu computador, como na imagem abaixo.

selecao-porta
Seleção da Porta Serial

Após selecionar a porta serial, será aberta uma janela para a seleção do modelo de placa que será gravada. Nesta janela, digite "ESP32 Dev Module" no campo de busca, e selecione a opção correspondente, como na próxima imagem.

Atenção: é normal que a porta serial da placa seja apresentada como "Desconhecida" ("Unknown") na Arduino IDE, portanto não se preocupe com isso.

selecao-modelo
Seleção do Modelo de Placa

Caso esteja utilizando uma Arduino IDE anterior à versão 2.0, a seleção de porta serial e modelo de placa deve ser feita através do menu "Ferramentas" da IDE. Esse procedimento também é possível nesta nova versão da IDE.

Com esta configuração feita, copie, cole e carregue o código a seguir para a sua placa.

Após alguns segundos de compilação, os LEDs RX e TX da placa piscarão e, quando a gravação de código for finalizada, será exibida uma mensagem de conclusão na IDE, como na imagem abaixo.

codigo-gravado
Código Gravado

Juntamente com essa mensagem de conclusão, a BlackBoard Edge começará a piscar o seu LED L de 1 em 1 segundo, como no GIF a seguir.

Resultado Final

Indo Além

A BlackBoard Edge possui um acelerômetro de 3 eixos embarcado em seu circuito e mostramos como usá-lo no tutorial Leitura do Acelerômetro da BlackBoard Edge. Além disso, outro grande diferencial da BlackBoard Edge é o conector Briick, e mostramos como usar cada um dos módulos disponíveis com a placa em uma série de tutoriais.

Conclusão

Neste tutorial vimos como instalar as ferramentas básicas necessárias para a gravação de códigos da BlackBoard Edge e gravamos o nosso primeiro código na placa.

Avatar