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()nemtone(), e I2C e SPI, então semWireouSPI. 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.
PD7como pino de reset. Num chip de fábrica, PD7 pode ser NRST dependendo dos seus option bytes; aqui é um GPIO comum.String,Streame 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.
Related
- 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