rt-thread-official/bsp/wch/risc-v/ch32v103r-evt/README.md

6.4 KiB
Raw Blame History

ch32v103r-evt BSP 说明

开发板简介

ch32v103r-evt 是基于 CH32V103 MCU 推出了一款开发板,包含 WCH-Link 调试器,具有丰富的外设,比较适合入门学习 RISC-V 架构。

开发板图片

2022-03-27_182300

基本硬件资源:

  • 青稞 V3A 处理器,最高 80MHz 系统主频;
  • 支持单周期乘法和硬件除法;
  • 20KB SRAM64KB CodeFlash
  • 供电范围2.7V ~ 5.5VGPIO同步供电电压
  • 多种低功耗模式:睡眠/停止/待机;
  • 上电/断电复位POR/PDR
  • 可编程电压监测器PVD
  • 7通道 DMA 控制器;
  • 16路 TouchKey 通道监测;
  • 16路12位 ADC 转换通道;
  • 7个定时器
  • 1个 USB2.0 主机/设备接口(全速和低速);
  • 2个 IIC 接口(支持 SMBus/PMBus
  • 3个 USART 接口;
  • 2个 SPI 接口(支持 Master 和 Slave 模式);
  • 51个 I/O 口,所有的 I/O 口都可以映射到16个外部中断
  • CRC 计算单元96位芯片唯一 ID
  • 串行单线调试SWD接口
  • 封装形式LQFP64M、LQFP48、QFN48。

更多信息和资源请访问 WCH CHV103

编译说明

板级包支持 RISC-V GCC 开发环境,以下是具体版本信息:

IDE/编译器 已测试版本
GCC WCH RISC-V GCC 8.2.0

外设支持

本 BSP 目前对外设驱动的支持情况如下:

驱动 支持情况 备注
UART 支持 USART 1
GPIO 支持 PA0...PE15

IO在板级支持包中的映射情况

IO号 板级包中的定义
PA9(默认与板载wch-link串口相连) USART1_TX
PA10(默认与板载wch-link串口相连) USART1_RX

使用说明

本章节是为刚接触 RT-Thread 的新手准备的使用说明,遵循简单的步骤即可将 RT-Thread 操作系统运行在该开发板上,看到实验效果 。

快速上手

本 BSP 为开发者提供 SCons编译配置。下面介绍如何将系统运行起来。

SCons 编译

需要先正确配置 RISC-V GCC 位置,推荐使用 RT_Studio 软件包里的

import os
ARCH     = 'risc-v'
CPU      = 'ch32v1'
# toolchains options
CROSS_TOOL  = 'gcc'

#------- toolchains path -------------------------------------------------------
if os.getenv('RTT_CC'):
    CROSS_TOOL = os.getenv('RTT_CC')

if  CROSS_TOOL == 'gcc':
    PLATFORM    = 'gcc'
    EXEC_PATH   = r'D:/Softwares/RT_ThreadStudio/repo/Extract/ToolChain_Support_Packages/WCH/RISC-V-GCC-WCH/8.2.0/bin'
else:
    print('Please make sure your toolchains is GNU GCC!')
    exit(0)

# if os.getenv('RTT_EXEC_PATH'):
    # EXEC_PATH = os.getenv('RTT_EXEC_PATH')

开始 scons 编译

LT@DESKTOP-WIN10 E:\WorkSpaces\rt-thread\bsp\wch\risc-v\ch32v103r-evt                             
>scons                                                                                           
scons: Reading SConscript files ...                                                               
Newlib version:3.0.0                                                                              
scons: done reading SConscript files.                                                             
scons: Building targets ...                                                                       
scons: building associated VariantDir targets: build                                              
CC build\applications\main.o                                                                      
CC build\board\board.o                                                                            
CC build\board\ch32v10x_it.o                                                                      
....                            
CC build\libraries\ch32_library\StdPeriph_Driver\src\ch32v10x_misc.o                              
CC build\libraries\ch32_library\StdPeriph_Driver\src\ch32v10x_pwr.o                               
CC build\libraries\ch32_library\StdPeriph_Driver\src\ch32v10x_rcc.o                               
CC build\libraries\ch32_library\StdPeriph_Driver\src\ch32v10x_rtc.o                               
CC build\libraries\ch32_library\StdPeriph_Driver\src\ch32v10x_spi.o                               
CC build\libraries\ch32_library\StdPeriph_Driver\src\ch32v10x_tim.o                               
CC build\libraries\ch32_library\StdPeriph_Driver\src\ch32v10x_usart.o                             
CC build\libraries\ch32_library\StdPeriph_Driver\src\ch32v10x_wwdg.o                              
LINK rtthread.elf                                                                                 
riscv-none-embed-objcopy -O binary rtthread.elf rtthread.bin                                      
riscv-none-embed-size rtthread.elf                                                                
text    data     bss     dec     hex filename                                                  
63540     392    8080   72012   1194c rtthread.elf                                              
scons: done building targets.                                                                     

硬件连接

使用数据线连接板载 wch-link 到 PC打开电源开关。

下载

打开WCH_RISC-V_Programmer下载软件选择bsp目录下生成的rtthread.bin 文件,单击执行进行下载。

image-20220404205018822

WCH_RISC-V_Programmer下载软件 可以从 MRS IDE中直接导出

运行结果

在终端工具里打开板载 wch-link 串口WCHDapLink SERIAL默认115200-8-1-N复位设备后在串口上可以看到 RT-Thread 的输出信息:


 \ | /
- RT -     Thread Operating System
 / | \     4.1.0 build Apr  4 2022 16:57:50
 2006 - 2022 Copyright by RT-Thread team

 MCU: CH32V103C8T6
 SysClk: 72000000Hz
 www.wch.cn
msh >ps
thread   pri  status      sp     stack size max used left tick  error
-------- ---  ------- ---------- ----------  ------  ---------- ---
tshell    20  running 0x00000140 0x00000400    83%   0x00000003 000
tidle0    31  ready   0x000000b0 0x00000100    70%   0x00000002 000
timer      4  suspend 0x000000e0 0x00000200    43%   0x00000009 000
main      10  suspend 0x00000140 0x00000800    20%   0x0000000f 000

联系人信息

维护人: