Placas

La WCH CH32V003

Un chip RISC-V de 48 MHz con 16 KB de flash y 2 KB de RAM, en una placa de conexión de veinte pines. Mokxi ejecuta Blink, Serial y el ADC en él.

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() ni tone(), y I2C y SPI, así que no hay Wire ni SPI. 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í.
  • PD7 como 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, Stream y 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.

  • 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