openCH 赤菟 开发板 开发资源 v1.0.2

• openCH 赤菟 开发板 开发资源 v1.0.2
  • 简介
    • 板载资源
    • CH32V307VCT6
  • 开发环境
    • firmware 例程的开发环境
    • MounRiver Studio (MRS)
      • 基于本仓库的 MRS 例程建立新项目
        • 方法一 在例程旁边建立项目（推荐）
        • 方法二 使用 MRS 的导出功能
    • RT-Thread Studio
    • CMake
  • 目录结构
  • 引脚分配
  • 开发资源

简介

openCH 赤菟 开发板 是 VeriMake 设计生产的、基于 RISC-V MCU 的嵌入式开发板，搭载 CH32V307 芯片，有丰富的外设。
原理图、尺寸与元件位号图等其它开发资料见 开发资源章节
引脚定义 见 引脚分配章节
VeriMake 会在 Bilibili 账号 上发布相关的教程、应用案例视频。
VeriMake 论坛也有专门的 赤菟版块 供开发者发帖展示相关项目、分享开发经验、提出开发过程中遇到问题等。
相关硬件可以从 VeriMake的淘宝店 购买。

板载资源

• CH32V307VCT6
• ES8388 音频采集与播放
• AP3216C 距离与环境光传感器 (ALS&PS)
• 128 Mbit 板载 Flash
• Type-C USB 接口
• 板载 WCH-Link 调试器
• 两个用户 LED，一个五向开关 和 三个用户按键，支持睡眠唤醒
• 温湿度传感器
• 六轴重力与加速度传感器
• 硬件 TF 卡 (micro-SD) 接口
• 硬件 DVP 摄像头接口，支持 OV2640 模组
• 1.33 寸 240x240 分辨率 LCD 屏，主控 ST7789，FSMC 控制
• 11 个拓展 GPIO 端口
• CH9141 BLE 透传模组，主从一体

CH32V307VCT6

• RISC-V4F 处理器，最高 144MHz 系统主频
• 支持单周期乘法和硬件除法，支持硬件浮点运算 ( FPU )
• 64 KB SRAM，256 KB Flash
• 供电电压：2.5/3.3 V，GPIO 单元独立供电
• 多种低功耗模式：睡眠、停止、待机
• 上/下电复位、可编程电压检测器
• 2 组 18 路通用 DMA
• 4 组运放比较器
• 1 个随机数发生器 TRNG
• 2 组 12 位 DAC 转换
• 2 单元 16 通道 12 位 ADC 转换，16 路触摸按键 TouchKey
• 10 组定时器
• USB2.0 全速 OTG 接口
• USB2.0 高速主机/设备接口（ 480 Mbps 内置 PHY ）
• 3 个 USART 接口和 5 个 UART 接口
• 2 个 CAN 接口（ 2.0B 主动）
• SDIO 接口、FSM C接口、DVP 数字图像接口
• 2 组 IIC 接口、3 组 SPI 接口、2 组 IIS 接口
• 千兆以太网控制器 ETH（内置 10M PHY ）
• 80 个 I/O 口，可以映射到16外部中断
• CRC 计算单元，96 位芯片唯一 ID
• 串行 2 线调试接口
• 封装形式：LQFP64M、LQFP100

开发环境

openCH 赤菟 支持 MounRiver Studio (MRS) ， RT-Thread Studio 亦或是CMake开发

firmware 例程的开发环境

MounRiver Studio (MRS)

大多数例程使用 MRS 开发：MRS 上手教程 【视频】
MRS 的介绍和软件资源在：MRS 官网

基于本仓库的 MRS 例程建立新项目

本仓库中 MRS 例程的部分依赖文件放置于 'firmware/SRC' 文件夹中，单独复制例程到其它位置可能无法使用。
可用以下方法基于本仓库例程建立新项目：（本仓库的结构与沁恒官方的 CH32V307 EVT 类似，下面的方法也适用于 EVT 中的例程）

方法一 在例程旁边建立项目（推荐）

以此方法建立的项目不可移动或复制到其它位置使用。
此处将示范以 UART_Basic 为基础，建立新项目：

1. 打开 UART_Basic 例程，在 项目资源管理器 中 右击 UART_Basic，选择 复制。（或者使用 Ctrl C)
   
2. 右击空白处，选择 粘贴 （或者使用 Ctrl V)
   
3. 在弹出的对话框中修改项目名称，取消勾选 使用缺省位置 后，点击 浏览
   
4. 到本项目的上一级目录中（此处是 UART_Basic 所在的 USART 文件夹中），新建文件夹并改名为项目名称
   
5. 选择新文件夹，返回对话框，点击 复制，就完成了。
   
6. 新项目编译通过
   

方法二 使用 MRS 的导出功能

以此方法导出的项目与原项目同名，可以移动或复制到其它位置使用。
此处示范导出 UART_Basic：

1. 打开 UART_Basic 例程，在 项目资源管理器 中 右击 UART_Basic，选择 导出。
   
2. 在弹出的对话框中选择 常规 分组中的 文件系统，点击 下一步
   
3. 选择 UART_Basic，在 选项 中勾选 创建文件的目录结构 和 解析并导出已连接资源；再点击 浏览 ，选择项目导出位置
   
4. 点击 完成，即可完成项目导出。导出的项目包含所有的依赖文件。
   
5. 导出的项目没有项目入口，可以通过 MRS 的 加载 功能打开（文件 -> 加载）。注意，加载的项目会覆盖 项目资源管理器 中的同名项目。
   
6. 在弹出的对话框中选择 工程，点击 浏览
   
7. 到导出的项目文件夹中，选择根目录下的 .projuct 文件，点击 打开
   
8. 返回对话框，点击 确定。如提示覆盖相同名称的工程，可选 是
   
9. 项目已导入，但一些文件夹仍处于未链接状态（带感叹号!）。需要将它们从项目中删除
   
10. 此时编译，项目下会多出一些文件夹，且编译可以通过
    

RT-Thread Studio

基于 RT-Thread 操作系统的工程可以使用 RT-Thread Studio 开发
RT-Thread Studio 编译 语音识别例程 【视频】
RT-Thread Studio 下载

CMake

配置好 CMake 和 ninja , 开启你的赤菟之旅.

• 键入make build APP=Integrated_Test编译工程，二进制文件将输出到./cmake_output路径下.APP参数替换成你想操作的工程
• 键入make program APP=Integrated_Test将二进制文件下载至 赤菟。
• 键入make build_elipse APP=Intergrated_Test输出eclipse工程到./build.eclipse路径，可直接导入MRS，RTT-studio等eclipse环境开发。

详细参考 : CH32V307教程 [番外] [开发环境-CMake] 赤菟CH32V307

目录结构

.
|-- CMakeLists.txt    
|-- Makefile
|-- README.md
|-- doc
|   |-- SCH_openCH_CH32V307_Board.pdf
|   `-- pic
|       |-- boardRes.jpg
|       `-- chipRes.jpg
`-- firmware
    |-- CH32V307_RTT_VC_RC_by_es8388
    |   `-- CH32V307_RTT_VC_RC
    |-- Camera
    |   |-- CMakeLists.txt
    |   |-- Camera.wvproj
    |   |-- User
    |   `-- obj
    |-- IIC_Sensor
    |   |-- CMakeLists.txt
    |   |-- IIC_Sensor.wvproj
    |   |-- User
    |   `-- obj
    |-- Integrated_Test
    |   |-- CMakeLists.txt
    |   |-- Integrated_Test.wvproj
    |   |-- User
    |   `-- obj
    |-- KEY_TEST
    |   |-- CMakeLists.txt
    |   |-- KEY_TEST.wvproj
    |   |-- User
    |   `-- obj
    |-- Record_Play
    |   |-- CMakeLists.txt
    |   |-- User
    |   `-- obj
    |-- SRC
    |   |-- CMakeLists.txt
    |   |-- Core
    |   |-- Debug
    |   |-- Ld
    |   |-- Peripheral
    |   |-- Startup
    |   `-- tools
    `-- USART
        |-- BLE_Serial
        `-- Wifi_ESP8266

引脚分配

开发资源

• openCH 赤菟开发板原理图
• openCH 赤菟开发板尺寸及元件位号图
• CH32V307 介绍页面 (WCH)
• CH32V307 沁恒官方例程（用于赤菟开发板时需修改）
• CH32V307 芯片手册 (WCH)
• CH32V307 参考手册 (WCH)