目录

  • 沁恒 CH32V208(一): CH32V208WBU6 评估板上手报告和Win10环境配置

CH32V208

CH32V208系列是沁恒32位RISC-V中比较新的一个系列, 基于青稞RISC-V4C内核, 最高144MHz主频, 64KB SRAM,128KB Flash, 供电电压2.5/3.3V.

这个型号的特点: 除了特有的硬件堆栈区、快速中断入口, 片上集成了 2Mbps低功耗蓝牙BLE 5.3, 10M以太网MAC+PHY, USB2.0全速设备+主机/设备接口, CAN控制器.

10M以太网是带 PHY 的, 可以直连网口, 省掉焊接LAN8720了

主要参数

  • Qingke V4C processor, up to 144MHz system clock frequency.
  • Single-cycle multiplication and hardware division.
  • 64KB SRAM, 128KB Flash.
  • Supply voltage: 2.5V/3.3V. GPIO unit is supplied independently.
  • Low-power modes: sleep/stop/standby.
  • Bluetooth Low Energy 5.3.
  • 10M Ethernet controller (MAC+PHY).
  • Power-on/power-down reset (POR/PDR), programmable voltage detector (PVD).
  • 2 amplifiers.
  • 16-channel 12-bit ADC, 16-channel TouchKey.
  • 5 timers.
  • USB2.0 full-speed host/device + device interface.
  • 4 USARTs.
  • One CAN interface (2.0B active).
  • 2 IIC interfaces, 2 SPI interfaces.
  • 53 I/O ports, can be mapped to 16 external interrupts.
  • CRC calculation unit, 96-bit unique ID.
  • Serial 2-wire debug interface.
  • Packages: LQFP64M, QFN68, QFN48, QFN28.

相关资料

  • CH32V208 产品页, 手册和示例下载 https://www.wch.cn/products/CH32V208.html

硬件部分CH32V208WBU6 评估板

这个板比较大, 尺寸8.6cm * 9.5cm, 上面集成了蓝牙天线, RJ45网口, 两个USB-A母口

  • 有电源开关, 开关是用于控制TypeC口的供电的, 如果通过SWD口供电, 这个开关无效
  • 烧录是通过评估板右上角, 编号为4的2×5排针, 排针布局正好和WCH-Link 的排针布局一致
  • 三颗LED, 一颗电源指示, 两颗未连接但是有对应的排针(LED1和LED2), 可以自己用跳线连到其他pin口方便观察输出

烧录器 WCH-Link

烧录 CH32V208 可以用 WCH-Link 或 WCH-LinkE

软件部分开发环境

Win10下的开发环境比较简单, 使用软件 MounRiver, 当前版本v1.84, 可以支持沁恒全系列的RISC-V芯片. 下载地址 http://mounriver.com/download

软件集成了代码编辑, 编译环境和烧录工具. 直接安装即可. 基于 Eclipse 开发, 需要熟悉一下 Eclipse 的快捷键.

注意要使用较新的版本, 旧版本不支持 CH32V208

MounRiver的使用说明参考官方专栏, 介绍得较为详细

示例代码

从 CH32V208 产品页 https://www.wch.cn/products/CH32V208.html 可以找到 CH32V208 评估板说明及应用参考例程 CH32V20xEVT.ZIP

下载后, 解压得到的目录结构如下, 其中 PUB 下是评估板的说明和电路图, EXAM 下是按外设区分的各个例程的子目录

|-- PUB: |      |-- CH32V20x评估板说明书.pdf:CH32V20x评估板说明及工程创建说明|      |-- CH32V20xSCH.pdf:CH32V20x评估板原理图|-- EXAM: |      |-- SRC  |      |      |-- Core:内核系统头文件|      |      |-- Debug:延时函数、串口调试源文件及头文件|      |      |-- Ld:ld文件  |      |      |-- Peripheral:基本外设驱动源文件及头文件|      |      |-- Startup:启动文件。针对用户使用芯片型号包含下列相应的启动文件,同时在ch32v20x.h文件中选择匹配芯片型号定义 |      |      |      |-- startup_ch32v20x_D6.S:适用于CH32V203F6-CH32V203G6-CH32V203K6-CH32V203K8-CH32V203C6-CH32V203C8系列|      |      |      |-- startup_ch32v20x_D8.S:适用于CH32V203RB系列|      |      |      |-- startup_ch32v20x_D8W.S:适用于CH32V208系列  |      |-- ADC ADC 例程|      |-- BLE ——仅适用于CH32V20x_D8W  |      |-- BKP:BKP例程|      |-- CAN  ——仅适用于CH32V20x_D6-CH32V20x_D8W|      |-- CRC:CRC例程  |      |-- DMA|      |-- ETH ——仅适用于CH32V20x_D8-CH32V20x_D8W|      |-- EXTI:外部中断线例程|      |-- FLASH:FLASH的擦/读/写,以及快速编程|      |-- FreeRTOS:FreeRTOS移植例程  |      |-- GPIO:GPIO例程|      |-- HarmonyOS:HarmonyOS移植例程  |      |-- I2C|      |-- INT|      |-- IAP:IAP升级例程-内置Hex转Bin工具和IAP升级工具  |      |-- IWDG:独立看门狗例程|      |-- OPA:OPA4作电压跟随器输出例程|      |-- PWR|      |-- RCC|      |-- RT-Thread:RT-Thread移植例程 |      |-- RTC:日历例程  |      |-- SPI|      |-- TencentOS:TencentOS移植例程       |      |-- TIM|      |-- TOUCHKEY:TouchKey检测例程 |      |-- USART|      |-- USB|      |-- WWDG:窗口看门狗例程

运行LED闪灯示例代码

下面以最简单的GPIO示例走一遍编译烧录的过程

连线

开发板 —> WCHLink, 注意不要连USB口, 如果已经通过PC的USB口连接了开发板, 就不要连WCHLink VCC, 如果连了WCHLink VCC, 就不要接USB口

  • CLK -> SWCLK
  • DIO -> SWDIO
  • GND -> GND
  • VDD -> 3V3
  • TXD -> RX (可以不连)
  • RXD -> TX (可以不连)

开发板本身

  • 连接一个LED到 PA0, 用于观察PA0的输出

编译项目

下载的示例代码解压后, 在MounRiver中 File -> Load -> Project, 打开 EVT\EXAM\GPIO\GPIO_Toggle 目录下的 GPIO_Toggle.wvproj

按 Shift + F7 或通过工具栏按钮编译即可. 编译正常会显示

12:08:14 **** Build of configuration obj for project GPIO_Toggle ****make -j4 all    text   data    bss    dec    hexfilename   6908    136   2072   9116   239cGPIO_Toggle.elf12:08:19 Build Finished. 0 errors, 0 warnings. (took 5s.11ms)

示例项目中默认的构建结果为 hex 文件, 编译结束后在 obj 目录下能看到 GPIO_Toggle.hex

编译中的选项1. 修改构建目标格式

  • 项目树中选中当前项目
  • 菜单 Project -> Properties
  • 对话框 C/C++ Build -> Settings -> GNU RISC-V Cross Create Flash Image -> General
  • 对话框 Output file format (-O): 选择 Raw Binary 编译会输出bin, Intel HEX 则会输出 hex

2. 显示完整编译命令和输出

完整编译命令和输出对判断问题非常重要, 可以通过菜单 Project -> Concise Build Output Mode 打开

  • 勾选则只显示简单提示, 默认是勾选
  • 取消勾选, 则显示完整编译命令和输出

3. 设置C编译参数, 修改目标MCU

GPIO_Toggle 示例代码, 使用的编译目标MCU是 CH32V20x_D6, 在 ch32v20x.h 中的这段代码中可以看到, 默认启用的是 CH32V20x_D6

#if !defined(CH32V20x_D8W) && !defined(CH32V20x_D8) && !defined(CH32V20x_D6)#define CH32V20x_D6              /* CH32V203F6-CH32V203F8-CH32V203G6-CH32V203G8-CH32V203K6-CH32V203K8-CH32V203C6-CH32V203C8 *///#define CH32V20x_D8              /* CH32V203RBT6 *///#define CH32V20x_D8W             /* CH32V208 */

对于当前评估板应当使用 CH32V20x_D8W, 可以通过在 MounRiver 添加 GNU C 参数进行设置

  • 菜单 Project -> Properties
  • C/C++ General -> Paths and Symbols
  • #Symbols 标签页 -> GNU C
  • Add, 增加一项 CH32V20x_D8W, 不需要填值, 确定

返回到编辑器后, 能看到上面的代码段已经变灰, 编译命令中出现了对应的参数-DCH32V20x_D8W

riscv-none-embed-gcc -march=rv32imacxw -mabi=ilp32 -msmall-data-limit=8 -msave-restore -Os -fmessage-length=0 -fsigned-char -ffunction-sections -fdata-sections -fno-common -Wunused -Wuninitialized  -g -DCH32V20x_D8W -I"D:\WorkMRS\ch32v208_ws\EVT\EXAM\SRC\Debug" -I"D:\WorkMRS\ch32v208_ws\EVT\EXAM\SRC\Core" -I"D:\WorkMRS\ch32v208_ws\EVT\EXAM\GPIO\GPIO_Toggle\User" -I"D:\WorkMRS\ch32v208_ws\EVT\EXAM\SRC\Peripheral\inc" -std=gnu99 -MMD -MP -MF"User/system_ch32v20x.d" -MT"User/system_ch32v20x.o" -c -o "User/system_ch32v20x.o" "../User/system_ch32v20x.c"

下载/烧录

通过 WCH-Link 连接开发板之后, 在 MounRiver 中通过菜单 Flash -> Configuration 可以打开下载设置

点击第一个图标 Query Status 查询芯片状态, 连接成功后底下会显示 0000#07:48:33:283>> Query Success, 同时会显示红色的 Code Read-Protect Status Disabled 或绿色的 Code Read-Protect Status Enabled, 红色的表示读保护关闭, 这时候可以烧录, 如果是绿色表示读保护打开, 需要关闭后才能烧录. 下面 Target 中会显示检测到的MCU类型, 写入开始地址 0x08000000, 以及要写入的文件 obj\GPIO_Toggle.hex

以上无误后, 应用保存, 按 F8 或点击工具栏图标烧录, 烧录过程输出

------------ Begin flash process of "obj\GPIO_Toggle.hex" ------------ 12:14:11:930 >> Current project vendor is WCH, debugger is WCH-Link12:14:11:930 >> Attempt to open link device and upgrade firmware if necessary...12:14:11:987 >> Link Device is CH549. Already the latest version v2.8, no need to upgrade12:14:12:059 >> Starting to Send Chip Type...12:14:12:102 >> Send Chip Type Success12:14:12:102 >> Starting to Check Read-Protect Status...12:14:12:103 >> Read-Protect Status Currently Disabled12:14:12:103 >> Starting to Erase All...12:14:12:242 >> Erase All Success12:14:12:244 >> Starting to Download & Verify...12:14:13:077 >> Download & Verify Success12:14:13:077 >> Starting to Reset...12:14:13:090 >> Reset Success12:14:13:090 >> Starting to Close Link...12:14:13:092 >> Close Link Success---------------------------------End ---------------------------------Operation Finished (took 1s.166ms)

烧录成功后就能看到连接的LED开始闪烁

问题处理WCH CMSIS-DAP 驱动不识别(黄色感叹号)

当使用过旧版 WCH-DAPLink 或者安装中未正常升级, 在连接DAPLink模式的 WCH-Link 后, 设备管理器显示带黄色警告的WCH CMSIS-DAP, 此时在 WCH-LinkUtility里是无法找到WCHLink的, 需要先安装驱动. 沁恒并没有单独提供这个驱动的下载, 但是在安装了 MounRiver 之后, 其目录下实际上是包含了对应驱动的.

  1. 在 WCH CMSIS-DAP 上右键更新驱动
  2. 选择浏览电脑, 搜索路径设成 MounRiver 的安装目录 (默认为 C:\MounRiver), 勾选包含子文件夹
  3. 下一步, 就会自动安装

WCH CMSIS-DAP 切换为 RISC-V 模式的 WCH-Link

首先电脑要能正确识别 CMSIS-DAP 模式的 WCH-Link, 如果驱动未安装, 可以参考上一步. 在 CMSIS-DAP 模式下, WCH-Link 的 CON 灯是常亮的.

  1. 打开 WCH-LinkUtility, 点击下方 Active WCH-Link Mode 右边的 GET, 就能看到当前的模式为 WCH-LinkDAP-WINUSB
  2. 在模式中选择 WCH-LinkRV, 再点击 SET, 就会开始更新固件, 切换到 RISC-V 模式
  3. 切换完成后, CON灯常灭