Como ligar um botão no Arduino: pull-up, pull-down e debounce

O botão é o componente mais simples para levar o toque do usuário a um projeto com Arduino. Pressionado, ele une dois contatos; solto, ele os separa. Por mais simples que pareça, se for ligado errado ele lê valores aleatórios ou conta um único toque várias vezes. Neste guia mostramos como ligar e ler um botão do jeito certo.

Por dentro de um botão de 4 terminais

O botão tátil de 6×6 mm, o que você mais vai usar na protoboard, tem 4 terminais, mas só 2 pontos de conexão: os pares de terminais opostos já são ligados internamente. Pressionar o botão une os dois pares. Se você encaixar o botão atravessado sobre o canal central da protoboard, cada par cai em fileiras separadas e fica fácil acertar a posição.

Por que você precisa de um resistor de pull-up ou pull-down?

Quando o botão não está pressionado, o pino de entrada do Arduino não está ligado a nada; isso se chama entrada flutuante. Um pino assim capta ruído elétrico e lê valores HIGH ou LOW aleatórios. A solução é puxar o pino para um nível fixo através de um resistor:

O jeito mais prático é pinMode(pin, INPUT_PULLUP): o resistor interno do Arduino, de cerca de 20–50 kΩ, é ativado e você só liga o botão entre o pino e o GND. A única diferença é que a lógica fica invertida: um toque é lido como LOW.

Debounce: por que um toque é contado várias vezes?

No instante em que os contatos metálicos do botão se tocam, eles vibram por alguns milissegundos e o circuito abre e fecha muitas vezes. Como o Arduino lê muito rápido, ele pode ver um toque como 3–5 toques. Isso se chama repique de contato (bounce). Para resolver no software, novas mudanças são ignoradas por cerca de 50 ms após a última mudança.

1const int BUTTON_PIN = 2;   // buton pin ile GND arasında / button between pin and GND
2const int LED_PIN = 13;     // karttaki LED / onboard LED
3
4bool ledOn = false;
5int lastReading = HIGH;
6int stableState = HIGH;
7unsigned long lastChange = 0;
8
9void setup() {
10  pinMode(BUTTON_PIN, INPUT_PULLUP); // dahili pull-up / internal pull-up
11  pinMode(LED_PIN, OUTPUT);
12}
13
14void loop() {
15  int reading = digitalRead(BUTTON_PIN);
16  if (reading != lastReading) lastChange = millis();   // değişti / changed
17  if (millis() - lastChange > 50 && reading != stableState) {
18    stableState = reading;                              // 50 ms kararlı / stable for 50 ms
19    if (stableState == LOW) {                           // basıldı / pressed
20      ledOn = !ledOn;                                   // LED'i değiştir / toggle LED
21      digitalWrite(LED_PIN, ledOn ? HIGH : LOW);
22    }
23  }
24  lastReading = reading;
25}

Este código alterna o LED uma vez a cada toque; segurar o botão não fica alternando. Como usa millis() em vez de delay(), o loop nunca fica esperando e pode fazer outras tarefas ao mesmo tempo.

Erros comuns

• Colocar o botão na posição errada: se você usa um par de terminais já ligado, o botão é lido sempre como pressionado. Gire-o 90°.
• Não usar resistor: sem pull-up ou pull-down, a leitura muda aleatoriamente.
• Esperar a lógica errada com INPUT_PULLUP: um toque é lido como LOW, não HIGH; escreva suas condições de acordo.
• Usar um delay() longo para o debounce: o programa não consegue fazer nada durante esse tempo; temporizar com millis() é melhor.
• Usar os pinos 34–39 em um ESP32: esses pinos não têm pull-up interno; adicione um resistor externo ou escolha outro pino.

Para posicionar corretamente o botão e o resistor na protoboard, veja O que é protoboard? e, para entender os valores do resistor de pull-up, O que é resistor?.