Bo mạch

WCH CH32V003

Một chip RISC-V 48 MHz với 16 KB flash và 2 KB RAM, trên board breakout hai mươi chân. Mokxi chạy được Blink, Serial và ADC trên nó.

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() hay tone(), và I2C với SPI, nên không có Wire hay SPI. Đâ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.
  • PD7 là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, Stream và 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.

  • 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