Tinjauannya, dengan contoh yang berjalan, ada di halaman board.
Apa ini
CH32V003 adalah mikrokontroler termurah dari WCH: core QingKe V2A yang menerapkan RV32EC (basis RISC-V dengan enam belas register, instruksi terkompresi, tanpa perkalian atau pembagian), dengan clock hingga 48 MHz dari osilator internal 24 MHz dan sebuah PLL. Komponen di sini adalah CH32V003F4P6, kemasan TSSOP-20, pada breakout yang mengeluarkan pin-pinnya ke dua baris lubang 0.1 inch berjarak 0.6 inch, sehingga mengangkangi celah breadboard. Tidak ada LED pengguna dan tidak ada tombol. VDD adalah catu daya 3.3 V dan GND adalah ground, selalu aktif.
Pin dan nomor pin
The twenty pins are named as the openwch Arduino core names them: PA1,
PA2, PC0 to PC7 and PD0 to PD7, plus VDD and GND. A sketch writes
pinMode(PD2, OUTPUT). A bare number is the port times 8 plus the bit, with A
at 0, C at 8 and D at 16, so PD2 is 18.
| Pin | Nama | Juga |
|---|---|---|
| 1 | PD4 |
A7 |
| 2 | PD5 |
A5, USART1 TX |
| 3 | PD6 |
A6, USART1 RX |
| 4 | PD7 |
di sini hanya GPIO biasa (lihat di bawah) |
| 5 | PA1 |
A1 |
| 6 | PA2 |
A0 |
| 7 | GND |
ground |
| 8 | VDD |
Suplai 3,3 V |
| 9 | PC0 |
|
| 10 | PC1 |
SDA I2C di chip asli |
| 11 | PC2 |
SCL I2C di chip asli |
| 12 | PC3 |
|
| 13 | PC4 |
A2 |
| 14 | PC5 |
SCK SPI di chip asli |
| 15 | PC6 |
MOSI SPI di chip asli |
| 16 | PC7 |
MISO SPI di chip asli |
| 17 | PD0 |
|
| 18 | PD1 |
SWIO, pin untuk pemrograman |
| 19 | PD2 |
A3 |
| 20 | PD3 |
A4 |
Di breakout, baris kiri adalah pin 1 sampai 10 dari atas, dan baris kanan adalah pin 20 turun ke 11, seperti penomoran pada paket.
A0 sampai A7 adalah kanal ADC1 0 sampai 7. analogRead() mengembalikan sepuluh bit, 0 sampai 1023, terhadap VDD.
Clock, dan port yang dimatikan
Program-lah yang mengatur clock. Setelah reset, chip berjalan dari osilator 24 MHz yang dibagi tiga, jadi 8 MHz; runtime Mokxi menyalakan PLL dan berjalan di 48 MHz sebelum setup(), seperti yang dilakukan Arduino core, dan setiap instruksi memakan waktu 1/48 mikrodetik. Program yang tidak mengubah clock berjalan enam kali lebih lambat, seperti di meja kerja.
A port ignores writes until its clock is enabled in RCC_APB2PCENR, and reads
as 0 until then. That is the chip's rule, and the first thing that bites a
program that writes the registers directly. pinMode() enables the clock for
you.
Serial
Serial adalah USART1, dengan TX di PD5 dan RX di PD6, tersambung ke Serial Monitor. Ia di-poll. Belum ada buffer penerima dan belum ada interrupt, dan USART menahan satu byte, jadi byte kedua yang tiba sebelum byte pertama dibaca akan hilang, seperti di chip dengan interrupt mati. Contoh Serial memeriksa Serial.available() terus-menerus dan tidak pernah menunggu di delay().
What is modeled
Core sebagai RV32EC dengan satu instruksi per clock, pohon clock (HSI, PLL, dan prescaler AHB), port GPIO A, C, dan D dengan mode push-pull, open drain, pull-up, pull-down, dan analog plus clock gating di atas, USART1 di pin bawaan, ADC1 sebagai konversi sepuluh bit yang dipicu perangkat lunak, dan SysTick di balik millis(), micros(), dan delay(). Alamat dan offset register mengikuti manual referensi; kontrak di docs/plans/ch32v003.md mencantumkan beberapa yang diperkirakan, bukan diperiksa.
Yang tidak dimodelkan
- Interrupt. PFIC tidak dimodelkan, jadi interrupt SysTick, EXTI, dan USART tidak pernah terpicu dan
attachInterrupt()tidak ada. Program melakukan polling. - PWM, jadi tidak ada
analogWrite()atautone(), serta I2C dan SPI, jadi tidak adaWireatauSPI. Itu semua untuk versi berikutnya. - Remap pin USART dan AFIO, option bytes, pemrograman flash, independent watchdog, dan auto wakeup.
- Instruksi terkompresi XW milik WCH, dan trap yang diambil core asli pada register x16 ke atas. Program yang dibangun dengan compiler milik WCH sendiri yang memakai XW akan trap di sini.
PD7sebagai pin reset. Di chip pabrik, PD7 bisa menjadi NRST tergantung option bytes-nya; di sini ia hanya GPIO biasa.String,Stream, dan library-library: flash 16 KB dan RAM 2 KB tidak cukup menampung semuanya, jadi katalog library Arduino tidak berlaku untuk board ini.
Common mistakes
Menulis ke register port sebelum mengaktifkan clock-nya. Tidak ada yang terjadi, di chip maupun di sini.
Mengira delay() itu tidur. Ia adalah busy wait pada SysTick, jadi simulasi menjalankan setiap instruksinya.
Menyambungkan LED ke board dan mengharapkan LED_BUILTIN. Breakout ini tidak punya; sambungkan LED dan resistor dari sebuah pin ke GND.
Proyek pemula
Blink menyalakan LED di PD2 melalui resistor 330 ohm. Button menyalakannya selama tombol tekan di PC4 ditahan. Serial mencetak hitungan tiap detik dan menampilkan kembali apa yang kamu ketik. Knob membaca potensiometer di PC4 dengan ADC.
Related
- Halaman board: /boards/ch32v003
- Tetangga RISC-V dengan ruang jauh lebih besar: ESP32-C3
- Rencana dan kontrak untuk model chip:
docs/plans/ch32v003.md