Referensi

Kontrak board STM32 "Blue Pill" F103 (Fase 9)

F103 pada core Cortex-M3 kita, dengan GPIO CRL dan CRH, TIM1 sampai TIM4, USART1, dan ADC dua belas bit.

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 STM32 Blue Pill dan halaman board.

Mikrokontroler kelima dan board Cortex-M kedua. Satu komponen kernel (bluepill di crates/parts) membungkus model SoC STM32F103C8T6 (crates/stm32f103) yang dibangun di atas inti ARMv7-M yang sama dengan Black Pill (crates/cortexm-core, dibuktikan di proofs/cortexm/REPORT.md). Firmware adalah ELF ARM Thumb biasa yang berbicara dengan peripheral di bawah ini di alamat STM32F103 sungguhan, diambil dari RM0008 (manual referensi STM32F101/102/103/105/107) dan datasheet STM32F103x8/xB, jadi program yang dibangun untuk Mokxi juga berjalan di Blue Pill sungguhan.

Tipe katalognya bluepill (STM32F103C8T6, LQFP 48-pin, board yang semua orang sebut Blue Pill). Semua di docs/esp32c3.md tentang perilaku komponen board (slice, host channel, reset, crash line) dan semua di docs/uno.md tentang bagaimana sebuah board diletakkan dalam rangkaian berlaku di sini kecuali file ini mengatakan lain.

Kenapa ini bukan Black Pill dengan angka berbeda

docs/stm32f411.md adalah saudara dari dokumen ini, dan godaannya membaca satu sebagai yang lain. Jangan. F1 adalah generasi berbeda dari keluarga ini dan perbedaannya persis yang bisa dilihat sebuah program:

F411 (Black Pill) F103 (Blue Pill)
inti Cortex-M4, tanpa FPU Cortex-M3
clock 84 MHz 72 MHz
flash / SRAM 512 KB / 128 KB 64 KB / 20 KB
konfigurasi pin MODER, OTYPER, PUPDR, AFRL/AFRH satu field empat bit di CRL/CRH
arah pull input PUPDR bit ODR pin itu
menghapus (clear) sebuah pin setengah atas BSRR setengah atas BSRR, atau BRR
gerbang clock GPIO RCC_AHB1ENR RCC_APB2ENR
fungsi alternatif sebuah angka per pin di AFR tetap per peripheral, dipetakan ulang di AFIO_MAPR
pemilihan port EXTI SYSCFG_EXTICR AFIO_EXTICR
basis RCC 0x4002_3800 0x4002_1000
timer TIM2 dan TIM5 32-bit setiap counter 16-bit
ADC tidak dimodelkan ADC1, konversi tunggal
pin debug saat reset PA13, PA14, PA15, PB4 ditarik pull kelima pin yang sama, dilepaskan oleh SWJ_CFG

Tidak ada satu pun alamat yang sama. Dua crate SoC ini bersaudara, bukan template dan salinannya.

Menjalankan biner vendor (STM32Cube HAL, libopencm3, core STM32duino) bukanlah tujuan. Semua itu butuh clock tree dinaikkan dari HSI, latensi dan prefetch flash, DMA dan USB, yang semuanya tidak dimodelkan. Yang jadi tujuan adalah setiap register yang disentuh program bare-metal untuk mengedipkan pin, mencetak ke UART, membaca tombol, membaca tegangan dan menggerakkan output PWM berada di alamat aslinya dengan bit aslinya, sehingga kode sumber yang sama yang di-cross-compile terhadap header CMSIS akan berjalan di silikon.

1. Pin board (urutan katalog)

The board is 2x20 pins on a 0.1 inch pitch, 53 x 23 mm, with the micro-USB socket at the top. Catalog order is the left header top to bottom, then the right header top to bottom.

Header kiri: VBAT, PC13, PC14, PC15, PA0, PA1, PA2, PA3, PA4, PA5, PA6, PA7, PB0, PB1, PB10, PB11, NRST, 3V3, GND, 5V

Header kanan: GNDb, GNDc, 3V3b, PB12, PB13, PB14, PB15, PA8, PA9, PA10, PA11, PA12, PA15, PB3, PB4, PB5, PB6, PB7, PB8, PB9

40 pin: 32 I/O, tiga ground, dua 3.3 V, satu 5 V, VBAT dan NRST. Silkscreen mencetak bentuk pendeknya (VB, C13, R, A0, B9, G, 3.3); katalog memakai nama port lengkap karena referensi pin netlist harus tidak ambigu, dan menambahkan akhiran pada yang berulang (GNDb, GNDc, 3V3b) karena dua pin dari satu komponen tidak boleh memakai nama yang sama.

Tiga pin chip tidak berada di header: PA13 dan PA14 adalah header SWD empat pin terpisah di sepanjang tepi bawah, dan PB2 adalah jumper BOOT1 di bagian atas. Pin-pin itu ada di model chip (memang harus ada, karena port debug menahannya), tapi tidak ada kabel yang bisa mencapainya di sini, sama persis seperti di board.

Kelistrikan:

  • 3V3 dan 3V3b menghasilkan 3.3 V pada R_SUPPLY; 5V menghasilkan 5 V pada R_SUPPLY; GND, GNDb dan GNDc menghasilkan 0 V. Board selalu mendapat daya (USB). Board ini adalah catu daya untuk sisa rangkaian. VBAT adalah input yang diabaikan board: di sini board selalu ditenagai dari rail 3.3 V.
  • NRST adalah input dengan pull-up internal 40 k ke 3.3 V (datasheet menyebut 30 k sampai 50 k); jika didorong di bawah 1.65 V ia menahan CPU dalam reset; melepaskannya menjalankan ulang program dari reset vector.
  • Setiap PAn, PBn dan PCn adalah GPIO inout. Output (MODE != 00): push-pull pada 3.3 V atau 0 V melalui R_STRONG, atau open-drain (CNF = 01 atau 11) yang tingginya high-Z tanpa pull sama sekali, karena output F1 tidak punya pull. Input (MODE = 00): high-Z untuk floating (CNF = 01) dan analog (CNF = 00), atau pull 40 k yang arahnya mengikuti bit ODR pin tersebut untuk CNF = 10. Input membaca tegangan net terhadap 1.65 V (setengah dari 3.3 V); Unknown terbaca 0, dan input floating membaca noise, seperti di Uno (docs/uno.md bagian 1).
  • PC13 membawa LED hijau on-board, anoda ke 3.3 V melalui 1 k, katoda ke pin: LED menyala saat PC13 didorong low. Ia adalah beban pada pin, dan visualnya ditampilkan dari bit probe (bagian 5). 1 k dan bukan 470 R seperti Black Pill, itulah sebabnya LED Blue Pill lebih redup dari keduanya. Catatan datasheet ST sendiri berlaku juga di sini: PC13, PC14 dan PC15 berada di backup power domain dan hanya bisa menyerap 3 mA, jadi pin-pin itu hanya menggerakkan indikator dan tidak lebih.
  • Di sini tidak ada tombol pengguna. Satu-satunya tombol Blue Pill adalah RESET, yang diakses lewat poke (bagian 5). Sketch yang butuh tombol harus memasangnya di breadboard, itu sebabnya banyak tutorial Blue Pill dimulai dengan menyambungkan satu tombol.
  • PA9/PA10 adalah TX/RX USART1 di board asli dan di sini; byte USART masuk ke channel host (bagian 4). PA11/PA12 adalah USB D-/D+ di board asli dan GPIO biasa di sini.
  • PA15, PB3 dan PB4 ada di header, tapi port debug SWJ menahannya sejak reset: PA15 dan PB4 ditarik pull-up, PB3 floating. Firmware bisa mendapatkannya kembali dengan menulis SWJ_CFG di AFIO_MAPR (bagian 3.5). Ini kejutan paling umum di board ini dan model memperlihatkannya apa adanya alih-alih menyembunyikannya.

2. Peta memori (alamat STM32F103C8 yang sebenarnya)

region alamat ukuran catatan
flash 0x0800_0000 64 KB flash milik STM32F103C8; penulisan diabaikan (tidak ada antarmuka pemrograman flash)
alias flash 0x0000_0000 64 KB byte yang sama, karena BOOT0 low dan area boot memetakan flash utama ke 0
SRAM 0x2000_0000 20 KB
APB1 0x4000_0000 32 KB TIM2..TIM4, USART2, USART3, bagian 3
APB2 0x4001_0000 32 KB AFIO, EXTI, GPIOA..GPIOC, ADC1, TIM1, USART1, bagian 3
AHB 0x4002_0000 RCC di 0x4002_1000, 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.

Banyak board C8 sebenarnya membawa 128 KB flash, karena dienya adalah CB dengan setengahnya tidak diuji. 64 KB adalah yang dijanjikan nomor komponen, jadi 64 KB adalah yang diberikan model ini dan yang boleh diandalkan firmware; link script memastikannya.

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 Profile::V7M dengan Cpu::set_priority_bits(4); keluarga STM32F1 mengimplementasikan empat bit teratas dari setiap field prioritas 8-bit, seperti F4, jadi NVIC_IPR berperilaku seperti yang diharapkan CMSIS NVIC_SetPriority. Cortex-M3 adalah ARMv7-M tanpa ekstensi DSP milik M4 dan tanpa FPU, persis seperti yang diimplementasikan dan ditolak cortexm-core: setiap encoding VFP dan saturating-SIMD memunculkan UNDEFINSTR. Tidak ada fitur yang perlu dimatikan untuk komponen ini; fitur tambahan M4 memang tidak pernah ada. Kompilasi firmware dengan -mcpu=cortex-m3 -mfloat-abi=soft.

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

Register 32 bit dan word aligned. Akses byte dan halfword berfungsi dan mengenai word yang memuatnya, itulah yang dilakukan jembatan APB untuk register yang dimodelkan di sini.

3.1 RCC (0x4002_1000)

Pohon clock dimodelkan dari register, dengan satu konsesi pada gambar yang dikirimkan Mokxi: hingga firmware menyentuh konfigurasi clock komponen berjalan di clock boot, SYSCLK = HCLK = 72 MHz (kristal HSE dikali sembilan), APB1 setengahnya dan ADC di PCLK2 / 6, karena runtime Arduino tidak pernah memprogram PLL. Penulisan pertama ke RCC_CR, atau penulisan RCC_CFGR yang mengubah SW, PLLSRC, PLLXTPRE atau PLLMUL, menyerahkan clock ke register: sejak saat itu SYSCLK adalah HSI (8 MHz), HSE (8 MHz) atau PLL (HSI / 2, atau HSE dibagi dua oleh PLLXTPRE, dikali PLLMUL + 2, maksimal 16) sesuai SWS, HCLK adalah SYSCLK / HPRE, PCLK1 dan PCLK2 adalah HCLK / PPRE1 dan PPRE2, clock timer adalah PCLK (prescaler 1) atau 2 x PCLK, dan clock ADC adalah PCLK2 / ADCPRE. Inti, SysTick, timer, baud rate USART, ADC dan konversi siklus-ke-waktu semuanya mengikuti, termasuk saat clock berubah di tengah jalannya program. 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. Reset 0x0000_0083
0x04 RCC_CFGR disimpan; SWS[3:2] mengikuti SW[1:0] langsung ketika sumber yang disebut SW aktif di RCC_CR, dan tetap diam sebaliknya. HPRE, PPRE1, PPRE2, PLLMUL, PLLSRC, PLLXTPRE dan ADCPRE mengatur clock seperti di atas
0x08 RCC_CIR tersimpan, terbaca kembali
0x0C RCC_APB2RSTR 1 yang ditulis ke bit sebuah peripheral mereset register peripheral itu; register itu sendiri terbaca 0
0x10 RCC_APB1RSTR sama untuk peripheral APB1
0x14 RCC_AHBENR disimpan, terbaca kembali; reset 0x0000_0014 (SRAMEN, FLITFEN)
0x18 RCC_APB2ENR bit 0 AFIOEN, 2 IOPAEN, 3 IOPBEN, 4 IOPCEN, 5 IOPDEN, 6 IOPEEN, 9 ADC1EN, 10 ADC2EN, 11 TIM1EN, 12 SPI1EN, 14 USART1EN
0x1C RCC_APB1ENR bit 0 TIM2EN, 1 TIM3EN, 2 TIM4EN, 11 WWDGEN, 14 SPI2EN, 17 USART2EN, 18 USART3EN, 21 I2C1EN, 22 I2C2EN, 23 USBEN, 25 CANEN, 27 BKPEN, 28 PWREN
0x20 RCC_BDCR disimpan; LSERDY (1) mengikuti LSEON (0)
0x24 RCC_CSR stored; LSIRDY (1) follows LSION (0); PINRSTF (26) set after an NRST reset, PORRSTF (27) after power-on, SFTRSTF (28) after AIRCR.SYSRESETREQ; a write with RMVF (24) clears the flags. There is no BORRSTF: this family has no brown-out reset flag, and bit 25 is reserved

GPIO digerakkan dari APB2ENR, bukan dari register AHB. Satu baris itu adalah bedanya antara sketch Blue Pill yang berfungsi dan yang setiap penulisan pin-nya hilang, dan di situlah kebiasaan dari F4 pertama kali gagal.

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 (0x4001_0800, 0x4001_0C00, 0x4001_1000)

offset nama bit
0x00 CRL 4 bit per pin, pin 0..7: MODE di 0..1, CNF di 2..3
0x04 CRH sama untuk pin 8..15
0x08 IDR hanya baca, bit 0..15: level pin
0x0C ODR bit 0..15: latch output, dan arah pull pada input yang dipull
0x10 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
0x14 BRR write-only: bits 0..15 clear the matching ODR bit. The F4 has no such register
0x18 LCKR disimpan, terbaca kembali; urutan lock tidak diberlakukan

MODE: 00 input, 01 output pada 10 MHz, 10 output pada 2 MHz, 11 output pada 50 MHz. Tiga kecepatan output itu disimpan dan tidak berpengaruh pada timing edge di sini, hal ini disebutkan, bukan disembunyikan.

CNF while MODE is 00: 00 analog, 01 floating, 10 pulled (dan arah pull-nya adalah bit ODR pin tersebut, 1 ke atas dan 0 ke bawah), 11 reserved.

CNF saat MODE bukan 00: 00 push-pull serbaguna, 01 open drain serbaguna, 10 push-pull alternate-function, 11 open drain alternate-function.

Nilai reset CRL dan CRH adalah 0x4444_4444: setiap pin jadi input floating. ODR reset ke 0.

IDR membaca kembali apa yang chip ini keluarkan pada pin yang didorong push-pull, dan apa yang board sampel dari net pada pin lain, persis seperti PINx di Uno. Jadi output open-drain membaca pin, bukan latch, dan justru itulah cara bus one-wire bisa bekerja.

Port debug SWJ menahan lima pin setelah reset, apa pun kata CRL/CRH (RM0008 9.3.5): PA13 (JTMS/SWDIO) dipull up, PA14 (JTCK/SWCLK) dipull down, PA15 (JTDI) dipull up, PB3 (JTDO) floating, PB4 (NJTRST) dipull up. AFIO_MAPR.SWJ_CFG menentukan mana yang dipertahankan: 000 kelima-limanya, 001 semua kecuali PB4, 010 hanya PA13/PA14 (SWD, dan pilihan yang biasa), 100 tidak ada. Pin yang ditahan port debug mengabaikan blok GPIO sepenuhnya.

3.3 TIM1, TIM2, TIM3, TIM4 (0x4001_2C00, 0x4000_0000, 0x4000_0400, 0x4000_0800)

Setiap counter pada komponen ini 16-bit. Keempatnya diclock pada 72 MHz (bagian 5). TIM1 adalah timer tingkat lanjut; tiga lainnya serbaguna.

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. Tulis 0 ke sebuah bit untuk menghapusnya, 1 membiarkannya (rc_w0, seperti kata manual)
0x14 EGR write-only: UG 0 reloads the prescaler, counter and repetition counter and sets UIF, CC1G 1..CC4G 4 set the capture/compare flags, TG 6 sets TIF
0x18 CCMR1 mode output: CC1S 0..1, OC1FE 2, OC1PE 3, OC1M 4..6, OC1CE 7, dan delapan bit yang sama untuk kanal 2
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 16 bit
0x28 PSC 16 bit; counter bertik pada 72 MHz / (PSC + 1)
0x2C ARR nilai reload; periodenya ARR + 1 detak saat menghitung naik
0x30 RCR hanya TIM1, 8 bit: event update terjadi setiap RCR + 1 overflow. Reserved pada tiga lainnya, dan penulisan di sana dihitung sebagai stray
0x34 0x38 0x3C 0x40 CCR1 CCR2 CCR3 CCR4 16 bit
0x44 BDTR hanya TIM1: hanya MOE (15) yang diperhatikan, dan tanpanya kanal tidak mencapai pin mana pun. Dead time, input break dan output komplemennya disimpan dan tidak dimodelkan
0x48 0x4C DCR DMAR 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.

Output compare modes (OCxM): 0 frozen, 1 active on match, 2 inactive on match, 3 toggle, 4 force inactive, 5 force active, 6 PWM mode 1 (active while CNT < CCRx up-counting), 7 PWM mode 2 (the inverse). CCxP inverts the output polarity. The pin only moves while CCxE is set (and, on TIM1, BDTR.MOE as well) and the pad's CNF says alternate function (section 3.2), and AFIO_MAPR has that channel on that pin (section 3.5).

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

NVIC lines: TIM1 splits its flags across TIM1_UP = 25 (the update flag) and TIM1_CC = 27 (the four compare flags and the trigger); TIM2 = 28, TIM3 = 29, TIM4 = 30 each carry all of theirs. Each asserts while any of its SR flags is set with the matching DIER enable, held as a level. The handler clears the flag, as on silicon.

3.4 USART1 (0x4001_3800), USART2 (0x4000_4400), USART3 (0x4000_4800)

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
0x04 DR tulis: kirim; baca: byte yang diterima dan menghapus RXNE
0x08 BRR DIV_Fraction 0..3, DIV_Mantissa 4..15; baud = f_PCLK / (16 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. Bit 15 reserved: tidak ada OVER8 pada komponen ini, dan oversampling selalu dengan enam belas kali
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 72 MHz untuk USART1 (APB2) dan 36 MHz untuk USART2 dan USART3 (APB1), bagian 5. Pada 72 MHz dan 115200 baud USARTDIV tepat 39.0625, jadi BRR = 0x271 dan ratenya eksak; itu salah satu alasan 72 MHz menjadi angka yang dipilih semua orang untuk komponen ini.

USART1 adalah kanal host. Transmit adalah buffer tunggal milik komponen sendiri plus shift register: tulis ke DR dengan TXE set akan menghapus TXE, shift register mengambil byte tersebut dan TXE langsung kembali set, dan byte sampai ke host satu waktu frame kemudian (10 waktu bit pada baud yang dikonfigurasi), saat TC menjadi set. Receive: byte dari host mengantre dalam FIFO seukuran register receive asli satu byte plus backlog di sisi host sebesar 256 byte supaya teks yang diketik tidak hilang; RXNE set selama ada byte menunggu; membaca DR mengeluarkannya, dan byte yang datang saat antrean penuh akan menyetel ORE.

USART2 dan USART3 adalah USART identik yang byte transmisinya tidak pergi ke mana pun (byte itu dihitung, jadi test bisa melihatnya) dan penerimanya tidak pernah punya apa pun untuk dibaca. Mereka ada supaya firmware yang ditulis untuk lebih dari satu port bisa di-link dan dijalankan.

Garis NVIC: USART1 = 37, USART2 = 38, USART3 = 39. 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 data untuk dikirim harus mematikan dirinya sendiri, seperti pada chip aslinya.

3.5 AFIO (0x4001_0000) dan EXTI (0x4001_0400)

offset nama bit
AFIO 0x00 EVCR tersimpan, terbaca kembali
AFIO 0x04 MAPR remap di bawah, plus SWJ_CFG di 24..26
AFIO 0x08..0x14 EXTICR1..EXTICR4 4 bit per line: 0 = port A, 1 = port B, 2 = port C. Line n mengawasi pin n dari port yang dipilih
AFIO 0x1C MAPR2 tersimpan, terbaca kembali
EXTI 0x00 IMR mask interrupt, satu bit per line 0..15 (line 16..18 disimpan tapi tidak pernah terpicu)
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

Tidak ada AFRL/AFRH pada komponen ini: pin sebuah peripheral sudah tetap, dan AFIO_MAPR memindahkan beberapa di antaranya secara keseluruhan. Pemetaan yang dimodelkan:

field MAPR nilai kanal 1 / TX 2 3 4
TIM1_REMAP 6..7 00, 01 PA8 PA9 PA10 PA11
11 port E, tidak dimodelkan
TIM2_REMAP 8..9 00 PA0 PA1 PA2 PA3
01 PA15 PB3 PA2 PA3
10 PA0 PA1 PB10 PB11
11 PA15 PB3 PB10 PB11
TIM3_REMAP 10..11 00 PA6 PA7 PB0 PB1
10 PB4 PB5 PB0 PB1
11 PC6 PC7 PC8 PC9
TIM4_REMAP 12 0 PB6 PB7 PB8 PB9
1 port D, tidak dimodelkan
USART1_REMAP 2 0 / 1 TX PA9 / PB6
USART2_REMAP 3 0 TX PA2 (1 adalah port D, tidak dimodelkan)
USART3_REMAP 4..5 00 / 01 TX PB10 / PC10

Remap ke port yang tidak dimiliki model ini (D atau E) membiarkan pin apa adanya daripada mengarang pin baru. Sebuah pin bisa jadi alternate function dari dua peripheral (PA9 adalah USART1 TX dan kanal 2 TIM1), yang pada silikon adalah kesalahan konfigurasi; model ini menyelesaikannya di satu tempat, USART sebelum timer, jadi sebuah pad punya tepat satu pemilik dan tidak ada peripheral yang bisa mendorong peripheral lain keluar dari pin secara diam-diam.

SWJ_CFG (24..26) adalah yang melepaskan pin debug; lihat bagian 3.2.

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 ADC1 (0x4001_2400)

A twelve-bit successive-approximation converter, clocked at PCLK2 / 6 = 12 MHz (section 5), which is the only divider that keeps a 72 MHz APB2 inside the part's 14 MHz limit. One ADC clock is six CPU cycles.

offset nama bit
0x00 SR AWD 0, EOC 1, JEOC 2, JSTRT 3, STRT 4; tulis 0 untuk menghapus
0x04 CR1 EOCIE 5, SCAN 8; sisanya disimpan
0x08 CR2 ADON 0, CONT 1, CAL 2, RSTCAL 3, ALIGN 11, EXTSEL 17..19, EXTTRIG 20, SWSTART 22
0x0C 0x10 SMPR1 SMPR2 3 bit per kanal: 1.5, 7.5, 13.5, 28.5, 41.5, 55.5, 71.5, 239.5 clock ADC. SMPR2 memuat kanal 0..9
0x14..0x20 JOFR1..JOFR4 tersimpan, terbaca kembali
0x24 0x28 HTR LTR disimpan, bisa dibaca kembali; analog watchdog tidak dimodelkan
0x2C SQR1 L 20..23, panjang grup dikurangi satu, dan konversi 13..16
0x30 0x34 SQR2 SQR3 lima bit per konversi; SQR3[4:0] adalah yang pertama
0x38 JSQR disimpan, bisa dibaca kembali; grup injected tidak dimodelkan
0x3C..0x48 JDR1..JDR4 dibaca 0
0x4C DR konversi reguler terakhir yang selesai; membacanya menghapus EOC

Satu konversi butuh sample time + 12.5 clock ADC, dan hasilnya tidak diberikan lebih awal: firmware benar-benar menunggu EOC. Pada sampling bawaan 1.5 siklus itu berarti 14 clock ADC (84 siklus CPU, 1.17 us); pada 55.5 yang dipakai runtime, 68 clock (408 siklus, 5.7 us).

Memulai konversi: menulis ADON saat nilainya sudah 1 akan memulai konversi, itu adalah idiom milik komponen ini, begitu juga SWSTART dengan EXTTRIG aktif dan EXTSEL = 111. CONT memulai ulang di akhir setiap konversi. CAL dan RSTCAL diterima dan langsung terbaca nol kembali (tidak ada yang perlu dikalibrasi), dan keduanya tidak memulai konversi, karena converter yang sedang mengalibrasi tidak mengonversi. ALIGN menempatkan dua belas bit di DR[15:4].

SCAN menelusuri grup reguler dan meninggalkan hasil terakhir di DR, itu memang perilaku komponen tanpa DMA, dan alasan mengapa SCAN tanpa DMA adalah jebakan.

Kanal: 0..7 adalah PA0..PA7 dan 8..9 adalah PB0..PB1. Kanal 10..15 ada di pin port C yang tidak dimiliki komponen 48-pin. Kanal 16 adalah sensor suhu, tetap di pembacaan 25 C sebesar 1,43 V (1775 count), dan kanal 17 adalah VREFINT, tetap di 1,20 V (1489 count). Komponen board mengubah tegangan net pada tiap pin analog menjadi count terhadap rel 3,3 V; net yang mengalami kontensi terbaca 0, dan yang mengambang akan bergeser-geser, seperti pada Uno.

Garis NVIC: ADC1_2 = 18, aktif selama EOC & EOCIE bernilai benar. ADC2 tidak dimodelkan.

3.7 SysTick dan NVIC

Keduanya ada di dalam cortexm-core pada alamat arsitektural di System Control Space dan tidak pernah sampai ke bus (proofs/cortexm/REPORT.md bagian 5). SYST_CALIB bernilai 90.000 dengan SKEW dan NOREF nol: referensi eksternalnya adalah HCLK/8 = 9 MHz, jadi tick 10 ms tepat 90.000 siklusnya dan nilainya eksak, tidak seperti di Black Pill yang tidak muat. Dengan CLKSOURCE nol, model tetap menghitung siklus prosesor; pembagi /8 tidak dimodelkan dan disebutkan di sini alih-alih disembunyikan.

stm32f103.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 (72.000.000, variabel seperti di CMSIS) dan SystemCoreClockUpdate() yang kosong. millis() milik runtime berjalan di SysTick, jadi sketch yang memprogram ulang SysTick akan mengubah millis() dan delay(), seperti di bawah HAL STM32duino.

3.8 Yang tidak dimodelkan

Pohon clock dan latensi flash, DMA, USB, CAN, I2C, SPI, RTC dan register backup, watchdog, ADC2, grup injected dan analog watchdog milik ADC, input break TIM1 dan output komplemennya, input capture, mode daya rendah pengendali daya, option byte, dan pemrograman flash. Register-register itu tidak terpetakan (access fault) kecuali bila suatu blok didaftar di atas, di mana offset yang tidak diimplementasikan terbaca 0, mengabaikan penulisan dan menghitung satu stray. WFI dan WFE memarkir core; SLEEPDEEP disimpan dan berperilaku seperti sleep biasa.

4. Kanal host

host = "byte utf-8 di USART1". readHost mengembalikan byte TX USART1 saat selesai keluar di kabel; writeHost mendorong byte ke antrean receive USART1 (luber membuang dan menyetel ORE, seperti di chip). Serial monitor menampilkan byte sebagai teks, menerjemahkan UTF-8 dan memperlakukan \n sebagai akhir baris (\r diabaikan).

5. Model waktu dan komponen

72 MHz, satu siklus per 1/72 us. Hitungan siklus berasal dari core (Cpu::run mengembalikan siklus; penghitung siklus core adalah jamnya). Satu siklus bukan bilangan pikodetik bulat, jadi waktu dihitung sebagai ps = cycles * 1_000_000 / 72, secara eksak, tidak pernah diakumulasi, selalu dihitung ulang dari hitungan siklus, jadi tidak akan pernah bergeser. Slice 10 us tepat 720 siklus, dan 720 siklus tepat 10.000.000 ps, jadi batas slice eksak.

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

domain frekuensi
SYSCLK, HCLK, CPU 72 MHz
Clock peripheral APB1 (USART2, USART3) 36 MHz
Clock timer APB1 (TIM2..TIM4) 72 MHz
APB2 (USART1, TIM1, masukan pembagi ADC) 72 MHz
ADC 12 MHz

Di dalam satu slice core dijalankan langkah demi langkah sehingga setiap store ke peripheral membawa siklus CPU saat ia terjadi: perubahan pad menjadi drive_after pada offset itu dari awal slice, jadi dua penulisan BSRR yang berjarak empat siklus benar-benar 55 ns terpisah di net. Timer dimajukan secara analitis. Event berikutnya tiap timer (compare match, update, atau overflow) dihitung dari count, prescaler, ARR dan modenya, core dijalankan sampai siklus itu, event diterapkan, dan jalannya dilanjutkan, jadi tepi PWM mendarat tepat pada siklusnya, bukan di akhir slice. Pembacaan IDR melihat level pin seperti pada awal slice ditambah perubahan yang dibuat program itu sendiri di dalam slice.

WFI (dan WFE dengan register event yang kosong) menghentikan sementara core: komponen berhenti melakukan slicing dan menjadwalkan satu wake pada waktu terdekat antara reload SysTick, event timer berikutnya yang bisa memunculkan interrupt yang aktif, event USART berikutnya, dan berakhirnya konversi ADC; perubahan pin atau byte dari host akan membangunkannya segera. Itulah semua cerita tentang idle. proofs/cortexm/REPORT.md mengukur core pada kecepatan sekitar real time di Chromium dan menyatakan dengan jelas bahwa tidak ada ruang sisa, jadi sketch yang busy-wait melewati delay() tidak akan mempertahankan waktu nyata. Oleh karena itu delay() di runtime berhenti pada WFI dan dibangunkan oleh SysTick, dan board yang idle hanya menghabiskan beberapa event kernel per detik simulasi, bukan 72 juta siklus.

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 = lepas RESET, 1 = tahan RESET. Tidak ada tombol kedua di board ini untuk di-poke.

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, BKPT #0 (CFSR 0x00000000, HFSR 0x40000000). Lockup, instruksi yang tidak didefinisikan, BKPT dan tabel vector yang tidak terpetakan semuanya datang sebagai trap. Komponen itu lalu berhenti meminta wakeup.

6. Runtime firmware (firmware/bluepill/)

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

  • crt0.S: the 16 system vectors plus the 60 IRQ vectors at the head of flash, reset entry (copy .data from its load address in flash, clear .bss, run the C++ static constructors, call main; the core has already loaded MSP from vector 0), and a default handler that executes BKPT so a stray interrupt becomes one line on the serial monitor rather than a silent spin.
  • link.ld: flash di 0x0800_0000 sebesar 64 KB, SRAM di 0x2000_0000 sebesar 20 KB, stack dari puncak SRAM, dengan assert bahwa data statis menyisakan 2 KB untuk stack.
  • stm32f103.h: setiap register di bagian 3 sebagai makro volatile dengan nama ST yang asli (GPIOC->ODR, RCC->APB2ENR, TIM3->CCR1, USART1->DR, ADC1->SQR3), plus konstanta bit dan nomor IRQ.
  • arduino.h: permukaan sketch yang sama seperti runtime Uno dan Black Pill, di pin komponen ini: pinMode, digitalWrite, digitalRead, analogRead, analogWrite, delay, delayMicroseconds, millis, micros, Serial, attachInterrupt, shiftOut, map, random. Nomor pin adalah nama portnya: PA0, PB9, PC13 adalah konstanta, dan LED_BUILTIN adalah PC13. Ada satu pinMode tambahan, INPUT_ANALOG, karena konverter F1 hanya boleh mengambil sampel pin yang CNF-nya mengatakan demikian.

millis() berasal dari SysTick pada 1 kHz (reload 71,999). micros() berasal dari TIM2 pada 1 MHz (PSC = 71, ARR = 0xFFFF) diperpanjang ke 32 bit di software: setiap counter pada komponen ini enam belas bit, jadi TIM2 overflow setiap 65.536 ms dan interrupt update-nya membawa setengah atasnya. micros() membaca kedua bagian itu dengan pengamanan terhadap overflow yang terjadi di antara keduanya, dan memasukkan overflow yang handler-nya belum berjalan, itulah makna noInterrupts() di sekitar pemanggilan micros(). Lima belas interrupt per detik bukan apa-apa dibanding seribu milik SysTick. delay() memarkir core di WFI sampai hitungan SysTick mencapai batas waktu; delayMicroseconds() busy-wait pada micros().

analogRead(pin) mengembalikan dua belas bit milik konverter itu sendiri, 0 pada 0 V dan 4095 pada 3.3 V, bukan sepuluh seperti yang dikembalikan Arduino: ADC komponen ini memang dua belas bit dan membulatkannya ke bawah agar terlihat seperti AVR akan membuang dua bit tanpa alasan. Panggilan pertama membangunkan ADC1, mengatur ADCPRE ke /6 dan menjalankan urutan reset-kalibrasi. Sepuluh pin itu adalah PA0..PA7, PB0 dan PB1; pin lain mengembalikan 0.

analogWrite(pin, 0..255) menggerakkan PWM pada 1 kHz, seperti STM32duino (PWM_FREQUENCY 1000: PSC = 1, tick 36 MHz, dan ARR = 35,999, yaitu 72 MHz / 2 / 36,000), dengan CCRx = 36,000 x nilai / 255, penskalaan setCaptureCompare milik core, pada sepuluh pin:

timer channel 1 channel 2 channel 3 channel 4
TIM3 PA6 PA7 PB0 PB1
TIM4 PB6 PB7 PB8 PB9
TIM1 PA8 tidak ada tidak ada PA11

PA0..PA3 are not PWM pins here, unlike on the Black Pill: TIM2 is the microsecond counter and it needs a whole timer to itself. TIM1's channels 2 and 3 are PA9 and PA10, which are Serial, so they are left out too. TIM1 needs BDTR.MOE, which the runtime sets when it starts that timer.

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.

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

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

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

UI memilih daftar firmware berdasarkan string program di katalog komponen (docs/sim-api.md bagian 3): "elf32 arm stm32f411" membaca /firmware/stm32/index.json dan "elf32 arm stm32f103" membaca /firmware/bluepill/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 basis, offset register dan posisi bit di bagian 2 dan 3 berasal dari manual referensi STM32F1 (RM0008) dan lembar data STM32F103C8: RCC di 0x4002_1000, GPIOA/B/C di 0x4001_0800/0C00/1000 dengan nibble konfigurasi empat bit khas F1 CRL/CRH, TIM1 sampai TIM4, USART1 sampai USART3, AFIO di 0x4001_0000, EXTI di 0x4001_0400 dan ADC1 di 0x4001_2400, dengan SRAM 20 KB dan flash 64 KB. crates/stm32f103/tests/firmware.rs memuat ELF sungguhan dan menggerakkan GPIO, timer, USART1, ADC1, SysTick dan EXTI melaluinya. Urutan header empat puluh pin Blue Pill, LED PC13-nya yang disambung anoda ke rail, dan fakta bahwa PA15, PB3 dan PB4 mula-mula muncul sebagai pin JTAG adalah milik board itu sendiri.

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

  • Clock saat boot adalah 72 MHz. Blue Pill sungguhan yang tidak pernah mengatur PLL berjalan di 8 MHz dari HSI; di sini program yang tidak pernah menyentuh register clock berjalan di 72 MHz, itulah yang diasumsikan runtime Arduino Mokxi. Begitu program menulis register clock, PLL, osilator dan prescaler diikuti (bagian 3.1); latensi flash tidak.
  • Slice ini punya dua percepatan, dan penyimpanan pertama setelah waktu tenang terjadi lebih awal, sampai 7,1 us. Segala sesuatu di dalam satu burst adalah eksak. Penalarannya sama dengan docs/stm32f411.md bagian 7.
  • ADC1 tidak punya error. Satu konversi adalah garis lurus terhadap VREF+ = 3,3 V, disampel pada saat ia dimulai, tanpa sample-and-hold, tanpa impedansi input, tanpa nonlinieritas, tanpa noise, dan tanpa offset yang perlu dikalibrasi seperti ADC F103 sungguhan (bit CAL di ADC_CR2 diterima dan tidak berbuat apa-apa di sini).
  • Pad-nya adalah tiga keadaan dan satu ambang. Push-pull pada 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.
  • Board-nya adalah suplai ideal: 3V3 dan 5V pada impedansi rail selamanya, jadi tidak ada yang brown out dan regulator (yang pada Blue Pill kloning sering kali adalah komponen yang salah dan alasan board-nya mati) tidak ada di sini. Startup satu mikrodetik, tanpa pin boot dan tanpa option bytes.
  • Tidak ada tombol pengguna, karena board-nya memang tidak punya; satu-satunya tombol menahan NRST rendah dan datang melalui poke.

Sengaja tidak ada, seperti didaftar di bagian 3.8: clock tree dan latensi flash, DMA, USB (jadi Serial sampai ke monitor melalui kanal host dan PA11/PA12 tetap GPIO biasa), CAN, I2C, SPI, RTC dan register backup, watchdog, input break dan output komplementer TIM1, ADC2, grup injected dan analog watchdog milik ADC, serta pemrograman flash.

8. Upload ke board sungguhan

"Upload ke board" menulis sketch ke Blue Pill sungguhan melalui bootloader system memory F103 di USART1, seperti yang dijelaskan AN3155 dari ST (web/src/hardware/stm32-serial.ts, kartunya di stm32-upload-dialog.ts).

  • Build. Build hardware adalah runtime simulator ditambah firmware/bluepill/hardware/clocks.c di bawah -DMOKXI_HARDWARE (hardwareBundle di web/src/compile/bundles.ts). Chip sungguhan keluar dari reset pada HSI 8 MHz; mokxi_hw_init() menyalakan kristal 8 MHz, mengatur dua wait state flash dan prefetch buffer, APB1 /2, APB2 /1, ADC /6, dan menjalankan SYSCLK dari PLL pada 72 MHz. Itulah tepat F_CPU, F_APB1, F_APB2 dan F_TIM yang diasumsikan stm32f103.h. Tanpa kristal, ia tetap di HSI. Alamat link sama (0x08000000), jadi link script-nya dipakai bersama. ELF simulator dipinkan di hardware-build.test.ts.
  • Kabel. Adapter serial USB pada 3,3 V: TX ke A10, RX ke A9, GND ke G. BOOT0 ke 1, lalu RESET, memulai ROM loader. Setelah upload, BOOT0 kembali ke 0.
  • Protokol. 115200 baud, 8E1. 0x7F sync, Get, Get ID (0x410 pada F103C8), Erase (0x43) atau Extended Erase (0x44) sesuai versi loader, Write Memory dalam blok 256 byte, Read Memory untuk memeriksa setiap blok, lalu Go ke 0x08000000. NACK saat erase berarti proteksi baca aktif, dan kartu menjelaskan cara menghapusnya.
  • Belum dicoba di board sungguhan. Flasher diuji hanya terhadap loader palsu (testing/fake-stm32.ts).