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 STM32 Blue Pill y la página de la placa.
El quinto microcontrolador y la segunda placa Cortex-M. Un componente del kernel (bluepill en crates/parts) envuelve un modelo del SoC STM32F103C8T6 (crates/stm32f103) construido sobre el mismo núcleo ARMv7-M que la Black Pill (crates/cortexm-core, comprobado 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 del STM32F103, tomadas de RM0008 (el manual de referencia del STM32F101/102/103/105/107) y la hoja de datos del STM32F103x8/xB, de modo que un programa compilado para Mokxi también corre en una Blue Pill real.
El tipo del catálogo es bluepill (STM32F103C8T6, LQFP de 48 pines, la placa que todos llaman la Blue Pill). Todo lo que dice docs/esp32c3.md sobre cómo se comporta un componente de placa (slices, canal del host, reset, línea de fallas) y todo lo que dice docs/uno.md sobre cómo se coloca una placa en un circuito aplica aquí, salvo que este archivo diga lo contrario.
Por qué esto no es la Black Pill con números distintos
docs/stm32f411.md es el documento hermano de este, y la tentación es leer uno como el otro. No lo hagas. La F1 es una generación distinta de la familia y las diferencias son exactamente las que un programa puede ver:
| F411 (Black Pill) | F103 (Blue Pill) | |
|---|---|---|
| núcleo | Cortex-M4, sin FPU | Cortex-M3 |
| clock | 84 MHz | 72 MHz |
| flash / SRAM | 512 KB / 128 KB | 64 KB / 20 KB |
| configuración de pines | MODER, OTYPER, PUPDR, AFRL/AFRH |
un campo de cuatro bits en CRL/CRH |
| dirección de la pull de entrada | PUPDR |
el bit ODR de ese pin |
| poner un pin en cero | mitad alta de BSRR |
mitad alta de BSRR, o BRR |
| compuerta de reloj del GPIO | RCC_AHB1ENR |
RCC_APB2ENR |
| función alternativa | un número por pin en AFR |
fijo por periférico, remapeado en AFIO_MAPR |
| selección de puerto del EXTI | SYSCFG_EXTICR |
AFIO_EXTICR |
| base del RCC | 0x4002_3800 |
0x4002_1000 |
| temporizadores | TIM2 y TIM5 son de 32 bits | cada contador es de 16 bits |
| ADC | no se modela | ADC1, conversión única |
| pines de depuración al reiniciar | PA13, PA14, PA15, PB4 con pull | los mismos cinco, liberados por SWJ_CFG |
Ni una sola dirección está compartida. Los dos crates del SoC son hermanos, no una plantilla y una copia.
Ejecutar binarios del fabricante (STM32Cube HAL, libopencm3, el núcleo STM32duino) no es un objetivo. Esos necesitan que el árbol de relojes se levante desde HSI, la latencia y el prefetch de la 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 toca para parpadear un pin, imprimir por un UART, leer un botón, leer un voltaje 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 los headers de CMSIS funcionaría en el silicio.
1. Pines de la placa (orden del catálogo)
The board is 2x20 pins on a 0.1 inch pitch, 53 x 23 mm, with the micro-USB socket at the top. Catalog order is the left header top to bottom, then the right header top to bottom.
Header izquierdo: VBAT, PC13, PC14, PC15, PA0, PA1, PA2, PA3, PA4, PA5, PA6, PA7, PB0, PB1, PB10, PB11, NRST, 3V3, GND, 5V
Header derecho: GNDb, GNDc, 3V3b, PB12, PB13, PB14, PB15, PA8, PA9, PA10, PA11, PA12, PA15, PB3, PB4, PB5, PB6, PB7, PB8, PB9
40 pines: 32 de E/S, tres tierras, dos de 3.3 V, uno de 5 V, VBAT y NRST. La serigrafía imprime las formas cortas (VB, C13, R, A0, B9, G, 3.3); el catálogo usa los nombres completos de puerto porque una referencia de pin en una netlist debe ser inequívoca, y agrega sufijos a las repeticiones (GNDb, GNDc, 3V3b) porque dos pines de un mismo componente no pueden compartir nombre.
Tres pines del chip no están en un header: PA13 y PA14 son el header SWD separado de cuatro pines en el borde inferior, y PB2 es el jumper BOOT1 en la parte superior. Existen en el modelo del chip (tienen que existir, porque el puerto de depuración los retiene), pero ningún cable puede alcanzarlos aquí, igual que en la placa.
Eléctrica:
3V3y3V3bentregan 3.3 V enR_SUPPLY;5Ventrega 5 V enR_SUPPLY;GND,GNDbyGNDcentregan 0 V. La placa siempre está alimentada (USB). Es una fuente para el resto del circuito.VBATes una entrada que la placa ignora: aquí siempre se alimenta desde el riel de 3.3 V.NRSTes una entrada con un pull-up interno de 40 k hacia 3.3 V (la hoja de datos da de 30 k a 50 k); si se lleva por debajo de 1.65 V mantiene la CPU en reset; soltarlo reinicia el programa desde el vector de reset.- Cada
PAn,PBnyPCnes un GPIO inout. Salida (MODE!= 00): push-pull a 3.3 V o 0 V a través deR_STRONG, o drenador abierto (CNF= 01 o 11) donde un alto es alta impedancia sin ningún pull, porque una salida F1 no tiene ninguno. Entrada (MODE= 00): alta impedancia para flotante (CNF= 01) y analógica (CNF= 00), o un pull de 40 k cuya dirección es el bitODRde ese pin paraCNF= 10. La entrada compara 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 el Uno (docs/uno.mdsección 1). PC13lleva el LED verde integrado, ánodo a 3.3 V a través de 1 k, cátodo al pin: el LED se enciende cuandoPC13se lleva a nivel bajo. Es una carga sobre el pin, y lo visual lo muestra desde un bit de sonda (sección 5). 1 k en lugar de los 470 R de la Black Pill, razón por la que el LED de una Blue Pill es el más tenue de las dos. La nota de la propia hoja de datos de ST aplica aquí también:PC13,PC14yPC15están en el dominio de respaldo de energía y solo pueden absorber 3 mA, así que manejan un indicador y no mucho más.- No hay botón de usuario. El único botón de la Blue Pill es
RESET, al que se llega mediantepoke(sección 5). Un sketch que necesite un botón requiere uno en la protoboard, razón por la que tantos tutoriales de Blue Pill empiezan conectando uno. PA9/PA10son USART1 TX/RX en la placa real y aquí; los bytes de la USART van al canal del host (sección 4).PA11/PA12son USB D-/D+ en la placa real y GPIO normal aquí.PA15,PB3yPB4están en el header, pero el puerto de depuración SWJ los retiene tras el reset:PA15yPB4con pull-up,PB3flotante. El firmware los recupera escribiendoSWJ_CFGenAFIO_MAPR(sección 3.5). Esta es la sorpresa más común en esta placa y el modelo la reproduce en lugar de ocultarla.
2. Mapa de memoria (direcciones reales del STM32F103C8)
| región | dirección | tamaño | notas |
|---|---|---|---|
| flash | 0x0800_0000 |
64 KB | la flash del STM32F103C8; las escrituras se ignoran (no hay interfaz de programación de flash) |
| alias de flash | 0x0000_0000 |
64 KB | los mismos bytes, porque BOOT0 está en bajo y el área de arranque mapea la flash principal a 0 |
| SRAM | 0x2000_0000 |
20 KB | |
| APB1 | 0x4000_0000 |
32 KB | TIM2..TIM4, USART2, USART3, sección 3 |
| APB2 | 0x4001_0000 |
32 KB | AFIO, EXTI, GPIOA..GPIOC, ADC1, TIM1, USART1, sección 3 |
| AHB | 0x4002_0000 |
RCC en 0x4002_1000, 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.
Muchas placas C8 realmente llevan 128 KB de flash, porque el dado es un CB con la mitad sin probar. 64 KB es lo que promete el número de parte, así que 64 KB es lo que da este modelo y en lo que el firmware puede confiar; el script de enlazado lo afirma.
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 STM32F1 implementa los cuatro bits superiores de cada campo de prioridad de 8 bits, como la F4, así que NVIC_IPR se comporta como espera un NVIC_SetPriority de CMSIS. Un Cortex-M3 es ARMv7-M sin la extensión DSP del M4 ni una FPU, que es exactamente lo que cortexm-core implementa y rechaza: toda codificación VFP y SIMD saturante lanza UNDEFINSTR. No hubo que desactivar ninguna función para esta parte; los extras del M4 nunca estuvieron ahí. Compila el firmware con -mcpu=cortex-m3 -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 halfword funciona y llega a la palabra contenedora, que es lo que hace el puente APB para los registros modelados aquí.
3.1 RCC (0x4002_1000)
El árbol de reloj se modela a partir de los registros, con una concesión a las imágenes que Mokxi trae de fábrica: hasta que el firmware toque la configuración del reloj el componente corre con el reloj de arranque, SYSCLK = HCLK = 72 MHz (el cristal HSE por nueve), APB1 a la mitad y el ADC a PCLK2 / 6, porque el runtime de Arduino nunca programa el PLL. La primera escritura a RCC_CR, o una escritura de RCC_CFGR que cambie SW, PLLSRC, PLLXTPRE o PLLMUL, entrega el reloj a los registros: a partir de entonces SYSCLK es el HSI (8 MHz), el HSE (8 MHz) o el PLL (HSI / 2, o HSE dividido a la mitad por PLLXTPRE, por PLLMUL + 2, como máximo 16) según lo que diga SWS, HCLK es SYSCLK / HPRE, PCLK1 y PCLK2 son HCLK / PPRE1 y PPRE2, los relojes de los temporizadores son PCLK (prescalador 1) o 2 x PCLK, y el reloj del ADC es PCLK2 / ADCPRE. El núcleo, el SysTick, los temporizadores, las velocidades de transmisión del USART, el ADC y la conversión de ciclos a tiempo lo siguen todo, 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 la flash se sigue guardando y se ignora.
| 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. Reset 0x0000_0083 |
0x04 |
RCC_CFGR |
guardado; SWS[3:2] sigue a SW[1:0] de inmediato cuando la fuente que SW indica está encendida en RCC_CR, y se queda quieto en caso contrario. HPRE, PPRE1, PPRE2, PLLMUL, PLLSRC, PLLXTPRE y ADCPRE fijan los relojes como se describe arriba |
0x08 |
RCC_CIR |
se guarda, se lee de vuelta |
0x0C |
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 |
0x10 |
RCC_APB1RSTR |
igual para los periféricos de APB1 |
0x14 |
RCC_AHBENR |
guardado, se lee de vuelta; reset 0x0000_0014 (SRAMEN, FLITFEN) |
0x18 |
RCC_APB2ENR |
bit 0 AFIOEN, 2 IOPAEN, 3 IOPBEN, 4 IOPCEN, 5 IOPDEN, 6 IOPEEN, 9 ADC1EN, 10 ADC2EN, 11 TIM1EN, 12 SPI1EN, 14 USART1EN |
0x1C |
RCC_APB1ENR |
bit 0 TIM2EN, 1 TIM3EN, 2 TIM4EN, 11 WWDGEN, 14 SPI2EN, 17 USART2EN, 18 USART3EN, 21 I2C1EN, 22 I2C2EN, 23 USBEN, 25 CANEN, 27 BKPEN, 28 PWREN |
0x20 |
RCC_BDCR |
guardado; LSERDY (1) sigue a LSEON (0) |
0x24 |
RCC_CSR |
stored; LSIRDY (1) follows LSION (0); PINRSTF (26) set after an NRST reset, PORRSTF (27) after power-on, SFTRSTF (28) after AIRCR.SYSRESETREQ; a write with RMVF (24) clears the flags. There is no BORRSTF: this family has no brown-out reset flag, and bit 25 is reserved |
El GPIO se habilita desde APB2ENR, no desde un registro del AHB. Esa sola línea es la diferencia entre un sketch de Blue Pill que funciona y uno donde cada escritura en un pin desaparece, y es donde un hábito de la F4 falla primero.
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 (0x4001_0800, 0x4001_0C00, 0x4001_1000)
| offset | nombre | bits |
|---|---|---|
0x00 |
CRL |
4 bits por pin, pines 0..7: MODE en 0..1, CNF en 2..3 |
0x04 |
CRH |
igual para los pines 8..15 |
0x08 |
IDR |
solo lectura, bits 0..15: los niveles de los pines |
0x0C |
ODR |
bits 0..15: el registro de salida, y la dirección de la resistencia pull-up/pull-down de una entrada con pull |
0x10 |
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 |
0x14 |
BRR |
write-only: bits 0..15 clear the matching ODR bit. The F4 has no such register |
0x18 |
LCKR |
guardado, se lee de vuelta; la secuencia de bloqueo no se aplica |
MODE: 00 entrada, 01 salida a 10 MHz, 10 salida a 2 MHz, 11 salida a 50 MHz. Las tres velocidades de salida se guardan y no tienen efecto en la temporización de los flancos aquí, lo cual se declara en vez de ocultarse.
CNF while MODE is 00: 00 analog, 01 floating, 10 pulled (y la dirección del pull es el bit de ODR de ese pin, 1 arriba y 0 abajo), 11 reservado.
CNF cuando MODE no es 00: 00 push-pull de propósito general, 01 drenador abierto de propósito general, 10 push-pull de función alternativa, 11 drenador abierto de función alternativa.
El valor de reset tanto de CRL como de CRH es 0x4444_4444: cada pin una entrada flotante. ODR se resetea a 0.
IDR devuelve lo que este chip está impulsando en un pin que impulsa en push-pull, y lo que la placa muestreó de la red en cualquier otro pin, exactamente como hace PINx en el Uno. Una salida en drenador abierto por lo tanto lee el pin y no el registro de salida, que es como funciona un bus de un cable.
El puerto de depuración SWJ retiene cinco pines tras el reset, sin importar lo que digan CRL/CRH (RM0008 9.3.5): PA13 (JTMS/SWDIO) con pull-up, PA14 (JTCK/SWCLK) con pull-down, PA15 (JTDI) con pull-up, PB3 (JTDO) flotante, PB4 (NJTRST) con pull-up. AFIO_MAPR.SWJ_CFG decide cuáles conserva: 000 los cinco, 001 todos menos PB4, 010 solo PA13/PA14 (SWD, la opción habitual), 100 ninguno. Un pin retenido por el puerto de depuración ignora por completo el bloque GPIO.
3.3 TIM1, TIM2, TIM3, TIM4 (0x4001_2C00, 0x4000_0000, 0x4000_0400, 0x4000_0800)
Todos los contadores de este componente son de 16 bits. Los cuatro reciben reloj a 72 MHz (sección 5). TIM1 es el temporizador avanzado; los otros tres son de propósito general.
| 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. Escribe 0 en un bit para limpiarlo, 1 lo deja igual (rc_w0, como dice el manual) |
0x14 |
EGR |
write-only: UG 0 reloads the prescaler, counter and repetition counter and sets UIF, CC1G 1..CC4G 4 set the capture/compare flags, TG 6 sets TIF |
0x18 |
CCMR1 |
modo de salida: CC1S 0..1, OC1FE 2, OC1PE 3, OC1M 4..6, OC1CE 7, y los mismos ocho bits de arriba para el canal 2 |
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 |
16 bits |
0x28 |
PSC |
16 bits; el contador avanza a 72 MHz / (PSC + 1) |
0x2C |
ARR |
valor de recarga; el período es ARR + 1 ticks contando hacia arriba |
0x30 |
RCR |
solo TIM1, 8 bits: el evento de actualización ocurre cada RCR + 1 desbordamientos. Reservado en los otros tres, y una escritura ahí cuenta como una escritura perdida |
0x34 0x38 0x3C 0x40 |
CCR1 CCR2 CCR3 CCR4 |
16 bits |
0x44 |
BDTR |
solo TIM1: solo se atiende MOE (15), y sin él los canales no llegan a ningún pin. El tiempo muerto, la entrada de break y las salidas complementarias se guardan y no se modelan |
0x48 0x4C |
DCR DMAR |
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.
Output compare modes (OCxM): 0 frozen, 1 active on match, 2 inactive on match,
3 toggle, 4 force inactive, 5 force active, 6 PWM mode 1 (active while
CNT < CCRx up-counting), 7 PWM mode 2 (the inverse). CCxP inverts the output
polarity. The pin only moves while CCxE is set (and, on TIM1, BDTR.MOE as
well) and the pad's CNF says alternate function (section 3.2), and
AFIO_MAPR has that channel on that pin (section 3.5).
La captura de entrada no está modelada: CCxS != 0 guarda el valor y cuenta como corriente perdida.
NVIC lines: TIM1 splits its flags across TIM1_UP = 25 (the update flag) and
TIM1_CC = 27 (the four compare flags and the trigger); TIM2 = 28, TIM3 = 29,
TIM4 = 30 each carry all of theirs. Each asserts while any of its SR flags is
set with the matching DIER enable, held as a level. The handler clears the
flag, as on silicon.
3.4 USART1 (0x4001_3800), USART2 (0x4000_4400), USART3 (0x4000_4800)
| 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 |
0x04 |
DR |
escribir: transmitir; leer: el byte recibido y limpiar RXNE |
0x08 |
BRR |
DIV_Fraction 0..3, DIV_Mantissa 4..15; baudios = f_PCLK / (16 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. El bit 15 está reservado: este componente no tiene OVER8, y el sobremuestreo siempre es por dieciséis |
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 72 MHz para USART1 (APB2) y 36 MHz para USART2 y USART3 (APB1), sección 5. Con 72 MHz y 115200 baudios, USARTDIV es exactamente 39.0625, así que BRR = 0x271 y la velocidad es exacta; esa es una razón por la que 72 MHz es el número que todos eligen para este componente.
USART1 es el canal del host. La transmisión usa el único búfer propio del componente más el registro de desplazamiento: una escritura en DR con TXE activado limpia TXE, el registro de desplazamiento toma el byte, TXE vuelve a activarse de inmediato, y el byte llega al host un tiempo de trama después (10 tiempos de bit a la velocidad de baudios configurada), cuando se activa TC. Recepción: los bytes del host se acumulan en un FIFO del tamaño del registro de recepción real de un byte más una cola de 256 bytes del lado del host para que no se pierda el texto tecleado; RXNE queda activado mientras espera un byte; leer DR lo saca de la cola, y un byte que llega con la cola llena activa ORE.
USART2 y USART3 son USART idénticos cuyos bytes transmitidos no van a ninguna parte (se cuentan, así que una prueba puede verlos) y cuyos receptores nunca tienen nada que leer. Existen para que el firmware escrito para más de un puerto enlace y funcione.
Líneas NVIC: USART1 = 37, USART2 = 38, USART3 = 39. Cada una se mantiene activa mientras se cumpla RXNE & RXNEIE, TXE & TXEIE, TC & TCIE o IDLE & IDLEIE. Son condiciones, no banderas de flanco, así que entrar al gestor no limpia nada. Un gestor de TXE sin nada más que enviar debe desactivarse a sí mismo, como en el chip.
3.5 AFIO (0x4001_0000) y EXTI (0x4001_0400)
| offset | nombre | bits |
|---|---|---|
AFIO 0x00 |
EVCR |
se guarda, se lee de vuelta |
AFIO 0x04 |
MAPR |
los remapeos siguientes, más SWJ_CFG en 24..26 |
AFIO 0x08..0x14 |
EXTICR1..EXTICR4 |
4 bits por línea: 0 = puerto A, 1 = puerto B, 2 = puerto C. La línea n observa el pin n del puerto seleccionado |
AFIO 0x1C |
MAPR2 |
se guarda, se lee de vuelta |
EXTI 0x00 |
IMR |
máscara de interrupciones, un bit por línea 0..15 (las líneas 16..18 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 |
No hay AFRL/AFRH en este componente: los pines de un periférico son fijos, y AFIO_MAPR mueve algunos de ellos en bloque. Los mapeos modelados:
Campo de MAPR |
valor | canal 1 / TX | 2 | 3 | 4 |
|---|---|---|---|---|---|
TIM1_REMAP 6..7 |
00, 01 |
PA8 |
PA9 |
PA10 |
PA11 |
11 |
puerto E, no modelado | ||||
TIM2_REMAP 8..9 |
00 |
PA0 |
PA1 |
PA2 |
PA3 |
01 |
PA15 |
PB3 |
PA2 |
PA3 |
|
10 |
PA0 |
PA1 |
PB10 |
PB11 |
|
11 |
PA15 |
PB3 |
PB10 |
PB11 |
|
TIM3_REMAP 10..11 |
00 |
PA6 |
PA7 |
PB0 |
PB1 |
10 |
PB4 |
PB5 |
PB0 |
PB1 |
|
11 |
PC6 |
PC7 |
PC8 |
PC9 |
|
TIM4_REMAP 12 |
0 |
PB6 |
PB7 |
PB8 |
PB9 |
1 |
puerto D, no modelado | ||||
USART1_REMAP 2 |
0 / 1 |
PA9 / PB6 TX |
|||
USART2_REMAP 3 |
0 |
PA2 TX (1 es puerto D, no modelado) |
|||
USART3_REMAP 4..5 |
00 / 01 |
PB10 / PC10 TX |
Un remapeo hacia un puerto que este modelo no tiene (D o E) deja los pines tal cual en lugar de inventarlos. Un pin puede ser función alternativa de dos periféricos (PA9 es USART1 TX y el canal 2 de TIM1), lo cual en silicio es un error de configuración; el modelo lo resuelve en un solo lugar, USART antes que el temporizador, de modo que cada pad tiene exactamente un dueño y ningún periférico puede quitarle un pin a otro a sus espaldas.
SWJ_CFG (24..26) es lo que libera los pines de depuración; consulta la sección 3.2.
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 ADC1 (0x4001_2400)
A twelve-bit successive-approximation converter, clocked at PCLK2 / 6 =
12 MHz (section 5), which is the only divider that keeps a 72 MHz APB2 inside
the part's 14 MHz limit. One ADC clock is six CPU cycles.
| offset | nombre | bits |
|---|---|---|
0x00 |
SR |
AWD 0, EOC 1, JEOC 2, JSTRT 3, STRT 4; escribe 0 para limpiar |
0x04 |
CR1 |
EOCIE 5, SCAN 8; el resto se guarda |
0x08 |
CR2 |
ADON 0, CONT 1, CAL 2, RSTCAL 3, ALIGN 11, EXTSEL 17..19, EXTTRIG 20, SWSTART 22 |
0x0C 0x10 |
SMPR1 SMPR2 |
3 bits por canal: 1.5, 7.5, 13.5, 28.5, 41.5, 55.5, 71.5, 239.5 ciclos de ADC. SMPR2 contiene los canales 0..9 |
0x14..0x20 |
JOFR1..JOFR4 |
se guarda, se lee de vuelta |
0x24 0x28 |
HTR LTR |
se guarda, se lee de vuelta; el watchdog analógico no está modelado |
0x2C |
SQR1 |
L 20..23, la longitud del grupo menos uno, y las conversiones 13..16 |
0x30 0x34 |
SQR2 SQR3 |
cinco bits por conversión; SQR3[4:0] es la primera |
0x38 |
JSQR |
se guarda, se lee de vuelta; el grupo inyectado no está modelado |
0x3C..0x48 |
JDR1..JDR4 |
lee 0 |
0x4C |
DR |
la última conversión regular completada; leerlo limpia EOC |
Una conversión toma tiempo de muestreo + 12.5 ciclos de ADC, y el resultado no se entrega antes de tiempo: el firmware de verdad espera a EOC. Con el muestreo predeterminado de 1.5 ciclos son 14 ciclos de ADC (84 ciclos de CPU, 1.17 us); con el de 55.5 que usa el runtime, 68 ciclos (408 ciclos, 5.7 us).
Iniciar una conversión: escribir ADON cuando ya está en 1 inicia una, que es el modismo propio del componente, y lo mismo hace SWSTART con EXTTRIG puesto y EXTSEL = 111. CONT reinicia al final de cada una. CAL y RSTCAL se aceptan y se leen en cero de inmediato (no hay nada que calibrar), y ninguno inicia una conversión, porque un convertidor calibrándose no convierte. ALIGN coloca los doce bits en DR[15:4].
SCAN recorre el grupo regular y deja el último resultado en DR, que es exactamente lo que hace un componente sin DMA, y la razón por la que SCAN sin DMA es una trampa.
Canales: 0..7 son PA0..PA7 y 8..9 son PB0..PB1. Los canales 10..15 están en pines del puerto C que un componente de 48 pines no tiene. El canal 16 es el sensor de temperatura, fijo en su lectura de 25 C de 1.43 V (1775 cuentas), y el canal 17 es VREFINT, fijo en 1.20 V (1489 cuentas). El componente de la placa convierte el voltaje de la red en cada pin analógico a una cuenta contra el riel de 3.3 V; una red en conflicto lee 0, y una flotante deambula, como lo hace en el Uno.
Línea NVIC: ADC1_2 = 18, activada mientras EOC & EOCIE se mantenga. ADC2 no está modelado.
3.7 SysTick y el NVIC
Ambos están dentro de cortexm-core en las direcciones arquitectónicas del System Control Space y nunca llegan al bus (proofs/cortexm/REPORT.md sección 5). SYST_CALIB es 90,000 con SKEW y NOREF en cero: la referencia externa es HCLK/8 = 9 MHz, así que un tick de 10 ms son exactamente 90,000 de ellos y el campo es exacto, a diferencia del de la Black Pill, donde no cabe. Con CLKSOURCE en cero el modelo sigue contando ciclos de procesador; el divisor /8 no está modelado y se señala aquí en lugar de ocultarse.
stm32f103.h también tiene las grafí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 (72,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(), como lo haría bajo el HAL de STM32duino.
3.8 Lo que no está modelado
El árbol de relojes y la latencia de flash, DMA, USB, CAN, I2C, SPI, el RTC y los registros de respaldo, los watchdogs, ADC2, el grupo inyectado y el watchdog analógico del ADC, la entrada de break y las salidas complementarias de TIM1, la captura de entrada, los modos de baja potencia 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 desplazamiento no implementado lee 0, ignora las escrituras y cuenta un acceso extraño. WFI y WFE dejan el núcleo en espera; SLEEPDEEP se guarda y se comporta como sueño normal.
4. Canal del host
host = "bytes UTF-8 por USART1". readHost devuelve los bytes TX de USART1 conforme terminan de salir por el cable; writeHost mete bytes en la cola de recepción de USART1 (el desbordamiento descarta y activa 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
72 MHz, un ciclo por cada 1/72 us. Los conteos de ciclos provienen 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 / 72, de forma exacta, nunca acumulada, siempre recalculada a partir del conteo de ciclos, por lo que nunca puede desviarse. Un segmento de 10 us es exactamente 720 ciclos, y 720 ciclos son exactamente 10,000,000 ps, así que los límites de los segmentos 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 | frecuencia |
|---|---|
| SYSCLK, HCLK, CPU | 72 MHz |
| Reloj de periféricos APB1 (USART2, USART3) | 36 MHz |
| Reloj de temporizadores APB1 (TIM2..TIM4) | 72 MHz |
| APB2 (USART1, TIM1, entrada del prescaler del ADC) | 72 MHz |
| ADC | 12 MHz |
Dentro de un segmento el núcleo se avanza de modo que cada escritura a un periférico lleva el ciclo de la CPU en que ocurrió: un cambio de pad se convierte en un drive_after en ese desplazamiento desde el inicio del segmento, así que dos escrituras en BSRR separadas por cuatro ciclos realmente están separadas 55 ns en la red. Los temporizadores se avanzan de forma analítica. El siguiente 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, de modo que un flanco de PWM cae en el ciclo exacto y no al final de un segmento. Las lecturas de IDR ven los niveles de los pines según el inicio del segmento más cualquier cambio que el propio programa haya hecho en el segmento.
WFI (y WFE con el registro de eventos en cero) estaciona el núcleo: el componente deja de segmentar y programa un solo despertar en el más temprano entre la recarga del SysTick, el siguiente evento de temporizador que pueda levantar una interrupción habilitada, el siguiente evento de USART y el fin de una conversión del ADC; un cambio de pin o un byte del host lo despierta de inmediato. Esta es toda la historia de inactividad. proofs/cortexm/REPORT.md mide el núcleo a aproximadamente tiempo real en Chromium y dice claramente que no hay margen, así que un sketch que espera activamente en un delay() no mantendrá el tiempo real. delay() en el runtime por lo tanto estaciona en WFI y lo despierta el SysTick, y una placa inactiva le cuesta al kernel un puñado de eventos por segundo simulado en lugar de 72 millones de ciclos.
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 = liberar RESET, 1 = mantener RESET. No hay un segundo botón que presionar en esta placa.
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 host, por ejemplo firmware crashed at pc=0x08000412, BKPT #0 (CFSR 0x00000000, HFSR 0x40000000). Un lockup, una instrucción indefinida, un BKPT y una tabla de vectores sin mapear llegan todos como trampas. El componente entonces deja de pedir despertares.
6. Runtime de firmware (firmware/bluepill/)
Un runtime de C y C++ independiente para el STM32F103 compilado con clang 18 (--target=thumbv7m-none-eabi -mcpu=cortex-m3 -mfloat-abi=soft -Os) y lld, sin newlib, sin CMSIS, sin HAL, nada de GPL:
crt0.S: the 16 system vectors plus the 60 IRQ vectors at the head of flash, reset entry (copy.datafrom its load address in flash, clear.bss, run the C++ static constructors, callmain; the core has already loadedMSPfrom vector 0), and a default handler that executesBKPTso a stray interrupt becomes one line on the serial monitor rather than a silent spin.link.ld: flash en0x0800_0000para 64 KB, SRAM en0x2000_0000para 20 KB, pila desde el tope de la SRAM, con un assert de que los datos estáticos dejan 2 KB para ella.stm32f103.h: cada registro de la sección 3 como macro volatile con el nombre real de ST (GPIOC->ODR,RCC->APB2ENR,TIM3->CCR1,USART1->DR,ADC1->SQR3), más las constantes de bits y los números de IRQ.arduino.h: la misma superficie de sketch que los runtimes del Uno y la Black Pill, sobre los pines de este componente:pinMode,digitalWrite,digitalRead,analogRead,analogWrite,delay,delayMicroseconds,millis,micros,Serial,attachInterrupt,shiftOut,map,random. Los números de pin son los nombres de los puertos:PA0,PB9yPC13son constantes, yLED_BUILTINesPC13. Hay unpinModeextra,INPUT_ANALOG, porque el conversor del F1 solo puede muestrear un pin cuyoCNFlo indique.
millis() viene de SysTick a 1 kHz (recarga 71,999). micros() viene de TIM2 a 1 MHz (PSC = 71, ARR = 0xFFFF) extendido a 32 bits por software: todos los contadores de este componente son de dieciséis bits, así que TIM2 se desborda cada 65.536 ms y su interrupción de actualización lleva la mitad alta. micros() lee las dos partes con una protección contra un desbordamiento que caiga entre ambas, e incorpora un desbordamiento cuyo manejador aún no se ha ejecutado, que es lo que implica noInterrupts() alrededor de una llamada a micros(). Quince interrupciones por segundo no son nada frente a las mil de SysTick. delay() deja el núcleo en WFI hasta que el conteo de SysTick alcanza el límite; delayMicroseconds() espera activamente sobre micros().
analogRead(pin) devuelve los doce bits propios del conversor, 0 a 0 V y 4095 a 3.3 V, no los diez que devuelve un Arduino: el ADC de este componente realmente es de doce bits y redondearlo hacia abajo para que parezca un AVR tiraría dos bits sin motivo. La primera llamada levanta ADC1, fija ADCPRE a /6 y ejecuta la secuencia de calibración de reinicio. Los diez pines son PA0..PA7, PB0 y PB1; cualquier otro devuelve 0.
analogWrite(pin, 0..255) genera PWM a 1 kHz, como lo hace STM32duino (PWM_FREQUENCY 1000: PSC = 1, un tick de 36 MHz, y ARR = 35,999, que es 72 MHz / 2 / 36,000), con CCRx = 36,000 x valor / 255, el escalado del setCaptureCompare del núcleo, en diez pines:
| temporizador | canal 1 | canal 2 | canal 3 | canal 4 |
|---|---|---|---|---|
| TIM3 | PA6 |
PA7 |
PB0 |
PB1 |
| TIM4 | PB6 |
PB7 |
PB8 |
PB9 |
| TIM1 | PA8 |
ninguno | ninguno | PA11 |
PA0..PA3 are not PWM pins here, unlike on the Black Pill: TIM2 is the
microsecond counter and it needs a whole timer to itself. TIM1's channels 2 and
3 are PA9 and PA10, which are Serial, so they are left out too. TIM1 needs
BDTR.MOE, which the runtime sets when it starts that timer.
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.
Serial es USART1 en PA9/PA10, 8N1, recepción por interrupción hacia un búfer circular de 64 bytes, transmisión mediante un búfer circular de 64 bytes que vacía 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 AFIO y EXTI: un manejador por línea, CHANGE, RISING y FALLING.
Ejemplos en firmware/bluepill/examples/<name>/sketch.ino, compilados a web/public/firmware/bluepill/<name>.elf con web/public/firmware/bluepill/index.json con la misma forma que el índice del Uno, cada entrada con "program": "elf32 arm stm32f103":
blink:PC13a 1 Hz, activo en bajo,delay(500)estacionado enWFI.button: un botón enPB0conINPUT_PULLUPenciendePC13.serial: imprimemillis()y unanalogRead(PA0)una vez por segundo, y repite lo que recibe.fade:analogWriteenPA6haciendo respirar un LED desde TIM3, conPC13acompañá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 arm stm32f411" lee /firmware/stm32/index.json y "elf32 arm stm32f103" lee /firmware/bluepill/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 verificado con firmware real. Cada dirección base, desplazamiento de registro y posición de bit en las secciones 2 y 3 proviene del manual de referencia del STM32F1 (RM0008) y de la hoja de datos del STM32F103C8: RCC en 0x4002_1000, GPIOA/B/C en 0x4001_0800/0C00/1000 con los nibbles de configuración de cuatro bits CRL/CRH propios del F1, TIM1 a TIM4, USART1 a USART3, AFIO en 0x4001_0000, EXTI en 0x4001_0400 y ADC1 en 0x4001_2400, con 20 KB de SRAM y 64 KB de flash. crates/stm32f103/tests/firmware.rs carga ELFs reales y a través de ellos maneja GPIO, los temporizadores, USART1, ADC1, SysTick y EXTI. El orden de los cuarenta pines del header de la Blue Pill, su LED en PC13 conectado del ánodo al riel, y el hecho de que PA15, PB3 y PB4 arranquen como pines JTAG 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 72 MHz. Una Blue Pill real que nunca configura el PLL corre a 8 MHz con el HSI; aquí un programa que nunca toca los registros de reloj corre a 72 MHz, que es lo que asume el runtime de Arduino de Mokxi. Una vez que un programa escribe los registros de reloj, se siguen el PLL, los osciladores y los preescaladores (sección 3.1); la latencia de flash no.
- El intervalo tiene dos engranajes, y la primera escritura tras un período de calma es temprana, hasta 7.1 us. Todo dentro de una ráfaga es exacto. El razonamiento es el mismo que en
docs/stm32f411.mdsección 7. - El ADC1 no tiene error. Una conversión es la recta contra
VREF+= 3.3 V, muestreada en el instante en que empezó, sin muestreo y retención, sin impedancia de entrada, sin no linealidad, sin ruido y sin el desfase que el ADC de un F103 real necesita calibrar (el bitCALdeADC_CR2se acepta y aquí no hace nada). - 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.
- La placa es una fuente de alimentación ideal: 3V3 y 5V a impedancia de riel para siempre, así que nada se apaga por caída de voltaje y el regulador (que en una Blue Pill clonada suele ser el componente equivocado y la razón de que la placa muera) no está. El arranque es un microsegundo, sin pines de arranque ni bytes de opción.
- No hay botón de usuario, porque la placa no lo tiene; el único botón mantiene
NRSTen bajo y llega a través depoke.
Ausentes a propósito, como enumera la sección 3.8: el árbol de reloj y la latencia de flash, el DMA, el USB (así que Serial llega al monitor por el canal del host y PA11/PA12 siguen siendo GPIO normales), CAN, I2C, SPI, el RTC y los registros de respaldo, los watchdogs, la entrada de break y las salidas complementarias de TIM1, el ADC2, el grupo inyectado y el watchdog analógico del ADC, y la programación de flash.
8. Cargar a una placa real
"Cargar a la placa" escribe un sketch en una Blue Pill real mediante el bootloader de memoria de sistema del F103 por USART1, como lo describe el AN3155 de ST (web/src/hardware/stm32-serial.ts, la tarjeta en stm32-upload-dialog.ts).
- Compilación. La compilación del hardware es el runtime del simulador más
firmware/bluepill/hardware/clocks.cbajo-DMOKXI_HARDWARE(hardwareBundleenweb/src/compile/bundles.ts). El chip real sale del reset con el HSI de 8 MHz;mokxi_hw_init()arranca el cristal de 8 MHz, configura dos estados de espera de flash y el búfer de prefetch, APB1 /2, APB2 /1, ADC /6, y corre el SYSCLK desde el PLL a 72 MHz. Eso es exactamente el F_CPU, F_APB1, F_APB2 y F_TIM que asumestm32f103.h. Sin cristal se queda en HSI. La dirección de enlace es la misma (0x08000000), así que el script de enlace se comparte. Los ELF del simulador están fijados enhardware-build.test.ts. - Cableado. Un adaptador serie USB a 3.3 V: TX a A10, RX a A9, GND a G. BOOT0 a 1, y luego RESET, arranca el cargador de la ROM. Después de la carga, BOOT0 de vuelta a 0.
- Protocolo. 115200 baudios, 8E1. Sincronización con 0x7F, Get, Get ID (0x410 en un F103C8), Erase (0x43) o Extended Erase (0x44) según la versión del cargador, Write Memory en bloques de 256 bytes, Read Memory para verificar cada uno, y luego Go a 0x08000000. Un NACK al borrar significa que la protección de lectura está activa, y la tarjeta indica cómo desactivarla.
- Aún no probado en una placa real. El flasheador solo se ha probado contra un cargador falso (
testing/fake-stm32.ts).