Referensi

Kontrak board STM32F411 "Black Pill" (Fase 4)

Black Pill dan Nucleo-F411RE pada core Cortex-M4 kita, dengan GPIO, ADC, TIM1 sampai TIM5, dua USART, dan SysTick.

Ini adalah referensi teknis untuk modelnya: apa yang diimplementasikan, register demi register, untuk orang yang menulis firmware menggunakannya. Untuk memakai board ini di editor, mulai dari STM32F411 Black Pill dan halaman board.

Mikrokontroler ketiga, dan board Cortex-M pertama. Satu komponen kernel (stm32f411 di crates/parts) membungkus model SoC STM32F411CEU6 (crates/stm32f411) yang dibangun di atas inti ARMv7-M (crates/cortexm-core, teruji di proofs/cortexm/REPORT.md). Firmware adalah ARM Thumb ELF biasa yang berbicara dengan periferal di bawah ini pada alamat STM32F411 aslinya, diambil dari RM0383 (manual referensi STM32F411xC/E) dan DS10314 (datasheet), jadi program yang dibangun untuk Mokxi juga berjalan di WeAct Black Pill asli.

Tipe katalognya adalah stm32f411 (WeAct MiniF4 "Black Pill" v3.x, STM32F411CEU6). Board kedua, nucleof411re (ST Nucleo-F411RE, die yang sama dengan STM32F411RET6), adalah model SoC yang sama dengan konfigurasi board tersendiri: clock, USART host, pin, dan build runtime-nya sendiri. Bagian 8 membahas board itu; selain itu semua yang ada di sini berlaku untuk keduanya kecuali disebutkan lain. Tiga agen melakukan build terhadap file ini: SoC dan komponen (Rust), runtime firmware dan contoh (C/C++, clang), serta visual board (TypeScript). Ubah hanya dengan mengedit file ini terlebih dahulu. Semua yang ada di docs/esp32c3.md tentang cara kerja komponen board (slice, host channel, reset, crash line) dan semua yang ada di docs/uno.md tentang cara board ditempatkan dalam rangkaian berlaku di sini kecuali file ini menyebutkan lain.

Menjalankan biner vendor (STM32Cube HAL, libopencm3, inti STM32duino) bukan tujuan Fase 4. Semuanya butuh pohon clock dibangun dari HSI, latensi dan prefetch flash, DMA dan USB, yang tidak dimodelkan. Yang menjadi tujuan adalah setiap register yang disentuh program bare-metal untuk menyalakan pin, mencetak di UART, membaca tombol dan menggerakkan output PWM ada di alamat aslinya dengan bit aslinya, jadi source yang sama yang di-cross-compile terhadap header CMSIS akan bekerja di silikon.

1. Pin board (urutan katalog)

Board ini punya pin 2x20 dengan jarak 0,1 inci plus header SWD 4 pin melintasi sisi bawah, USB-C di atas, dalam urutan diagram pinout WeAct sendiri untuk board STM32F4x1 v2.0+. Urutan katalog adalah header kiri dari atas ke bawah, lalu header kanan dari atas ke bawah, lalu header SWD dari kiri ke kanan.

Header kiri: PB12, PB13, PB14, PB15, PA8, PA9, PA10, PA11, PA12, PA15, PB3, PB4, PB5, PB6, PB7, PB8, PB9, 5V, GND, 3V3

Header kanan: 5Vb, GNDc, 3V3b, PB10, PB2, PB1, PB0, PA7, PA6, PA5, PA4, PA3, PA2, PA1, PA0, NRST, PC15, PC14, PC13, VBAT

Header SWD: 3V3c, PA13 (SWDIO), PA14 (SWCLK), GNDb

44 pin. PB11 tidak ada: STM32F411CEU6 adalah komponen 48 pin dan tidak mengeluarkannya, jadi PB0..PB15 adalah "sesuai yang terpasang": lima belas pin, bukan enam belas. Rel muncul lebih dari sekali (tiga 3.3 V, dua 5 V, tiga ground) dan membawa huruf karena nama pin katalog harus unik. Pin SWD tidak menancap ke breadboard tempat board berada (plug: false di web/src/parts/stm32f411.ts).

Until late October 2026 the drawing had the board end for end (VBAT at the USB end) with the SWD header folded into the VBAT row as PA13, PA14 and GNDb, and no second 5 V or 3.3 V pins. A diagram saved then is read with the part's header setting at early and keeps that drawing (web/src/parts/header-layout.ts); the model does not read the setting. The silkscreen prints the short forms (VB, C13, R, A0, B9, G); the catalog uses the full port names because a netlist pin reference has to be unambiguous.

Kelistrikan:

  • 3V3 memberi 3.3 V pada R_SUPPLY; 5V memberi 5 V pada R_SUPPLY; GND dan GNDb memberi 0 V. Board selalu mendapat daya (USB-C). Board ini adalah catu daya untuk sisa rangkaian. VBAT adalah input yang diabaikan board: di sini board selalu dialiri daya dari rel 3.3 V.
  • NRST adalah input dengan pull-up internal 40 k ke 3.3 V (RM0383 menyebut 30 k sampai 50 k); bila diturunkan di bawah 1.65 V pin ini menahan CPU dalam reset; melepaskannya memulai ulang program dari vektor reset.
  • Setiap PAn, PBn dan PCn (dan pada Nucleo PD2) adalah GPIO inout. Output (MODER = 01 atau 10): push-pull pada 3.3 V atau 0 V melalui R_STRONG, atau open-drain (bit OTYPER disetel) di mana high berarti high-Z. Input atau analog (MODER = 00 atau 11): high-Z, plus pull-up 40 k ke 3.3 V untuk PUPDR = 01 atau pull-down 40 k untuk PUPDR = 10. Input membaca tegangan net terhadap 1.65 V (setengah dari 3.3 V); Unknown terbaca 0, dan input mengambang membaca derau, seperti pada Uno (docs/uno.md bagian 1).
  • PC13 membawa LED biru bawaan board, anoda ke 3,3 V melalui 470 R, katoda ke pin: LED menyala saat PC13 ditarik ke level low. LED ini adalah beban pada pin, dan visualnya ditampilkan dari bit probe (bagian 5).
  • PA0 juga membawa tombol KEY, yang menyambung singkat PA0 ke ground selama ditekan. Tidak ada pull-up eksternal: firmware memakai pull-up internal. Tombol ini diakses melalui poke (bagian 5), bukan melalui pin.
  • PA9/PA10 adalah TX/RX USART1 pada board asli dan di sini; byte USART dikirim ke kanal host (bagian 4), dan kedua pin tetap GPIO pada net sehingga osiloskop padanya menampilkan apa pun yang sedang dilakukan blok GPIO. PA11/PA12 adalah USB D-/D+ pada board asli dan GPIO biasa di sini.
  • PA13/PA14 keluar dari reset dalam mode alternate-function untuk SWD, persis seperti perilaku komponennya, artinya keduanya high-Z sampai firmware memprogram ulang MODER.

2. Peta memori (alamat STM32F411CE yang sebenarnya)

region alamat ukuran catatan
flash 0x0800_0000 512 KB flash STM32F411CE; penulisan diabaikan (tidak ada antarmuka pemrograman flash)
alias flash 0x0000_0000 512 KB byte yang sama, karena BOOT0 low dan area boot memetakan flash utama ke 0
SRAM 0x2000_0000 128 KB
APB1 0x4000_0000 32 KB TIM2..TIM5 dan USART2, bagian 3
APB2 0x4001_0000 32 KB TIM1, USART1, ADC1, SYSCFG, EXTI, TIM10, bagian 3
AHB1 0x4002_0000 64 KB GPIOA..GPIOD dan RCC, bagian 3
SCS 0xE000_E000 4 KB SysTick, NVIC dan SCB, dijawab di dalam cortexm-core dan tidak pernah terlihat di bus

Apa pun di luar itu adalah access fault: core mengalami BusFault, yang dengan SHCSR hasil reset meningkat menjadi HardFault. Register yang tidak terpetakan di dalam blok peripheral yang terpetakan terbaca 0 dan mengabaikan penulisan, dengan pencacah untuk diagnostik.

ELF firmware: loadProgram menerima executable ARM ELF32 little-endian (e_machine 40). Setiap segmen PT_LOAD harus berada di dalam flash (melalui salah satu view) atau di SRAM. Reset adalah reset arsitektural, bukan lompatan ke entry point: MSP diambil dari word di dasar tabel vektor dan PC dari word kedua, dengan bit rendah di-nol-kan, jadi image firmware adalah tabel vektor sungguhan dan bukan entry point telanjang. VTOR direset ke 0, yaitu alias flash. Memuat saat runtime mereset board.

Core-nya adalah Profile::V7M dengan Cpu::set_priority_bits(4); keluarga STM32F4 mengimplementasikan empat bit teratas dari setiap field prioritas 8-bit, jadi NVIC_IPR berperilaku seperti yang diharapkan NVIC_SetPriority CMSIS. Tidak ada FPU: CPACR disimpan tanpa pernah dipakai, dan setiap instruksi VFP dan DSP memunculkan UNDEFINSTR. Kompilasi firmware dengan -mfloat-abi=soft.

3. Register peripheral (subset, offset asli, posisi bit asli)

Register 32 bit dan selaras word. Akses byte dan halfword berfungsi dan mengenai word yang memuatnya, seperti yang dilakukan jembatan AHB/APB untuk register yang dimodelkan di sini.

3.1 RCC (0x4002_3800)

Pohon clock dimodelkan dari register, dengan satu konsesi untuk image yang dibawa Mokxi: sampai firmware menyentuh konfigurasi clock komponen berjalan pada clock boot board-nya (SYSCLK = HCLK = 84 MHz pada Black Pill, 100 MHz pada Nucleo, APB1 setengahnya), karena runtime Arduino tidak pernah memprogram PLL. Penulisan pertama ke RCC_CR atau RCC_PLLCFGR, atau penulisan RCC_CFGR yang mengubah SW, menyerahkan clock ke register: sejak itu SYSCLK adalah HSI (16 MHz), HSE (kristal 25 MHz pada Black Pill, 8 MHz dari ST-LINK pada Nucleo) atau PLL (src / PLLM * PLLN / PLLP) sesuai SWS, HCLK adalah SYSCLK / HPRE, PCLK1 dan PCLK2 adalah HCLK / PPRE1 dan PPRE2, dan clock timer adalah PCLK (prescaler 1) atau 2 x PCLK, atau dengan DCKCFGR.TIMPRE HCLK hingga pembagian 4. Core, SysTick, timer, baud rate USART, clock ADC dan konversi siklus-ke-waktu semuanya mengikuti, termasuk saat clock berubah di tengah berjalan. HCLK dibulatkan ke MHz penuh untuk konversi waktu. Reset mengembalikan clock boot. Latensi flash tetap disimpan dan diabaikan.

offset nama perilaku
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 (oscillators and the PLL start at once)
0x04 RCC_PLLCFGR disimpan, terbaca kembali; reset 0x2400_3010
0x08 RCC_CFGR disimpan; SWS[3:2] mengikuti SW[1:0] seketika saat sumber yang disebut SW aktif di RCC_CR, dan tetap diam jika tidak. HPRE, PPRE1, PPRE2 mengatur clock bus seperti di atas
0x0C RCC_CIR tersimpan, terbaca kembali
0x10 0x20 0x24 RCC_AHB1RSTR RCC_APB1RSTR RCC_APB2RSTR 1 yang ditulis ke bit sebuah peripheral mereset register peripheral itu; register itu sendiri terbaca 0
0x30 RCC_AHB1ENR bit 0 GPIOAEN, 1 GPIOBEN, 2 GPIOCEN, 3 GPIODEN, 4 GPIOEEN, 7 GPIOHEN, 12 CRCEN, 21 DMA1EN, 22 DMA2EN
0x34 RCC_AHB2ENR tersimpan, terbaca kembali
0x40 RCC_APB1ENR bit 0 TIM2EN, 1 TIM3EN, 2 TIM4EN, 3 TIM5EN, 11 WWDGEN, 14 SPI2EN, 15 SPI3EN, 17 USART2EN, 21 I2C1EN, 22 I2C2EN, 23 I2C3EN, 28 PWREN
0x44 RCC_APB2ENR bit 0 TIM1EN, 4 USART1EN, 5 USART6EN, 8 ADC1EN, 11 SDIOEN, 12 SPI1EN, 13 SPI4EN, 14 SYSCFGEN, 16 TIM9EN, 17 TIM10EN, 18 TIM11EN
0x50 0x54 0x60 0x64 keempat register LPENR tersimpan, terbaca kembali
0x70 RCC_BDCR disimpan; LSERDY (1) mengikuti LSEON (0)
0x74 RCC_CSR disimpan; LSIRDY (1) mengikuti LSION (0); PINRSTF (26) set setelah reset NRST, PORRSTF (27) dan BORRSTF (25) setelah power-on; penulisan dengan RMVF (24) menghapus flag

Bit pengaktifan clock adalah gerbang sungguhan: peripheral yang bit pengaktifnya kosong terbaca 0 dan mengabaikan penulisan, dan pencacah galat mencatat aksesnya. Itu kesalahan bare-metal STM32 yang paling umum, dan menyembunyikannya akan membuatnya tak terlihat di sini.

3.2 GPIOA, GPIOB, GPIOC, GPIOD (0x4002_0000, 0x4002_0400, 0x4002_0800, 0x4002_0C00)

Port D is on the die in both packages; the 48-pin F411CE bonds out none of it and the 64-pin F411RE only PD2. Its reset values are all zero. The clock enable is RCC_AHB1ENR bit 3, GPIODEN.

offset nama bit
0x00 MODER 2 bits per pin: 00 input, 01 output, 10 alternate function, 11 analog
0x04 OTYPER 1 bit per pin: 0 push-pull, 1 open-drain
0x08 OSPEEDR 2 bits per pin; stored, read back, no effect on edge timing
0x0C PUPDR 2 bits per pin: 00 none, 01 pull-up, 10 pull-down
0x10 IDR hanya baca, bit 0..15: level pin
0x14 ODR bit 0..15: latch output
0x18 BSRR hanya tulis: bit 0..15 menyetel bit ODR yang cocok, bit 16..31 menghapusnya; reset menang atas set dalam penulisan yang sama. Terbaca 0
0x1C LCKR disimpan, terbaca kembali; urutan lock tidak diberlakukan
0x20 0x24 AFRL AFRH 4 bit per pin, pin 0..7 dan 8..15

Nilai reset adalah milik komponen itu sendiri, dan ini penting karena nilai itulah yang membiarkan pin SWD tidak tersentuh: GPIOA_MODER = 0xA800_0000, GPIOA_OSPEEDR = 0x0C00_0000, GPIOA_PUPDR = 0x6400_0000; GPIOB_MODER = 0x0000_0280, GPIOB_OSPEEDR = 0x0000_00C0, GPIOB_PUPDR = 0x0000_0100; sisanya 0.

IDR membaca kembali apa yang chip ini keluarkan pada pin yang ia drive, dan apa yang board sampel dari net pada pin yang tidak ia drive, persis seperti PINx di Uno.

Fungsi alternatif: dengan MODER = 10 pad di-drive oleh peripheral mana pun yang dipilih AFRL/AFRH untuk pin tersebut, dari subset di bagian 3.3 dan 3.4. Pemilihan fungsi alternatif yang tidak dimodelkan di sini membuat pad tetap high-Z dan dihitung sebagai stray. Pemetaan yang dimodelkan (DS10314 tabel 9):

AF pins
AF1 TIM2 PA0 CH1, PA1 CH2, PA2 CH3, PA3 CH4, PA5 CH1, PA15 CH1, PB3 CH2, PB10 CH3
AF1 TIM1 PA8 CH1, PA9 CH2, PA10 CH3, PA11 CH4; komplementer PA7, PB13 CH1N, PB0, PB14 CH2N, PB1, PB15 CH3N
AF2 TIM3 PA6 CH1, PA7 CH2, PB0 CH3, PB1 CH4, PB4 CH1, PB5 CH2, PC6 CH1, PC7 CH2, PC8 CH3, PC9 CH4
AF3 TIM10 PB8 CH1
AF2 TIM4 PB6 CH1, PB7 CH2, PB8 CH3, PB9 CH4
AF2 TIM5 PA0 CH1, PA1 CH2, PA2 CH3, PA3 CH4
AF7 USART1 PA9 TX, PA10 RX, PB6 TX, PB7 RX
AF7 USART2 PA2 TX, PA3 RX

3.3 TIM2, TIM3, TIM4, TIM5 (0x4000_0000, 0x4000_0400, 0x4000_0800, 0x4000_0C00)

TIM2 dan TIM5 punya CNT, ARR dan CCRx 32-bit; TIM3 dan TIM4 16-bit. Keempatnya diclock pada 84 MHz (bagian 5).

offset nama bit
0x00 CR1 CEN 0, UDIS 1, URS 2, OPM 3, DIR 4, CMS 5..6, ARPE 7, CKD 8..9
0x04 CR2 tersimpan, terbaca kembali
0x08 SMCR tersimpan, bisa dibaca kembali; mode slave dan trigger tidak dimodelkan
0x0C DIER UIE 0, CC1IE 1, CC2IE 2, CC3IE 3, CC4IE 4, TIE 6; enable DMA disimpan
0x10 SR UIF 0, CC1IF 1..CC4IF 4, TIF 6, CC1OF 9..CC4OF 12. Tulis 0 ke sebuah bit untuk menghapusnya, 1 membiarkannya (rc_w0, seperti kata manual)
0x14 EGR hanya tulis: UG 0 memuat ulang prescaler dan counter serta menyetel UIF, CC1G 1..CC4G 4 menyetel flag capture/compare, TG 6 menyetel TIF
0x18 CCMR1 mode output: CC1S 0..1, OC1FE 2, OC1PE 3, OC1M 4..6, OC1CE 7, CC2S 8..9, OC2FE 10, OC2PE 11, OC2M 12..14, OC2CE 15
0x1C CCMR2 sama untuk kanal 3 dan 4
0x20 CCER CC1E 0, CC1P 1, CC2E 4, CC2P 5, CC3E 8, CC3P 9, CC4E 12, CC4P 13
0x24 CNT
0x28 PSC 16 bit; counter berdetak pada 84 MHz / (PSC + 1)
0x2C ARR nilai reload; periodenya ARR + 1 detak saat menghitung naik
0x34 0x38 0x3C 0x40 CCR1 CCR2 CCR3 CCR4
0x48 0x4C DCR DMAR tersimpan, terbaca kembali
0x50 TIM2_OR / TIM5_OR tersimpan, terbaca kembali

Penghitungan: naik (DIR = 0), turun (DIR = 1) dan center-aligned (CMS != 0) semuanya dimodelkan, masing-masing dengan event update di tempat yang ditunjuk manual. ARPE mem-buffer ARR dan OCxPE mem-buffer CCRx sampai event update, dan itulah yang membuat perubahan duty-cycle bebas glitch.

Mode output compare (OCxM): 0 frozen, 1 aktif saat cocok, 2 nonaktif saat cocok, 3 toggle, 4 paksa nonaktif, 5 paksa aktif, 6 mode PWM 1 (aktif selama CNT < CCRx saat menghitung naik), 7 mode PWM 2 (kebalikannya). CCxP membalik polaritas output. Pin hanya bergerak selama CCxE disetel dan pad berada dalam mode alternate function dengan timer tersebut dipilih (bagian 3.2).

Input capture tidak dimodelkan: CCxS != 0 disimpan dan dihitung sebagai stray.

Garis NVIC: TIM2 = 28, TIM3 = 29, TIM4 = 30, TIM5 = 50. Masing-masing aktif selama ada salah satu flag SR yang disetel dengan enable DIER yang cocok, ditahan sebagai level. Handler menghapus flag, seperti pada silikon.

3.3a TIM1 (0x4001_0000) dan TIM10 (0x4001_4400)

TIM1 is the advanced-control timer: the registers of section 3.3, 16 bits wide, plus RCR (0x30, stored; the repetition counter is not acted on) and BDTR (0x44). BDTR.MOE (bit 15) gates every TIM1 output: with it clear none of them drives a pin. CCER adds CCxNE (bit 4n+2) and CCxNP (bit 4n+3) for channels 1 to 3: the complementary output alone is the channel's reference level with CCxNP as its polarity, and with CCxE on as well it is the reference's complement (RM0383 table 56 with no dead time; dead time and the break input are stored and not modeled). Clock enable RCC_APB2ENR bit 0.

TIM10 adalah timer 16 bit dengan satu kanal, dimodelkan dengan register bagian 3.3; yang tidak ada di silikon dibaca seperti tersimpan. Enable clock RCC_APB2ENR bit 17.

Keduanya berhitung pada clock timer APB2, yaitu HCLK di kedua board. Garis NVIC: TIM1_UP_TIM10 = 25 (update TIM1, atau interrupt TIM10 apa pun), TIM1_TRG_COM_TIM11 = 26 (trigger TIM1), TIM1_CC = 27 (flag compare TIM1).

3.4 USART1 (0x4001_1000) dan USART2 (0x4000_4400)

offset nama bit
0x00 SR PE 0, FE 1, NE 2, ORE 3, IDLE 4, RXNE 5, TC 6, TXE 7, LBD 8, CTS 9. RXNE, TC dan LBD/CTS dihapus dengan menulis 0; TC dan ORE juga terhapus pada urutan baca-SR-lalu-baca-DR, seperti kata manual
0x04 DR tulis: kirim; baca: byte yang diterima dan menghapus RXNE
0x08 BRR DIV_Fraction 0..3, DIV_Mantissa 4..15; baud = f_PCLK / (8 x (2 - OVER8) 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, OVER8 15
0x10 CR2 disimpan, terbaca kembali; STOP 12..13 disimpan dan 8N1 diasumsikan untuk pacing
0x14 CR3 tersimpan, terbaca kembali
0x18 GTPR tersimpan, terbaca kembali

f_PCLK adalah HCLK untuk USART1 (APB2) dan HCLK / 2 untuk USART2 (APB1), bagian 5: 84 dan 42 MHz di Black Pill, 100 dan 50 MHz di Nucleo.

USART1 adalah kanal host di Black Pill; di Nucleo itu USART2, yang oleh board itu disambungkan ke virtual COM port ST-LINK, dan USART1 adalah port yang byte-nya tidak ke mana-mana. Transmisi adalah satu buffer milik komponen sendiri plus shift register: tulis ke DR dengan TXE disetel akan menghapus TXE, shift register mengambil byte dan TXE langsung kembali, dan byte sampai ke host satu waktu frame (10 waktu bit pada baud yang dikonfigurasi) kemudian, saat TC disetel. Penerimaan: byte host masuk antrean di FIFO seukuran register penerima asli satu byte ditambah backlog di sisi host 256 byte supaya teks yang diketik tidak hilang; RXNE disetel selama ada byte menunggu; membaca DR mengambilnya, dan byte yang datang saat RXNE sudah disetel menyetel ORE.

USART satunya lagi adalah USART kedua yang identik, yang byte kirimannya tidak pergi ke mana-mana (byte dihitung, jadi sebuah test bisa melihatnya) dan penerimanya tidak pernah punya apa pun untuk dibaca. Ia ada supaya firmware yang ditulis untuk dua port bisa di-link dan dijalankan.

Garis NVIC: USART1 = 37, USART2 = 38. Masing-masing aktif selama RXNE & RXNEIE, TXE & TXEIE, TC & TCIE atau IDLE & IDLEIE berlaku. Itu adalah kondisi, bukan flag edge, jadi masuk ke handler tidak menghapus apa pun. Handler TXE yang tidak punya lagi sesuatu untuk dikirim harus mematikan dirinya sendiri, seperti pada chip.

3.5 SYSCFG (0x4001_3800) dan EXTI (0x4001_3C00)

offset nama bit
SYSCFG 0x00 MEMRMP disimpan, terbaca kembali; remap boot tetap di main flash
SYSCFG 0x04 PMC tersimpan, terbaca kembali
SYSCFG 0x08..0x14 EXTICR1..EXTICR4 4 bit per line: 0 = port A, 1 = port B, 2 = port C, 3 = port D. Line n mengamati pin n dari port yang dipilih
SYSCFG 0x20 CMPCR terbaca 0
EXTI 0x00 IMR mask interrupt, satu bit per line 0..15 (line 16..22 disimpan dan tidak pernah memicu)
EXTI 0x04 EMR mask event; disimpan, dan line yang di-mask membangunkan core dari WFE
EXTI 0x08 RTSR pilihan trigger naik
EXTI 0x0C FTSR pilihan trigger turun
EXTI 0x10 SWIER writing 1 sets the matching PR bit
EXTI 0x14 PR pending; tulis 1 untuk menghapus

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 SysTick dan NVIC

Both are inside cortexm-core at the architectural addresses in the System Control Space and never reach the bus (proofs/cortexm/REPORT.md section 5). SYST_CALIB is programmed to 10500 with SKEW and NOREF clear: the board's external reference is HCLK/8 = 10.5 MHz, so a 10 ms tick is 105,000 of them, which does not fit 24 bits: the part's own answer, and the reason CMSIS SysTick_Config uses the processor clock. With CLKSOURCE clear the model still counts processor cycles; the /8 divider is not modeled and is called out here rather than hidden.

stm32f411.h juga punya ejaan CMSIS, untuk kode yang ditulis dengan header ST: nama SysTick_CTRL_*_Msk dan _Pos, SysTick_LOAD_RELOAD_Msk dan SysTick_VAL_CURRENT_Msk, SystemCoreClock (84.000.000, variabel seperti di CMSIS) dan SystemCoreClockUpdate() yang kosong. millis() dari runtime berjalan di SysTick, jadi sketch yang memprogram ulang SysTick mengubah millis() dan delay().

3.6a ADC1 (0x4001_2000, register umum di 0x4001_2300)

Satu regular group, dimulai oleh SWSTART (bit 30 dari CR2) selama ADON disetel, dalam mode tunggal atau kontinu, dengan SCAN menelusuri sekuens dan meninggalkan hasil terakhir di DR, seperti itulah komponen tanpa DMA. Tidak ada start "tulis ADON dua kali" pada keluarga ini. SR: EOC (1) disetel saat konversi selesai dan terhapus saat DR dibaca; STRT (4) disetel saat satu dimulai; keduanya rc_w0. CR1.RES (bit 24..25) memilih 12, 10, 8 atau 6 bit; CR2.ALIGN meratakan ke kiri; CR1.EOCIE menaikkan baris NVIC 18 (ADC). ADC_CCR.ADCPRE (bit 16..17) membagi PCLK2 dengan 2, 4, 6 atau 8 untuk clock ADC, dan satu konversi memakan waktu sampling SMPRx kanal tersebut (3, 15, 28, 56, 84, 112, 144 atau 480 clock ADC) ditambah satu clock per bit (RM0383 11.5): EOC tidak terlalu cepat maupun terlambat.

Channels 0..7 are PA0..PA7, 8 and 9 PB0 and PB1, 10..15 PC0..PC5 (DS10314 table 8). The board hands each one the voltage on its net as a twelve-bit count against 3.3 V; a floating pin reads noise. Channel 17 (VREFINT, 1.21 V, count 1502) and 18 (the temperature sensor at 25 C, 0.76 V, count 943) read their nominal values while ADC_CCR.TSVREFE (bit 23) is set, and 0 otherwise. Not modeled: the injected group, the analog watchdog, external triggers, DMA and the overrun flag. Clock enable RCC_APB2ENR bit 8.

3.7 Apa yang tidak dimodelkan

Pohon clock dan latensi flash, DMA, USB, I2C, SPI, SDIO, RTC, watchdog, TIM9 dan TIM11, unit CRC, mode daya rendah dari pengendali daya, option byte, dan pemrograman flash. Register mereka tidak terpetakan (access fault) kecuali bila sebuah blok tercantum di atas, di mana offset yang tidak diimplementasikan membaca 0, mengabaikan penulisan dan menghitung satu stray. WFI dan WFE memarkir core; SLEEPDEEP disimpan dan berperilaku seperti sleep biasa.

4. Kanal host

host = "utf-8 bytes on USART1" ("utf-8 bytes on USART2" di Nucleo). readHost mengembalikan byte TX dari USART host saat byte itu selesai keluar di kabel; writeHost mendorong byte ke antrean terimanya (luber membuang dan menyetel ORE, seperti pada chip). Serial monitor menampilkan byte sebagai teks, mendekode UTF-8 dan memperlakukan \n sebagai akhir baris (\r diabaikan).

5. Model waktu dan komponen

84 MHz di Black Pill, satu siklus per 1/84 us (100 MHz di Nucleo, satu siklus per tepat 10 ns, dan slice 1000 siklus; sisa bagian ini memberi angka Black Pill). Hitungan siklus berasal dari core (Cpu::run mengembalikan siklus; penghitung siklus core adalah jamnya). Satu siklus bukan bilangan bulat pikodetik, jadi waktu diturunkan sebagai ps = cycles * 1_000_000 / 84, tepat, tidak pernah diakumulasi, selalu dihitung ulang dari hitungan siklus, jadi tidak mungkin bergeser. Slice 10 us tepat 840 siklus, dan 840 siklus tepat 10.000.000 ps, jadi batas slice selalu eksak.

Clock saat boot (bagian 3.1 menjelaskan bagaimana firmware mengubahnya; setiap angka di sini lalu mengikuti HCLK):

domain Black Pill Nucleo
SYSCLK, HCLK, CPU 84 MHz 100 MHz
clock periferal APB1 (USART2) 42 MHz 50 MHz
clock timer APB1 (TIM2..TIM5) 84 MHz 100 MHz
APB2 (USART1, ADC1) dan timer-timernya (TIM1, TIM10) 84 MHz 100 MHz

Di dalam sebuah slice, core dijalankan langkah demi langkah sehingga setiap store periferal membawa siklus CPU saat terjadinya: perubahan pad menjadi drive_after pada offset tersebut dari awal slice, jadi dua penulisan BSRR yang berjarak empat siklus benar-benar berjarak 48 ns di net. Timer dimajukan secara analitis. Event berikutnya setiap timer (kecocokan compare, update, overflow) dihitung dari hitungan, prescaler, ARR dan mode-nya, core dijalankan sampai siklus itu, event diterapkan, dan jalannya dilanjutkan, jadi tepi PWM mendarat pada siklus yang tepat, bukan di akhir slice. Pembacaan IDR melihat level pin pada awal slice ditambah perubahan yang dibuat program itu sendiri di dalam slice.

WFI (and WFE with the event register clear) parks the core: the part stops slicing and schedules one wake at the earliest of the SysTick reload, the next timer event that can raise an enabled interrupt, and the next USART event; a pin change or a host byte wakes it immediately. This is the whole idle story. proofs/cortexm/REPORT.md measures the core at 1.02x of a real STM32F411 in Chromium and says plainly that there is no headroom, so a sketch that busy-waits through a delay() will not hold real time. delay() in the runtime therefore parks on WFI and is woken by SysTick, and an idle board costs the kernel a handful of events a simulated second instead of 84 million cycles.

Probe: bit 0 = berjalan (1 saat mengeksekusi, 0 saat reset atau halted), bit 1 = tidur (parkir di WFI/WFE), bit 2 = LED on-board (PC13 ditarik rendah), bit 3 = aktivitas TX dalam 20 ms terakhir, bit 4 = aktivitas RX dalam 20 ms terakhir. Jadi probe adalah bitmask kecil, 0 tanpa program.

Poke: 0 = lepaskan KEY, 1 = tekan KEY (menghubungkan singkat PA0 ke ground selama ditahan), 2 = tahan NRST, 3 = lepaskan NRST.

Penanganan crash seperti di docs/esp32c3.md bagian 5: core melaporkan Trap, dan komponen berhenti serta mencetak satu baris di kanal host, misalnya firmware crashed at pc=0x08000412, HardFault (CFSR 0x00000100). Lockup, instruksi tidak dikenal, BKPT, dan vector table yang tidak terpetakan semuanya datang sebagai trap. Setelah itu komponen berhenti meminta wakeup.

6. Runtime firmware (firmware/stm32/)

Runtime C dan C++ freestanding untuk STM32F411 yang dibangun dengan clang 18 (--target=thumbv7em-none-eabi -mfloat-abi=soft -mcpu=cortex-m4 -Os) dan lld, tanpa newlib, tanpa CMSIS, tanpa HAL, tanpa apa pun yang GPL:

  • crt0.S: the 16 system vectors plus the 85 IRQ vectors at the head of flash, _start (set MSP, which the core has already done from vector 0; copy .data from its load address in flash, clear .bss, run the C++ static constructors, call main), and a default handler that stops.
  • link.ld: flash di 0x0800_0000 sebesar 512 KB, SRAM di 0x2000_0000 sebesar 128 KB, stack dari puncak SRAM, dengan assert bahwa data statis menyisakan ruang untuknya.
  • stm32f411.h: setiap register di bagian 3 sebagai makro volatile dengan nama asli ST (GPIOC->ODR, RCC->AHB1ENR, TIM3->CCR1, USART1->DR), plus konstanta bit dan nomor IRQ.
  • arduino.h: permukaan sketch yang sama seperti runtime Uno, pada pin komponen ini: pinMode, digitalWrite, digitalRead, analogWrite, delay, delayMicroseconds, millis, micros, Serial, attachInterrupt, shiftOut, map, random. Nomor pin adalah nama port: PA0, PB9, PC13 adalah konstanta, dan LED_BUILTIN adalah PC13.

millis() berasal dari SysTick pada 1 kHz (reload 83,999). micros() berasal dari TIM2, sebuah penghitung 32-bit yang berjalan bebas pada 1 MHz (PSC = 83, ARR = 0xFFFFFFFF), jadi resolusinya 1 us dan berulang setiap 71.6 menit. delay() memarkir inti pada WFI sampai hitungan SysTick mencapai tenggat; delayMicroseconds() busy-wait pada TIM2.

analogWrite(pin, 0..255) menghasilkan PWM pada 1 kHz, seperti STM32duino (PWM_FREQUENCY 1000: PSC = 1, tick 42 MHz, dan ARR = 41,999, yaitu 84 MHz / 2 / 42,000), dengan CCRx = 42,000 x nilai / 255, penskalaan setCaptureCompare milik inti, pada dua belas pin:

timer channel 1 channel 2 channel 3 channel 4
TIM5 PA0 PA1 PA2 PA3
TIM3 PA6 PA7 PB0 PB1
TIM4 PB6 PB7 PB8 PB9

0 dan 255 bukan PWM: keduanya melepas output compare dan menggerakkan pin ke rendah atau tinggi, jadi analogWrite(pin, 0) benar-benar mati. digitalWrite pada pin PWM mengambil alih pin kembali, seperti yang dilakukan Arduino core.

analogRead(pin) mengonversi pada ADC1 (bagian 3.6a) seperti STM32duino: pin ke mode analog, ADCPRE PCLK2 / 4, 15 siklus sampling, SWSTART dan menunggu EOC, dan hasilnya sepuluh bit secara bawaan (ADC_RESOLUTION 10). analogReadResolution(bits) memilih resolusi terdekat dari konverter (6, 8, 10 atau 12) lalu memetakan ke bit yang diminta dengan mapResolution milik inti. Angka di bawah jumlah input analog board berarti input analog (analogRead(0) adalah A0), seperti di STM32duino; pada Black Pill A0 sampai A9 adalah PA0 sampai PA7, PB0 dan PB1.

Serial adalah USART1 pada PA9/PA10, 8N1, penerimaan digerakkan interrupt ke dalam ring 64-byte, pengiriman lewat ring 64-byte yang dikosongkan oleh interrupt TXE, seperti yang dilakukan HardwareSerial milik STM32duino (SERIAL_TX_BUFFER_SIZE 64): print yang muat langsung kembali dan byte keluar pada baud rate, yang lebih panjang menunggu ruang kosong, dan availableForWrite() adalah ruang tersisa (63 saat kosong). attachInterrupt(pin, fn, mode) memakai SYSCFG dan EXTI: satu handler per line, CHANGE, RISING dan FALLING.

Contoh di firmware/stm32/examples/<name>/sketch.ino, dibuild ke web/public/firmware/stm32/<name>.elf dengan web/public/firmware/stm32/index.json dalam bentuk yang sama seperti index Uno, setiap entri membawa "program": "elf32 arm stm32f411":

  • blink: PC13 pada 1 Hz, active low, delay(500) parkir di WFI.
  • button: tombol KEY pada PA0 dengan INPUT_PULLUP menyalakan PC13.
  • serial: mencetak millis() sekali per detik dan menggemakan apa yang diterima.
  • fade: analogWrite pada PA0 membuat LED bernapas, dengan PC13 mengikuti.

UI memilih daftar firmware berdasarkan string program pada katalog komponen (docs/sim-api.md bagian 3): "elf32 riscv32imc" membaca /firmware/index.json, "elf32 avr atmega328p" membaca /firmware/uno/index.json, "elf32 arm stm32f411" membaca /firmware/stm32/index.json, dan "elf32 arm stm32f411 nucleo" membaca /firmware/nucleof411re/index.json.

7. Apa yang sudah pasti pada model ini, dan apa yang belum

Tiga kelompok, dengan pengurutan yang sama seperti docs/esp32c6.md bagian 7. Ini ada karena model board yang menebak alamat diam-diam lebih buruk daripada yang mengaku tidak tahu.

Diambil dari manual referensi, dan dijalankan oleh firmware sungguhan. Setiap alamat dasar, offset register, dan posisi bit di bagian 2 dan 3 berasal dari manual referensi STM32F4 (RM0383) dan lembar data STM32F411CE: RCC di 0x4002_3800, GPIOA/B/C di 0x4002_0000/0400/0800, TIM2 sampai TIM5 di 0x4000_0000/0400/0800/0C00, USART1 di 0x4001_1000 dan USART2 di 0x4000_4400, SYSCFG di 0x4001_3800 dan EXTI di 0x4001_3C00, SysTick dan NVIC di alamat ARM-nya, 128 KB SRAM di 0x2000_0000 dan 512 KB flash di 0x0800_0000; GPIOD di 0x4002_0C00, TIM1 di 0x4001_0000, ADC1 di 0x4001_2000 dan TIM10 di 0x4001_4400 dengan bit field dan timing ADC dari bab 11 RM0383. crates/stm32f411/tests/firmware.rs dan tests/nucleo.rs memuat ELF sungguhan dan menggerakkan GPIO, timer, kedua USART, ADC, SysTick, dan EXTI melaluinya. Urutan header WeAct Black Pill dan LED PC13-nya adalah milik board itu sendiri.

Dimodelkan, tetapi tidak terikat pada angka manual referensi. Perilakunya, bukan alamatnya:

  • Clock saat boot adalah clock penuh board (84 MHz, atau 100 di Nucleo). Board sungguhan yang tidak pernah mengonfigurasi PLL berjalan di 16 MHz dari HSI; di sini program yang tidak pernah menyentuh register clock berjalan di clock board, dan itulah yang diasumsikan runtime Arduino Mokxi. Begitu sebuah program menulis ke register clock, PLL, osilator, dan prescaler diikuti (bagian 3.1); latency flash tidak.
  • Slice punya dua gigi, dan store pertama setelah masa tenang terjadi lebih awal. Core berjalan dalam batch kasar sampai sebuah store mendarat di register GPIO, timer, atau USART, lalu satu instruksi demi satu instruksi untuk sementara. Semua yang di dalam burst itu eksak; store pertama dari sebuah burst diberi timing di awal batch tempatnya terjadi, yang bisa sampai 6.1 us terlalu awal.
  • Pad-nya punya tiga keadaan dan satu ambang. Push-pull di 3.3 V, open drain, high-Z, atau pull internal 40 kΩ (lembar data memberi 30 kΩ sampai 50 kΩ), dibaca kembali terhadap setengah suplai, tanpa histeresis, tanpa pengaturan kecepatan, tanpa waktu naik, dan tanpa batas arus. LED di board adalah LED dengan 470 Ω di PC13, anoda ke rel, jadi level rendah menyalakannya.
  • The board is an ideal supply: 3V3 and 5V at rail impedance for ever, so nothing browns out and the regulator is not there. VBAT is a pin and no more. Startup is a microsecond, with no option bytes and no boot pins.

Sengaja tidak ada, seperti yang didaftar di bagian 3.7: clock tree dan latency flash, DMA, USB (jadi soket USB di board tidak membawa apa pun; Serial sampai ke monitor melalui kanal host dan PA11/PA12 tetap GPIO biasa), I2C, SPI, I2S, SDIO, RTC, watchdog, TIM9 dan TIM11, CRC, FPU dan register-nya, serta pemrograman flash. Ketiadaan FPU memakan waktu, bukan hasil: runtime di-build untuk ABI soft-float, jadi float dihitung di software dan hasilnya sama, dengan siklus lebih banyak daripada FPU chip.

8. Nucleo-F411RE (nucleof411re)

NUCLEO-F411RE dari ST (MB1136, UM1724): STM32F411RET6, die yang sama dalam paket 64 pin, di board dengan ST-LINK. Komponennya adalah adapter yang sama dengan Black Pill (crates/parts/src/parts/stm32f411.rs) dengan konfigurasi board stm32f411::NUCLEO_F411RE; runtime-nya firmware/stm32/ yang di-build dengan -DMOKXI_BOARD_NUCLEO_F411RE (firmware/nucleof411re/build.sh). Katalog program = "elf32 arm stm32f411 nucleo", yang membaca /firmware/nucleof411re/index.json; host = "utf-8 bytes on USART2".

Clock. 100 MHz, clock yang diprogram varian NUCLEO_F411RE dari STM32duino (HSE bypass dari 8 MHz milik ST-LINK, PLLM 4, PLLN 100, PLLP 2; APB1 / 2, APB2 / 1), jadi satu siklus tepat 10 ns dan satu slice 10 us adalah 1000 siklus. Core membebani host sama per siklus seperti di Black Pill, dan ada 19 % lebih banyak siklus per detik, jadi sketch yang busy-wait butuh 19 % lebih banyak mesin untuk mempertahankan waktu nyata; yang tidur di delay() tidak membebani apa pun di kedua kasus.

Pin (urutan katalog): header Arduino CN6 IOREF, NRST, 3V3, 5V, GND, GNDb, VIN; CN8 A0..A5; CN5 D15, D14, AVDD, GNDc, D13..D8; CN9 D7..D2; lalu pin yang hanya dibawa keluar oleh header morpho, CN7 PC10, PC11, PC12, PD2, VDD, E5V, BOOT0, GNDd, PA13, PA14, PA15, PB7, PC13, VBAT, PC2, PC3 dan CN10 PC9, PC8, PC6, PC5, U5V, GNDe, PA12, PA11, PB12, PB2, PB1, PB15, PB14, PB13, AGND, PC4, PA2, PA3 (63 pin). Pad yang ada di header Arduino dan header morpho sekaligus adalah satu pin, dengan nama Arduino-nya:

Arduino D2 D3 D4 D5 D6 D7 D8 D9 D10 D11 D12 D13 D14 D15 A0 A1 A2 A3 A4 A5
pad PA10 PB3 PB5 PB4 PB10 PA8 PA9 PC7 PB6 PA7 PA6 PA5 PB9 PB8 PA0 PA1 PA4 PB0 PC1 PC0

Ditinggalkan karena board saat dikirim tidak menghubungkannya (UM1724 6.8, 6.12): D0/D1 (SB62/SB63 terbuka; PA3/PA2 menuju ST-LINK dan ada di header morpho), PC14/PC15 (kristal LSE) dan PH0/PH1 (MCO milik ST-LINK). VIN, E5V, dan BOOT0 adalah input yang diabaikan board; IOREF, VDD, AVDD, dan VBAT (terikat ke VDD di board ini) adalah 3.3 V; U5V adalah 5 V.

Di board. LD2, hijau, dari PA5 melalui 510 ohm ke ground: menyala selama pin menggerakkan level tinggi, dan hanya selama itu menjadi output (bit probe 2). B1, tombol USER biru, menyambung singkat PC13 ke ground (poke 1 menahannya, 0 melepaskannya), dan R30, 4.7 k dari PC13 ke 3.3 V, selalu ada di pin, jadi input terbaca tinggi saat dilepas. B2 adalah NRST (poke 2, 3). Bit probe-nya sama dengan Black Pill; bit 3 dan 4 adalah COM milik LD1 ST-LINK.

Runtime. Penomoran NUCLEO_F411RE milik STM32duino: 0..15 adalah D0..D15, 16..51 urutan morpho varian, PIN_A0..PIN_A15 = 192..207 input analognya, dan setiap nama port didefinisikan sebagai salah satu angka itu (PA5 adalah PIN_A15, yaitu pin digital 13), jadi 13, D13, PA5 dan LED_BUILTIN adalah satu pin. USER_BTN adalah PC13. Serial adalah USART2 di PA2/PA3 (SERIAL_UART_INSTANCE 2), juga bernama Serial2; tidak ada Serial1. analogWrite memakai timer pertama yang didaftar PinMap_TIM varian untuk tiap pin, pada 1 kHz (PSC 1, ARR 49.999): TIM2 di PA0..PA3, PA5, PA15, PB3, PB10; TIM3 di PA6, PB4, PB5, PC6..PC9; TIM4 di PB6..PB9; TIM1 di PA8..PA11 dan, sebagai CH1N..CH3N, PA7, PB0, PB1, PB13.. PB15. Jadi micros() berjalan di TIM5 di sini, dan tone() di TIM10, TIMER_TONE varian. Wire bawaan di D14/D15, SPI di D13, D12, D11, D10. Contoh di firmware/nucleof411re/examples/: blink, button, serial, fade (D9) dan analog (A0).