Primeiros Passos com o BRIICK Keypad


This tutorial is not available in English



Introdução

A família de módulos BRIICK não para de crescer, e novos módulos foram desenvolvidos para facilitar a criação dos seus projetos.

Neste tutorial veremos como utilizar o módulo BRIICK Keypad, para ler os botões e acionar os LEDs, tanto de modo independente, quanto associando o pressionar do botão com o acender do LED.

Lista de Materiais

Para este tutorial você precisará dos seguintes itens:

Instalação da Biblioteca

Para controlar o BRIICK com facilidade e realizar a leitura dos botões do módulo, desenvolvemos uma biblioteca, que pode ser baixada diretamente pelo "Gerenciador de Bibliotecas" da Arduino. Ao abrir o gerenciador, digite "briick keypad" no campo de pesquisa e então instale a opção retornada.

biblioteca-instalada
Biblioteca Instalada

Após pressionar o botão para instalar e aguardar alguns instantes, a biblioteca estará instalada e pronta para ser usada.

Circuito

Utilizando módulos BRIICK, a conexão é extremamente simples, basta conectar o módulo à BlackBoard Edge utilizando o cabo incluso ao módulo, como na imagem abaixo.

circuito-eletrico
Circuito Elétrico

Leitura dos Botões

Código

Para ler os botões do módulo, carregue o código a seguir na sua BlackBoard Edge. Caso seja a sua primeira vez utilizando a BlackBoard Edge, recomendamos que siga antes o tutorial de primeiros passos com a Edge.

Entendendo o Código

O código se inicia com a inclusão da biblioteca "BRIICK_Keypad" instalada anteriormente, e com a criação do objeto keypad como instância da classe BRIICK_Keypad da biblioteca.

Já nas configurações do código (função void setup()), apenas inicializamos a comunicação com o módulo através da função keypad.config(). Neste momento, vale mencionar que, caso você queira utilizar outro endereço I2C do módulo, por exemplo, para utilizar mais de um módulo Keypad na mesma BlackBoard Edge, basta digitar o novo endereço I2C como parâmetro da função de configuração. Vale mencionar também que o endereço I2C pode ser alterado no módulo através dos jumpers de solda na face inferior do módulo.

Por fim, na repetição do código (função void loop()), verificamos se cada um dos botões do módulo está sendo pressionado através da condição if (keypad.buttonPressed()), com os botões do módulo como parâmetro da função na sequência: KEYPAD_BTN_1, KEYPAD_BTN_2, KEYPAD_BTN_3 e KEYPAD_BTN_4. Caso um, ou mais de um, botão seja pressionado, será exibido no monitor serial qual botão está sendo pressionado.

O Que Deve Acontecer

Após carregar o código para a BlackBoard Edge, abra o monitor serial e veja que, ao pressionar um dos botões, o seu número será exibido no monitor, como na imagem abaixo.

resultado-final
Resultado Final

Acionamento dos LEDs

Código

Para acionar os LEDs do módulo, carregue o código a seguir na sua BlackBoard Edge.

Entendendo o Código

O código se inicia com a inclusão da biblioteca "BRIICK_Keypad" instalada anteriormente, e com a criação do objeto keypad como instância da classe BRIICK_Keypad da biblioteca, como no projeto anterior. Além disso, temos a criação da variável DELAY_TIME, que armazena o tempo de espera entre o piscar dos LEDs da placa.

Já nas configurações do código (função void setup()), apenas inicializamos a comunicação com o módulo através da função keypad.config().

Por fim, na repetição do código (função void loop()), através do comando keypad.setLED(), acionamos e apagamos os LEDs do módulo em sequência, acendendo eles com o parâmetro "HIGH" (nível lógico alto), e apagando-os com o parâmetro "LOW" (nível lógico baixo). O outro parâmetro da função é o LED que será acionado, e acionamos eles em sequência: KEYPAD_LED_1, KEYPAD_LED_2, KEYPAD_LED_3, KEYPAD_LED_4 e KEYPAD_LED_ALL, para acender todos os LEDs juntos ao final da sequência. Entretanto, em cada atualização de estado e de número dos LEDs, temos um delay() conforme o valor salvo na variável DELAY_TIME. Inclusive você pode alterar o valor desta variável para ver o piscar dos LEDs mais rapidamente ou mais lentamente.

O Que Deve Acontecer

A execução do código fará com que os 4 LEDs do módulo sejam acionados e apagados na sequência, como no GIF abaixo.

Resultado Final

Associação de Botões e LEDs

Código

A biblioteca do módulo permite associar o pressionar dos botões com os seus respectivos LED. Para isso, carregue o código a seguir na sua BlackBoard Edge.

Entendendo o Código

Este código é basicamente o mesmo do primeiro projeto, porém com a adição de um comando nas configurações do código. Graças ao comando keypad.attachLED(KEYPAD_LED_ALL), associamos todos os LEDs do módulo ao seu respectivo botão. Desta forma, ao pressionar um dos botões, o seu respectivo LED irá acender.

O Que Deve Acontecer

Após carregar o código para a BlackBoard Edge, você verá que, ao pressionar um dos botões, o seu respectivo LED no módulo acenderá, como no GIF abaixo.

Resultado Final

Conclusão

Neste tutorial vimos como utilizar o módulo BRIICK Keypad, e agora você poderá adicionar mais esta funcionalidade aos seus projetos com a BlackBoard Edge.

Avatar