A visão geral, com exemplos rodando, está na página da placa e O modelo do STM32F411 (todos os registradores).
O que é
The WeAct MiniF4 "Black Pill", an STM32F411CEU6 running on our own Cortex-M core in its ARMv7-M profile with Thumb-2. The registers come from the manufacturer's reference manual and datasheet at their real addresses, so the same source cross-compiled against the vendor headers would work on silicon.
O clock é fixo: 84 MHz para a CPU, o barramento e os timers, e 42 MHz no barramento mais lento dos periféricos. O mesmo chip na placa Nucleo da ST roda a 100 MHz: a Nucleo-F411RE.
Os pinos
Two twenty-pin headers on a 0.1 inch pitch and a four-pin SWD header across the bottom edge, in the order of WeAct's own pinout diagram, with USB-C at the top.
Conector esquerdo, de cima para baixo: PB12, PB13, PB14, PB15, PA8 a PA12, PA15, PB3 a PB9, depois 5V, G e 3V3.
Conector direito, de cima para baixo: 5V, G, 3V3, PB10, PB2, PB1, PB0, PA7 até PA0, R (NRST), PC15, PC14, PC13 e VB (VBAT) na ponta mais distante do conector USB.
Conector SWD, da esquerda para a direita: 3V3, DIO (PA13), SCK (PA14), G. Uma placa encaixada numa protoboard não conecta esses pinos, pois o conector real aponta para cima ou não vem montado; ligue fios direto a eles.
Os trilhos extras têm nomes próprios num diagrama, porque cada nome de pino é único: os da fileira direita são 5Vb, GNDc e 3V3b, os do conector SWD são 3V3c e GNDb. Todos são os mesmos trilhos.
A project saved before Mokxi drew the real order (late October 2026) has this
board end for end, with VBAT beside the USB socket and PA13, PA14 and a
ground folded into the left row. It opens that way, with its header setting
on early, so a board in a breadboard keeps every pin in the hole it was in.
Set header to board for the real order: wires to pins follow them, but a
board sitting in a breadboard then reaches different holes.
PB11 não existe, porque o componente de 48 pinos não o traz para fora. Então a porta B tem quinze pinos, não dezesseis.
Um pino aqui é uma porta e um número, não um número da placa: PA5, e não 5. Isso pega quem vem do Arduino, e a trilha de aprendizagem começa com isso.
O LED é ao contrário
PC13 carrega o LED azul da placa com o ânodo no 3,3 V através de 470 ohms e o cátodo no pino. Ele acende quando PC13 é levado ao nÃvel baixo. A primeira aula da placa se chama "O LED que acende quando o pino está baixo" por esse motivo.
What is modeled
GPIO, TIM1 a TIM5 e TIM10 nos modos de contagem e PWM, ADC1, USART1 e SysTick, além do bastante do RCC para responder às leituras de registradores que um programa faz na subida.
analogRead lê os dez pinos do ADC, PA0 a PA7, PB0 e PB1 (A0 a A9), nos dez bits do STM32duino por padrão (0 a 1023 em 0 a 3,3 V); analogReadResolution(12) dá os doze bits completos do conversor.
Todo periférico num STM32 de verdade começa com o clock desligado, e aqui é igual: ligar o clock antes de mexer num periférico faz parte do exercÃcio, não é uma formalidade que este modelo pula.
O que não é
A árvore de clock e a latência da flash, DMA, USB, I2C, SPI, SDIO, o RTC, os watchdogs, TIM9 e TIM11, a unidade CRC, os modos de baixo consumo, os option bytes e a programação da flash. Os registradores deles não estão mapeados, então tocá-los causa um bus fault. A FPU também não é modelada: floats são calculados em software, então dão o mesmo resultado e gastam mais ciclos do que no chip.
A árvore de clock não modelada corta também no outro sentido. O núcleo roda a 84 MHz não importa como o RCC esteja programado, então um sketch que esquece de ligar o PLL mantém o tempo aqui e roda cinco vezes mais lento numa placa real. Os pinos 3V3 e 5V são fontes ideais que não sofrem queda de tensão.
A captura de entrada não é modelada. WFI e WFE pausam o núcleo; o sono profundo se comporta como sono comum.
As bibliotecas do fabricante (a Cube HAL, libopencm3, o core do STM32duino) ficam de fora pelo mesmo motivo que o Pico SDK: elas inicializam hardware que não está aqui.
As tabelas de registradores estão em o modelo do STM32F411.
Serial
A USART1 carrega o monitor serial. O detalhe completo, incluindo o que acontece quando a fila de recepção transborda, está no documento de contrato.
Bibliotecas do Arduino
Um tutorial que inclua Servo.h, Wire.h, SPI.h, EEPROM.h, LiquidCrystal_I2C.h, Adafruit_GFX.h com Adafruit_SSD1306.h e DHT.h compila aqui como está. Cada uma é um cabeçalho próprio do Mokxi sob o nome upstream, escrito sobre os drivers dos componentes da caixa de componentes, e nada disso é o código da biblioteca upstream.
Wire.begin()coloca o barramento I2C emPB7(SDA) ePB6(SCL).EEPROM.hfunciona, mas o modelo desta placa não tem EEPROM nem flash gravável, então os bytes vivem em 4 KB de RAM: eles são lidos de volta dentro de uma execução e somem num reset.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.
O editor de código e a compilação lista o que cada uma cobre e como difere da biblioteca upstream.
Os exemplos
Blink, Button, Serial, Fade e Chaser.
Assembly
O painel Firmware também oferece Assembly (sem Arduino): um Blink, um Button para LED, um hello por UART e uma interrupção de Timer em assembly ARM Thumb-2 para o Cortex-M4. Os arquivos da placa viram um main.S, e nada além desse arquivo é linkado, então ele carrega sua própria tabela de vetores: .word _estack, depois
Reset_Handler, depois seus handlers. Os projetos iniciais ligam os clocks em
RCC_AHB1ENR, controlam o PC13, leem o PA0, imprimem na USART1 no PA9 a 115200 e rodam o SysTick a 1 kHz a partir do núcleo de 84 MHz. Um .S ao lado de um sketch comum também funciona. Veja Escrevendo em assembly.
Em outros lugares
- A página da placa: /boards/stm32f411
- O documento de contrato: o modelo do STM32F411
- A trilha de aprendizagem: Embedded no STM32F411, em /learn
- O mesmo chip na placa da ST: a Nucleo-F411RE
- A placa F1 mais antiga: a Blue Pill
- Projetos iniciais: STM32 chaser e STM32 tilt lamp