Tổng quan, kèm các ví dụ đang chạy, nằm ở trang bo mạch.
Đây là gì
CH32V003 là vi điều khiển rẻ nhất của WCH: nhân QingKe V2A triển khai RV32EC (tập cơ bản RISC-V với mười sáu thanh ghi, lệnh nén và không có phép nhân hay chia), chạy tối đa 48 MHz từ bộ dao động nội 24 MHz và một PLL. Linh kiện ở đây là CH32V003F4P6, kiểu đóng gói TSSOP-20, trên một bo chuyển đổi đưa các chân ra hai hàng lỗ cách nhau 0.1 inch, hai hàng cách nhau 0.6 inch, nên nó bắt qua rãnh của breadboard. Nó không có LED cho người dùng và không có nút nhấn. VDD là nguồn 3.3 V và GND là đất, luôn có điện.
Các chân và số chân
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 | Tên | Ngoài ra |
|---|---|---|
| 1 | PD4 |
A7 |
| 2 | PD5 |
A5, TX của USART1 |
| 3 | PD6 |
A6, RX của USART1 |
| 4 | PD7 |
chỉ là GPIO thường ở đây (xem bên dưới) |
| 5 | PA1 |
A1 |
| 6 | PA2 |
A0 |
| 7 | GND |
mass |
| 8 | VDD |
Nguồn 3.3 V |
| 9 | PC0 |
|
| 10 | PC1 |
SDA của I2C trên chip thật |
| 11 | PC2 |
SCL của I2C trên chip thật |
| 12 | PC3 |
|
| 13 | PC4 |
A2 |
| 14 | PC5 |
SCK của SPI trên chip thật |
| 15 | PC6 |
MOSI của SPI trên chip thật |
| 16 | PC7 |
MISO của SPI trên chip thật |
| 17 | PD0 |
|
| 18 | PD1 |
SWIO, chân nạp chương trình |
| 19 | PD2 |
A3 |
| 20 | PD3 |
A4 |
Trên bo chuyển đổi, cột trái là các chân 1 đến 10 từ trên xuống và cột phải là chân 20 xuống 11, đúng như cách đánh số của kiểu đóng gói.
A0 đến A7 là các kênh 0 đến 7 của ADC1. analogRead() trả về mười bit, từ 0 đến 1023, so với VDD.
Xung nhịp và các cổng bị tắt
Chương trình tự đặt xung nhịp. Sau khi reset, chip chạy từ bộ dao động 24 MHz chia ba, tức 8 MHz; runtime của Mokxi bật PLL và chạy ở 48 MHz trước setup(), giống lõi Arduino, và mỗi lệnh mất 1/48 microgiây. Chương trình nào không đụng vào xung nhịp sẽ chạy chậm hơn sáu lần, như trên bàn thật.
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 là USART1, với TX trên PD5 và RX trên PD6, nối tới serial monitor. Nó chạy theo kiểu hỏi vòng. Chưa có bộ đệm nhận và chưa có ngắt, và USART giữ đúng một byte, nên byte thứ hai đến trước khi byte thứ nhất được đọc sẽ bị mất, như trên chip thật khi ngắt bị tắt. Ví dụ Serial kiểm tra Serial.available() liên tục và không bao giờ chờ trong delay().
What is modeled
Lõi là RV32EC với một lệnh mỗi chu kỳ, cây xung nhịp (HSI, PLL và bộ chia AHB), các cổng GPIO A, C và D với các chế độ đẩy-kéo, hở đầu ra, điện trở kéo lên, kéo xuống và analog cùng việc chặn xung nhịp nói trên, USART1 trên các chân mặc định, ADC1 là bộ chuyển đổi mười bit kích hoạt bằng phần mềm, và SysTick đứng sau millis(), micros() và delay(). Địa chỉ và độ lệch thanh ghi theo đúng tài liệu tham khảo; phần ghi chép trong docs/plans/ch32v003.md liệt kê vài chỗ chỉ là suy đoán chứ chưa được kiểm tra.
Những gì không được mô hình hóa
- Ngắt. PFIC chưa được mô hình hóa, nên các ngắt SysTick, EXTI và USART không bao giờ kích hoạt và
attachInterrupt()không tồn tại. Chương trình phải hỏi vòng. - PWM, nên không có
analogWrite()haytone(), và I2C với SPI, nên không cóWirehaySPI. Đây là việc của phiên bản tới. - Remap chân USART và AFIO, các byte tùy chọn, nạp flash, watchdog độc lập và tự động thức giấc.
- Các lệnh nén XW của WCH, và bẫy mà lõi thật mắc vào với các thanh ghi x16 trở lên. Chương trình biên dịch bằng chính trình biên dịch của WCH mà dùng XW sẽ bị bẫy ở đây.
PD7làm chân reset. Trên chip xuất xưởng, PD7 có thể là NRST tùy vào byte tùy chọn; ở đây nó chỉ là GPIO thường.String,Streamvà các thư viện: 16 KB flash và 2 KB RAM không đủ chứa, nên danh mục thư viện Arduino không áp dụng cho bo mạch này.
Common mistakes
Ghi vào thanh ghi cổng trước khi bật xung nhịp của nó. Không có gì xảy ra, trên chip thật cũng như ở đây.
Mong delay() ngủ. Nó là vòng chờ bận trên SysTick, nên bản mô phỏng chạy từng lệnh của nó.
Nối LED vào bo mạch và mong chờ LED_BUILTIN. Bo chuyển đổi không có; hãy nối một LED và một điện trở từ một chân tới GND.
Dự án khởi đầu
Blink nhấp nháy một LED ở chân PD2 qua điện trở 330 ohm. Button sáng LED khi nút nhấn ở chân PC4 được giữ. Serial in một bộ đếm mỗi giây và lặp lại những gì bạn gõ. Knob đọc một chiết áp ở chân PC4 bằng ADC.
Related
- Trang bo mạch: /boards/ch32v003
- Một người hàng xóm RISC-V rộng rãi hơn nhiều: ESP32-C3
- Kế hoạch và hợp đồng cho mô hình chip:
docs/plans/ch32v003.md