La descripción general, con ejemplos en ejecución, está en la página de la placa.
Qué es
La CH32V003 es el microcontrolador más barato de WCH: un núcleo QingKe V2A que implementa RV32EC (la base de RISC-V con dieciséis registros, instrucciones comprimidas y sin multiplicación ni división), con velocidad de hasta 48 MHz desde un oscilador interno de 24 MHz y un PLL. El componente aquí es el CH32V003F4P6, el paquete TSSOP-20, sobre un breakout que saca sus pines a dos filas de agujeros de 0.1 pulgadas separadas 0.6 pulgadas, de modo que abraza el canal de una protoboard. No tiene LED de usuario ni botones. VDD es una alimentación de 3.3 V y GND es tierra, siempre activos.
Pines y números de 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 | Nombre | También |
|---|---|---|
| 1 | PD4 |
A7 |
| 2 | PD5 |
A5, TX de USART1 |
| 3 | PD6 |
A6, RX de USART1 |
| 4 | PD7 |
un GPIO normal aquí (ver abajo) |
| 5 | PA1 |
A1 |
| 6 | PA2 |
A0 |
| 7 | GND |
tierra |
| 8 | VDD |
Alimentación de 3.3 V |
| 9 | PC0 |
|
| 10 | PC1 |
SDA de I2C en el chip real |
| 11 | PC2 |
SCL de I2C en el chip real |
| 12 | PC3 |
|
| 13 | PC4 |
A2 |
| 14 | PC5 |
SCK de SPI en el chip real |
| 15 | PC6 |
MOSI de SPI en el chip real |
| 16 | PC7 |
MISO de SPI en el chip real |
| 17 | PD0 |
|
| 18 | PD1 |
SWIO, el pin de programación |
| 19 | PD2 |
A3 |
| 20 | PD3 |
A4 |
En el breakout, la fila izquierda son los pines 1 a 10 de arriba abajo y la fila derecha son los pines del 20 al 11, como se numera un paquete.
A0 a A7 son los canales 0 a 7 del ADC1. analogRead() devuelve diez bits, de 0 a 1023, contra VDD.
El reloj, y puertos que están apagados
El programa configura el reloj. Tras un reset el chip corre con el oscilador de 24 MHz dividido entre tres, 8 MHz; el runtime de Mokxi enciende el PLL y corre a 48 MHz antes de setup(), como lo hace el núcleo de Arduino, y cada instrucción toma 1/48 de microsegundo. Un programa que deja el reloj como está corre seis veces más lento, como lo haría en el banco de trabajo.
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.
Serie
Serial es USART1, con TX en PD5 y RX en PD6, conectado al monitor serie. Funciona por sondeo. Aún no hay búfer de recepción ni interrupción, y la USART guarda un byte, así que un segundo byte que llegue antes de leer el primero se pierde, como sucede en el chip con su interrupción apagada. El ejemplo de Serial revisa Serial.available() todo el tiempo y nunca espera en delay().
What is modeled
El núcleo como RV32EC con una instrucción por ciclo de reloj, el árbol de reloj (HSI, el PLL y el preescalador AHB), los puertos GPIO A, C y D con modos push-pull, drenador abierto, pull-up, pull-down y analógico, y el gating de reloj mencionado, USART1 en los pines predeterminados, ADC1 como una conversión de diez bits por disparo de software, y SysTick detrás de millis(), micros() y delay(). Las direcciones y offsets de registros son los del manual de referencia; el contrato en docs/plans/ch32v003.md enumera los pocos que se suponen en lugar de verificarse.
Lo que no está modelado
- Interrupciones. La PFIC no está modelada, así que las interrupciones de SysTick, EXTI y USART nunca se disparan y
attachInterrupt()no existe. Un programa sondea. - PWM, así que no hay
analogWrite()nitone(), y I2C y SPI, así que no hayWireniSPI. Eso es para la próxima versión. - Remapeos de pines de USART y AFIO, los bytes de opción, la programación de flash, el watchdog independiente y el despertar automático.
- Las instrucciones comprimidas XW de WCH, y la trampa que el núcleo real toma con los registros x16 en adelante. Un programa compilado con el compilador de WCH que use XW cae en la trampa aquí.
PD7como pin de reset. En un chip de fábrica PD7 puede ser NRST según sus bytes de opción; aquí es un GPIO normal.String,Streamy las bibliotecas: 16 KB de flash y 2 KB de RAM no las aguantan, así que el catálogo de bibliotecas de Arduino no aplica a esta placa.
Common mistakes
Escribir en un registro de puerto antes de habilitar su reloj. No pasa nada, en el chip y aquí.
Esperar que delay() duerma. Es una espera activa sobre SysTick, así que la simulación ejecuta cada una de sus instrucciones.
Conectar un LED a la placa y esperar LED_BUILTIN. El breakout no tiene ninguno; conecta un LED y una resistencia de un pin a GND.
Proyectos iniciales
Blink hace parpadear un LED en PD2 a través de una resistencia de 330 ohms. Button lo enciende mientras se mantiene presionado un botón en PC4. Serial imprime un conteo cada segundo y repite lo que escribes. Knob lee un potenciómetro en PC4 con el ADC.
Related
- La página de la placa: /boards/ch32v003
- Una vecina RISC-V con mucho más espacio: la ESP32-C3
- El plan y el contrato para el modelo del chip:
docs/plans/ch32v003.md