文章目录
- 目的
- 官方库
- 工程模板
- 使用例程
- 总结
目的
现在开发单片机大多数时候都是面向库开发的,这里将简单介绍下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建立的工程模板结构上还是比较清晰的,上手起来比较简单。更深入的使用方面的内容可以通过官方例程来学习。