Referencia

Contrato de la placa STM32F411 "Black Pill" (Fase 4)

La Black Pill y la Nucleo-F411RE sobre nuestro núcleo Cortex-M4, con GPIO, el ADC, TIM1 a TIM5, dos USART y SysTick.

Esta es la referencia de ingeniería del modelo: qué implementa, registro por registro, para quienes escriben firmware sobre él. Para usar la placa en el editor, empieza por La STM32F411 Black Pill y la página de la placa.

El tercer microcontrolador, y la primera placa Cortex-M. Un componente del kernel (stm32f411 en crates/parts) envuelve un modelo del SoC STM32F411CEU6 (crates/stm32f411) construido sobre el núcleo ARMv7-M (crates/cortexm-core, probado en proofs/cortexm/REPORT.md). El firmware es un ELF ARM Thumb normal que se comunica con los periféricos de abajo en sus direcciones reales de STM32F411, tomadas de RM0383 (el manual de referencia STM32F411xC/E) y DS10314 (la hoja de datos), de modo que un programa compilado para Mokxi también corre en una Black Pill WeAct real.

El tipo de catálogo es stm32f411 (WeAct MiniF4 "Black Pill" v3.x, STM32F411CEU6). Una segunda placa, nucleof411re (la Nucleo-F411RE de ST, el mismo dado que el STM32F411RET6), es el mismo modelo de SoC con una configuración de placa propia: su reloj, su USART del host, sus pines y su compilación del entorno de ejecución. La sección 8 es esa placa; todo lo demás aquí aplica a ambas salvo que se diga lo contrario. Tres agentes compilan contra este archivo: el SoC y el componente (Rust), el entorno de ejecución del firmware y los ejemplos (C/C++, clang), la imagen de la placa (TypeScript). Cámbialo solo editando primero este archivo. Todo lo que dice docs/esp32c3.md sobre cómo se comporta un componente de placa (slices, canal del host, reinicio, línea de fallo) y todo lo que dice docs/uno.md sobre cómo se sitúa una placa en un circuito aplica aquí salvo que este archivo diga lo contrario.

Ejecutar binarios del fabricante (STM32Cube HAL, libopencm3, el núcleo STM32duino) no es un objetivo de la Fase 4. Esos necesitan el árbol de relojes levantado desde HSI, la latencia y el prefetch de flash, DMA y USB, nada de lo cual está modelado. Lo que sí es un objetivo es que cada registro que un programa bare-metal toque para parpadear un pin, imprimir por un UART, leer un botón y manejar una salida PWM esté en su dirección real con sus bits reales, de modo que el mismo código fuente compilado de forma cruzada contra headers CMSIS funcionaría en silicio.

1. Pines de la placa (orden del catálogo)

La placa tiene 2x20 pines con paso de 0.1 pulgadas más un header SWD de 4 pines a lo largo del borde inferior, USB-C arriba, en el orden del propio diagrama de pines de WeAct para las placas STM32F4x1 v2.0+. El orden del catálogo es el header izquierdo de arriba abajo, luego el header derecho de arriba abajo, luego el header SWD de izquierda a derecha.

Header izquierdo: PB12, PB13, PB14, PB15, PA8, PA9, PA10, PA11, PA12, PA15, PB3, PB4, PB5, PB6, PB7, PB8, PB9, 5V, GND, 3V3

Header derecho: 5Vb, GNDc, 3V3b, PB10, PB2, PB1, PB0, PA7, PA6, PA5, PA4, PA3, PA2, PA1, PA0, NRST, PC15, PC14, PC13, VBAT

Header SWD: 3V3c, PA13 (SWDIO), PA14 (SWCLK), GNDb

44 pines. PB11 está ausente: el STM32F411CEU6 es un componente de 48 pines y no lo expone, así que PB0..PB15 está "según esté poblado": quince pines, no dieciséis. Los rieles aparecen más de una vez (tres de 3.3 V, dos de 5 V, tres tierras) y llevan una letra porque los nombres de pines del catálogo son únicos. Los pines SWD no se insertan en una protoboard donde la placa esté montada (plug: false en web/src/parts/stm32f411.ts).

Until late October 2026 the drawing had the board end for end (VBAT at the USB end) with the SWD header folded into the VBAT row as PA13, PA14 and GNDb, and no second 5 V or 3.3 V pins. A diagram saved then is read with the part's header setting at early and keeps that drawing (web/src/parts/header-layout.ts); the model does not read the setting. The silkscreen prints the short forms (VB, C13, R, A0, B9, G); the catalog uses the full port names because a netlist pin reference has to be unambiguous.

Eléctrica:

  • 3V3 entrega 3.3 V en R_SUPPLY; 5V entrega 5 V en R_SUPPLY; GND y GNDb entregan 0 V. La placa siempre está alimentada (USB-C). Es una fuente para el resto del circuito. VBAT es una entrada que la placa ignora: aquí siempre está alimentada desde el riel de 3.3 V.
  • NRST es una entrada con una pull-up interna de 40 k hacia 3.3 V (RM0383 indica de 30 k a 50 k); si se lleva por debajo de 1.65 V mantiene la CPU en reinicio; soltarla reinicia el programa desde el vector de reinicio.
  • Cada PAn, PBn y PCn (y en la Nucleo PD2) es un GPIO de entrada/salida. Salida (MODER = 01 o 10): push-pull a 3.3 V o 0 V a través de R_STRONG, o drenador abierto (OTYPER con el bit activado), donde un alto es alta impedancia. Entrada o analógico (MODER = 00 o 11): alta impedancia, más una pull-up de 40 k a 3.3 V para PUPDR = 01 o una pull-down de 40 k para PUPDR = 10. La entrada lee el voltaje de la red contra 1.65 V (la mitad de 3.3 V); Unknown lee 0, y una entrada flotante lee ruido, como en la Uno (docs/uno.md sección 1).
  • PC13 lleva el LED azul integrado, ánodo a 3.3 V a través de 470 R, cátodo al pin: el LED se enciende cuando PC13 se pone en bajo. Es una carga sobre el pin, y la vista la muestra desde un bit de sonda (sección 5).
  • PA0 también lleva el botón KEY, que pone PA0 a tierra mientras se mantiene presionado. No hay pull-up externa: el firmware usa la interna. El botón se accede mediante poke (sección 5), no a través de un pin.
  • PA9/PA10 son USART1 TX/RX en la placa real y aquí; los bytes de la USART van al canal del host (sección 4), y los dos pines siguen siendo GPIO en la red, así que un osciloscopio en ellos muestra lo que el bloque GPIO esté haciendo. PA11/PA12 son USB D-/D+ en la placa real y GPIO normales aquí.
  • PA13/PA14 salen del reset en modo de función alternativa para SWD, exactamente como lo hace el componente, lo que significa que están en alta impedancia hasta que el firmware reprograma MODER.

2. Mapa de memoria (direcciones reales del STM32F411CE)

región dirección tamaño notas
flash 0x0800_0000 512 KB la flash del STM32F411CE; las escrituras se ignoran (no hay interfaz de programación de flash)
alias de flash 0x0000_0000 512 KB los mismos bytes, porque BOOT0 está en bajo y el área de arranque mapea la flash principal a 0
SRAM 0x2000_0000 128 KB
APB1 0x4000_0000 32 KB TIM2..TIM5 y USART2, sección 3
APB2 0x4001_0000 32 KB TIM1, USART1, ADC1, SYSCFG, EXTI, TIM10, sección 3
AHB1 0x4002_0000 64 KB GPIOA..GPIOD y RCC, sección 3
SCS 0xE000_E000 4 KB SysTick, NVIC y el SCB, respondidos dentro de cortexm-core y nunca visibles en el bus

Cualquier otra cosa es una falla de acceso: el núcleo toma un BusFault, que con el SHCSR de reset escala a HardFault. Los registros sin mapear dentro de un bloque de periférico mapeado leen 0 e ignoran escrituras, con un contador para diagnóstico.

ELF del firmware: loadProgram acepta un ejecutable ARM ELF32 little-endian (e_machine 40). Cada segmento PT_LOAD debe caer dentro de la flash (por cualquiera de las dos vistas) o de la SRAM. El reset es el arquitectónico, no un salto al punto de entrada: MSP viene de la palabra en la base de la tabla de vectores y PC de la segunda palabra, con el bit bajo en cero, así que una imagen de firmware es una tabla de vectores real y no un punto de entrada suelto. VTOR se restablece a 0, que es el alias de flash. Una carga en tiempo de ejecución reinicia la placa.

El núcleo es Profile::V7M con Cpu::set_priority_bits(4); la familia STM32F4 implementa los cuatro bits superiores de cada campo de prioridad de 8 bits, así que NVIC_IPR se comporta como espera un NVIC_SetPriority de CMSIS. No hay FPU: CPACR se guarda y nunca se aplica, y cada instrucción VFP y DSP genera UNDEFINSTR. Compila el firmware con -mfloat-abi=soft.

3. Registros de periféricos (subconjunto, offsets reales, posiciones de bits reales)

Los registros son de 32 bits y alineados a palabra. El acceso por byte y media palabra funciona y alcanza la palabra contenedora, que es lo que hacen los puentes AHB/APB para los registros modelados aquí.

3.1 RCC (0x4002_3800)

El árbol de relojes se modela a partir de los registros, con una concesión a las imágenes que Mokxi incluye: hasta que el firmware toca la configuración del reloj el componente corre al reloj de arranque de su placa (SYSCLK = HCLK = 84 MHz en la Black Pill, 100 MHz en la Nucleo, APB1 a la mitad), porque el runtime de Arduino nunca programa el PLL. La primera escritura a RCC_CR o RCC_PLLCFGR, o una escritura de RCC_CFGR que cambie SW, entrega el reloj a los registros: desde entonces SYSCLK es el HSI (16 MHz), el HSE (cristal de 25 MHz en la Black Pill, el de 8 MHz del ST-LINK en la Nucleo) o el PLL (src / PLLM * PLLN / PLLP) según lo que diga SWS, HCLK es SYSCLK / HPRE, PCLK1 y PCLK2 son HCLK / PPRE1 y PPRE2, y los relojes de los temporizadores son PCLK (prescalador 1) o 2 x PCLK, o con DCKCFGR.TIMPRE HCLK hasta un divisor de 4. El núcleo, SysTick, los temporizadores, las velocidades de transmisión de la USART, el reloj del ADC y la conversión de ciclos a tiempo siguen todo esto, incluso cuando el reloj cambia a mitad de la ejecución. HCLK se redondea a MHz enteros para la conversión de tiempo. Un reset devuelve el reloj de arranque. La latencia de flash se sigue guardando e ignorando.

offset nombre comportamiento
0x00 RCC_CR stored; HSIRDY (1), HSERDY (17) and PLLRDY (25) read back set whenever their ON bit is set, so a spin on "ready" terminates immediately (oscillators and the PLL start at once)
0x04 RCC_PLLCFGR guardado, se lee de vuelta; reset 0x2400_3010
0x08 RCC_CFGR guardado; SWS[3:2] sigue a SW[1:0] de inmediato cuando la fuente que SW indica está activada en RCC_CR, y se queda quieta en caso contrario. HPRE, PPRE1, PPRE2 fijan los relojes de bus como arriba
0x0C RCC_CIR se guarda, se lee de vuelta
0x10 0x20 0x24 RCC_AHB1RSTR RCC_APB1RSTR RCC_APB2RSTR un 1 escrito en el bit de un periférico restablece los registros de ese periférico; el registro en sí lee 0
0x30 RCC_AHB1ENR bit 0 GPIOAEN, 1 GPIOBEN, 2 GPIOCEN, 3 GPIODEN, 4 GPIOEEN, 7 GPIOHEN, 12 CRCEN, 21 DMA1EN, 22 DMA2EN
0x34 RCC_AHB2ENR se guarda, se lee de vuelta
0x40 RCC_APB1ENR bit 0 TIM2EN, 1 TIM3EN, 2 TIM4EN, 3 TIM5EN, 11 WWDGEN, 14 SPI2EN, 15 SPI3EN, 17 USART2EN, 21 I2C1EN, 22 I2C2EN, 23 I2C3EN, 28 PWREN
0x44 RCC_APB2ENR bit 0 TIM1EN, 4 USART1EN, 5 USART6EN, 8 ADC1EN, 11 SDIOEN, 12 SPI1EN, 13 SPI4EN, 14 SYSCFGEN, 16 TIM9EN, 17 TIM10EN, 18 TIM11EN
0x50 0x54 0x60 0x64 los cuatro registros LPENR se guarda, se lee de vuelta
0x70 RCC_BDCR guardado; LSERDY (1) sigue a LSEON (0)
0x74 RCC_CSR guardado; LSIRDY (1) sigue a LSION (0); PINRSTF (26) activado tras un reset de NRST, PORRSTF (27) y BORRSTF (25) tras el encendido; una escritura con RMVF (24) limpia las banderas

Un bit de habilitación de reloj es una compuerta real: un periférico cuyo bit de habilitación está en cero lee 0 e ignora escrituras, y un contador de accesos fuera de lugar registra el acceso. Ese es el error bare-metal más común en el STM32 y ocultarlo lo haría invisible aquí.

3.2 GPIOA, GPIOB, GPIOC, GPIOD (0x4002_0000, 0x4002_0400, 0x4002_0800, 0x4002_0C00)

Port D is on the die in both packages; the 48-pin F411CE bonds out none of it and the 64-pin F411RE only PD2. Its reset values are all zero. The clock enable is RCC_AHB1ENR bit 3, GPIODEN.

offset nombre bits
0x00 MODER 2 bits per pin: 00 input, 01 output, 10 alternate function, 11 analog
0x04 OTYPER 1 bit per pin: 0 push-pull, 1 open-drain
0x08 OSPEEDR 2 bits per pin; stored, read back, no effect on edge timing
0x0C PUPDR 2 bits per pin: 00 none, 01 pull-up, 10 pull-down
0x10 IDR solo lectura, bits 0..15: los niveles de los pines
0x14 ODR bits 0..15: el latch de salida
0x18 BSRR solo escritura: los bits 0..15 activan el bit correspondiente de ODR, los bits 16..31 lo desactivan; un reset gana sobre una activación en la misma escritura. Lee 0
0x1C LCKR guardado, se lee de vuelta; la secuencia de bloqueo no se aplica
0x20 0x24 AFRL AFRH 4 bits por pin, pines 0..7 y 8..15

Los valores de reset son los propios del componente, lo que importa porque son los que dejan tranquilos a los pines SWD: GPIOA_MODER = 0xA800_0000, GPIOA_OSPEEDR = 0x0C00_0000, GPIOA_PUPDR = 0x6400_0000; GPIOB_MODER = 0x0000_0280, GPIOB_OSPEEDR = 0x0000_00C0, GPIOB_PUPDR = 0x0000_0100; todo lo demás 0.

IDR devuelve lo que este chip está colocando en un pin que maneja, y lo que la placa muestreó de la red en un pin que no maneja, exactamente como hace PINx en el Uno.

Función alternativa: con MODER = 10 el pad es manejado por el periférico que AFRL/AFRH seleccione para ese pin, del subconjunto de las secciones 3.3 y 3.4. Una selección de función alternativa que este modelo no implementa deja el pad en alta impedancia y cuenta como corriente perdida. Los mapeos modelados (tabla 9 de DS10314):

AF pines
AF1 TIM2 PA0 CH1, PA1 CH2, PA2 CH3, PA3 CH4, PA5 CH1, PA15 CH1, PB3 CH2, PB10 CH3
AF1 TIM1 PA8 CH1, PA9 CH2, PA10 CH3, PA11 CH4; complementarios PA7, PB13 CH1N, PB0, PB14 CH2N, PB1, PB15 CH3N
AF2 TIM3 PA6 CH1, PA7 CH2, PB0 CH3, PB1 CH4, PB4 CH1, PB5 CH2, PC6 CH1, PC7 CH2, PC8 CH3, PC9 CH4
AF3 TIM10 PB8 CH1
AF2 TIM4 PB6 CH1, PB7 CH2, PB8 CH3, PB9 CH4
AF2 TIM5 PA0 CH1, PA1 CH2, PA2 CH3, PA3 CH4
AF7 USART1 PA9 TX, PA10 RX, PB6 TX, PB7 RX
AF7 USART2 PA2 TX, PA3 RX

3.3 TIM2, TIM3, TIM4, TIM5 (0x4000_0000, 0x4000_0400, 0x4000_0800, 0x4000_0C00)

TIM2 y TIM5 tienen CNT, ARR y CCRx de 32 bits; TIM3 y TIM4 son de 16 bits. Los cuatro corren a 84 MHz (sección 5).

offset nombre bits
0x00 CR1 CEN 0, UDIS 1, URS 2, OPM 3, DIR 4, CMS 5..6, ARPE 7, CKD 8..9
0x04 CR2 se guarda, se lee de vuelta
0x08 SMCR se guardan y se leen; los modos esclavo y disparo no están modelados
0x0C DIER UIE 0, CC1IE 1, CC2IE 2, CC3IE 3, CC4IE 4, TIE 6; las habilitaciones de DMA se guardan
0x10 SR UIF 0, CC1IF 1..CC4IF 4, TIF 6, CC1OF 9..CC4OF 12. Escribe 0 en un bit para limpiarlo, 1 lo deja (rc_w0, como dice el manual)
0x14 EGR solo escritura: UG 0 recarga el preescalador y el contador y activa UIF, CC1G 1..CC4G 4 activan las banderas de captura/comparación, TG 6 activa TIF
0x18 CCMR1 modo de salida: CC1S 0..1, OC1FE 2, OC1PE 3, OC1M 4..6, OC1CE 7, CC2S 8..9, OC2FE 10, OC2PE 11, OC2M 12..14, OC2CE 15
0x1C CCMR2 lo mismo para los canales 3 y 4
0x20 CCER CC1E 0, CC1P 1, CC2E 4, CC2P 5, CC3E 8, CC3P 9, CC4E 12, CC4P 13
0x24 CNT
0x28 PSC 16 bits; el contador avanza a 84 MHz / (PSC + 1)
0x2C ARR valor de recarga; el período es ARR + 1 ticks contando hacia arriba
0x34 0x38 0x3C 0x40 CCR1 CCR2 CCR3 CCR4
0x48 0x4C DCR DMAR se guarda, se lee de vuelta
0x50 TIM2_OR / TIM5_OR se guarda, se lee de vuelta

Conteo: hacia arriba (DIR = 0), hacia abajo (DIR = 1) y alineado al centro (CMS != 0) están todos modelados, cada uno con el evento de actualización donde el manual lo pone. ARPE almacena en búfer ARR y OCxPE almacena en búfer CCRx hasta el evento de actualización, que es lo que hace que un cambio de ciclo útil sea sin fallas.

Modos de comparación de salida (OCxM): 0 congelado, 1 activo al coincidir, 2 inactivo al coincidir, 3 alternar, 4 forzar inactivo, 5 forzar activo, 6 modo PWM 1 (activo mientras CNT < CCRx contando hacia arriba), 7 modo PWM 2 (el inverso). CCxP invierte la polaridad de salida. El pin solo se mueve mientras CCxE está activo y el pad está en modo de función alternativa con ese temporizador seleccionado (sección 3.2).

La captura de entrada no está modelada: CCxS != 0 guarda el valor y cuenta como corriente perdida.

Líneas NVIC: TIM2 = 28, TIM3 = 29, TIM4 = 30, TIM5 = 50. Cada una se activa mientras cualquiera de sus banderas de SR esté puesta con la habilitación correspondiente de DIER, mantenida como nivel. El manejador limpia la bandera, como en el silicio.

3.3a TIM1 (0x4001_0000) y TIM10 (0x4001_4400)

TIM1 is the advanced-control timer: the registers of section 3.3, 16 bits wide, plus RCR (0x30, stored; the repetition counter is not acted on) and BDTR (0x44). BDTR.MOE (bit 15) gates every TIM1 output: with it clear none of them drives a pin. CCER adds CCxNE (bit 4n+2) and CCxNP (bit 4n+3) for channels 1 to 3: the complementary output alone is the channel's reference level with CCxNP as its polarity, and with CCxE on as well it is the reference's complement (RM0383 table 56 with no dead time; dead time and the break input are stored and not modeled). Clock enable RCC_APB2ENR bit 0.

TIM10 es un temporizador de 16 bits con un canal, modelado con los registros de la sección 3.3; los que le faltan en el silicio se leen como guardados. Habilitación de reloj RCC_APB2ENR bit 17.

Ambos cuentan con el reloj de temporizadores de APB2, que es HCLK en ambas placas. Líneas NVIC: TIM1_UP_TIM10 = 25 (la actualización de TIM1, o cualquier interrupción de TIM10), TIM1_TRG_COM_TIM11 = 26 (el disparo de TIM1), TIM1_CC = 27 (las banderas de comparación de TIM1).

3.4 USART1 (0x4001_1000) y USART2 (0x4000_4400)

offset nombre bits
0x00 SR PE 0, FE 1, NE 2, ORE 3, IDLE 4, RXNE 5, TC 6, TXE 7, LBD 8, CTS 9. RXNE, TC y LBD/CTS se limpian escribiendo 0; TC y ORE también se limpian con la secuencia de leer SR y luego leer DR, como dice el manual
0x04 DR escribir: transmitir; leer: el byte recibido y limpiar RXNE
0x08 BRR DIV_Fraction 0..3, DIV_Mantissa 4..15; baudios = f_PCLK / (8 x (2 - OVER8) x USARTDIV)
0x0C CR1 SBK 0, RWU 1, RE 2, TE 3, IDLEIE 4, RXNEIE 5, TCIE 6, TXEIE 7, PEIE 8, PS 9, PCE 10, WAKE 11, M 12, UE 13, OVER8 15
0x10 CR2 se guarda, se lee de vuelta; STOP 12..13 se guarda y se asume 8N1 para el ritmo
0x14 CR3 se guarda, se lee de vuelta
0x18 GTPR se guarda, se lee de vuelta

f_PCLK es HCLK para USART1 (APB2) y HCLK / 2 para USART2 (APB1), sección 5: 84 y 42 MHz en la Black Pill, 100 y 50 MHz en la Nucleo.

USART1 es el canal del host en la Black Pill; en la Nucleo es USART2, que esa placa conecta al puerto COM virtual del ST-LINK, y USART1 es el puerto cuyos bytes no llegan a ninguna parte. La transmisión es el propio búfer único del componente más el registro de corrimiento: una escritura en DR con TXE puesto limpia TXE, el registro de corrimiento toma el byte y TXE vuelve de inmediato, y el byte llega al host un tiempo de trama después (10 tiempos de bit a los baudios configurados), cuando TC se pone. Recepción: los bytes del host se acumulan en una FIFO del tamaño del registro de recepción real de un byte más una reserva de 256 bytes del lado del host para que el texto tecleado no se pierda; RXNE se pone mientras espera un byte; leer DR lo saca, y un byte que llega con RXNE ya puesto activa ORE.

El otro USART es un segundo, idéntico, cuyos bytes transmitidos no van a ninguna parte (se cuentan, así una prueba puede verlos) y cuyo receptor nunca tiene nada que leer. Existe para que el firmware escrito para dos puertos enlace y funcione.

Líneas del NVIC: USART1 = 37, USART2 = 38. Cada una se activa mientras se mantengan RXNE & RXNEIE, TXE & TXEIE, TC & TCIE o IDLE & IDLEIE. Son condiciones, no banderas de flanco, así que entrar al manejador no borra nada. Un manejador de TXE sin nada más que enviar debe desactivarse solo, como en el chip.

3.5 SYSCFG (0x4001_3800) y EXTI (0x4001_3C00)

offset nombre bits
SYSCFG 0x00 MEMRMP se guarda, se lee de vuelta; el remap de arranque está fijo en la flash principal
SYSCFG 0x04 PMC se guarda, se lee de vuelta
SYSCFG 0x08..0x14 EXTICR1..EXTICR4 4 bits por línea: 0 = puerto A, 1 = puerto B, 2 = puerto C, 3 = puerto D. La línea n vigila el pin n del puerto seleccionado
SYSCFG 0x20 CMPCR se lee 0
EXTI 0x00 IMR máscara de interrupción, un bit por línea 0..15 (las líneas 16..22 se guardan y nunca se disparan)
EXTI 0x04 EMR máscara de evento; se guarda, y una línea enmascarada despierta el núcleo de WFE
EXTI 0x08 RTSR selección de disparo por flanco de subida
EXTI 0x0C FTSR selección de disparo por flanco de bajada
EXTI 0x10 SWIER writing 1 sets the matching PR bit
EXTI 0x14 PR pendiente; escribir 1 para borrar

NVIC lines: EXTI0 = 6, EXTI1 = 7, EXTI2 = 8, EXTI3 = 9, EXTI4 = 10, EXTI9_5 = 23, EXTI15_10 = 40. A line asserts its NVIC input while its PR bit is set and its IMR bit is set; the handler clears PR, as on silicon.

3.6 SysTick y el NVIC

Both are inside cortexm-core at the architectural addresses in the System Control Space and never reach the bus (proofs/cortexm/REPORT.md section 5). SYST_CALIB is programmed to 10500 with SKEW and NOREF clear: the board's external reference is HCLK/8 = 10.5 MHz, so a 10 ms tick is 105,000 of them, which does not fit 24 bits: the part's own answer, and the reason CMSIS SysTick_Config uses the processor clock. With CLKSOURCE clear the model still counts processor cycles; the /8 divider is not modeled and is called out here rather than hidden.

stm32f411.h también tiene las ortografías de CMSIS, para código escrito contra los headers de ST: los nombres SysTick_CTRL_*_Msk y _Pos, SysTick_LOAD_RELOAD_Msk y SysTick_VAL_CURRENT_Msk, SystemCoreClock (84,000,000, una variable como en CMSIS) y un SystemCoreClockUpdate() vacío. El millis() del runtime corre sobre SysTick, así que un sketch que lo reprograma cambia millis() y delay().

3.6a ADC1 (0x4001_2000, registros comunes en 0x4001_2300)

Un grupo regular, iniciado por SWSTART (bit 30 de CR2) mientras ADON está activado, en modo único o continuo, con SCAN recorriendo la secuencia y dejando el último resultado en DR, que es lo que hace un componente sin DMA. En esta familia no existe el arranque de "escribir ADON dos veces". SR: EOC (1) se activa cuando termina una conversión y se borra al leer DR; STRT (4) se activa cuando inicia una; ambos son rc_w0. CR1.RES (bits 24..25) elige 12, 10, 8 o 6 bits; CR2.ALIGN alinea a la izquierda; CR1.EOCIE genera la interrupción en la línea 18 del NVIC (ADC). ADC_CCR.ADCPRE (bits 16..17) divide PCLK2 entre 2, 4, 6 u 8 para el reloj del ADC, y una conversión toma el tiempo de muestreo del canal según SMPRx (3, 15, 28, 56, 84, 112, 144 o 480 ciclos de ADC) más un ciclo por bit (RM0383 11.5): EOC no llega ni antes ni después.

Channels 0..7 are PA0..PA7, 8 and 9 PB0 and PB1, 10..15 PC0..PC5 (DS10314 table 8). The board hands each one the voltage on its net as a twelve-bit count against 3.3 V; a floating pin reads noise. Channel 17 (VREFINT, 1.21 V, count 1502) and 18 (the temperature sensor at 25 C, 0.76 V, count 943) read their nominal values while ADC_CCR.TSVREFE (bit 23) is set, and 0 otherwise. Not modeled: the injected group, the analog watchdog, external triggers, DMA and the overrun flag. Clock enable RCC_APB2ENR bit 8.

3.7 Lo que no está modelado

El árbol de relojes y la latencia de flash, DMA, USB, I2C, SPI, SDIO, el RTC, los watchdogs, TIM9 y TIM11, la unidad CRC, los modos de bajo consumo del controlador de energía, los bytes de opción y la programación de flash. Sus registros no están mapeados (fallo de acceso), salvo donde un bloque aparece arriba, donde un offset no implementado lee 0, ignora las escrituras y cuenta un evento perdido. WFI y WFE estacionan el núcleo; SLEEPDEEP se guarda y se comporta como sueño normal.

4. Canal del host

host = "utf-8 bytes on USART1" ("utf-8 bytes on USART2" en la Nucleo). readHost devuelve los bytes TX del USART del host conforme terminan de salir por el cable; writeHost mete bytes en su cola de recepción (el desbordamiento descarta y pone ORE, como en el chip). El monitor serie muestra los bytes como texto, decodificando UTF-8 y tratando \n como fin de línea (\r se ignora).

5. Modelo de tiempo y el componente

84 MHz en la Black Pill, un ciclo por 1/84 us (100 MHz en la Nucleo, un ciclo por exactamente 10 ns, y una rodaja de 1000 ciclos; el resto de esta sección da los números de la Black Pill). Los conteos de ciclos vienen del núcleo (Cpu::run devuelve ciclos; el contador de ciclos del núcleo es el reloj). Un ciclo no es un número entero de picosegundos, así que el tiempo se deriva como ps = cycles * 1_000_000 / 84, exacto, nunca acumulado, siempre recalculado a partir del conteo de ciclos, así que nunca puede desviarse. Una rodaja de 10 us es exactamente 840 ciclos, y 840 ciclos son exactamente 10,000,000 ps, así que los límites de rodaja son exactos.

Relojes al arrancar (la sección 3.1 dice cómo los cambia el firmware; cada número de aquí sigue luego a HCLK):

dominio Black Pill Nucleo
SYSCLK, HCLK, CPU 84 MHz 100 MHz
reloj de periféricos APB1 (USART2) 42 MHz 50 MHz
reloj de temporizadores APB1 (TIM2..TIM5) 84 MHz 100 MHz
APB2 (USART1, ADC1) y sus temporizadores (TIM1, TIM10) 84 MHz 100 MHz

Dentro de una rodaja el núcleo avanza de modo que cada escritura a un periférico lleva el ciclo de CPU en que ocurrió: un cambio de pad se convierte en un drive_after con ese desfase desde el inicio de la rodaja, así que dos escrituras de BSRR separadas por cuatro ciclos de verdad están a 48 ns de distancia en la red. Los temporizadores avanzan analíticamente. El próximo evento de cada temporizador (una coincidencia de comparación, una actualización, un desbordamiento) se calcula a partir de su conteo, prescaler, ARR y modo, el núcleo se ejecuta hasta ese ciclo, se aplica el evento y la ejecución continúa, así que un flanco de PWM cae en el ciclo exacto y no al final de una rodaja. Las lecturas de IDR ven los niveles de los pines según el inicio de la rodaja más cualquier cambio que el propio programa haya hecho en la rodaja.

WFI (and WFE with the event register clear) parks the core: the part stops slicing and schedules one wake at the earliest of the SysTick reload, the next timer event that can raise an enabled interrupt, and the next USART event; a pin change or a host byte wakes it immediately. This is the whole idle story. proofs/cortexm/REPORT.md measures the core at 1.02x of a real STM32F411 in Chromium and says plainly that there is no headroom, so a sketch that busy-waits through a delay() will not hold real time. delay() in the runtime therefore parks on WFI and is woken by SysTick, and an idle board costs the kernel a handful of events a simulated second instead of 84 million cycles.

Sonda: bit 0 = en ejecución (1 mientras ejecuta, 0 en reset o detenido), bit 1 = dormido (estacionado en WFI/WFE), bit 2 = el LED integrado (PC13 en nivel bajo), bit 3 = actividad de TX en los últimos 20 ms, bit 4 = actividad de RX en los últimos 20 ms. Así que probe es una pequeña máscara de bits, 0 sin programa.

Poke: 0 = soltar KEY, 1 = presionar KEY (conecta PA0 a tierra mientras se mantiene), 2 = mantener NRST, 3 = soltar NRST.

Manejo de fallos como en la sección 5 de docs/esp32c3.md: el núcleo reporta un Trap, y el componente se detiene e imprime una línea en el canal del anfitrión, por ejemplo firmware crashed at pc=0x08000412, HardFault (CFSR 0x00000100). Un bloqueo, una instrucción indefinida, un BKPT y una tabla de vectores sin mapear llegan todos como traps. El componente entonces deja de pedir despertares.

6. Runtime del firmware (firmware/stm32/)

Un runtime de C y C++ independiente para el STM32F411 compilado con clang 18 (--target=thumbv7em-none-eabi -mfloat-abi=soft -mcpu=cortex-m4 -Os) y lld, sin newlib, sin CMSIS, sin HAL, nada de GPL:

  • crt0.S: the 16 system vectors plus the 85 IRQ vectors at the head of flash, _start (set MSP, which the core has already done from vector 0; copy .data from its load address in flash, clear .bss, run the C++ static constructors, call main), and a default handler that stops.
  • link.ld: flash en 0x0800_0000 con 512 KB, SRAM en 0x2000_0000 con 128 KB, pila desde la parte alta de la SRAM, con un assert de que los datos estáticos dejan espacio para ella.
  • stm32f411.h: cada registro de la sección 3 como una macro volatile con el nombre real de ST (GPIOC->ODR, RCC->AHB1ENR, TIM3->CCR1, USART1->DR), más las constantes de bits y los números de IRQ.
  • arduino.h: la misma interfaz de sketch que el runtime del Uno, con los pines de este componente: pinMode, digitalWrite, digitalRead, analogWrite, delay, delayMicroseconds, millis, micros, Serial, attachInterrupt, shiftOut, map, random. Los números de pin son los nombres de puerto: PA0, PB9, PC13 son constantes, y LED_BUILTIN es PC13.

millis() viene de SysTick a 1 kHz (recarga 83,999). micros() viene de TIM2, un contador libre de 32 bits a 1 MHz (PSC = 83, ARR = 0xFFFFFFFF), así que tiene resolución de 1 us y se desborda cada 71.6 minutos. delay() estaciona el núcleo en WFI hasta que el conteo de SysTick llegue al límite; delayMicroseconds() espera en bucle sobre TIM2.

analogWrite(pin, 0..255) genera PWM a 1 kHz, como lo hace STM32duino (PWM_FREQUENCY 1000: PSC = 1, un pulso de 42 MHz, y ARR = 41,999, que es 84 MHz / 2 / 42,000), con CCRx = 42,000 x valor / 255, el escalado del setCaptureCompare del núcleo, en doce pines:

temporizador canal 1 canal 2 canal 3 canal 4
TIM5 PA0 PA1 PA2 PA3
TIM3 PA6 PA7 PB0 PB1
TIM4 PB6 PB7 PB8 PB9

0 y 255 no son PWM: desconectan la salida de comparación y llevan el pin a nivel bajo o alto, así que analogWrite(pin, 0) realmente está apagado. Un digitalWrite en un pin PWM recupera el pin, como lo hace el núcleo de Arduino.

analogRead(pin) convierte en el ADC1 (sección 3.6a) como lo hace STM32duino: el pin a modo analógico, ADCPRE PCLK2 / 4, 15 ciclos de muestreo, SWSTART y una espera en EOC, y el resultado en diez bits por defecto (ADC_RESOLUTION 10). analogReadResolution(bits) elige la resolución más cercana del convertidor (6, 8, 10 o 12) y mapea a los bits pedidos con el mapResolution del núcleo. Un número menor que la cantidad de entradas analógicas de la placa es una entrada analógica (analogRead(0) es A0), como en STM32duino; en la Black Pill A0 a A9 son PA0 a PA7, PB0 y PB1.

Serial es USART1 en PA9/PA10, 8N1, recepción por interrupción a un búfer circular de 64 bytes, transmisión a través de un búfer circular de 64 bytes vaciado por la interrupción TXE, como lo hace el HardwareSerial de STM32duino (SERIAL_TX_BUFFER_SIZE 64): un print que cabe regresa de inmediato y los bytes salen a la velocidad de baudios, uno más largo espera espacio, y availableForWrite() es el espacio restante (63 cuando está vacío). attachInterrupt(pin, fn, mode) usa SYSCFG y EXTI: un manejador por línea, CHANGE, RISING y FALLING.

Ejemplos en firmware/stm32/examples/<name>/sketch.ino, compilados a web/public/firmware/stm32/<name>.elf con web/public/firmware/stm32/index.json con la misma forma que el índice del Uno, cada entrada con "program": "elf32 arm stm32f411":

  • blink: PC13 a 1 Hz, activo en bajo, delay(500) estacionado en WFI.
  • button: el botón KEY en PA0 con INPUT_PULLUP enciende PC13.
  • serial: imprime millis() una vez por segundo y devuelve lo que recibe.
  • fade: analogWrite en PA0 haciendo respirar un LED, con PC13 siguiéndolo.

La interfaz elige la lista de firmware según la cadena program del catálogo del componente (docs/sim-api.md sección 3): "elf32 riscv32imc" lee /firmware/index.json, "elf32 avr atmega328p" lee /firmware/uno/index.json, "elf32 arm stm32f411" lee /firmware/stm32/index.json, y "elf32 arm stm32f411 nucleo" lee /firmware/nucleof411re/index.json.

7. Lo que este modelo sabe con certeza, y lo que no

Tres grupos, con el mismo orden que usa la sección 7 de docs/esp32c6.md. Existe porque un modelo de placa que adivina silenciosamente una dirección es peor que uno que dice que no lo sabía.

Tomado del manual de referencia y probado con firmware real. Cada dirección base, desplazamiento de registro y posición de bit de las secciones 2 y 3 proviene del manual de referencia del STM32F4 (RM0383) y de la hoja de datos del STM32F411CE: RCC en 0x4002_3800, GPIOA/B/C en 0x4002_0000/0400/0800, TIM2 a TIM5 en 0x4000_0000/0400/0800/0C00, USART1 en 0x4001_1000 y USART2 en 0x4000_4400, SYSCFG en 0x4001_3800 y EXTI en 0x4001_3C00, SysTick y el NVIC en sus direcciones de ARM, 128 KB de SRAM en 0x2000_0000 y 512 KB de flash en 0x0800_0000; GPIOD en 0x4002_0C00, TIM1 en 0x4001_0000, ADC1 en 0x4001_2000 y TIM10 en 0x4001_4400 con los campos de bit y los tiempos del ADC del capítulo 11 de RM0383. crates/stm32f411/tests/firmware.rs y tests/nucleo.rs cargan ELFs reales y manejan a través de ellos el GPIO, los temporizadores, ambos USART, el ADC, SysTick y EXTI. El orden de los headers de la WeAct Black Pill y su LED en PC13 son propios de la placa.

Modelado, pero sin apegarse a los números del manual de referencia. Comportamientos en lugar de direcciones:

  • El reloj de arranque es la velocidad completa de la placa (84 MHz, o 100 en la Nucleo). Una placa real que nunca configura el PLL corre a 16 MHz desde el HSI; aquí un programa que nunca toca los registros de reloj corre al reloj de la placa, que es lo que supone el runtime de Arduino de Mokxi. Una vez que el programa escribe los registros de reloj, se sigue el PLL, los osciladores y los preescaladores (sección 3.1); la latencia del flash no.
  • El intervalo tiene dos velocidades, y la primera escritura tras un periodo de calma llega antes. El núcleo corre en lotes gruesos hasta que una escritura cae en un registro de GPIO, temporizador o USART, y entonces avanza de una instrucción a la vez por un rato. Todo lo que está dentro de una ráfaga es exacto; la primera escritura de una ráfaga se sitúa al inicio del lote en que ocurrió, con hasta 6.1 us de adelanto.
  • Los pads son tres estados y un umbral. Push-pull a 3.3 V, drenaje abierto, alta impedancia, o una resistencia interna de 40 kΩ (la hoja de datos da de 30 kΩ a 50 kΩ), leídos contra la mitad del suministro, sin histéresis, sin ajuste de velocidad, sin tiempo de subida y sin límite de corriente. El LED integrado es un LED detrás de 470 Ω en PC13, con el ánodo al riel, así que un nivel bajo lo enciende.
  • The board is an ideal supply: 3V3 and 5V at rail impedance for ever, so nothing browns out and the regulator is not there. VBAT is a pin and no more. Startup is a microsecond, with no option bytes and no boot pins.

Ausente a propósito, como lista la sección 3.7: el árbol de reloj y la latencia del flash, el DMA, el USB (así que el puerto USB de la placa no transporta nada; Serial llega al monitor por el canal del host y PA11/PA12 se quedan como GPIO normal), I2C, SPI, I2S, SDIO, el RTC, los watchdogs, TIM9 y TIM11, CRC, la FPU y sus registros, y la programación del flash. La ausencia de la FPU cuesta tiempo, no resultados: el runtime está construido para el ABI de soft-float, así que un float se calcula por software y da el mismo resultado, en más ciclos de los que la FPU del chip tardaría.

8. La Nucleo-F411RE (nucleof411re)

La NUCLEO-F411RE de ST (MB1136, UM1724): la STM32F411RET6, el mismo dado en el paquete de 64 pines, sobre una placa con ST-LINK. El componente es el mismo adaptador que la Black Pill (crates/parts/src/parts/stm32f411.rs) con la configuración de placa stm32f411::NUCLEO_F411RE; el runtime es firmware/stm32/ construido con -DMOKXI_BOARD_NUCLEO_F411RE (firmware/nucleof411re/build.sh). Catálogo: program = "elf32 arm stm32f411 nucleo", que lee /firmware/nucleof411re/index.json; host = "utf-8 bytes on USART2".

Reloj. 100 MHz, el reloj que programa la variante NUCLEO_F411RE de STM32duino (HSE en bypass desde los 8 MHz del ST-LINK, PLLM 4, PLLN 100, PLLP 2; APB1 / 2, APB2 / 1), así que un ciclo dura exactamente 10 ns y un intervalo de 10 us son 1000 ciclos. El núcleo le cuesta al host lo mismo por ciclo que en la Black Pill, y hay 19 % más ciclos por segundo, así que un sketch que espera en bucle necesita 19 % más de la máquina para mantener el tiempo real; uno que duerme en delay() no cuesta nada en ningún caso.

Pines (orden del catálogo): los headers Arduino CN6 IOREF, NRST, 3V3, 5V, GND, GNDb, VIN; CN8 A0..A5; CN5 D15, D14, AVDD, GNDc, D13..D8; CN9 D7..D2; luego los pines que solo sacan los headers morpho, CN7 PC10, PC11, PC12, PD2, VDD, E5V, BOOT0, GNDd, PA13, PA14, PA15, PB7, PC13, VBAT, PC2, PC3 y CN10 PC9, PC8, PC6, PC5, U5V, GNDe, PA12, PA11, PB12, PB2, PB1, PB15, PB14, PB13, AGND, PC4, PA2, PA3 (63 pines). Un pad que está en un header Arduino y en un header morpho es un solo pin, con su nombre Arduino:

Arduino D2 D3 D4 D5 D6 D7 D8 D9 D10 D11 D12 D13 D14 D15 A0 A1 A2 A3 A4 A5
pad PA10 PB3 PB5 PB4 PB10 PA8 PA9 PC7 PB6 PA7 PA6 PA5 PB9 PB8 PA0 PA1 PA4 PB0 PC1 PC0

Se omiten porque la placa tal como viene no los conecta (UM1724 6.8, 6.12): D0/D1 (SB62/SB63 abiertos; PA3/PA2 van al ST-LINK y están en el header morpho), PC14/PC15 (el cristal LSE) y PH0/PH1 (el MCO del ST-LINK). VIN, E5V y BOOT0 son entradas que la placa ignora; IOREF, VDD, AVDD y VBAT (unido a VDD en esta placa) están a 3.3 V; U5V está a 5 V.

Sobre la placa. LD2, verde, desde PA5 a través de 510 ohmios a tierra: está encendida mientras el pin entrega un nivel alto, y solo mientras es una salida (bit 2 de la sonda). B1, el botón azul de USER, pone PC13 a tierra (tocar con 1 lo mantiene presionado, 0 lo suelta), y R30, 4.7 k de PC13 a 3.3 V, está siempre en el pin, así que una entrada lee un nivel alto cuando está suelto. B2 es NRST (tocar con 2, 3). Los bits de la sonda son los de la Black Pill; los bits 3 y 4 son el COM del LD1 del ST-LINK.

Tiempo de ejecución. Numeración NUCLEO_F411RE de STM32duino: 0..15 son D0..D15, 16..51 siguen el orden morpho de la variante, PIN_A0..PIN_A15 = 192..207 son sus entradas analógicas, y cada nombre de puerto se define como uno de esos números (PA5 es PIN_A15, que es el pin digital 13), así que 13, D13, PA5 y LED_BUILTIN son el mismo pin. USER_BTN es PC13. Serial es USART2 en PA2/PA3 (SERIAL_UART_INSTANCE 2), también llamado Serial2; no existe Serial1. analogWrite usa el primer temporizador que el PinMap_TIM de la variante lista para cada pin, a 1 kHz (PSC 1, ARR 49,999): TIM2 en PA0..PA3, PA5, PA15, PB3, PB10; TIM3 en PA6, PB4, PB5, PC6..PC9; TIM4 en PB6..PB9; TIM1 en PA8..PA11 y, como CH1N..CH3N, PA7, PB0, PB1, PB13..PB15. Así que micros() corre aquí en TIM5, y tone() en TIM10, el TIMER_TONE de la variante. Wire usa por defecto D14/D15, SPI usa D13, D12, D11, D10. Ejemplos en firmware/nucleof411re/examples/: blink, button, serial, fade (D9) y analog (A0).