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

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

简介

此为 赤菟 v1.1 版的开发资源，支持赤菟 v1.1.x 硬件。现正持续更新中。
旧版 v1.0.x 硬件对应的开发资源仓库为：https://gitee.com/verimaker/opench-ch32v307/tree/v1.0.3
硬件版本修改信息见硬件版本历史章节

openCH 赤菟 开发板 是 VeriMake 设计生产的、基于 RISC-V MCU 的嵌入式开发板，搭载 CH32V307 芯片，有丰富的外设。
原理图、尺寸与元件位号图、3D 模型等资料见 开发资源章节
引脚定义 见 引脚分配章节
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 透传模组，主从一体

注：由于引脚冲突，部分功能不能同时使用：

• 使用DVP 摄像头时，UART1、TF 卡、以太网 不能使用
• 使用以太网模块时， DVP 摄像头、ES8388（I2S 音频芯片）、TF 卡 不能使用

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

硬件版本历史

硬件版本号位于开发板正面的左下角、电源指示灯 PWR 的下方：

v1.1

从 v1.0 到 v1.1 的更改有：

1. 去除 AHT10 温湿度传感器
2. 增加 QMC7983 磁力计
3. IMU 从 MPU6050 更改为 QMI8658A
4. ES8388 的 LIN2/RIN2 连接到耳机座的 Sleeve，可以使用常见耳机的麦克风录音。
5. DVP 接口晶振从 12MHz 更换为 24MHz。

• v1.1.1 最新版。
• v1.1.0 测试版本

v1.0

v1.0.x 硬件对应的开发资源仓库为：https://gitee.com/verimaker/opench-ch32v307/tree/v1.0.3

• v1.0.3 仅细微调整，FPC 座改为翻盖式。
• v1.0.2 仅细微调整。
• v1.0.1 仅细微调整。
• v1.0.0 第一个发售版本。

仓库目录结构

.
|-- doc (存放原理图、尺寸与元件位号图、文档图片等资料)
`-- firmware (例程与库)
    |-- Camera
    |-- ...(其它例程)
    `-- SRC ( CH32V307 库文件)

开发环境

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

引脚分配

注：由于引脚冲突，部分功能不能同时使用：

• 使用DVP 摄像头时，UART1、TF 卡、以太网 不能使用
• 使用以太网模块时， DVP 摄像头、ES8388（I2S 音频芯片）、TF 卡 不能使用

开发资源

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