点赞 点赞 0
评论 0
书签 书签 10

STM32HAL库MDK工程创建

最新推荐文章于 2026-07-17 14:59:15 发布
原创 最新推荐文章于 2026-07-17 14:59:15 发布 · 1.5k 阅读 ·
本内容遵循CC 4.0 BY-SA版权协议
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
cknow-ai 代码可运行
本文介绍了如何获取和理解STM32的HAL库，包括库的结构、重要文件的作用，以及如何在MDK环境中创建工程、移植HAL库。CMSIS文件夹包含关于编译器和内核的头文件。工程创建涉及文件夹结构规划、HAL库文件的复制和配置，以及MDK工程的魔术棒配置、Target、Output、C/C++和Debug选项卡的设置。

HAL库文件解析与MDK工程创建

前言

本文是基于正点原子新发布的HAL库学习教程的学习笔记，不明白的可以去看正点原子的视频。

HAL库获取

ST 为了方便用户开发 STM32芯片开发提供了三种库：
标准外设库 (Standard Peripheral Libraries)
HAL库(硬件抽象层)：Hardware Abstraction Layer
LL库：Low Layer
目前标准库已停止维护，ST主推HAL库，使用CUBEMX生成的代码也是基于HAL库，LL库是与HAL库捆绑发布，是HAL库的轻量化版本。
我们可以在ST公司的官网获取HAL库，在官网搜索STM32Cube，找到对应的版本下载即可

HAL库文件讲解

HAL库结构

打开固件包是这样的：
来自正点原子的ppt
我们需要的文件一般都在Drivers文件夹

在这里插入图片描述
CMSIS文件夹：
在这里插入图片描述
在这里插入图片描述

重要文件讲解

以stm32f103c8t6为例

./路径/文件名描述
\CMSIS\Device\ST\STM32F1xx\Include\stm32f1xx.h是所有F1系列的顶层头文件，通过条件编译来包含某个芯片的头文件，定义通用的枚举类型，定义通用的宏定义（固件库没用这个）
\CMSIS\Device\ST\STM32F1xx\Include\stm32f103xb.h包含：中断编号定义、外设寄存器结构体类型定义、寄存器映射、寄存器位定义、外设判定。
\Drivers\CMSIS\Device\ST\STM32F1xx\Source\Templates\ system_stm32f1xx.c定义了系统初始化函数 SystemInit和系统时钟更新函数 SystemCoreClockUpdate
\Drivers\CMSIS\Device\ST\STM32F1xx\Include\system_stm32f1xx.h定义了系统初始化函数 SystemInit和系统时钟更新函数 SystemCoreClockUpdate
\CMSIS\Device\ST\STM32F1xx\Include\startup_stm32f103xb.s中容量F103系列芯片的启动文件

HAL库文件介绍

在这里插入图片描述
ps：v1.8版本的HAL库的stm32f1xx_hal_conf.h文件为stm32f1xx_hal_conf_template.h。根据文件内描述，移植的时候重新命名为stm32f1xx_hal_conf.h即可

CMSIS文件

在固件包\Drivers\CMSIS\Core\Include\路径下，定义了一些关于编译器 、内核、架构的头文件，根据需要移植即可。
在这里插入图片描述

工程创建

创建工程文件夹

先创建一个新的工程文件夹，打开后新建如下文件夹：
在这里插入图片描述
Middlewares文件夹：该文件夹用于存放其他第三方提供的中间层代码（组件/Lib 等），
如： USMART、MALLOC、 TEXT、 FATFS、 USB、 LWIP、各种 OS、各种 GUI 等

Drivers文件夹下新建如下文件夹
在这里插入图片描述

移植HAL库

建立完文件夹后：按上一章节介绍找到在固件包对应文件，复制到相应位置。
其中
stm32f1xx.hal.conf.h
stm32f1xx_it.c
stm32f1xx_it.h
stm32f1xx_hal_msp.c // 回调函数存放文件，不用可删除
放入User文件夹，后三个个文件可以去固件包的Projects文件夹的官方例程里找，也可以把中断服务函数定义在其他位置。
前一章节五个重要文件放入CMSIS
内核文件放入CMSIS
main.c也可以定义在User文件夹
在这里插入图片描述

MDK建立工程

工程新建到Project文件夹下的MDK-ARM文件夹

工程分组

建立如下分组：
Middlewares没用到可以先不加
在这里插入图片描述
添加对应.C文件即可
ps：外设库文件按需求添加，可以加快编译速度，全添加完可能会有重复定义的函数，导致编译错误。

魔术棒配置

Target选项卡

在这里插入图片描述
晶振按实际的设置

Output选项卡

在这里插入图片描述
点上面唯一的按钮，将hex文件输出设置为Output文件夹

C/C++选项卡

在这里插入图片描述
Define：USE_HAL_DRIVER,STM32F103xE
后面那个XE表示大容量，根据实际情况去设置
打开stm32f1xx.h文件
该选项是通过条件编译来包含对应芯片的头文件
在这里插入图片描述
Include Path选项
在这里插入图片描述
添加工程文件夹内所有的头文件路径

Debug选项卡

设置对应的下载器
在这里插入图片描述
点开Setting按钮：
Debug选项，设置接口和下载速度
在这里插入图片描述
Flash Dowload选项
在这里插入图片描述
根据实际设置芯片容量，选择的Flash符合容量范围即可
例如：stm32f103c8t6 为中容量产品 flash为64k ‘
可选择如下选项
在这里插入图片描述
64k-128k为中容量：

标签
#stm32 #单片机 #嵌入式硬件
分类 嵌入式与硬件开发
STM32CubeMX生成的代码里，那个神秘的`stm32f1xx_hal_conf.h`文件到底该怎么配置？
weixin_29189377的博客
03-27 281
本文详细解析了STM32CubeMX生成的`stm32f1xx_hal_conf.h`文件配置方法，重点介绍了HAL库中外设驱动启用、时钟源配置和断言功能的使用技巧。通过合理配置该文件，开发者可以优化代码体积并提升系统稳定性，特别适合STM32F1系列开发。
STM32开发环境配置相关问题记录
麦克斯的实验室
03-27 1291
1、编译时出现 error: #35: #error directive: "Please select first the target STM32F10x device used 解决方案：点选options for target ，选择C/C++，在define文本框中输入USE_STDPERIPH_DRIVER,STM32F10X_MD 即可。 2、编辑时出
stm 社区 关于HAL库中stm32f1xx_hal_msp.c文件的认知（新手贴）
Never say never
07-31 2989
用户使用的时候，只用包含hal.h而不用去管是hal_f1还是hal_f2或是什么其他系列的头文件，所有系列的代码打包在一起，通过条件编译来实现真正的跨平台，而如果需要使用某款mcu的特色功能时，就再包含一个hal_f1extend.h。就是说MSP的作用是把某个外设的接口资源给具体化了，比如对于串口外设，就是指定串口具体的接口引脚状态（包含引脚的位置、电气属性等等）以及外设与CPU的接口（外设与CPU的接口就是特殊功能寄存器的映射地址，也就是告诉CPU要操作哪个外设只要操作相应地址的寄存器就可以了）。
STM32 HAL库Keil MDK工程创建全流程详解
weixin_35390379的博客
02-06 99
HAL库是STM32嵌入式开发的核心抽象层，通过硬件无关接口屏蔽寄存器操作细节，提升代码可移植性与开发效率。其运行依赖严格的编译环境配置，包括ARM Compiler 5兼容性、C99语法支持及芯片型号宏（如STM32F103xB）定义。技术价值体现在模块化分层设计（Drivers/CMSIS/User）、时钟与外设初始化解耦，以及面向量产的可复用工程模板构建能力。典型应用场景涵盖教学实验、工业控制原型开发及IoT终端固件搭建。本文以STM32F1系列为例，系统解析Keil MDK下HAL库工程从固件包集成
【STM32】Keil5在编译过程中出现.cannot open source input file “STM32F1Xx.h“: No such file or directory的问题
ycjunhua的专栏
03-27 2514
编译报错cannot open source input file “STM32F1Xx.h“: No such file or directory。2、重新配置头文件包含路径。
2. STM32 HAL库MDK工程模板创建
qq_51355375的博客
10-30 1831
工程结构参考引用自正点原子新建一个工程目录，在里边创建一下子目录 这个文件夹主要存放的是中间层代码（组件/Lib 等），比如：FATFS、USB、LWIP、FreeRTOS，各种 GUI 等等。但作为模板工程，文件夹暂时空置即可。该文件夹用于存放编译器编译工程输出的中间文件，比如：.hex、.bin、.o 文件等。该文件夹用于存放编译器（MDK、 IAR 等）工程文件，我们主要用 MDK，为了方便区分，在该文件夹下新建： MDK-ARM 文件夹，用于存放 MDK 的工程文件。 该文件夹用于存放用户编写的代码
STM32——HAL 库MDK工程创建
PinnsiR的博客
07-31 719
本文介绍了基于HAL库的STM32工程新建方法。主要内容包括： 1）工程目录结构（Drivers、Middlewares等文件夹）； 2）工程框架搭建步骤（删除原有工程文件）； 3）文件添加方法（手动选择.c文件并修改属性）； 4）MDK配置要点（Target、Output等6个选项卡设置）； 5）main.c文件创建（保存到User文件夹并导入）。 文章提供了从零开始建立STM32 HAL库工程的具体操作指南，适合初学者快速上手STM32开发。
在Keil MDK 5里面直接创建使用HAL库的STM32工程的方法（不使用STM32CubeMX）
热门推荐
ZLK1214的专栏
11-24 2万+
本文使用的单片机为STM32F030C8。 【示例程序代码】 注：“= {0}”语句相当于原来标准库中的GPIO_StructInit函数。 全局变量和静态局部变量默认已经清零，所以不需要写“= {0}”。而普通局部变量默认值为随机值，所以必须要写“= {0}”。 #include <ctype.h> #include <stm32f0xx.h> #include...
STM32 HAL库MDK工程模板创建与优化指南
最新发布
weixin_30983965的博客
07-17 243
硬件抽象层(HAL)是STM32开发中的核心概念，通过封装底层硬件操作提供跨芯片系列的兼容性。其工作原理是通过标准化的API接口屏蔽硬件差异，显著提升代码复用率。在嵌入式开发实践中，合理使用HAL库能降低60%以上的移植成本，特别适合需要快速迭代的物联网设备开发。本文以STM32F103为例，详细介绍如何使用CubeMX和Keil MDK创建标准化工程模板，涵盖时钟配置、外设初始化等关键步骤，并分享延时函数优化、printf重定向等实用技巧。针对HAL库体积较大的痛点，特别提供了LL库混用和链接优化等解决方
STM32部分：2-2、传统手动创建工程方法
嵌入式成长手册
05-05 1488
例如，stm32f10x_gpio.c和stm32f10x_gpio.h文件分别包含了GPIO寄存器的操作函数和相关的宏定义。打开"Template\Drivers\CMSIS\Device\ST\STM32F1xx\Source\Templates\arm"，添加startup_stm32f103xe.s。HAL库的STM32Cube_FW_F1_Vxxxx\Drivers\STM32F1xx_HAL_Driver文件夹。这是ST提供的4个启动文件，分别适用于不同容量的STM32芯片。
【STM32CubeMX】教程一_创建工程/界面介绍
m0_54160307的博客
01-07 1751
STM32CubeMX教程一_创建工程/界面介绍
【STM32】STM32F103ZET6 创建工程模版详解(HAL库)
C/C++软件工程师、嵌入式软件工程师、物联网研发工程师、C/C++讲师、物联网讲师、嵌入式讲师、鸿蒙讲师---欢迎大家一起交流(私信添加博主微信)
07-10 4187
HAL库，全称为Hardware Abstraction Layer（硬件抽象层）库，是STMicroelectronics（ST）为STM32微控制器提供的较新的固件库。HAL库的定义与特点定义：HAL库是一个中间件，为应用程序和硬件之间提供了一个接口，允许开发者在不知道底层硬件细节的情况下编写控制硬件的代码。特点跨平台支持：HAL库支持STM32全系列微控制器，使得开发者编写的代码可以在不同的STM32产品之间移植。结构统一：为所有外设提供统一的API和驱动结构，简化了开发过程。易于使用。
stm32H7开发之创建工程（一）
一零的博客
01-20 1216
摘要：本文详细介绍了STM32开发环境的搭建流程，重点讲解基于STM32H743芯片的手动工程创建方法。内容包括STM32基础知识、开发工具链选择、芯片支持包和HAL库的获取与配置，以及STM32Cube固件包的结构解析。通过分步骤指导开发者完成文件准备、工程目录构建和关键文件配置，为后续硬件功能测试和软件开发奠定基础。
keil添加hal库_嵌入式36——基于 HAL 库的工程模板和工程结构
weixin_29638241的博客
01-03 2535
我们可以使用ST官方的 STM32CubeMX 图形工具生成一个工程模板。这里之所以还要新建一个模板，是为了对工程新建和运行过程有一个深入的理解，这样在日后的开发中遇到任何问题都可以得心应手的解决。在新建模板之前之前，要准备如下资料：1) HAL 库开发包： STM32Cube_FW_L4_V1.13.0 这是 ST 官网下载的 STM32CubeL4 包完整版， 可以直 接去 ST官网进行下载，...
STM32CubeMX点灯
qq_51426845的博客
12-06 687
软件使用笔记
基础篇003. 【STM32F446，NUCLEO-F446RE板】使用STM32CubeMX创建MDK工程，实现流水灯
qcmyqcmy的专栏
04-11 6161
STM32 Nucleo-64板为用户提供了一种可负担的灵活方法，通过选择STM32微控制器提供的各种性能和功耗特性组合来尝试新概念并构建原型。对于兼容板，外部SMPS可显著降低运行模式下的功耗。 实验采用STM32F446RE MCU的STM32 Nucleo-64（NUCLEO-F446RE）开发板，利用STM32CubeMX，创建MDK工程，实现流水灯。
【STM32嵌入式系统】1.开发环境认识与工程创建
dochyi的博客
11-06 223
本实验旨在学习STM32开发环境的搭建与应用。主要内容包括熟悉STM32固件库结构、掌握Keil MDK和STM32CubeMX软件的安装方法，以及使用这两个工具创建STM32 HAL工程。实验需要计算机和STM32微控制器学习素材作为硬件支持。实验步骤分为三个部分：安装STM32CubeMX、安装Keil MDK软件，以及利用这两个工具创建STM32开发工程，为后续STM32嵌入式开发奠定基础。
【正点原子STM32连载】第八章 新建HAL版本MDK工程 摘自【正点原子】MiniPro STM32H750 开发指南_V1.1
weixin_55796564的博客
08-11 1730
1）实验平台：正点原子MiniPro H750开发板4）对正点原子STM32感兴趣的同学可以加群讨论：879133275。
基础篇004. 【STM32F1】采用Proteus + STM32CubeMX + MDK-ARM学习流水灯
qcmyqcmy的专栏
02-27 5121
采用Proteus + STM32CubeMX + MDK-ARM学习流水灯
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值