Board

WCH CH32V003

Chip RISC-V 48 MHz dengan 16 KB flash dan 2 KB RAM, pada breakout dua puluh pin. Mokxi menjalankan Blink, Serial dan ADC di sini.

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() atau tone(), serta I2C dan SPI, jadi tidak ada Wire atau SPI. 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.
  • PD7 sebagai 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.

  • Halaman board: /boards/ch32v003
  • Tetangga RISC-V dengan ruang jauh lebih besar: ESP32-C3
  • Rencana dan kontrak untuk model chip: docs/plans/ch32v003.md