Haz parpadear una Blue Pill escribiendo tú mismo los registros
- 526componentes en el banco de trabajo
- 46placas funcionando ahora
- 1.00xtiempo real, en todas las placas
pinMode y digitalWrite esconden tres escrituras de registros. En un STM32 esas tres escrituras valen la pena aprenderlas, porque el día que pases del núcleo Arduino al HAL del fabricante o a metal desnudo, son lo que hace toda función de GPIO, y el error STM32 más común de todos vive en la primera.
El circuito de arriba es una STM32F103 Blue Pill con un LED y una resistencia de 1 k desde 3.3 V hasta PC13, el mismo pin del LED verde de la propia placa. El sketch lo hace parpadear sin pinMode ni digitalWrite, y antes de empezar imprime tres valores de registros. Presiona Ejecutar y el monitor serie muestra:
Las tres líneas son "CRH con el reloj del puerto C apagado: 0x0", luego "CRH después de IOPCEN, valor de reinicio: 0x44444444", y luego "CRH con PC13 como salida: 0x44244444". Después de eso ambos LED parpadean una vez por segundo.
Paso 1: enciende el reloj del puerto
Cada periférico en un STM32 empieza con su reloj apagado para ahorrar energía, y un periférico sin reloj no hace nada. El reloj del puerto C de GPIO es el bit 4 de RCC->APB2ENR, llamado IOPCEN. Hasta que se active, los registros del puerto leen cero e ignoran las escrituras.
El sketch lo demuestra. Escribe un valor en GPIOC->CRH antes de habilitar el reloj y lee de vuelta 0x0: la escritura no llegó a ningún lado. Después de RCC->APB2ENR |= RCC_APB2ENR_IOPCEN, el mismo registro lee 0x44444444, su valor de reinicio. En hardware real, olvidar esta línea produce un programa que compila, corre y no hace absolutamente nada, sin ningún error. Mokxi modela la compuerta igual, a propósito.
Paso 2: configura el pin en CRH
La F103 describe cada pin con cuatro bits: dos para MODE (entrada, o una salida a 10, 2 o 50 MHz) y dos para CNF (push-pull, drenador abierto o una función alternativa). Los pines 0 a 7 viven en CRL y los pines 8 a 15 en CRH. PC13 es el sexto nibble de CRH, los bits 20 a 23.
El valor de reinicio 0x4 en cada nibble significa CNF 01, MODE 00: una entrada flotante. El sketch limpia el nibble de PC13 y escribe 0x2, MODE 10 (salida, 2 MHz) y CNF 00 (push-pull), y por eso la tercera línea lee 0x44244444: un nibble cambió, los demás intactos. Las familias STM32 posteriores, como la F4, usan una distribución distinta (MODER, OTYPER, OSPEEDR), y eso es lo primero que se rompe cuando el código de una F1 se pasa a una F4.
const uint32_t PIN = 13;
const uint32_t CRH_SHIFT = (PIN - 8) * 4; // bits 20..23
const uint32_t OUT_2MHZ_PUSH_PULL = 0x2; // CNF 00, MODE 10
void setup() {
RCC->APB2ENR |= RCC_APB2ENR_IOPCEN; // 1. clock on
uint32_t crh = GPIOC->CRH;
crh &= ~(0xFUL << CRH_SHIFT);
crh |= OUT_2MHZ_PUSH_PULL << CRH_SHIFT;
GPIOC->CRH = crh; // 2. PC13 an output
}
void loop() {
GPIOC->BSRR = 1UL << (PIN + 16); // 3. reset: low, LED on
delay(500);
GPIOC->BSRR = 1UL << PIN; // set: high, LED off
delay(500);
}Abrir este sketch en el editorSolo el código: el editor coloca la placa y los componentes que puede leer del sketch.
Paso 3: BSRR, y por qué no ODR
You could change the pin by reading ODR, the output register, flipping bit 13 and writing it back. BSRR is better. Writing a 1 to one of its low 16 bits sets that pin; writing a 1 to one of its high 16 bits resets it; zeros change nothing. It is a single write with no read first, so if an interrupt changes another pin on port C between your read and your write, BSRR cannot undo that change, and a read-modify-write of ODR can.
El LED en PC13 está conectado de 3.3 V al pin, así que el pin absorbe su corriente y el LED se enciende cuando el pin está en bajo. Eso es lo contrario del pin 13 de un Uno, y la razón por la que el sketch pone el pin en bajo para encender el LED.
Por qué la resistencia es de 1 k, y dónde entra HAL
PC13, PC14 y PC15 son especiales en el F103. Reciben alimentación a través del interruptor de energía del dominio de respaldo, y la hoja de datos de ST los limita a absorber unos 3 mA, a no más de 2 MHz, y dice que no deben usarse como fuente de corriente, por ejemplo para encender un LED desde el pin hacia tierra. El LED de la Blue Pill está conectado al revés, de 3.3 V hacia el pin, a través de una resistencia de 1 k: (3.3 - 2) / 1000 da unos 1.3 mA. Una resistencia de 220 ohms ahí pediría unos 6 mA, así que este circuito usa 1 k para mantenerse dentro del límite. Para un LED más brillante en una placa real, elige un pin común como PA5 y una resistencia de 330 ohms.
La biblioteca HAL de ST hace los mismos tres pasos con funciones con nombre: __HAL_RCC_GPIOC_CLK_ENABLE(), HAL_GPIO_Init() con un GPIO_InitTypeDef, y HAL_GPIO_WritePin() o HAL_GPIO_TogglePin(), que por dentro escribe en BSRR. Mokxi no ejecuta los binarios de HAL, porque empiezan configurando el árbol de reloj y los tiempos de espera de la flash, que no están modelados; la Blue Pill de aquí corre a 72 MHz fijos. Los registros de arriba son exactamente lo que terminan escribiendo esas llamadas de HAL.
Una advertencia del mundo real: muchas placas que se venden como Blue Pill traen un clon del STM32F103 en lugar del chip de ST. Normalmente corren bien código simple de GPIO como este, pero pueden diferir en el tamaño de la flash y en el soporte del depurador, así que revisa la marca del chip si una placa se comporta de forma rara.
Abre este circuito en el editor. Blue Pill: parpadeo por registro, conectada como se ejecuta arriba en esta página. Cambia un componente o un valor y ejecútalo de nuevo.
Preguntas
¿Por qué mi código GPIO del STM32 no hace nada?
La causa más común, por mucho, es dejar apagado el reloj del puerto en RCC. En la familia F1 los relojes de GPIO están en RCC->APB2ENR; en la F4 están en RCC->AHB1ENR. Con el reloj apagado, las escrituras se ignoran y las lecturas devuelven cero.
¿El LED de la Blue Pill es activo en bajo?
Sí. Está conectado de 3.3 V a través de una resistencia a PC13, así que se enciende cuando PC13 se pone en bajo.
¿Cuál es la diferencia entre BSRR y BRR?
BSRR puede poner pines en alto (mitad baja) y en bajo (mitad alta) en una sola escritura. BRR solo puede ponerlos en bajo. Ambos dejan intactos todos los pines que no nombraste.
¿Puedo usar las funciones de Arduino y los registros en el mismo sketch?
Sí. Este sketch sigue usando Serial y delay() del entorno. Solo evita que ambos toquen la configuración del mismo pin, o el último que escriba en CRH gana.
Á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.