Board

STM32F411 Black Pill

Cortex-M4 84 MHz dengan GPIO, timer, ADC, USART1, dan SysTick.

Tinjauannya, dengan contoh yang berjalan, ada di halaman board dan Model STM32F411 (setiap register).

Apa ini

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.

Clocknya tetap: 84 MHz untuk CPU, bus, dan timer, serta 42 MHz di bus peripheral yang lebih lambat. Die yang sama di board Nucleo buatan ST berjalan di 100 MHz: Nucleo-F411RE.

Pin-pin-nya

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.

Header kiri, dari atas ke bawah: PB12, PB13, PB14, PB15, PA8 sampai PA12, PA15, PB3 sampai PB9, lalu 5V, G, dan 3V3.

Header kanan, dari atas ke bawah: 5V, G, 3V3, PB10, PB2, PB1, PB0, PA7 sampai PA0, R (NRST), PC15, PC14, PC13, dan VB (VBAT) di ujung paling jauh dari soket USB.

Header SWD, dari kiri ke kanan: 3V3, DIO (PA13), SCK (PA14), G. Board yang ditancapkan ke breadboard tidak menghubungkan pin-pin ini, karena header aslinya menghadap ke atas atau tidak terpasang; sambungkan kabel ke pin tersebut secara langsung.

Rel tambahan punya nama sendiri dalam diagram, karena setiap nama pin itu unik: milik baris kanan adalah 5Vb, GNDc, dan 3V3b, milik header SWD adalah 3V3c dan GNDb. Semuanya adalah rel yang sama.

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 tidak ada, karena komponen 48-pin tidak mengeluarkannya. Jadi port B berlima belas pin, bukan enam belas.

Pin di sini adalah port dan nomor, bukan nomor board: PA5, bukan 5. Ini sering menjebak orang yang terbiasa dengan Arduino, dan jalur belajar kami mengedepankannya.

LED-nya terbalik arahnya

PC13 membawa LED biru bawaan board dengan anoda ke 3,3 V melalui 470 ohm dan katoda di pin. LED menyala saat PC13 ditarik rendah. Pelajaran pertama board ini diberi nama "LED yang menyala saat pin rendah" karena alasan itu.

What is modeled

GPIO, TIM1 sampai TIM5 dan TIM10 dalam mode penghitungan dan PWM, ADC1, USART1, dan SysTick, plus cukup RCC untuk menjawab pembacaan register yang dilakukan program saat awal berjalan.

analogRead membaca sepuluh pin ADC, PA0 sampai PA7, PB0, dan PB1 (A0 sampai A9), dalam sepuluh bit milik STM32duino secara bawaan (0 sampai 1023 untuk 0 sampai 3,3 V); analogReadResolution(12) memberikan dua belas bit penuh dari konverter.

Setiap peripheral di STM32 sungguhan mulai dengan clocknya dalam keadaan mati, dan itu berlaku di sini juga: menyalakan clock sebelum menyentuh peripheral adalah bagian dari latihannya, bukan formalitas yang dilewati model ini.

Yang tidak

Pohon clock dan latency flash, DMA, USB, I2C, SPI, SDIO, RTC, watchdog, TIM9 dan TIM11, unit CRC, mode daya rendah, option bytes, dan pemrograman flash. Registernya tidak terpetakan, jadi menyentuhnya menyebabkan bus fault. FPU juga tidak dimodelkan: float dihitung di software, jadi hasilnya sama tapi butuh siklus lebih banyak dibanding di chip.

Pohon clock yang tidak dimodelkan juga berlaku ke arah sebaliknya. Core berjalan di 84 MHz apa pun yang diprogram ke RCC, jadi sketch yang lupa menyalakan PLL tetap akurat waktunya di sini tapi berjalan lima kali lebih lambat di board sungguhan. Pin 3V3 dan 5V adalah sumber ideal yang tidak bisa turun tegangannya.

Input capture tidak dimodelkan. WFI dan WFE memarkir core; deep sleep berperilaku seperti sleep biasa.

Stack vendor (Cube HAL, libopencm3, core STM32duino) di luar cakupan dengan alasan yang sama seperti Pico SDK: semuanya menyalakan hardware yang tidak ada di sini.

Tabel register ada di model STM32F411.

Serial

USART1 membawa serial monitor. Detail lengkapnya, termasuk yang terjadi saat antrean terima meluap, ada di dokumen kontrak.

Library Arduino bawaan

Tutorial yang memuat Servo.h, Wire.h, SPI.h, EEPROM.h, LiquidCrystal_I2C.h, Adafruit_GFX.h dengan Adafruit_SSD1306.h dan DHT.h dikompilasi di sini apa adanya. Masing-masing adalah header buatan Mokxi sendiri dengan nama upstream, ditulis di atas driver untuk komponen di kotak komponen, dan tidak ada satu pun kode dari library upstream.

  • Wire.begin() menaruh bus I2C di PB7 (SDA) dan PB6 (SCL).
  • EEPROM.h bekerja, tapi model board ini tidak punya EEPROM atau flash yang bisa ditulis, jadi byte-nya tinggal di RAM sebesar 4 KB: byte itu terbaca kembali selama satu Run dan hilang saat 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.

Editor kode dan kompilasi mencantumkan apa yang dicakup masing-masing dan bagaimana bedanya dengan library upstream.

Contoh-contoh

Blink, Button, Serial, Fade, dan Chaser.

Assembly

Panel Firmware juga menawarkan Assembly (tanpa Arduino): sebuah Blink, sebuah Button ke LED, sebuah hello lewat UART, dan interupsi Timer dalam assembly ARM Thumb-2 untuk Cortex-M4. File-file board menjadi satu main.S, dan tidak ada selain file itu yang di-link, jadi ia membawa vector table sendiri: .word _estack, lalu Reset_Handler, lalu handler-handlernya. Proyek awal menyalakan clock di RCC_AHB1ENR, menggerakkan PC13, membaca PA0, mencetak di USART1 pada PA9 di 115200, dan menjalankan SysTick di 1 kHz dari core 84 MHz. Sebuah .S di samping sketch biasa juga bisa. Lihat Menulis assembly.

Di tempat lain