沁恒CH32V307单片机入门（02）：官方库与工程模板介绍

Posted 2023-01-31 Naisu Xu

文章目录

• 目的
• 官方库
• 工程模板
• 使用例程
• 总结

目的

现在开发单片机大多数时候都是面向库开发的，这里将简单介绍下CH32V307的官方库。

在开发过程中新建项目时通常会从某些模板开始，模板包含了库和初始化代码等内容，有一定的组织好的目录结构，使用模板可以加速开发过程。这里也将介绍下使用MounRiverStudio进行开发时的模板内容。

一些基础的内容可以参考文章《沁恒CH32V307单片机入门（01）：基础说明与流程体验》：
https://blog.csdn.net/Naisu_kun/article/details/128734532

官方库

在前面文章提到的 CH32V307评估板说明及参考应用例程 中 EXAM 目录下的 SRC 目录中就是官方库了。

Ld：链接脚本
链接脚本中主要就是一些符号定义和内存空间分配配置等。主要包括：程序入口定义、栈大小定义、FLASH和RAM位置与大小、内存中各个分段大小设置等。

Startup：启动文件
根据链接脚本定义的程序入口，系统启动后程序从这里开始运行。这里将数据在内存上进行初始化，然后设置堆栈，初始化中断和浮点，调用 SystemInit 函数初始化系统时钟，最后调用 main 函数。
目前有两个启动文件： startup_ch32v30x_D8.S 适用于CH32V303系列， startup_ch32v30x_D8C.S 适用于CH32V307-CH32V305系列，在 ch32v30x.h 文件中宏定义来选择相应的文件。

Core：内核系统头文件
这里主要用于中断控制器及相关功能。另外很多常用数据类型别名定义也在这里。

Peripheral：基本外设驱动源文件及头文件
这个目录下主要就是各种外设使用相关的库了：

ch32v30x.h 这个文件中定义了选择哪个启动文件、内外部时钟基准频率、外设用到的各种数据结构和宏定义等。

Debug：延时函数、串口调试源文件及头文件
这里包含了最常用的延时函数和打印输出功能。默认情况下通过UART1打印输出，可以修改头文件中宏定义来选择其它串口。

工程模板

这里将对NoneOS和FreeRTOS两种模板进行介绍。

NoneOS

ch32v30x_conf.h ：这个文件中引入了大部分的外设库文件，可以根据自己的需求调整；
ch32v30x_it.h/ch32v30x_it.c ：中断服务程序；
main.c ：主程序；
system_ch32v30x.h/system_ch32v30x.c ：系统时钟初始化，系统时钟调整可以在此处进行；

FreeRTOS

这个没有什么需要特别说明的，相比不带操作系统的新增了操作系统源码和配置代码。

使用例程

CH32V307评估板说明及参考应用例程 中 EXAM 目录下除了官方库源码外其余内容都是官方例程：

进入相应的例程，双击里面 .wvproj 格式文件就会启动IDE打开例程：

可以在和 EXAM 同级的 PUB 目录中找到《CH32V30x评估板说明书》，其中描述了例程打开、编译、下载、仿真等操作方法。

总结

沁恒CH32V307单片机官方的库和通过IDE建立的工程模板结构上还是比较清晰的，上手起来比较简单。更深入的使用方面的内容可以通过官方例程来学习。