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:
3V3entrega 3.3 V enR_SUPPLY;5Ventrega 5 V enR_SUPPLY;GNDyGNDbentregan 0 V. La placa siempre está alimentada (USB-C). Es una fuente para el resto del circuito.VBATes una entrada que la placa ignora: aquí siempre está alimentada desde el riel de 3.3 V.NRSTes 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,PBnyPCn(y en la NucleoPD2) es un GPIO de entrada/salida. Salida (MODER= 01 o 10): push-pull a 3.3 V o 0 V a través deR_STRONG, o drenador abierto (OTYPERcon 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 paraPUPDR= 01 o una pull-down de 40 k paraPUPDR= 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.mdsección 1). PC13lleva el LED azul integrado, ánodo a 3.3 V a través de 470 R, cátodo al pin: el LED se enciende cuandoPC13se pone en bajo. Es una carga sobre el pin, y la vista la muestra desde un bit de sonda (sección 5).PA0también lleva el botónKEY, que ponePA0a tierra mientras se mantiene presionado. No hay pull-up externa: el firmware usa la interna. El botón se accede mediantepoke(sección 5), no a través de un pin.PA9/PA10son 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/PA12son USB D-/D+ en la placa real y GPIO normales aquí.PA13/PA14salen 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 reprogramaMODER.
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(setMSP, which the core has already done from vector 0; copy.datafrom its load address in flash, clear.bss, run the C++ static constructors, callmain), and a default handler that stops.link.ld: flash en0x0800_0000con 512 KB, SRAM en0x2000_0000con 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,PC13son constantes, yLED_BUILTINesPC13.
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:PC13a 1 Hz, activo en bajo,delay(500)estacionado enWFI.button: el botónKEYenPA0conINPUT_PULLUPenciendePC13.serial: imprimemillis()una vez por segundo y devuelve lo que recibe.fade:analogWriteenPA0haciendo respirar un LED, conPC13siguié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.
VBATis 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).