STM32 con Arduino API (4/4): mini-controlador

Tu mini-controlador tendrá tres estados:

- Potenciómetro por debajo del umbral: color verde.
- Potenciómetro por encima del umbral: color rojo.
- Botón pulsado: color azul, aunque el potenciómetro indique otra cosa.

El reto no es solo copiar el programa. Al final debes tener un mini-controlador
probado: lee una entrada, decide un estado, cambia el RGB, escribe evidencia por
Serial y conserva una mejora pequeña que puedas defender.

Antes de programar, piensa como si fueras a probar un producto pequeño. Una
buena prueba debe decir qué vas a tocar, qué color esperas ver y qué dato de
Serial confirmaría que el controlador tomó la decisión correcta.

El código inicial imprimirá líneas con esta forma exacta:
estado=<verde/rojo/manual> pot1=<lectura ADC> boton=<suelto/pulsado>.

La función setRgb(rojo, verde, azul) evita repetir tres líneas cada vez que
cambias de color. Cada argumento es un brillo PWM de 0 a 255. El umbral
inicial es 600 cuentas ADC, pero debes compararlo con lecturas reales.

bool guarda true o false. Como el botón 1 es activo en LOW, el booleano
botonPulsado es verdadero cuando la lectura es LOW. if / else if / else
comprueba ramas de arriba abajo y ejecuta solo la primera verdadera, por eso la
condición manual debe ir primero. const char* estado guarda una etiqueta de
texto breve para Serial; no necesitas modificar esa sintaxis.

Vas a copiar un programa inicial, probarlo y ajustarlo. El resultado final debe ser
un controlador pequeño pero completo: lee POT_1, decide con UMBRAL, permite
modo manual con BOTON_1, cambia el RGB y escribe por Serial qué estado eligió.

#include <Arduino.h>

const int POT_1 = PC0;
const int BOTON_1 = PC5;  // Activo en LOW
const int RGB_ROJO = PA8;
const int RGB_VERDE = PA9;
const int RGB_AZUL = PA10;

const int UMBRAL = 600;

void setRgb(int rojo, int verde, int azul) {
  analogWrite(RGB_ROJO, rojo);
  analogWrite(RGB_VERDE, verde);
  analogWrite(RGB_AZUL, azul);
}

void setup() {
  pinMode(BOTON_1, INPUT);
  pinMode(RGB_ROJO, OUTPUT);
  pinMode(RGB_VERDE, OUTPUT);
  pinMode(RGB_AZUL, OUTPUT);
  Serial.begin(115200);
}

void loop() {
  int lectura = analogRead(POT_1);
  bool botonPulsado = digitalRead(BOTON_1) == LOW;
  const char* estado;

  if (TODO_CONDICION_MANUAL) { // TODO 1: verdadera solo si se solicita modo manual
    setRgb(0, 0, 255);
    estado = "manual";
  } else if (TODO_CONDICION_ALTA) { // TODO 2: lectura en el umbral o por encima
    setRgb(255, 0, 0);
    estado = "rojo";
  } else {
    setRgb(0, 180, 0);
    estado = "verde";
  }

  Serial.print("estado=");
  Serial.print(estado);
  Serial.print(" pot1=");
  Serial.print(lectura);
  Serial.print(" boton=");
  if (botonPulsado) {
    Serial.println("pulsado");
  } else {
    Serial.println("suelto");
  }

  delay(100);
}

Usa seis filas. Las filas 1-3 documentan el programa inicial y deben completarse
antes del cambio. Las filas 4-6 repiten los mismos tres casos tras la
calibración y la mejora diagnóstica. Cada fila debe conectar entrada, decisión y evidencia de hardware real:

- Filas 1 y 4: B1 suelto, potenciómetro en la posición de calibración inferior.
- Filas 2 y 5: B1 suelto, potenciómetro en la posición de calibración superior.
- Filas 3 y 6: B1 mantenido en la posición de calibración superior.
- En Valores vistos por Serial, copia estado, pot1 y boton de forma
aproximada.
- En las filas mejoradas copia también el nuevo campo margen. Reproduce cada
posición con una diferencia máxima aproximada de 30 cuentas respecto a su lectura inicial.

Sustituye 600 en UMBRAL por tu punto medio redondeado. Después añade un
diagnóstico de Serial justo después del valor pot1: imprime margen= seguido
de lectura - UMBRAL. Un margen negativo significa que está por debajo del
límite calibrado; cero o positivo significa que está en él o por encima.

Guarda, compila, sube y vuelve a abrir Serial a 115200 baudios. Repite los mismos
tres casos de prueba y anota las filas mejoradas 4-6. El diagnóstico solo es útil
si el estado visible, estado y el signo de margen coinciden; el modo manual
debe seguir teniendo prioridad aunque el margen sea positivo.