【STM32+CubeMX】 新建一个工程(STM32F407)
相关文章：
【HAL库】 STM32CubeMX 教程 1 --- 下载、安装
目录
第一部分、新建工程
第二部分、工程文件解释
第三部分、编译验证工程
友情约定：本系列的前五篇，为了方便新手玩家熟悉CubeMX、Keil的使用，会详细地截图每一步CubeMX、Keil的操作，并做上标记。之后的篇章，仅截图主要步骤页面。希望新手玩家熟记本篇的基本操作。
第一部分、新建工程
步骤 8-1：新建工程（基于芯片型号）
步骤 8-2：搜索芯片型号
- 输入芯片型号，在搜索列表里，双击目标型号，即可进入配置。
步骤 8-3：配置Debug调试方式
- 最多人出问题、易漏易错的 4 项中，这是其一;
- 养成习惯，新建工程时，先配置Debug选项, 即调试模式。
- 默认是关闭的，配置为：Serial Wire，通用STLink、JLink、CMSIS DAP等仿真器。
- 如果忘了配置，将会导致：烧录一次程序后，芯片无法再烧录（按图中操作解锁芯片）。
步骤 8-4：设置晶振源
- 易漏易错的 4 项中，这是其二;
- HSE，外部高速晶振： Crystal/Ceramic Resonator
- LSE ，外部低速晶振：用于实时时钟，不使能，以后用到时再打开CubeMX增加配置置。
步骤 8-5：配置时钟树
- 下图参数，通用STM32F407xx系列 。
- 易漏易错的 4 项中，这是其三; 特别是F4, 经常有人填错晶振值，导致各种无法排查的问题。
- 下图中 1、3 这两项值，注意填写真实晶振值。可以查看晶振上丝印， 也可以查看原理图。
- 在配置F407芯片时，软件上默认是25M的值，但是，市面上F407板子，常用 8M、25M 这两种不同的晶振，一定要注意区分。如果搞错了，程序可能无法运行、通信失败等等。
| 晶振值 | 输入分频 | 输出倍频 | 输出分频 | USB分频 | APB1分频 | APB2分频 | 系统时钟 |
|---|---|---|---|---|---|---|---|
| 8 或 25 | 8 或 25 | 336 | 2 | 7 | 4 | 2 | 168MHz |
平时是灰色不可选状态。当使能了USB功能时，才会变成可设置状态。
步骤 8-6：工程管理
进入工程管理页面，这一页要设置3个地方：工程名称、存放目录、开发环境。
- 易漏易错的 4 项中，这是其四！
- 重点1：工程生成位置、工程名称，不能使用中文！ 否则，生成时会缺少文件，工程无效。
- 重点2：开发环境，默认是EWARM，改 MDK-ARM, 即Keil工程。
- 重点3：Stack Size, 栈空间大小，改 0x1000。Heap Size, 默认，除非你用到malloc申请空间。
栈空间大小 - Stack Size。
在单片机开发中，栈空间大小是一个非常重要的概念。与Java、Python等高级语言不同，单片机的内存资源非常有限，通常只有几十K到几百K。因此，开发者需要特别留意局部数组、变量等占用栈空间的大小，避免栈溢出，导致程序跑飞、卡死。
为避免以后无意间使用了大数组作为函数变量、函数传参，或者要移植FreeRTOS、LVGL等功能，在配置工程时，先把Stack设置大一点，有备无患。
注意，栈溢出是编译时无法发现的，这类bug较难排查。
步骤 8-7：代码文件配置
打勾两个选项：
- 标记2：只复制需要的库文件, 可以有效控制代码体积。
- 标记3：为各种外设生成独立的C、h文件：倘若不打勾，外设的生成代码会堆在main.c中。
至此，基础工程所需，配置完毕。
步骤 8-8：生成工程
稍等片刻，会弹窗：
操作技巧：
- 在刚才的软件配置中，我们使用的是英文的目录路径、英文的工程名称。
- 工程在第一次生成时，必须是英文路径、名称 。否则生成时，会缺失文件。
- 当工程生成后，可以把工程文件夹，修改成中文名称。也可以，把工程文件夹复制到其它带中文的路径中存放，方便管理。
- 但是，不能修改：工程内的子文件夹名称、文件名称！否则工程无法正常打开。
第二部分、工程文件解释
双击打开工程目录，不管哪种STM32芯片, 文件结构都基本相同：
这个目录下，常用的是 ioc文件。
当需要修改工程配置、功能时，双击这个蓝色 ioc 文件，可再次进入CubeMX配置。
文件、文件夹解释：
| Core | 用户平时要编写的文件，都在这文件夹里，如main.c |
| Drives | 芯片内核支持文件、 HAL库文件。都不用修改的 |
| MDK-ARM | 工程入口文件、仿真调试记录文件 |
| 工程名称.ioc | CubeMX的配置文件，双击它，就可以再次对工程进行配置 |
而最常用的，是 “MDK-ARM"这个文件夹。
打开后，如下图，里面有一个绿色图标的 keil 工程文件。
平时就是通过它，打开keil工程，进行代码的编辑。
第三部分、编译验证工程
步骤 2-1：打开工程
双击绿色图标的uvprojx文件，进入keil工程。
Keil 常用按钮，只有三、四个，下图中，圈出了它们的位置，及标示了功能。
双击左侧文件管理器中的 Core 文件夹，其下，有最常用的main.c、it.c等文件。
双击main.c，即可在代码编辑区中打开进行编辑。
步骤 2-2：编译工程
无需做其它环境配置、参数设置。
点击工具栏的 “编译” 按钮，即可对工程进行编译。
等待编译完成后，信息中结果为:0 Error, 即表示CubeMX生成工程成功，如下图：
如果，在CubeMX配置时，使用了中文路径、名称，就会出再各种错误，如缺少启动文件等。
至此，咱的第一个工程，已成功地建成了！
为了清晰界定每一项操作，点亮LED、配置烧录器、烧录等等必备技能，咱们拆篇再独立示范！
CubeMX 与 Keil 的作用区分
CubeMX： 配置工程; 生成指定功能的初始化代码、底层代码;
Keil: 编写具体的业务代码。
其实用keil也能新建、配置工程，编写初始化代码、底层代码。
但通过CubeMX来实现，更直观、更省事。
CubeMX更大的意义在于，当我们熟悉了一个型号芯片的操作后，就能方便在其它型号的芯片间游走，因为不同型号的芯片，配置操作是大致相同的、生成的代码文件结构是相同的、函数名称是相同的。