1. 代码开发工具用错顺序,后面全是返工
代码开发工具用错顺序,后面全是返工。我习惯先用 STM32CubeMX 把芯片型号、时钟、引脚和 GPIO 输入模式配好,生成 MDK-ARM 工程,再进 Keil MDK-ARM 补业务代码。这次拿人体红外模块当输入源,不是为了讲传感器原理,而是让这套工具链跑通一条可复现的路径:从新建工程到 PA0 读到电平,中间不手写启动文件,也不背寄存器地址。它适合刚接触 STM32 工具链、又不想一上来就啃手册的人,也适合需要把生成工程交接给同事的场合。下面按建工程、配引脚、生成代码、补 HAL 代码、排错、验证的顺序走一遍。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. STM32CubeMX 建工程:芯片、时钟、PA0 输入三处配置
2.1 新建工程与芯片型号:先锁定 STM32F103C8T6
打开 STM32CubeMX,从 File 菜单进 New Project,在 Part Number 搜索框里直接输入 STM32F103C8T6。搜索框支持完整型号,输入完整型号比在列表里翻系列稳,尤其同系列不同封装长得像,选错之后启动文件、HAL 驱动和引脚定义都会跟着错。材料里给的芯片就是 STM32F103C8T6,工程里的 GPIOA、PA0 这些名字都从这颗芯片的引脚定义来,先锁型号再谈配置。
选中型号后点 Start Project,工程保存路径我一般会避开中文和空格。这不是洁癖,Keil 打开带空格路径的工程时偶尔会出现找不到源文件的情况,排起来很烦。生成目录里会多出 Core、Drivers、MDK-ARM 三块,Core 放 main.c 和 main.h,Drivers 放 HAL 库,MDK-ARM 里才是 Keil 能打开的工程文件。路径定好之后不要中途挪目录,CubeMX 重新生成时按原路径写文件,挪了容易生成到旧地方。
型号选完先别急着点 Generate Code。CubeMX 的配置是“先画引脚、再配外设、最后生成”,顺序反了会反复改。先把 Pinout 视图切出来,看清楚 PA0 在芯片哪个位置,再去配引脚模式,这样后面生成代码时不会把输入配成输出。
2.2 时钟和调试接口:先把系统节拍和下载口留住
材料里说“配置相应的时钟、引脚和外设”,没有给具体频率,我也不会在这篇里编一个数字。实际做法是:在 Pinout & Configuration 左侧找到 System Core 里的 SYS,Debug 选项选 Serial Wire。这一步比时钟更先做,因为调试口关掉之后,下载一次程序可能就连不上芯片,得用复位方式救回来,算是一条血泪经验。Serial Wire 只占两个引脚,留给下载和调试用,不影响 PA0 做输入。
时钟树在 Clock Configuration 页。如果板子上有外部晶振,按原理图选 HSE;如果手头只有最小系统板、不确定晶振焊没焊,就先保持默认内部时钟,等 GPIO 输入跑通再动时钟树。为什么先不动时钟?因为时钟配错的现象是“程序下载了但不跑”或“串口乱码”,而这一篇只验证 PA0 电平,先把变量减少。HAL 库的 HAL_Init 会按 CubeMX 里的时钟配置建立系统节拍,节拍不对,后面的 HAL_Delay 也会跟着不准。
还有一个前置条件:确认下载器接的是 SWD 口,不是只接了电源。Keil 里下载配置选错,编译能过,下载会报找不到目标。这个坑在第 4 章还会展开,这里先把调试口留住。
2.3 PA0 配成 GPIO_Input 与上拉:引脚、模式、Pull 三件事
在 Pinout 视图里找到 PA0,左键点一下,下拉菜单选 GPIO_Input。这时 PA0 会变成绿色,表示已经被占用。接着到左侧 System Core 里点 GPIO,在列表里选中 PA0,下面会出现这个引脚的详细参数。材料里的代码用的是 GPIO_MODE_INPUT 和 GPIO_PULLUP,对应到 CubeMX 就是 Mode 选 Input,Pull 选 Pull-up。User Label 可以填 SENSOR,生成代码时会在 main.h 里多一个宏,方便人看,不填也不影响功能。
为什么用上拉?人体红外模块的输出通常是开关量,空闲时希望引脚有一个确定的电平,不要悬空。悬空输入在高阻态下读数会乱跳,看起来像“玄学触发”。上拉之后,空闲为高,模块触发时把引脚拉低,代码里判断 GPIO_PIN_RESET 就行。但这里有一个前提:模块输出有效电平是低有效。如果手里的模块是高有效,上拉不影响它输出高,代码里的判断要反过来。先按低有效配,后面用调试器看 IDR 再确认,别把判断写死。
配置项可以用下面这张表对照,位置都在 CubeMX 里,不需要手改寄存器:
| 配置项 | 在 CubeMX 的位置 | 设成什么 | 作用 |
|---|---|---|---|
| 芯片型号 | New Project 的 Part Number | STM32F103C8T6 | 绑定启动文件与引脚定义 |
| PA0 模式 | Pinout 视图点 PA0 | GPIO_Input | 让引脚读电平而不是驱动 |
| PA0 上拉 | System Core -> GPIO -> PA0 | Pull-up | 空闲时给确定高电平 |
| 调试口 | System Core -> SYS | Serial Wire | 保留 SWD 下载与调试 |
| 工具链 | Project Manager -> Project | MDK-ARM | 生成 Keil 能打开的工程 |
表里最容易被忽略的是工具链。材料里明确说用 Keil MDK-ARM 作为开发环境,所以生成时必须选 MDK-ARM,不能选成别的 IDE 再指望 Keil 直接打开。选错之后生成目录里没有 .uvprojx,只有别的工程文件,现场就会卡在“Keil 怎么打开”这一步。
2.4 Generate Code:工具链选 MDK-ARM,生成后先编译一次
引脚和时钟配完,切到 Project Manager 的 Project 页。Project Name 填一个不带空格的英文名,Project Location 用刚才定好的路径,Toolchain/IDE 选 MDK-ARM。材料里说“点击 Project 菜单,选择 Generate Code 选项”,对应到操作就是顶部菜单 Project -> Generate Code。生成过程会把 HAL 库、启动文件、main.c、main.h 和 Keil 工程一起写出来。
生成完先别改代码,直接进 MDK-ARM 目录双击 .uvprojx 打开 Keil,点一次 Build。这一步是基线验证:如果生成出来的空工程都编译不过,后面加代码只会更乱。编译通过的标准是 0 Error,Warning 可以暂时留着。如果提示找不到器件包,说明 Keil 没装 STM32F1 系列的 Device Pack,去 Pack Installer 里补,不要急着手写寄存器绕过。
生成后的 Core/Src/main.c 里会有 /* USER CODE BEGIN */ 和 /* USER CODE END */ 成对注释。自己的代码要写在两段注释之间,这是后面反复重新生成时唯一不会被冲掉的位置。材料里没有展开这一点,但 CubeMX 的生成逻辑就是按这些区间保留用户代码,写在区间外的内容下次 Generate Code 会被覆盖。先记住这个边界,第 4 章会专门讲翻车现象。
3. Keil MDK-ARM 补代码:HAL_GPIO 初始化的四个参数与读取判断
3.1 宏定义放哪里:SENSOR_PIN 和 SENSOR_GPIO 的可读性
材料里的写法是在 main.c 顶部加两个宏:
c复制#include "stm32f1xx_hal.h"
#define SENSOR_PIN GPIO_PIN_0
#define SENSOR_GPIO GPIOA
这两行把“第 0 号引脚”和“GPIOA 端口”拆成两个有名字的符号。好处是后面换引脚只改宏,不用在初始化、读取、调试打印里到处搜 GPIO_PIN_0。GPIO_PIN_0 是 HAL 定义的位掩码,不是数字 0;GPIOA 是端口基地址的宏,也不是随便写的变量。把这两个宏放在 main.c 顶部、/* USER CODE BEGIN Includes */ 附近,重新生成时不会被冲掉。
如果工程里多处要读这个传感器,可以把宏挪到 main.h 的 /* USER CODE BEGIN Private defines */ 区间,再把 main.h 包含进去。单文件验证阶段放 main.c 就够,不要为了“规范”提前拆一堆文件,先把电平读通。
3.2 HAL_Init 与 GPIOA 时钟使能:初始化顺序不能反
材料里的初始化顺序是 HAL_Init 在前,时钟使能在后:
c复制/* 初始化HAL库 */
HAL_Init();
/* 初始化GPIO引脚 */
__HAL_RCC_GPIOA_CLK_ENABLE();
GPIO_InitTypeDef GPIO_InitStruct;
GPIO_InitStruct.Pin = SENSOR_PIN;
GPIO_InitStruct.Mode = GPIO_MODE_INPUT;
GPIO_InitStruct.Pull = GPIO_PULLUP;
HAL_GPIO_Init(SENSOR_GPIO, &GPIO_InitStruct);
HAL_Init() 先建立 HAL 的时基和中断优先级分组,后面 HAL_Delay 能不能用、HAL 内部状态对不对,都依赖它。__HAL_RCC_GPIOA_CLK_ENABLE() 是打开 GPIOA 的外设时钟。STM32 的外设不打开时钟,写它的寄存器不会生效,HAL_GPIO_Init 看起来执行了,引脚其实没配上。这个顺序不能反:先开时钟,再配 GPIO;HAL_Init 放在最前面,是因为时钟配置和 HAL 状态初始化要在外设使用之前完成。
GPIO_InitTypeDef GPIO_InitStruct; 是声明一个初始化结构体,三个关键字段在下面赋值。HAL_GPIO_Init(SENSOR_GPIO, &GPIO_InitStruct); 把结构体传给 HAL,由 HAL 去写 GPIOA 的配置寄存器。第二个参数要传地址,所以是 &GPIO_InitStruct,不是结构体本身。材料里的 & 是转义写法,实际代码就是 &。
3.3 GPIO_InitTypeDef 三行:Pin、Mode、Pull 分别管什么
三个字段对应三件事,设错任何一个,现象都不一样:
| 字段 | 材料里的值 | 管什么 | 设错会怎样 |
|---|---|---|---|
| Pin | GPIO_PIN_0 |
选中 PA0 这一位 | 配到别的引脚,PA0 还是默认状态 |
| Mode | GPIO_MODE_INPUT |
引脚方向为输入 | 配成输出会驱动引脚,读回来不是外部电平 |
| Pull | GPIO_PULLUP |
内部上拉打开 | 配成无上下拉,悬空时读数乱跳 |
GPIO_MODE_INPUT 和 GPIO_MODE_OUTPUT_PP 是两种完全不同的方向。输入模式下引脚是高阻,外部信号决定电平;输出模式下芯片自己驱动引脚,这时候再去读外部传感器,读到的可能是自己输出的电平。材料里明确用 GPIO_MODE_INPUT,因为红外模块是输出方,STM32 只负责读。
GPIO_PULLUP 打开内部上拉。如果模块输出是开漏低有效,上拉负责把空闲电平拉到高;如果模块是推挽输出,内部上拉一般不会把低电平拉不低,但会增加一点电流。保守做法是先用上拉,读不到再查模块输出类型。不要同时开上拉又外部加一个强下拉,电平会被分压,判断会飘。
3.4 读取与判断:HAL_GPIO_ReadPin 返回什么,循环里怎么放
材料只给了初始化,读取用 HAL 的标准接口补上,仍然在同一套 HAL 接口范围内:
c复制while (1)
{
/* 常见做法:低电平视为触发,具体以模块有效电平为准 */
if (HAL_GPIO_ReadPin(SENSOR_GPIO, SENSOR_PIN) == GPIO_PIN_RESET)
{
/* 这里放触发后的业务,例如置标志位 */
}
/* 50ms 轮询一次,避开人体微动时的抖动 */
HAL_Delay(50);
}
HAL_GPIO_ReadPin 返回的是 GPIO_PinState,取值是 GPIO_PIN_SET 或 GPIO_PIN_RESET,不是 0 和 1 的普通整数。所以判断时用 == GPIO_PIN_RESET,不要写 == 0,也不要拿返回值直接和 GPIO_PIN_0 比。GPIO_PIN_0 是掩码,GPIO_PIN_RESET 是状态,两个概念不一样。
HAL_Delay(50) 是轮询周期。红外模块在人体微动时输出会抖,周期太短会看到状态频繁跳变,周期太长又可能漏掉快速经过。50ms 是常见折中,不是硬指标;如果业务要求更快响应,可以改成 10ms 并加连续采样确认,但不要在中断里放 HAL_Delay。这一版先用轮询,不展开中断方式,避免把 GPIO 输入和 EXTI 混在一起讲。
3.5 编译下载:Build 和 Download 前看两个地方
代码写进 /* USER CODE BEGIN 2 */ 和 /* USER CODE END 2 */ 之间,或者放在 main 的 while 循环对应的 USER CODE 区间。点 Keil 的 Build 按钮,先看 0 Error。如果报 stm32f1xx_hal.h 找不到,检查 Include Paths 里有没有 HAL 的 Inc 目录;CubeMX 生成的工程一般已经配好,除非手工挪过目录。
下载前看两个地方:Options for Target 的 Debug 页选对下载器,Port 选 SW;Utilities 页确认 Download 之后复位运行。材料没有指定下载器型号,按手里实际接的选,不要照抄别人的配置。编译通过但下载报“No target connected”,先查线序和供电,再查 Debug 页的 Port,不要一上来就怀疑代码。
4. 避坑排查:代码开发工具链上最容易翻车的四件事
4.1 现象:Keil 打不开生成的工程,或者打开后没有器件
现象是 CubeMX 生成完,MDK-ARM 目录里找不到 .uvprojx,或者 Keil 打开后提示 device not found。原因通常有两个:一是 Project Manager 里的 Toolchain/IDE 没选 MDK-ARM,生成的是别的 IDE 工程;二是 Keil 没装 STM32F1 系列的 Device Pack。前者是生成配置问题,后者是开发环境缺件,两者都会让人误以为 CubeMX 没生成成功。
解决顺序是先回 CubeMX 看 Project Manager 的 Toolchain/IDE,确认是 MDK-ARM 后重新 Generate Code;如果工程文件在,但 Keil 提示找不到器件,打开 Pack Installer 搜 STM32F1,装上对应系列包再重开工程。不要用手写启动文件的方式绕,HAL 库和启动文件是配套的,绕过去后面中断向量表对不上,排起来更费时间。
4.2 现象:编译通过,PA0 读数一直不变
现象是程序下载后,不管手在传感器前面怎么晃,HAL_GPIO_ReadPin 返回一直是同一个值。原因有三种常见可能:GPIOA 时钟没使能,HAL_GPIO_Init 写了但寄存器没生效;宏 SENSOR_PIN 或 SENSOR_GPIO 指向的引脚和实际接线不一致;CubeMX 里 PA0 没配成 GPIO_Input,生成代码里根本没有这段初始化。
解决时先看 main.c 里有没有 __HAL_RCC_GPIOA_CLK_ENABLE(),再看 SENSOR_GPIO 是不是 GPIOA、SENSOR_PIN 是不是 GPIO_PIN_0,最后对照板子丝印确认传感器输出线真的接在 PA0。三步都对了还不变,进 Keil 调试模式看 GPIOA 的 IDR 寄存器,手动遮挡传感器,看对应位有没有翻转。IDR 不变是硬件接线或模块供电问题,IDR 变了而代码判断不变,才是软件判断问题。
4.3 现象:重新 Generate Code 后自己写的逻辑消失
现象是第一次写完读取逻辑能跑,回 CubeMX 改了一个引脚或时钟,再 Generate Code,Keil 一编译发现自己的代码没了。原因是代码写在了 /* USER CODE BEGIN */ 和 /* USER CODE END */ 区间外,CubeMX 重新生成时按模板重写 main.c,区间外的内容被覆盖。这不是 CubeMX 的 bug,是它的生成规则。
解决是把业务代码放进 USER CODE 区间,初始化放 USER CODE BEGIN 2,循环里的读取放 USER CODE BEGIN 3 对应的 while 内。如果逻辑已经变多,把读取和判断封装成独立函数,放到自己新建的 .c/.h 里,main.c 只留一行调用。这样即使 main.c 被重新生成,业务文件不动。从那以后我每次点 Generate Code 之前,先扫一眼自己最近改的那几行在不在 USER CODE 区间里,这个习惯能省很多后悔药。
4.4 现象:没人也触发,有人反而不触发
现象是传感器前面没人,代码却一直进触发分支;手放上去,状态反而恢复。原因多半是有效电平判断反了,或者上拉配置和模块输出类型不匹配。材料里的初始化用了 GPIO_PULLUP,代码示例按 GPIO_PIN_RESET 判断触发,这是建立在模块低有效的前提上。如果手里的模块是高有效,空闲低、触发高,判断就要改成 GPIO_PIN_SET。
解决时先用调试器看空闲和触发两种状态下 IDR 的对应位,确认模块到底输出高还是低,再改判断,不要靠猜。另一个检查点是模块供电和地是否共地,共地不良时电平会漂。上拉不是万能的,如果模块输出是强推挽高有效,内部上拉不会改变它的高电平;如果模块是开漏且没有外部上拉,内部上拉刚好补上。先确认输出类型,再决定 Pull 要不要保留。
5. 验证与收尾:用 GPIOA->IDR 和 USER CODE 区间把工程变成可复用模板
验证 PA0 最直接的办法不是反复改代码打印,而是进 Keil 调试模式看寄存器。在 Watch 窗口输入 GPIOA->IDR,或者打开 Peripherals 里的 GPIOA,观察第 0 位。手遮挡传感器时这一位翻转,说明从模块到引脚这一段是通的;不翻转就先查线和供电,不要继续在代码里找原因。
c复制/* 调试用:在 USER CODE BEGIN 2 里读一次快照 */
uint32_t idr_snapshot = GPIOA->IDR;
/* 业务用:把判断收成一个函数,换引脚只改宏 */
static uint8_t sensor_is_triggered(void)
{
return (HAL_GPIO_ReadPin(SENSOR_GPIO, SENSOR_PIN) == GPIO_PIN_RESET) ? 1 : 0;
}
GPIOA->IDR 是端口输入数据寄存器,读它能看到引脚当前电平,不走 HAL 的封装,适合排查“到底是引脚没变还是代码判断错”。sensor_is_triggered 把判断收在一处,后面要改有效电平只改这个函数,不用在 while 里到处搜。两个片段都放在 USER CODE 区间,重新生成不会丢。
| 验证动作 | 看哪里 | 预期 |
|---|---|---|
| 遮挡传感器 | GPIOA->IDR 第 0 位 | 电平翻转 |
| 不遮挡 | GPIOA->IDR 第 0 位 | 保持空闲电平 |
| 改判断条件 | sensor_is_triggered 返回值 |
与模块有效电平一致 |
| 重新 Generate Code | main.c 的 USER CODE 区间 | 自己的代码还在 |
这套模板跑通之后,换别的开关量传感器也是同一套:CubeMX 配输入和上下拉,Keil 里用 HAL_GPIO_ReadPin 读,判断收成一个函数,调试先看 IDR。从那以后我每次用 CubeMX 重新生成前,都强制先看一眼 USER CODE 区间和 Toolchain 选项,再点 Generate Code;这两处不出错,后面的代码才谈得上复用。希望帮到你。
