Placas

A WCH CH32V003

Um chip RISC-V de 48 MHz com 16 KB de flash e 2 KB de RAM, num breakout de vinte pinos. O Mokxi roda Blink, Serial e o ADC nele.

A visão geral, com exemplos rodando, está na página da placa.

O que é

O CH32V003 é o microcontrolador mais barato da WCH: um núcleo QingKe V2A que implementa RV32EC (a base do RISC-V com dezesseis registradores, instruções comprimidas e sem multiplicação nem divisão), rodando a até 48 MHz a partir de um oscilador interno de 24 MHz e um PLL. O componente aqui é o CH32V003F4P6, o encapsulamento TSSOP-20, numa placa de breakout que traz seus pinos para duas fileiras de furos de 0,1 polegada separadas por 0,6 polegada, de modo que ela atravessa o canal da protoboard. Não tem LED de usuário nem botões. VDD é uma alimentação de 3,3 V e GND é o terra, sempre ativos.

Pinos e números de pino

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 Nome Também
1 PD4 A7
2 PD5 A5, TX da USART1
3 PD6 A6, RX da USART1
4 PD7 um GPIO comum aqui (veja abaixo)
5 PA1 A1
6 PA2 A0
7 GND terra
8 VDD Fonte de 3,3 V
9 PC0
10 PC1 SDA do I2C no chip real
11 PC2 SCL do I2C no chip real
12 PC3
13 PC4 A2
14 PC5 SCK do SPI no chip real
15 PC6 MOSI do SPI no chip real
16 PC7 MISO do SPI no chip real
17 PD0
18 PD1 SWIO, o pino de programação
19 PD2 A3
20 PD3 A4

No breakout, a fileira da esquerda são os pinos 1 a 10 de cima para baixo e a da direita são os pinos 20 a 11, como um encapsulamento é numerado.

A0 a A7 são os canais 0 a 7 do ADC1. analogRead() retorna dez bits, de 0 a 1023, contra VDD.

O clock e portas que ficam desligadas

É o programa que configura o clock. Depois de um reset o chip roda a partir do oscilador de 24 MHz dividido por três, 8 MHz; o runtime do Mokxi liga o PLL e roda a 48 MHz antes do setup(), como o core do Arduino faz, e cada instrução leva 1/48 de microssegundo. Um programa que não mexe no clock roda seis vezes mais devagar, como rodaria na bancada.

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 é a USART1, com TX em PD5 e RX em PD6, ligada ao monitor serial. Ela funciona por polling. Ainda não há buffer de recepção nem interrupção, e a USART guarda um byte, então um segundo byte que chega antes de o primeiro ser lido é perdido, como acontece no chip com a interrupção desligada. O exemplo Serial verifica Serial.available() o tempo todo e nunca espera em delay().

What is modeled

O core como RV32EC com uma instrução por clock, a árvore de clock (HSI, o PLL e o prescaler AHB), as portas GPIO A, C e D com os modos push-pull, dreno aberto, pull-up, pull-down e analógico e o clock gating mencionado, a USART1 nos pinos padrão, a ADC1 como uma conversão de dez bits disparada por software, e o SysTick por trás de millis(), micros() e delay(). Os endereços e offsets dos registradores são os do manual de referência; o contrato em docs/plans/ch32v003.md lista os poucos que são presumidos, e não verificados.

O que não é modelado

  • Interrupções. A PFIC não é modelada, então as interrupções do SysTick, do EXTI e da USART nunca disparam e attachInterrupt() não existe. Um programa faz polling.
  • PWM, então sem analogWrite() nem tone(), e I2C e SPI, então sem Wire ou SPI. Isso fica para a próxima versão.
  • Remapeamento de pinos da USART e da AFIO, os option bytes, a gravação da flash, o watchdog independente e o despertar automático.
  • As instruções comprimidas XW da WCH, e a armadilha que o núcleo real dispara nos registradores x16 em diante. Um programa compilado com o próprio compilador da WCH que usa XW gera trap aqui.
  • PD7 como pino de reset. Num chip de fábrica, PD7 pode ser NRST dependendo dos seus option bytes; aqui é um GPIO comum.
  • String, Stream e as bibliotecas: 16 KB de flash e 2 KB de RAM não comportam tudo isso, então o catálogo de bibliotecas do Arduino não se aplica a esta placa.

Common mistakes

Escrever num registrador de porta antes de ativar seu clock. Nada acontece, no chip e aqui.

Esperar que delay() durma. É uma espera ocupada no SysTick, então a simulação executa cada instrução dela.

Ligar um LED à placa e esperar um LED_BUILTIN. O breakout não tem nenhum; ligue um LED e um resistor de um pino ao GND.

Projetos iniciais

Blink pisca um LED no PD2 por meio de um resistor de 330 ohms. Button acende o LED enquanto um botão de pressão no PC4 está pressionado. Serial imprime uma contagem a cada segundo e ecoa o que você digita. Knob lê um potenciômetro no PC4 com o ADC.

  • A página da placa: /boards/ch32v003
  • Uma vizinha RISC-V com muito mais espaço: a ESP32-C3
  • O plano e o contrato do modelo do chip: docs/plans/ch32v003.md