Kedipkan Blue Pill dengan menulis register sendiri
Atau lihat semua pelajaran.
- 526komponen di meja kerja
- 46board sedang berjalan
- 1.00xwaktu nyata, di semua board
pinMode dan digitalWrite menyembunyikan tiga penulisan register. Di STM32, ketiga penulisan itu layak dipelajari, karena saat kamu pindah dari core Arduino ke HAL milik vendor atau ke bare metal, itulah yang dilakukan setiap fungsi GPIO, dan bug STM32 paling umum bersembunyi di penulisan yang pertama.
Rangkaian di atas adalah STM32F103 Blue Pill dengan LED dan resistor 1 k dari 3.3 V ke PC13, pin yang sama dengan LED hijau milik board itu sendiri. Sketch ini mengedipkannya tanpa pinMode atau digitalWrite, dan sebelum mulai, sketch mencetak tiga nilai register. Tekan Jalankan dan serial monitor akan terbaca:
Tiga baris itu adalah "CRH dengan clock port C mati: 0x0", lalu "CRH setelah IOPCEN, nilai reset: 0x44444444", lalu "CRH dengan PC13 sebagai output: 0x44244444". Setelah itu, kedua LED berkedip sekali per detik.
Langkah 1: nyalakan clock port
Setiap peripheral di STM32 dimulai dengan clock-nya dalam keadaan mati untuk menghemat daya, dan peripheral tanpa clock tidak melakukan apa pun. Clock dari GPIO port C adalah bit 4 dari RCC->APB2ENR, bernama IOPCEN. Sampai bit itu di-set, register port terbaca nol dan mengabaikan penulisan.
Sketch ini membuktikannya. Ia menulis nilai ke GPIOC->CRH sebelum mengaktifkan clock dan membaca kembali 0x0: penulisan itu tidak pernah sampai. Setelah RCC->APB2ENR |= RCC_APB2ENR_IOPCEN, register yang sama terbaca 0x44444444, nilai resetnya. Di hardware sungguhan, melupakan baris ini menghasilkan program yang terkompilasi, berjalan, dan sama sekali tidak melakukan apa pun, tanpa error di mana pun. Mokxi memodelkan gerbang ini dengan cara yang sama, sengaja.
Langkah 2: atur pin di CRH
F103 menjelaskan setiap pin dengan empat bit: dua untuk MODE (input, atau output pada 10, 2, atau 50 MHz) dan dua untuk CNF (push-pull, open-drain, atau alternate function). Pin 0 sampai 7 berada di CRL dan pin 8 sampai 15 di CRH. PC13 adalah nibble keenam dari CRH, bit 20 sampai 23.
Nilai reset 0x4 di setiap nibble berarti CNF 01, MODE 00: input mengambang. Sketch ini menghapus nibble PC13 dan menulis 0x2, MODE 10 (output, 2 MHz) dan CNF 00 (push-pull), itulah sebabnya baris ketiga terbaca 0x44244444: satu nibble berubah, sisanya tidak tersentuh. Keluarga STM32 yang lebih baru seperti F4 memakai tata letak berbeda (MODER, OTYPER, OSPEEDR), dan itulah hal pertama yang rusak saat kode F1 dipindahkan ke F4.
const uint32_t PIN = 13;
const uint32_t CRH_SHIFT = (PIN - 8) * 4; // bits 20..23
const uint32_t OUT_2MHZ_PUSH_PULL = 0x2; // CNF 00, MODE 10
void setup() {
RCC->APB2ENR |= RCC_APB2ENR_IOPCEN; // 1. clock on
uint32_t crh = GPIOC->CRH;
crh &= ~(0xFUL << CRH_SHIFT);
crh |= OUT_2MHZ_PUSH_PULL << CRH_SHIFT;
GPIOC->CRH = crh; // 2. PC13 an output
}
void loop() {
GPIOC->BSRR = 1UL << (PIN + 16); // 3. reset: low, LED on
delay(500);
GPIOC->BSRR = 1UL << PIN; // set: high, LED off
delay(500);
}Buka sketch ini di editorKodenya saja: editor menempatkan board dan komponen yang bisa dibacanya dari sketch.
Langkah 3: BSRR, dan kenapa bukan ODR
You could change the pin by reading ODR, the output register, flipping bit 13 and writing it back. BSRR is better. Writing a 1 to one of its low 16 bits sets that pin; writing a 1 to one of its high 16 bits resets it; zeros change nothing. It is a single write with no read first, so if an interrupt changes another pin on port C between your read and your write, BSRR cannot undo that change, and a read-modify-write of ODR can.
LED di PC13 disambung dari 3,3 V ke pin, jadi pin yang menyerap arusnya dan LED menyala saat pin bernilai rendah. Itu kebalikan dari pin 13 pada Uno, dan itulah alasan sketch mengeset ulang pin untuk menyalakan LED.
Kenapa resistornya 1 k, dan di mana letak HAL
PC13, PC14 dan PC15 adalah pin khusus pada F103. Pin-pin ini dialiri daya melalui saklar daya backup domain, dan datasheet ST membatasi arus yang diserapnya sampai sekitar 3 mA, pada frekuensi tidak lebih dari 2 MHz, dan menyatakan pin-pin ini tidak boleh dipakai sebagai sumber arus, misalnya untuk menyalakan LED dari pin ke ground. LED di Blue Pill disambung sebaliknya, dari 3,3 V masuk ke pin, melalui resistor 1 k: (3,3 - 2) / 1000 adalah sekitar 1,3 mA. Resistor 220 ohm di sana akan meminta sekitar 6 mA, jadi rangkaian ini memakai 1 k agar tetap dalam batas. Untuk LED lebih terang di board sungguhan, pilih pin biasa seperti PA5 dan resistor 330 ohm.
Library HAL dari ST melakukan tiga langkah yang sama dengan fungsi bernama: __HAL_RCC_GPIOC_CLK_ENABLE(), HAL_GPIO_Init() dengan GPIO_InitTypeDef, dan HAL_GPIO_WritePin() atau HAL_GPIO_TogglePin(), yang di belakangnya menulis ke BSRR. Mokxi tidak menjalankan biner HAL, karena HAL mulai dengan mengonfigurasi clock tree dan flash wait state, yang tidak dimodelkan; Blue Pill di sini berjalan pada 72 MHz tetap. Register di atas persis seperti yang ditulis oleh pemanggilan HAL tersebut.
Satu catatan dari dunia nyata: banyak board yang dijual sebagai Blue Pill membawa klon dari STM32F103, bukan chip buatan ST. Biasanya kode GPIO sederhana seperti ini tetap jalan, tapi bisa berbeda dalam ukuran flash dan dukungan debugger, jadi periksa tanda pada chip jika board berperilaku aneh.
Buka rangkaian ini di editor. Blue Pill: blink lewat register, dirangkai seperti yang berjalan di bagian atas halaman ini. Ubah komponen atau nilainya dan jalankan lagi.
Pertanyaan
Kenapa kode GPIO STM32-ku tidak melakukan apa-apa?
Penyebab paling umum adalah clock port yang tidak dinyalakan di RCC. Pada keluarga F1 clock GPIO ada di RCC->APB2ENR; pada F4 clock GPIO ada di RCC->AHB1ENR. Jika clock mati, penulisan diabaikan dan pembacaan mengembalikan nol.
Apakah LED Blue Pill active low?
Ya. LED disambung dari 3,3 V melalui resistor ke PC13, jadi menyala saat PC13 dibuat rendah.
Apa bedanya BSRR dan BRR?
BSRR bisa men-set pin (setengah bawah) dan mereset pin (setengah atas) dalam satu penulisan. BRR hanya bisa mereset. Keduanya membiarkan semua pin yang tidak kamu sebut tetap seperti semula.
Bisakah aku memakai fungsi Arduino dan register dalam sketch yang sama?
Bisa. Sketch ini masih memakai Serial dan delay() dari runtime. Jangan sampai keduanya menyentuh konfigurasi pin yang sama, atau yang terakhir menulis ke CRH akan menang.
Rakit versi nyatanya
Buka editor, ubah sebuah nilai, dan lihat angkanya ikut berubah. Tidak ada yang perlu dipasang, dan tidak perlu akun.