Placas

O STM32F411 Black Pill

Um Cortex-M4 a 84 MHz com GPIO, timers, um ADC, USART1 e SysTick.

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 em PB7 (SDA) e PB6 (SCL).
  • EEPROM.h funciona, 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.h stops 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