带你快速上手STM32F103的HAL库开发--keil版

弃梓

已于 2024-06-15 16:14:49 修改

阅读量4k

点赞数 35

文章标签： stm32 嵌入式硬件单片机

于 2024-06-11 05:53:36 首次发布

本文链接：https://blog.csdn.net/weixin_51134453/article/details/139582894

版权

#背景故事：在嵌入式开发以及硬件设计的学习道路上，能够使人快速成长的只有俩种情况：压力山大的项目工作和兴趣学习。实际上，生活节奏很快，工作很现实。小公司没有培训时间，大公司很关注学历和你现有的能力。一旦选择工作，就很难再花足够的时间去探究学习（报班除外）

#学习过程：有一个导师指点远比你自己摸索快得多，所以争取每一份工作尽量都能掌握新的技能。很多前辈都跟我说在这个行业，你的项目经验和资历很重要，但同样的情况是，只要是程序员到了35岁这个年纪，就会面临着精力无法跟上的情况，无法再胜任一线的岗位。所以，趁年轻，学会将自己的经验条保存下来。

#学习推荐：自主学习来说，市面上常见的正点原子、野火、凡亿教育、张飞电子的资料很多。下单了他们家的产品就会免费送资料。以下资料部分来自 正点原子，且博客内容较长，包括了一些调试过程中会出现的问题。

#以下博客目录内容分布为：

1--如何建立一个标准的HAL库工程文件

1、初步认识HAL库文件

2、如何获取一份完整的HAL库文件包？

3、如何建立一个相对完整的HAL工程文件？

1--如何建立一个标准的HAL库工程文件

1、初步认识HAL库文件

个人理解为：将寄存器的操作封装为函数，对开发者（上层用户）来说屏蔽了底层寄存器操作。

比如你需要配置某个引脚时候，通常你需要调整相应寄存器的操作（置1或者0），包括端口时钟使能、端口引脚输入输出模式等，在芯片手册上你可以看见相应需要调整的寄存器名称。

所以HAL库实际上就是一堆打包好的C文件和头文件（C文件写具体函数的函数体，H文件写宏定义和函数声明），以及最重要的核心底层文件，参考下图

以上部分，最重要的就是文件就是stm32f103xe.h 和stm32f103xe.s。

当你得到一份完整的HAL固件包时，会包含以下这些文件。

通常会把.h的头文件放在 Include 文件夹里 .c文件放在Source文件夹里，这样方便区分开。

CMSIS文件夹的内容主要有：

这些.h文件在你工程的头文件路径里都需要囊括进来，少一个可能都编译不出来。当然你也可以单独把所有H文件和C文件领出来存在一起。

需要注意的是，因为F1系列有很多具体类型，但是HAL库中类似于stm32f1xx.h这种头文件是通用型的，适用于这个系列内所有的芯片。当你编译的时候，会根据芯片选择的类型在宏定义内区分开头文件。如下图：

在没有宏定义到底用的是哪个芯片的时候，这里有一堆elif语句用来判断，所以第一次编译犯的错就是在#error 那里，最后解决办法就是自己补充一个宏定义：

Middlewares 就是中间件，使用基础外设的话暂时用不到。

Projects 就是例程，工程文件存储的地方，根据你的芯片类型来选择。

2、如何获取一份完整的HAL库文件包？

获取途径：ST官网 https://www.st.com.cn/content/st_com/zh.html

点击”工具和软件“，依次选择 STM32Cube Ecosystem，下拉找到 "STM32Cube MCU和MPU软件包"。

我购买的开发板是正点原子的STM32F103战舰V3，所以下载F1的固件包。当然，你也可以直接下载正点原子哥的资料，里面包含了F1的固件包。微信gz号搜索 正点原子。

（STM32CubeMX 本身是一个图形化开发软件，本身就是基于HAL库进行开发，开发效率相对来说更高一点）

3、如何建立一个相对完整的HAL工程文件？

（1）建立分区的文件夹

文件夹储存何种文件同第一步初步认识HAL库文件中所说的一样。

User 用户自己写的驱动和main.c

Project 储存工程文件

Drivers 底层驱动文件

Output 编译产生的输出文件（可以在工程设置-Output-Set Folder Object调整输出文件的输出位置）

建立完分区文件夹以后，可以先把你需要的驱动文件放在合适的位置，或者整个复制粘贴过来也是没问题的。

例如我的Drivers文件夹就是这样：

（2）新建工程文件

新建工程Project的时候选择好自己的芯片型号，然后调整魔术棒设置如下：

Browse Information 用于后期调试代码否则的话不方便右键找definition

include path里需要添加你所有头文件所在的位置，主要包括Drivers文件夹里的CMSIS和STM32F1xx_HAL_Drivers 即前面说的核心文件和HAL库的头文件。

这里注意，如果你添加的头文件的path 并没有指向具体存放xxx.h文件的文件夹，那么当你include

xxx.h的时候，肯定会找不到。于是乎，出现了相对路径的写法。

Define 的内容是宏定义，其效果类似于你直接.h文件里写# define

（3）建立工程里的项目文件夹

在Project Items的视图里，右键单击 Manage Project Items

在这里你可以增加或者删除工程视图里的文件夹和文件（点击新建以后，点击三个点）

方框图标是新建

箭头则是上下移动 ×是删除，最后添加的结果像下面这样：tap.c就是main.c

最后你可以将文件夹名字命名成你认为容易区分的类型（注意它并不需要和你第一步中建立分区文件夹的名字一模一样，也不会在你实际的文件夹里建立新的文件夹,单纯只在这个工程里有。）

（4）调试小技巧：

前面说到，在C/C++这一栏，需要添加Define处的宏定义，当然你也可以像我之前一样编译错误的时候就在文件里面自己写出宏定义，否则编译错误显示一些数据类型无法找到definition，就很难确认到底是以下三种情况哪一种：1、本身缺少.h文件 2、缺少宏定义 3、Include Path 里面少囊括了头文件。

比如像下面这种：