Um sensor de toque MPR121 em um Arduino: um piano de toque
Iniciante
- 526componentes na bancada
- 46placas rodando agora
- 1.00xtempo real, em todas as placas
O MPR121 transforma doze pedaços de metal em botões de toque. Ligue cada um de seus eletrodos a um pedaço de papel-alumínio, fita de cobre, um parafuso ou até um pedaço de fruta, e ele diz ao seu Arduino em quais um dedo está. Ele se comunica por I2C, então doze teclas usam apenas dois fios de sinal.
O circuito acima é um Uno, um MPR121 e um piezo, formando um piano de toque de doze teclas: uma oitava de notas a partir do dó central. Segure uma tecla e ela toca; segure duas e a mais grave vence; solte e para. Aperte Rodar e depois segure as teclas no MPR121.
O que você precisa
- Um Arduino Uno
- Uma placa breakout MPR121
- Um piezo passivo
- Doze almofadas de toque: papel-alumínio, fita de cobre ou fio
- Uma protoboard e jumpers
Ligação
| Componente e pino | Vai para | Nota |
|---|---|---|
| MPR121 VIN | 5 V | A placa funciona de 3 a 5 V |
| MPR121 GND | GND | |
| MPR121 SCL | SCL (A5) | |
| MPR121 SDA | SDA (A4) | Endereço 0x5A |
| MPR121 0 a 11 | As almofadas de toque | Um fio para cada tecla |
| Piezo | Pino 8 | Outra perna no GND |
Como funciona o toque capacitivo
Cada eletrodo, com a almofada e o fio nele, tem uma pequena capacitância: guarda um pouco de carga, como um capacitor minúsculo. Seu corpo é um grande condutor, então um dedo na almofada aumenta essa carga. O MPR121 mede cada eletrodo muitas vezes por segundo e percebe a mudança.
O chip mantém uma linha de base para cada eletrodo, sua leitura sem ninguém tocando. Quando uma leitura cai mais do que o limiar de toque abaixo da linha de base, a tecla está tocada; quando volta para dentro do limiar de liberação, ela é solta. A biblioteca da Adafruit define esses limiares como 12 e 6 contagens para cada tecla. Tudo isso acontece dentro do chip, e o Arduino apenas lê dois bytes: doze bits, um por tecla.
O sketch
cap.begin(0x5A) encontra o chip e o inicia. Então, a cada 10 ms, o loop chama cap.touched(), que devolve os doze bits, o eletrodo 0 no bit 0. O sketch procura o menor bit que está ativo e, se essa tecla mudou, toca sua nota com tone() ou para com noTone().
As notas são os doze semitons a partir do dó central, arredondados para o hertz: 262 Hz para o C4 até 494 Hz para o B4. Segure a tecla 0 e o monitor serial diz "tecla 0: C4, 262 Hz". Segure as teclas 4 e 9 juntas e você ouve a tecla 4, "E4, 330 Hz". Solte tudo e ele diz "silêncio".
#include <Wire.h>
#include "Adafruit_MPR121.h"
const int PIEZO = 8;
const unsigned int NOTES[12] = {262, 277, 294, 311, 330, 349, 370, 392, 415, 440, 466, 494};
const char *NAMES[12] = {"C", "C#", "D", "D#", "E", "F", "F#", "G", "G#", "A", "A#", "B"};
Adafruit_MPR121 cap = Adafruit_MPR121();
int playing = -1;
void setup() {
Serial.begin(115200);
if (!cap.begin(0x5A)) {
Serial.println("no MPR121: check SDA, SCL and power");
while (1) delay(10);
}
Serial.println("ready: touch a key");
}
void loop() {
uint16_t touched = cap.touched();
int key = -1;
for (int i = 0; i < 12; i++) {
if (touched & (1 << i)) {
key = i;
break;
}
}
if (key != playing) {
playing = key;
if (key < 0) {
noTone(PIEZO);
Serial.println("quiet");
} else {
tone(PIEZO, NOTES[key]);
Serial.print("key ");
Serial.print(key);
Serial.print(": ");
Serial.print(NAMES[key]);
Serial.print("4, ");
Serial.print(NOTES[key]);
Serial.println(" Hz");
}
}
delay(10);
}Abrir este sketch no editorSó o código: o editor posiciona a placa e os componentes que ele consegue ler do sketch.
Tocar apenas quando algo muda
O sketch lembra qual tecla está tocando e só chama tone() quando isso muda. Chamar tone() de novo a cada 10 ms com a mesma nota reiniciaria a onda sonora a cada vez, e você ouviria um zumbido por cima da nota. Lembrar o estado e agir na mudança é a mesma ideia da detecção de borda de um botão.
Um piezo consegue tocar uma nota por vez, e por isso a tecla mais grave vence. Para acordes você precisaria de vários pinos e um pouco mais de código, ou de um módulo de som.
Almofadas reais, problemas reais
Mantenha os fios da placa até as almofadas curtos e separados, já que um fio comprido faz parte do eletrodo e pode disparar a tecla quando uma mão se aproxima. Almofadas do tamanho de uma ponta de dedo ou maiores funcionam bem.
O chip aprende suas linhas de base quando inicia. Toque em uma almofada enquanto ele liga e esse toque vira a leitura de "não tocado", então a tecla não responde até ser reiniciada. Mantenha as mãos longe no primeiro segundo.
A simulação deixa a capacitância de fora: uma tecla não tocada lê 700 contagens e um dedo tira 40, e a linha de base não deriva. Em um projeto real você pode precisar ajustar os limiares com cap.setThresholds(touch, release) para adequar às suas almofadas.
Erros comuns
O chip não foi encontrado. Com o SDA desconectado, o sketch imprime "sem MPR121: verifique SDA, SCL e a alimentação" e para. Verifique os dois fios do barramento e a alimentação.
Outro componente em 0x5A. O termômetro IR MLX90614 também mora lá. Mude o MPR121 ligando seu pino ADDR: ao 3.3 V para 0x5B, ao SDA para 0x5C, ao SCL para 0x5D, e passe o novo endereço para begin().
Tocar em uma almofada na inicialização, então ela nunca é lida como tocada.
Reiniciar tone() a cada loop, gerando um zumbido em vez de uma nota limpa.
Almofadas próximas demais, então um dedo toca duas teclas. Deixe um espaço.
Abra este circuito no editor. Arduino Uno: um piano de toque com MPR121, ligado como aparece no topo desta página. Troque um componente ou um valor e rode de novo.
Abrir o circuitoPerguntas
Quantas entradas de toque o MPR121 tem?
Doze, numeradas de 0 a 11. Até quatro placas MPR121 podem compartilhar um barramento I2C nos endereços 0x5A a 0x5D, somando 48 teclas.
Qual biblioteca uso para o MPR121?
A Adafruit MPR121 Library: cap.begin(0x5A), depois cap.touched() para um número de doze bits, um bit por eletrodo.
O MPR121 consegue detectar através do plástico?
Sim, através de uma camada fina de plástico, vidro ou papel sobre a almofada, embora a mudança seja menor. Talvez você precise baixar o limiar de toque.
O MPR121 é melhor que o TTP223?
O TTP223 é uma tecla de toque com uma saída digital, simples e barato. O MPR121 cuida de doze teclas em dois fios e deixa você ajustar os limiares. Para mais de duas ou três teclas, o MPR121 exige menos ligação.
Continuar
Monte isto de verdade
Abra o editor, mude um valor e veja o número mudar junto. Nada para instalar, e não precisa de conta.