La descripción general, con ejemplos en ejecución, está en la página de la placa y El modelo de la STM32 Blue Pill (todos los registros).
Qué es
The board everybody calls the Blue Pill, an STM32F103C8T6 running on our own Cortex-M core in its ARMv7-M profile. A Cortex-M3 is ARMv7-M without the M4's DSP extension and without an FPU, and the core refuses both here, so a program that reaches for them stops rather than quietly working.
Los registros provienen del RM0008 y de la hoja de datos del STM32F103x8/xB en sus direcciones reales, así que el mismo firmware corre en la placa de tu escritorio. El reloj es fijo: 72 MHz para la CPU y los temporizadores, desde el encendido.
Esta no es la Black Pill con números distintos
La F1 es una generación distinta de la familia, y las diferencias son las que un programa puede ver. La F411 es una Cortex-M4 a 84 MHz con 512 KB de flash; la F103 es una Cortex-M3 a 72 MHz con 64 KB de flash y 20 KB de SRAM. La F411 configura un pin con MODER, OTYPER, PUPDR y AFRL/AFRH; la F103 usa un campo de cuatro bits en CRL o CRH, y toma la dirección de pull-up de una entrada del bit ODR de ese pin. Ni una sola dirección de periférico se comparte.
Los pines
40 pines con paso de 0.1 pulgadas, 2 por 20, con el conector micro-USB en la parte superior.
Header izquierdo, de arriba abajo: VBAT, PC13, PC14, PC15, PA0 a PA7, PB0, PB1, PB10, PB11, NRST, 3V3, GND, 5V.
Header derecho: GNDb, GNDc, 3V3b, PB12 a PB15, PA8 a PA12, PA15, PB3 a PB9.
Un pin aquí es un puerto y un número, no un número de placa: PA5, no 5. La serigrafía imprime las formas cortas (VB, C13, R, A0); el catálogo las escribe completas y les añade sufijos a las repetidas (GNDb, GNDc, 3V3b) porque dos pines de un mismo componente no pueden compartir nombre.
PA13 y PA14 están en el header SWD aparte y PB2 es el jumper BOOT1, así que ningún cable llega a ellos aquí, igual que en la placa.
Esta es una placa de 3.3 voltios, siempre alimentada por USB. 3V3 y 3V3b suministran 3.3 V, 5V suministra 5 V, y las tres tierras son el retorno.
El LED está al revés, y no hay botón
PC13 conduce el LED verde integrado con su ánodo a 3.3 V a través de 1 k y su cátodo en el pin. Se enciende cuando PC13 se pone en bajo. 1 k en lugar de los 470 ohmios de la Black Pill, por eso el LED de una Blue Pill es el más tenue de las dos, y PC13 a PC15 están en el dominio de alimentación de respaldo y entre ambos solo pueden absorber 3 mA: sirven para manejar un indicador y poco más.
No hay botón de usuario. El único botón de la Blue Pill es RESET. Un sketch que necesita un botón debe tenerlo en la protoboard, y por eso tantos tutoriales de Blue Pill empiezan cableando uno.
Por qué tu sketch no puede manejar PA15, PB3 o PB4
El puerto de depuración SWJ los retiene fuera del reset: PA15 y PB4 con pull-up, PB3 flotante. Escribe SWJ_CFG en AFIO_MAPR una vez en setup() y son tuyos. Esta es la sorpresa más común en la placa y el modelo la reproduce en lugar de ocultarla.
What is modeled
GPIO en los puertos A a C a través de CRL y CRH, TIM1 a TIM4 en sus modos de conteo y PWM, USART1 en PA9 y PA10 conectado al monitor serie, un ADC1 de doce bits en conversión única en diez pines a la propia velocidad de conversión del componente, AFIO y EXTI, SysTick y la NVIC, y lo suficiente de RCC para responder las lecturas de registros que hace un programa durante el arranque.
Todos los periféricos de una STM32 real empiezan con su reloj apagado, y aquí es igual: habilitar el reloj antes de tocar un periférico es parte del ejercicio, no una formalidad que este modelo se salte.
Lo que no está
El árbol de reloj y la latencia de flash, el DMA, el USB, el CAN, el I2C, el SPI, el RTC y los registros de respaldo, los watchdogs, el ADC2, el grupo inyectado y el watchdog analógico del ADC, la entrada de apagado y las salidas complementarias del TIM1, la captura de entrada, los modos de baja potencia, los Bytes de opción y la programación de flash. Sus registros no están mapeados, así que tocar uno produce una falla de bus en lugar de un cero silencioso.
Las bibliotecas del fabricante (la HAL de STM32Cube, libopencm3 y el núcleo STM32duino) quedan fuera del alcance por la misma razón que el SDK del Pico: inicializan hardware que no está aquí. Escribe el sketch contra el runtime y presiona Ejecutar.
Que el árbol de reloj no se modele corta en ambos sentidos. El núcleo corre a 72 MHz sin importar lo que se programe en RCC, así que un sketch que olvide iniciar el PLL lleva el tiempo correcto aquí y corre nueve veces más lento en una placa real. El ADC1 tampoco tiene error: sin muestreo y retención, sin no linealidad, sin ruido y sin desplazamiento, y el bit de calibración de ADC_CR2 se acepta y no hace nada. Y los pines de 3V3 y 5V son fuentes ideales que no pueden caer, lo cual importa en esta placa más que en la mayoría: el regulador de una Blue Pill clon suele ser el componente equivocado, y eso es una falla que nada aquí puede mostrarte.
The register tables are in el modelo de la STM32 Blue Pill, whose section 7 sorts every address and every approximation.
Bibliotecas estándar de Arduino
Un tutorial que incluya Servo.h, Wire.h, SPI.h, EEPROM.h, LiquidCrystal_I2C.h, Adafruit_GFX.h con Adafruit_SSD1306.h y DHT.h se compila aquí tal cual. Cada uno es un header propio de Mokxi con el nombre original, escrito sobre los controladores de los componentes de la caja, y nada de eso es código de la biblioteca original.
Wire.begin()pone el bus I2C enPB7(SDA) yPB6(SCL).EEPROM.hfunciona, pero el modelo de esta placa no tiene EEPROM ni flash escribible, así que los bytes viven en 4 KB de RAM: se leen dentro de una ejecución y desaparecen al reiniciar.Adafruit_NeoPixel.hstops with a message: a WS2812 bit is too short to make by hand on this board. The AVR boards, the ESP32s, the Pico and the Uno R4 drive the strip.
El editor de código y la compilación enumera lo que cubre cada una y en qué difiere de la biblioteca original.
Los ejemplos
Blink, Button, Fade y Serial.
En otras partes
- La página de la placa: /boards/bluepill
- El documento del contrato: el modelo de la STM32 Blue Pill
- Proyecto inicial: Lámpara Blue Pill
- La placa F4: la STM32F411 Black Pill