Leer un botón en una Raspberry Pi Pico
Principiante
- 526componentes en el banco de trabajo
- 46placas funcionando ahora
- 1.00xtiempo real, en todas las placas
Para leer un botón en una Raspberry Pi Pico, conéctalo de un pin GPIO a GND, activa la resistencia pull-up interna del pin con pinMode(pin, INPUT_PULLUP) y léelo con digitalRead(): HIGH significa suelto, LOW significa presionado. No se necesita resistencia.
El circuito de arriba es una Pico con un botón pulsador entre GP15 y GND, y un LED con una resistencia de 220 ohms en GP14. Mientras mantienes presionado el botón, se enciende el LED de la placa, en GP25, y también el de GP14. Se ejecuta en tu navegador sobre un RP2040 simulado, y el sketch es C++ estilo Arduino que también compila para una Pico real.
Lo que necesitas
- Una Raspberry Pi Pico
- Un botón pulsador (un interruptor táctil de cuatro patas)
- Dos cables puente
- Opcional: un LED y una resistencia de 220 ohms en GP14, que el sketch también enciende
Cableado
| Componente y pin | Va a | Nota |
|---|---|---|
| Botón, una pata | GP15 | El pin que lee el sketch |
| Botón, la pata que queda enfrente | GND | Cualquier pin GND de la Pico |
| LED (opcional), a través de 220 ohm | GP14 | Se enciende con el LED integrado de la placa |
Paso 1: conecta el botón a tierra
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.
Ese es todo el circuito. GP15 es el pin de abajo del lado izquierdo de la Pico, con un pin GND a pocos pines de distancia, así que sobre un escritorio son dos cables cortos y nada de protoboard.
Paso 2: por qué INPUT_PULLUP
Un pin de entrada sin nada que lo impulse queda flotando. Capta lo que haya cerca y lee HIGH y LOW al azar. La solución es una resistencia que lleve el pin a un nivel conocido cuando el botón está suelto. El RP2040 tiene una integrada en cada GPIO, así que pinMode(BUTTON, INPUT_PULLUP) la activa y el pin descansa en 3.3 V.
Presionar el botón conecta el pin directo a tierra, lo cual gana contra la débil pull-up, y el pin lee LOW. Así que la lógica está al revés de lo que podrías esperar: LOW significa presionado. El sketch lo voltea en una línea antes de encender los LEDs.
Paso 3: el código, explicado
setup() convierte GP15 en una entrada con su pull-up, y hace del LED integrado y de GP14 salidas. LED_BUILTIN es GP25 en una Pico. loop() lee el botón y escribe el resultado en ambos LEDs, una y otra vez, así que los LEDs siguen tu dedo.
Como el LED simplemente refleja el botón, el rebote de contacto no importa aquí: unos parpadeos rápidos en el instante de la presión son demasiado cortos para verse. El rebote importa en cuanto cuentas presiones o alternas algo con cada presión, que es lo que cubre el tutorial de antirrebote.
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 en el editorSolo el código: el editor coloca la placa y los componentes que puede leer del sketch.
Paso 4: haz que alterne
Un botón que enciende el LED con una presión y lo apaga con la siguiente necesita dos cambios. Recordar la última lectura, y actuar solo cuando cambia de HIGH a LOW, que es el momento de la presión. Luego ignora el botón durante unas decenas de milisegundos, para que el rebote no cuente como más presiones.
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 en el editorSolo el código: el editor coloca la placa y los componentes que puede leer del sketch.
Pruébalo en el editor
Abre el circuito en el editor y mantén presionado el botón con el ratón: el LED de la placa se enciende. Reemplaza el sketch con la versión de alternancia de arriba y presiona Ejecutar otra vez. Luego agrega un LED y una resistencia de 220 ohm de GP14 a GND y observa cómo sigue al LED de la placa.
Para ver para qué sirve la pull-up, activa Mostrar niveles con Shift+L, que etiqueta cada cable con su nivel mientras el circuito se ejecuta. Luego cambia INPUT_PULLUP por INPUT y ejecútalo de nuevo. Con el botón suelto, nada sostiene el pin en ninguno de los dos niveles: esa entrada flotante es justo lo que la pull-up estaba ahí para evitar.
Errores comunes
Conectar el botón a 3V3 en lugar de GND usando INPUT_PULLUP. El pin ya está elevado, así que presionar no cambia nada. Con la pull-up, el botón va a tierra.
Usar dos patas del mismo par. Están unidas dentro del interruptor, así que el pin lee presionado todo el tiempo. Usa patas de lados opuestos.
Esperar HIGH al presionar. Con una pull-up, presionado es LOW. O prueba con LOW, o conecta el botón a 3V3 y usa INPUT_PULLDOWN, que el RP2040 también tiene.
Usar GP25 para un LED externo. GP25 está conectado al LED de la placa y no está en el header, así que un LED externo va en otro pin, como GP14 aquí.
Abre este circuito en el editor. Raspberry Pi Pico: botón, cableado tal como se ejecuta al inicio de esta página. Cambia un componente o un valor y ejecútalo de nuevo.
Abrir el circuitoPreguntas
¿Necesito una resistencia para un botón en una Pico?
No si usas INPUT_PULLUP o INPUT_PULLDOWN. Cada GPIO del RP2040 tiene una pull-up y una pull-down integradas. Una resistencia externa de 10 k hace el mismo trabajo y solo se necesita si desactivas las internas.
¿Qué pines de la Pico pueden leer un botón?
Cualquier GPIO, de GP0 a GP22 y de GP26 a GP28. Aquí se usa GP15 porque está cerca de un pin GND. GP23 a GP25 y GP29 se usan dentro del módulo.
¿Puedo usar MicroPython para esto?
Sí. Elige MicroPython (main.py) en el panel Firmware de la Pico y Mokxi ejecuta el firmware oficial de MicroPython: Pin(15, Pin.IN, Pin.PULL_UP), y value() es 0 mientras el botón está presionado. El circuito de esta página ejecuta C++ estilo Arduino.
¿Por qué mi botón registra varias presiones?
Los contactos rebotan durante unos milisegundos al cerrarse. Actúa solo en el cambio de HIGH a LOW e ignora el pin brevemente después, como hace el sketch de alternancia de arriba, o consulta el tutorial de antirrebote del botón para un método que no usa delay().
Sigue así
Ármalo en la vida real
Abre el editor, cambia un valor y mira cómo cambia el número con él. Nada que instalar y sin necesidad de cuenta.