Aprender

Ler um botão no Raspberry Pi Pico

Iniciante

Ou veja todas as aulas.

  • 526componentes na bancada
  • 46placas rodando agora
  • 1.00xtempo real, em todas as placas
Raspberry Pi Pico: botãoao vivo0.000 s 0.00x
Segure o botão
Um botão de pressão do GP15 ao GND, lido com o pull-up interno. Segure-o e o LED do GP25 acende.

Para ler um botão no Raspberry Pi Pico, ligue-o de um pino GPIO ao GND, ative o pull-up interno do pino com pinMode(pin, INPUT_PULLUP) e leia-o com digitalRead(): HIGH significa solto, LOW significa pressionado. Não é preciso resistor.

O circuito acima é um Pico com um botão de pressão entre GP15 e GND, e um LED por meio de um resistor de 220 ohms no GP14. Enquanto você segura o botão, o LED da placa, no GP25, acende, e o do GP14 também. Ele roda no seu navegador em um RP2040 simulado, e o sketch é C++ estilo Arduino que também compila para um Pico real.

O que você precisa

  • Um Raspberry Pi Pico
  • Um botão de pressão (um interruptor tátil de quatro pernas)
  • Dois fios jumper
  • Opcional: um LED e um resistor de 220 ohms no GP14, que o sketch também acende

Ligação

Componente e pinoVai paraNota
Botão, uma pernaGP15O pino que o sketch lê
Botão, a perna do lado oposto a eleGNDQualquer pino GND do Pico
LED (opcional), com um resistor de 220 ohmsGP14Acende junto com o LED da placa

Passo 1: ligue o botão ao terra

A four-leg tactile switch is two pairs of legs. The legs in a pair are always joined, and pressing the button joins one pair to the other. Wire one leg to GP15 and a leg on the other side to any GND pin. If the button seems to be pressed all the time, you have used two legs of the same pair: turn it a quarter turn.

Esse é o circuito inteiro. GP15 é o pino de baixo do lado esquerdo do Pico, com um pino GND alguns pinos acima, então na mesa são dois fios curtos e nenhuma protoboard.

Passo 2: por que INPUT_PULLUP

Um pino de entrada sem nada ligado a ele fica flutuando. Ele capta o que estiver por perto e lê HIGH e LOW aleatoriamente. A solução é um resistor que puxa o pino para um nível conhecido quando o botão está solto. O RP2040 tem um embutido em cada GPIO, então pinMode(BUTTON, INPUT_PULLUP) o ativa e o pino fica em repouso a 3,3 V.

Apertar o botão liga o pino direto ao terra, que vence o pull-up fraco, e o pino lê LOW. Então a lógica fica invertida do que você talvez espere: LOW significa pressionado. O sketch vira isso de cabeça para cima em uma linha antes de acionar os LEDs.

Passo 3: o código, explicado

setup() configura GP15 como entrada com seu pull-up, e configura o LED da placa e o GP14 como saídas. LED_BUILTIN é GP25 no Pico. loop() lê o botão e escreve o resultado nos dois LEDs, repetidamente, então os LEDs acompanham o seu dedo.

Como o LED simplesmente reflete o botão, o repique de contato não importa aqui: alguns cintilamentos rápidos no instante do aperto são curtos demais para perceber. O repique passa a importar assim que você conta apertos ou alterna algo a cada aperto, que é o que o tutorial de debounce cobre.

O exemplo do botão no Pico
const int BUTTON = 15;
const int LED = 14;

void setup() {
  pinMode(BUTTON, INPUT_PULLUP);
  pinMode(LED_BUILTIN, OUTPUT);
  pinMode(LED, OUTPUT);
}

void loop() {
  int pressed = digitalRead(BUTTON) == LOW ? HIGH : LOW;
  digitalWrite(LED_BUILTIN, pressed);
  digitalWrite(LED, pressed);
}

Abrir este sketch no editorSó o código: o editor posiciona a placa e os componentes que ele consegue ler do sketch.

Passo 4: faça alternar

Um botão que acende o LED com um aperto e apaga com o próximo precisa de duas mudanças. Guarde a última leitura, e aja apenas quando ela muda de HIGH para LOW, que é o momento do aperto. Depois ignore o botão por algumas dezenas de milissegundos, para que o repique não conte como mais apertos.

Alternar a cada aperto
const int BUTTON = 15;
int last = HIGH;
bool on = false;

void setup() {
  pinMode(BUTTON, INPUT_PULLUP);
  pinMode(LED_BUILTIN, OUTPUT);
}

void loop() {
  int now = digitalRead(BUTTON);
  if (last == HIGH && now == LOW) {
    on = !on;
    digitalWrite(LED_BUILTIN, on ? HIGH : LOW);
    delay(30);  // let the contacts settle
  }
  last = now;
}

Abrir este sketch no editorSó o código: o editor posiciona a placa e os componentes que ele consegue ler do sketch.

Experimente no editor

Abra o circuito no editor e segure o botão com o mouse: o LED da placa acende. Troque o sketch pela versão que alterna acima e aperte Rodar de novo. Depois adicione um LED e um resistor de 220 ohms do GP14 ao GND e veja-o acompanhar o LED da placa.

Para ver para que serve o pull-up, ative Mostrar níveis com Shift+L, que rotula cada fio com o seu nível enquanto o circuito roda. Depois troque INPUT_PULLUP por INPUT e rode de novo. Com o botão solto, nada segura mais o pino em nenhum nível: essa entrada flutuante é exatamente o que o pull-up estava lá para evitar.

Erros comuns

Ligar o botão ao 3V3 em vez do GND usando INPUT_PULLUP. O pino já está puxado para cima, então apertar não muda nada. Com o pull-up, o botão vai ao terra.

Usar duas pernas do mesmo par. Elas estão unidas dentro do botão, então o pino lê pressionado o tempo todo. Use pernas de lados opostos.

Esperar HIGH quando pressionado. Com pull-up, pressionado é LOW. Ou teste LOW, ou ligue o botão ao 3V3 e use INPUT_PULLDOWN, que o RP2040 também tem.

Usar GP25 para um LED externo. GP25 está ligado ao LED da placa e não está no cabeçalho, então um LED externo vai em outro pino, como o GP14 aqui.

Abra este circuito no editor. Raspberry Pi Pico: botão, ligado como está no circuito que roda no topo desta página. Troque um componente ou um valor e rode de novo.

Abrir o circuito

Perguntas

Preciso de um resistor para um botão no Pico?

Não, se você usar INPUT_PULLUP ou INPUT_PULLDOWN. Cada GPIO do RP2040 tem um pull-up e um pull-down embutidos. Um resistor externo de 10 k faz o mesmo trabalho e só é necessário se você desligar os internos.

Quais pinos do Pico podem ler um botão?

Qualquer GPIO, de GP0 a GP22 e de GP26 a GP28. GP15 é usado aqui porque fica perto de um pino GND. GP23 a GP25 e GP29 são usados dentro do módulo.

Posso usar MicroPython para isso?

Sim. Escolha MicroPython (main.py) no painel de Firmware do Pico e o Mokxi roda o firmware oficial do MicroPython: Pin(15, Pin.IN, Pin.PULL_UP), e value() é 0 enquanto o botão está pressionado. O circuito desta página roda C++ estilo Arduino.

Por que meu botão registra vários apertos?

Os contatos repicam por alguns milissegundos ao fechar. Aja apenas na mudança de HIGH para LOW e ignore o pino brevemente depois, como o sketch de alternância acima faz, ou veja o tutorial de debounce de botão para um método que não usa delay().

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.