Placas

La STM32F411 Black Pill

Un Cortex-M4 a 84 MHz con GPIO, temporizadores, un ADC, USART1 y SysTick.

La descripción general, con ejemplos en ejecución, está en la página de la placa y El modelo de la STM32F411 (todos los registros).

Qué es

The WeAct MiniF4 "Black Pill", an STM32F411CEU6 running on our own Cortex-M core in its ARMv7-M profile with Thumb-2. The registers come from the manufacturer's reference manual and datasheet at their real addresses, so the same source cross-compiled against the vendor headers would work on silicon.

El reloj es fijo: 84 MHz para la CPU, el bus y los temporizadores, y 42 MHz en el bus de periféricos más lento. El mismo chip en la placa Nucleo de ST corre a 100 MHz: la Nucleo-F411RE.

Los pines

Two twenty-pin headers on a 0.1 inch pitch and a four-pin SWD header across the bottom edge, in the order of WeAct's own pinout diagram, with USB-C at the top.

Header izquierdo, de arriba abajo: PB12, PB13, PB14, PB15, PA8 a PA12, PA15, PB3 a PB9, luego 5V, G y 3V3.

Header derecho, de arriba abajo: 5V, G, 3V3, PB10, PB2, PB1, PB0, PA7 hasta PA0, R (NRST), PC15, PC14, PC13, y VB (VBAT) en el extremo más alejado del conector USB.

Header SWD, de izquierda a derecha: 3V3, DIO (PA13), SCK (PA14), G. Una placa insertada en una protoboard no conecta estos pines, ya que el header real apunta hacia arriba o no está instalado; conecta cables a ellos directamente.

Los rieles extra tienen sus propios nombres en el diagrama, porque cada nombre de pin es único: los de la fila derecha son 5Vb, GNDc y 3V3b, y los del header SWD son 3V3c y GNDb. Todos son los mismos rieles.

A project saved before Mokxi drew the real order (late October 2026) has this board end for end, with VBAT beside the USB socket and PA13, PA14 and a ground folded into the left row. It opens that way, with its header setting on early, so a board in a breadboard keeps every pin in the hole it was in. Set header to board for the real order: wires to pins follow them, but a board sitting in a breadboard then reaches different holes.

PB11 no está, porque la versión de 48 pines no lo expone. Así que el puerto B tiene quince pines, no dieciséis.

Un pin aquí es un puerto y un número, no un número de placa: PA5, no 5. Eso sorprende a quien viene de un Arduino, y la ruta de aprendizaje lo destaca desde el principio.

El LED está al revés

PC13 lleva el LED azul integrado con su ánodo a 3.3 V a través de 470 ohmios y su cátodo en el pin. Se enciende cuando PC13 se pone en bajo. La primera lección de la placa se llama "El LED que se enciende cuando el pin está en bajo" por esa razón.

What is modeled

GPIO, TIM1 a TIM5 y TIM10 en sus modos de conteo y PWM, ADC1, USART1 y SysTick, más lo suficiente de RCC para responder a las lecturas de registros que hace un programa durante el arranque.

analogRead lee los diez pines del ADC, PA0 a PA7, PB0 y PB1 (A0 a A9), con los diez bits de STM32duino de forma predeterminada (0 a 1023 sobre 0 a 3.3 V); analogReadResolution(12) da los doce bits completos del convertidor.

Todo periférico en una STM32 real arranca con su reloj apagado, y aquí también es así: habilitar el reloj antes de tocar un periférico es parte del ejercicio, no una formalidad que este modelo se salte.

Lo que no está

El árbol de reloj y la latencia de flash, DMA, USB, I2C, SPI, SDIO, el RTC, los watchdog, TIM9 y TIM11, la unidad de CRC, los modos de bajo consumo, los bytes de opción y la programación de flash. Sus registros no están mapeados, así que tocar uno provoca un bus fault. El FPU tampoco está modelado: los flotantes se calculan por software, así que dan el mismo resultado y tardan más ciclos que en el chip.

Que el árbol de reloj no esté modelado también corta al revés. El núcleo corre a 84 MHz sin importar lo que se programe en RCC, así que un sketch que olvide iniciar el PLL lleva bien el tiempo aquí y corre cinco veces más lento en una placa real. Los pines 3V3 y 5V son fuentes ideales que no pueden caer.

La captura de entrada no está modelada. WFI y WFE dejan el núcleo en espera; el sueño profundo se comporta como el sueño normal.

Las pilas del fabricante (el Cube HAL, libopencm3, el núcleo de STM32duino) quedan fuera del alcance por la misma razón que el Pico SDK: inicializan hardware que no está aquí.

Las tablas de registros están en el modelo de la STM32F411.

Serie

USART1 lleva el monitor serie. El detalle completo, incluido qué pasa cuando la cola de recepción se desborda, está en el documento de contrato.

Bibliotecas estándar de Arduino

Un tutorial que incluya Servo.h, Wire.h, SPI.h, EEPROM.h, LiquidCrystal_I2C.h, Adafruit_GFX.h con Adafruit_SSD1306.h y DHT.h se compila aquí tal cual. Cada uno es un header propio de Mokxi con el nombre original, escrito sobre los controladores de los componentes de la caja, y nada de eso es código de la biblioteca original.

  • Wire.begin() pone el bus I2C en PB7 (SDA) y PB6 (SCL).
  • EEPROM.h funciona, pero el modelo de esta placa no tiene EEPROM ni flash escribible, así que los bytes viven en 4 KB de RAM: se leen dentro de una ejecución y desaparecen al reiniciar.
  • Adafruit_NeoPixel.h stops with a message: a WS2812 bit is too short to make by hand on this board. The AVR boards, the ESP32s, the Pico and the Uno R4 drive the strip.

El editor de código y la compilación enumera lo que cubre cada una y en qué difiere de la biblioteca original.

Los ejemplos

Blink, Button, Serial, Fade y Chaser.

Ensamblador

El panel Firmware también ofrece Ensamblador (sin Arduino): un Blink, un botón a LED, un saludo por UART y una interrupción de temporizador en ensamblador ARM Thumb-2 para la Cortex-M4. Los archivos de la placa se convierten en un main.S, y no se enlaza nada más que ese archivo, así que lleva su propia tabla de vectores: .word _estack, luego Reset_Handler, luego sus manejadores. Los proyectos de ejemplo encienden los relojes en RCC_AHB1ENR, manejan PC13, leen PA0, imprimen por USART1 en PA9 a 115200 y ejecutan SysTick a 1 kHz desde el núcleo de 84 MHz. Un .S junto a un sketch común también funciona. Consulta Escribir en ensamblador.

En otras partes