工程结构参考引用自正点原子
1. 新建工程文件夹
新建一个工程目录，在里边创建一下子目录
2. 目录说明
| 文件夹 | 说明 |
|---|---|
| Drivers | 存放与硬件相关的驱动层文件 |
| Middlewares | 存放中间层文件 |
| Output | 存放工程编译输出文件 |
| Projects | 存放 MDK工程文件 |
| User | 存放 HAL库用户配置文件、main.c、中断处理文件，以及分散加载文件 |
2.1 Drivers文件夹
| 文件夹 | 作用 |
|---|---|
| BSP | 存放开发板板级支持包驱动代码，如各种外设驱动 |
| CMSIS | 存放 CMSIS 底层代码，如启动文件（.s 文件）等 |
| SYSTEM | 存放系统级核心驱动代码，如 sys.c、delay.c 和 usart.c 等 |
| STM32F1xx_HAL_Driver | 存放 ST 提供的 F1 系列 HAL 库驱动源码 |
2.2 Middlewares文件夹
这个文件夹主要存放的是中间层代码（组件/Lib 等），比如：FATFS、USB、LWIP、FreeRTOS，各种 GUI 等等。但作为模板工程，文件夹暂时空置即可。
2.3 Output文件夹
该文件夹用于存放编译器编译工程输出的中间文件，比如：.hex、.bin、.o 文件等。
2.4 Projects文件夹
该文件夹用于存放编译器（MDK、 IAR 等）工程文件，我们主要用 MDK，为了方便区分，在该文件夹下新建： MDK-ARM 文件夹，用于存放 MDK 的工程文件。
2.5 User文件夹
该文件夹用于存放用户编写的代码，如：HAL 库用户配置文件、main.c 文件、中断处理文件，以及分散加载文件等。
3. 工程框架配置
3.1 新建工程
打开keil, 新建工程
3.2 选择芯片
需要提前安装对应的固件包，可以参考：https://blog.csdn.net/qq_51355375/article/details/143273553
本模板使用的时stm32f103c8t6,选择如下， 选定后点ok
跳过即可
3.3 删除文件夹
因为定义了Output文件夹用于存放编译器编译工程输出的中间文件， 所以删除Listings和Objects两个文件夹
4. 添加文件
4.1 复制HAL 库驱动代码
使用stm32CubeMX 下载固件包
选择需要的版本， 这里选历史版本1.8
等待下载完成后，查看下载目录
去对应的目录下找对应固件驱动包
复制STM32Cube_FW_F1_V1.8.0\Drivers\STM32F1xx_HAL_Driver下的Inc和Src目录到我们自己的Drivers\STM32F1xx_HAL_Driver下
4.2 HAL 库用户配置文件和中断处理文件到我们的 User 文件夹
从官方STM32Cube_FW_F1_V1.8.0\Projects\STM3210E_EVAL\Templates 下的Inc 和 Src 文件夹里面，在这两个文件夹里面找到：stm32f4xx_it.c、stm32f4xx_it.h、stm32f4xx_hal_conf.h 这三个文件，并且拷贝到我们的 User 文件夹下。
4.3 设置工程名和分组名
在 Project→Target 上右键，选择 Manage Project Items…进入工程管理界面
设置工程名字为：Template，并设置四个分组：
Startup（存放启动文件）、User（存放 main.c 等用户代码）、Drivers/SYSTEM（存放系统级驱
动代码）Driver/STM32F1xx_HAL_Driver（存放 HAL 库代码）、Readme（存放工程说明文件），
设置好之后，我们点击 OK，回到 MDK 主界面，可以看到我们设置的工程名和分组名如图
这里我们只是新建了一个简单的工程，并没有添加 BSP、Middlewares 等分组，后面随着工
程复杂程度的增加，我们需要一步步添加对应的分组。为了让工程结构清晰，尽量让 MDK 的工程分组和我们前面新建的工程文件夹对应起来，由于 MDK 分组不支持多级目录，因此我们将路径也带入分组命名里面，以便区分。如：User 分组对应 User 文件夹里面的源码，Drivers/SYSTEM 分组，对应 Drivers/SYSTEM文件夹里面的源码，Drivers/BSP 分组对应 Drivers/BSP 文件夹里面的源码等。
4.4 添加启动文件
复制CMSIS 文件夹
复制上边cubeMx下载的官方包里STM32Cube_FW_F1_V1.8.0\Drivers下的CMSIS 文件夹 下的所有内容到我们自己的工程模板下的Drivers\CMSIS文件夹
由于固件包里面的 CMISIS 兼容了太多芯片，导致非常大， 需要根据实际情况，对其进行了大幅精简
，最简单做法是只保留Device和Include目录，也可以不精简
右键打开项目管理
在刚才添加的\Drivers\CMSIS\Device\ST\STM32F1xx\Source\Templates\arm目录下找到对应的启动文件。
点Add 后如下则添加成功
点击ok后工程目录变化
4.5 添加 SYSTEM 源码
这里使用的文件直接是复制原子的工程中的
同样操作如上，添加三个目录下的源文件到SYSTEM分组即可
4.6 添加USER分组
同样操作如上，将Users目录下的源文件到Users分组即可
4.7 添加驱动添加驱动文件
同样如上操作，将Drivers\STM32F1xx_HAL_Driver\Src 目录下的文件添加到对应分组，可以添加全部或者只添加对应的。
5. 魔术棒设置
5…1 Target选项卡
5.2 Output
5.3 Listing选项卡
经过 Output 和 Listing 这两步设置，原来存储在 Objects 和 Listings 文件夹的内容（中间文
件）就都改为输出到 Output 文件夹
5.4 C/C++选项卡
下图 define 中间定义用英文逗号分隔
引用原子的相对路径解释：
上图中我们设置了 6 个头文件包含路径，其中 3 个在 Drivers 文件夹下，一个在 User 文件
夹下，一个在 Middlewares 文件夹下。为避免频繁设置头文件包含路径，正点原子最新源码的
include 全部使用相对路径，也就是我们只需要在头文件包含路径里面指定一个文件夹，那么该
文件夹下的其他文件夹里面的源码，如果全部是使用相对路径，则无需再设置头文件包含路径
了，直接在 include 里面就指明了头文件所在。
关于相对路径，这里大家记住 3 点：
1，默认路径就是指 MDK 工程所在的路径，即.uvprojx 文件所在路径（文件夹）
2，“./”表示当前目录（相对当前路径，也可以写做“.\”）
3，“../”表示当前目录的上一层目录（也可以写做“..\”）再举个例子，在完成上图所示的头文件包含路径设置以后，我们在代码里面编写：
#include "./SYSTEM/sys/sys.h"
即表示当前头文件包含路径所指示的 4 个文件夹里面，肯定有某一个文件夹包含了：
SYSTEM/sys/sys.h 的路径，实际上就是在 Drivers 文件夹下面，两者结合起来就相当于：
#include "../../Drivers/SYSTEM/sys/sys.h"
这就是相对路径。它既可以减少头文件包含路径设置（即减少 MDK 配置步骤，免去频繁
设置头文件包含路径的麻烦），同时又可以很方便的知道头文件具体在那个文件夹，因此我们推
荐在编写代码的时候使用相对路径。
5.5 设置 Debug 选项卡
5.6 设置 Utilities 选项卡
6. 添加 main.c，并编写代码
在 MDK 主界面，右键选择Users分组， 添加新项目到分组
点Add添加后，打开项目管理发现main.c也已经新建并加入了分组
编写测试代码：
#include "SYSTEM/sys/sys.h"
#include "SYSTEM/uart1/uart1.h"
#include "SYSTEM/delay/delay.h"#define LED_CLK() __HAL_RCC_GPIOB_CLK_ENABLE()
#define LED_GPIO GPIOB
#define LED_PIN GPIO_PIN_8void led_init(void); /* LED初始化函数声明 */int main(void)
{HAL_Init(); /* 初始化HAL库 */stm32_clock_init(RCC_PLL_MUL9); /* 设置时钟, 72Mhz */led_init(); /* LED初始化 */uart1_init(115200);printf("running...\r\n");while(1){ HAL_GPIO_WritePin(LED_GPIO,LED_PIN,GPIO_PIN_SET);delay_ms(500);HAL_GPIO_WritePin(LED_GPIO,LED_PIN,GPIO_PIN_RESET);delay_ms(500); }
}/*** @brief 初始化LED相关IO口, 并使能时钟* @param 无* @retval 无*/
void led_init(void)
{GPIO_InitTypeDef gpio_initstruct;LED_CLK(); /* IO口时钟使能 */gpio_initstruct.Pin = LED_PIN; /* LED0引脚 */gpio_initstruct.Mode = GPIO_MODE_OUTPUT_PP; /* 推挽输出 */gpio_initstruct.Pull = GPIO_PULLUP; /* 上拉 */gpio_initstruct.Speed = GPIO_SPEED_FREQ_HIGH; /* 高速 */HAL_GPIO_Init(LED_GPIO, &gpio_initstruct); /* 初始化LED0引脚 */
}注意： 这里要注意头文件的引入方式
修改代码：
编译下载验证：
出现错误
移除这三个
报错：
需要将： Drivers\CMSIS\Device\ST\STM32F1xx\Source\Templates 下的 system_stm32f1xx.c 添加到Users分组下， 右键Users分组，添加到已存在分组
再次编译：
