STM32 Mbed CodeIDE (3/8): botones, pull-ups y antirrebote

Las entradas convierten un patrón fijo de luces en un controlador que responde a una persona, interruptor o sensor. Primero comprobarás qué lee el botón cuando está suelto y pulsado, y después añadirás una comprobación antirrebote sencilla para que el programa reaccione a una pulsación real en vez de a un contacto ruidoso.

La guía de CodeIDE enumera PC_5, PC_6 y PC_10 entre los pines de botón/sensor disponibles en el laboratorio STM32 WB55RG. Esta lección usa primero PC_5 y te enseña a verificar el valor pulsado antes de construir lógica alrededor de él.

Muchos circuitos de botón con pull-up son activos en bajo: el nivel eléctrico pulsado es menor que el nivel suelto. Aun así, debes medir el cableado del laboratorio antes de introducir cualquiera de los valores en la lógica.

DigitalIn button(PC_5, PullUp);
int raw = button.read();

DigitalIn es el objeto de entrada de Mbed para leer un pin. PullUp pide a Mbed que use la resistencia pull-up interna del microcontrolador, de modo que el pin tenga un valor definido cuando el botón está suelto. button.read() devuelve el valor 0/1 actual en el momento en que tu código lo llama.

La interfaz del laboratorio remoto tiene controles de botón redondos. En esta lección, usa B1 para PC_5.

Planifica tres compilaciones y unos 25 minutos de laboratorio activo: prueba, secuencia y un cambio de retardo de secuencia. Si hay cola, prepara los dos campos de observación y lee los TODO 1-2 antes de iniciar la sesión.

#include "mbed.h"

DigitalIn button(PC_5, PullUp);
int main() {
    printf("Button probe start\n");

    while (true) {
        int raw = button.read();

        printf("button_raw=%d\n", raw);
        ThisThread::sleep_for(500ms);
    }
}

Registra por separado las lecturas de suelto y pulsado. Copia el número exacto button_raw desde la consola.

Las líneas copiadas deben usar los valores observados, no valores proporcionados por la lección:

button_raw=<valor suelto observado>
button_raw=<valor pulsado observado>

Ahora usa B1 para iniciar una secuencia de tres LED. Introducirás el valor pulsado medido en tu propia prueba en vez de copiar un valor supuesto.

Los botones mecánicos pueden rebotar: durante una pulsación, la señal eléctrica puede cambiar rápidamente entre 0 y 1 durante unos milisegundos. El antirrebote consiste en esperar brevemente y comprobar otra vez para que una pulsación física no se trate como varias pulsaciones.

Tres protecciones cumplen funciones distintas:

- Confirmación antirrebote: espera 50 ms, vuelve a medir y acepta solo si la segunda muestra sigue siendo igual al valor pulsado observado.
- Bloqueo de secuencia: run_sequence() es bloqueante, por lo que no se muestrea la entrada mientras se ejecuta la secuencia. Evita otro inicio durante la secuencia; no es antirrebote.
- Rearme al soltar: después de la secuencia, espera hasta que la entrada sea distinta del valor pulsado antes de aceptar otra pulsación. Evita que una pulsación mantenida reinicie inmediatamente; tampoco es antirrebote.

El código contiene exactamente dos marcadores que impiden compilar. El TODO 1 usa tu valor pulsado observado. El TODO 2 debe ser una condición real de rechazo de la segunda muestra. Sustituye ambos y busca TODO antes de compilar.

#include "mbed.h"

DigitalIn button(PC_5, PullUp);
DigitalOut led1(PB_13, 1);
DigitalOut led2(PB_14, 1);
DigitalOut led3(PB_15, 1);

void led_on(DigitalOut &led) {
    led = 0;
}

void led_off(DigitalOut &led) {
    led = 1;
}

void all_off() {
    led_off(led1);
    led_off(led2);
    led_off(led3);
}

void run_sequence() {
    led_on(led1);
    ThisThread::sleep_for(500ms);
    led_on(led2);
    ThisThread::sleep_for(500ms);
    led_on(led3);
    ThisThread::sleep_for(2000ms);
    all_off();
}

int main() {
    // 1: sustituye por el valor pulsado exacto observado en la prueba.
    const int pressed_value = TODO_PRESSED_VALUE;
    all_off();
    printf("Button sequence start\n");

    while (true) {
        bool pressed = (button.read() == pressed_value);

        if (pressed) {
            ThisThread::sleep_for(50ms);
            // 2: rechaza si la segunda muestra ya no está pulsada.
            if (TODO_CONFIRM_CONDITION) {
                continue;
            }

            printf("press detected: running sequence\n");
            run_sequence();
            printf("sequence complete; release button\n");
            while (button.read() == pressed_value) {
                ThisThread::sleep_for(20ms);
            }
            printf("ready for next press\n");
        }

        ThisThread::sleep_for(20ms);
    }
}

Registra tres comprobaciones breves. Mantén separadas la predicción y la evidencia.