Aprender

Um sensor de toque MPR121 em um Arduino: um piano de toque

Iniciante

Ou veja todas as aulas.

  • 526componentes na bancada
  • 46placas rodando agora
  • 1.00xtempo real, em todas as placas
Arduino Uno: um piano de toque com MPR121ao vivo0.000 s 0.00x
Clique para abrir no editor
O exemplo Piano de toque: doze teclas em um MPR121, uma oitava a partir do dó central em um piezo. Segure as teclas.

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 pinoVai paraNota
MPR121 VIN5 VA placa funciona de 3 a 5 V
MPR121 GNDGND
MPR121 SCLSCL (A5)
MPR121 SDASDA (A4)Endereço 0x5A
MPR121 0 a 11As almofadas de toqueUm fio para cada tecla
PiezoPino 8Outra 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".

O sketch do piano de toque
#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 circuito

Perguntas

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.

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.