Ler um botão no Raspberry Pi Pico
Iniciante
- 526componentes na bancada
- 46placas rodando agora
- 1.00xtempo real, em todas as placas
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 pino | Vai para | Nota |
|---|---|---|
| Botão, uma perna | GP15 | O pino que o sketch lê |
| Botão, a perna do lado oposto a ele | GND | Qualquer pino GND do Pico |
| LED (opcional), com um resistor de 220 ohms | GP14 | Acende 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.
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.
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 circuitoPerguntas
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().
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.