零基础STM32入门教程--07-按键

原创 已于 2026-08-22 14:19:23 修改 · 41 阅读 · 3 ·
本内容遵循CC 4.0 BY-SA版权协议
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
GEO检测
于 2026-08-22 11:44:37 首次发布

第11课：STM32按键输入实验（标准库）

专栏：STM32F103入门教程
环境：Keil‑MDK + STM32F103 标准库3.5版本

在单片机项目开发中，按键是非常基础、高频使用的人机交互方式。复杂产品会采用触摸屏、APP、小程序，而入门阶段我们先学习普通物理按键读取。本节课使用 PB12 作为按键输入引脚。

一、硬件接线

按键原理

在这里插入图片描述

轻触按键特性：未按下时两端断开；按下之后两端导通。可以把万用表拨到蜂鸣档，自行实测验证通断。

本实验接线方案：

按键一端接开发板3.3V，另一端接单片机PB12引脚。

在这里插入图片描述

GPIO总共有4种输入模式：上拉输入、下拉输入、浮空输入、模拟输入，我们分析该选用哪一种：

  1. 模拟输入GPIO_Mode_AIN：专门用于ADC电压采集，直接排除。
  2. 浮空输入GPIO_Mode_IN_FLOATING：芯片内部上下拉电阻全部断开。引脚电平极易受外界电磁干扰产生抖动，只适合外部电路已经自带上下拉电阻的场景，本实验不使用。
  3. 上拉输入GPIO_Mode_IPU：空闲默认高电平；按键接3.3V，按下后依旧是高电平，电平不会发生变化，无法识别按键动作，不可用。
  4. 下拉输入GPIO_Mode_IPD✅：引脚空闲默认低电平；按键按下接通3.3V，引脚变为高电平，可以准确识别按键按下，本节课选用该模式。

💡学习小建议：上面4种模式大家都可以修改代码实际测试一遍，实践出真知。

面包板实物接线参考：
在这里插入图片描述

  • 3.3V电源从开发板3.3V引脚引出
  • 按键的其中一个引脚接3.3V
  • 按键另外一个引脚飞线连接到PB12

二、工程与程序编写

2.1 工程复制

复制上节课LED_FLASH整个工程文件夹，重命名为KEY，同时把工程文件LED_FLASH.uvprojx重命名为KEY.uvprojx，双击打开工程。

本节课我们加入串口printf打印功能，按键按下时把信息输出到电脑串口助手，方便调试。串口原理后续课程详解，本节课先直接使用，做到会调用即可。

2.2 添加串口驱动文件

  1. 在工程目录 KEY\Hardware 文件夹下新建子文件夹 Usart。
  2. Keil工程，右键Hardware分组 → Add New Item to Group 'Hardware'，新建usart.c源文件。
    在这里插入图片描述

继续新建头文件usart.h：
在这里插入图片描述

usart.h
#ifndef __USART_H   //防止头文件重复包含，避免编译报错
#define __USART_H
#include "stm32f10x.h"
void usart1_init(uint32_t baud); //串口1初始化函数
#endif
usart.c
#include "stdio.h"
#include "usart.h"

// MicroLIB 环境下printf重定向，仅需实现fputc
int fputc(int ch, FILE *f)
{
    USART_SendData(USART1, (uint8_t)ch);
    //等待发送数据寄存器为空，避免丢字符
    while(USART_GetFlagStatus(USART1, USART_FLAG_TXE) == RESET);
    return ch;
}

void usart1_init(uint32_t baud)
{
	GPIO_InitTypeDef GPIO_InitStructure;
	USART_InitTypeDef USART_InitStructure;

	//开启USART1、GPIOA外设时钟
	RCC_APB2PeriphClockCmd(RCC_APB2Periph_USART1|RCC_APB2Periph_GPIOA, ENABLE);

	//PA9 USART1_TX 复用推挽输出
	GPIO_InitStructure.GPIO_Pin = GPIO_Pin_9;
	GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz;
	GPIO_InitStructure.GPIO_Mode = GPIO_Mode_AF_PP;
	GPIO_Init(GPIOA, &GPIO_InitStructure);

	//串口参数初始化
	USART_InitStructure.USART_BaudRate = baud;                     //波特率
	USART_InitStructure.USART_WordLength = USART_WordLength_8b;    //8位数据
	USART_InitStructure.USART_StopBits = USART_StopBits_1;        //1位停止位
	USART_InitStructure.USART_Parity = USART_Parity_No;            //无校验
	USART_InitStructure.USART_HardwareFlowControl = USART_HardwareFlowControl_None; //无硬件流控
	USART_InitStructure.USART_Mode = USART_Mode_Tx;                //仅发送模式

	USART_Init(USART1, &USART_InitStructure);
	USART_Cmd(USART1, ENABLE); //使能串口1
}

  1. 添加标准库外设文件stm32f10x_usart.c到工程，用到哪个外设就添加对应的库文件。在这里插入图片描述

  2. 添加头文件搜索路径，把Hardware\Usart加入包含路径。
    在这里插入图片描述

2.3 添加按键驱动文件

在KEY\Hardware\Gpio目录新建key.c、key.h。

key.h
#ifndef __KEY_H
#define __KEY_H
#include "stm32f10x.h"

void key_init(void);                 //按键GPIO初始化
uint8_t key_press_get(void);         //读取按键状态：返回1代表按键按下

#endif
key.c
#include "key.h"

void key_init(void)
{
	GPIO_InitTypeDef gpio_init_struct;

	RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOB,ENABLE); //开启GPIOB时钟

	gpio_init_struct.GPIO_Pin = GPIO_Pin_12;
	gpio_init_struct.GPIO_Mode = GPIO_Mode_IPD;         //下拉输入模式
	gpio_init_struct.GPIO_Speed = GPIO_Speed_2MHz;       //输入模式低速即可
	GPIO_Init(GPIOB,&gpio_init_struct);
}

//读取PB12引脚电平
uint8_t key_press_get(void)
{
	return GPIO_ReadInputDataBit(GPIOB,GPIO_Pin_12);
}

📖怎么知道API函数、模式宏定义？
可以查阅《STM32F10x_StdPeriph_Driver_3.5.0中文版.chm》固件库手册，也可以直接打开库源码stm32f10x_gpio.c、stm32f10x_gpio.h查看函数声明。
在这里插入图片描述

GPIO库部分函数声明参考：

void GPIO_DeInit(GPIO_TypeDef* GPIOx);
void GPIO_AFIODeInit(void);
void GPIO_Init(GPIO_TypeDef* GPIOx, GPIO_InitTypeDef* GPIO_InitStruct);
void GPIO_StructInit(GPIO_InitTypeDef* GPIO_InitStruct);
uint8_t GPIO_ReadInputDataBit(GPIO_TypeDef* GPIOx, uint16_t GPIO_Pin);
uint16_t GPIO_ReadInputData(GPIO_TypeDef* GPIOx);
uint8_t GPIO_ReadOutputDataBit(GPIO_TypeDef* GPIOx, uint16_t GPIO_Pin);
uint16_t GPIO_ReadOutputData(GPIO_TypeDef* GPIOx);
void GPIO_SetBits(GPIO_TypeDef* GPIOx, uint16_t GPIO_Pin);
void GPIO_ResetBits(GPIO_TypeDef* GPIOx, uint16_t GPIO_Pin);
void GPIO_WriteBit(GPIO_TypeDef* GPIOx, uint16_t GPIO_Pin, BitAction BitVal);
void GPIO_Write(GPIO_TypeDef* GPIOx, uint16_t PortVal);
void GPIO_PinLockConfig(GPIO_TypeDef* GPIOx, uint16_t GPIO_PinSource);
//......省略其余函数

🔔初学阶段优先学会调用库函数；后续进阶再去研究底层寄存器。

2.4 main.c主函数

#include "stm32f10x.h"
#include "led.h"
#include "delay.h"
#include "key.h"
#include "usart.h"
#include <stdio.h>

int main(void)
{
	led_init();
	delay_init();
	usart1_init(115200);  //串口波特率115200，串口助手需要保持一致
	key_init();

	while(1)
	{
		led_on();
		delay_ms(1000);
		led_off();
		delay_ms(1000);

		if(key_press_get() == 1){
			printf("检测到按键按下 \r\n");
		}
	}
}

硬件接线提示：PA9(TX)接到WCH-LINK的RX引脚。

2.5 Keil工程配置MicroLIB

魔术棒 → Target，勾选 Use MicroLIB，printf重定向依赖该配置。
在这里插入图片描述

⚠️注意：MicroLIB不需要写半主机相关桩代码，只需要实现fputc函数。

三、现象与问题分析

下载程序，打开串口助手，波特率设置115200。

现象1：LED周期闪烁，按键很难触发打印

大部分时候按下按键串口没有输出，需要一直按住按键，大约等待2秒左右才会打印一次。

原因分析
主循环里面大部分时间卡在delay_ms(1000)延时，按键检测代码执行时机极少，只有LED熄灭后的一瞬间读取按键电平。

时序说明：0~2000ms执行LED亮灭延时，仅很短的窗口执行按键判断。
在这里插入图片描述
这是时间简化示意图，实际检测时间不到1ms.led_on这类函数执行时间很短，没有算在里面。

现象2：去掉LED延时，循环只检测按键

while(1)
{
	if(key_press_get() == 1){
		printf("检测到按键按下 \r\n");
	}
}

实际效果：按一次按键，串口疯狂输出大量打印信息。
在这里插入图片描述

原因：单片机运行速度极快；人手按下按键持续几百毫秒，在这段时间内程序会循环成千上万次，就会重复多次检测到高电平。

现象3：简单加上延时消抖

while(1)
{
	delay_ms(200);
	if(key_press_get() == 1){
		printf("检测到按键按下 \r\n");
	}
}

简单测试下可以做到按一次打印一次。

❗该写法只适合简单测试项目，实际产品中不推荐。delay_ms是阻塞延时，会卡住整个系统，其他任务无法运行。

✨下一节课我们学习外部中断方式实现按键检测，解决轮询阻塞的痛点。

实物效果图

在这里插入图片描述

串口助手接收效果：
在这里插入图片描述

资料下载

参考资料网盘：
链接: https://pan.baidu.com/s/1BrH0JbUY6z7j7gAihTa4Dw
提取码: qnws

本节课完整工程例程网盘：
链接: https://pan.baidu.com/s/1rl6EIqi9m6kQ1JFjuSqINg
提取码: bumc

标签
#stm32 #嵌入式硬件 #单片机
Stm32CubeMx按键控制呼吸灯
weixin_44229981的博客
06-04 7313
Stm32CubeMx按键控制呼吸灯知识储备外部中断定时器Stm32CubeMx配置配置按键按键基础配置配置按键为触发外部中断并设置优先级配置TIM4的PWM配置PB8引脚功能为 TIM4 的 CH3 输出通道配置TIM4 输出 PWM 信号代码部分定义变量按键外部中断回调函数使能 TIM4 输出 PWM 信号while循环代码 知识储备 在这一次例程里面，按键控制需要用到外部中断，呼吸灯需要用到定时器 外部中断 在stm32中，每一个IO口经过配置都可以触发外部中断 stm32的芯片有16条中断线可供GP
STM32独立按键工作原理及设计
FantasyQin的博客
03-07 2万+
STM32的独立按键的实现，需要懂得独立按键的工作原理，并且还要在STM32单片机的软硬件中进行搭建和设计。
基于stm32标准库独立按键的多按键状态机的实现
meteor的博客
05-03 1万+
写在前面   一般引用都写在最后，但是这篇博文对我这个状态机的影响很大，我这里有许多借鉴他的思维。所以写在前面，如有侵权立即删除 简单按键检测   一开始学习单片机的时候我接触到按键的时候就知道按键有抖动，记得当初按键消抖分为硬件和软件，硬件上常用于复位按键如下图   软件上来说，最经典的消抖 if(KEY1 == 0) { delay_ms(20); // 延时消抖 if(KE...
STM32——GPIO输入——按键检测
qq_36535414的博客
04-20 5008
硬件介绍 当按键置空时，IO接地 按键按下之后，IO口接通3.3V高电压，电流比较大，为了避免损坏IO，这里需要加装一个限流电阻。可以看到IO口是默认低电平，按键按下后产生一个上升沿，和平常的电路设计不太一样。这是因为PA0还具有一种自动唤醒的功能叫Weakup，Weakup必须要是上升沿才能唤醒的。 电容C6以及C14是用来做硬件消抖的。其原理就是，机械按键在按下的过程大约有20ms，在这个过程中，IO与3.3V电源不断地接通，相当于形成了一个交流电，这时有电容的话，这个过程就相当于是在给这个电容不断地
STM32-按键输入
一直在路上的Tom的博客
09-19 1万+
1 硬件连接 1.1mini 1.2战舰 1.3 探索者 KEY0->PE4 上拉输入KEY1->PE3 上拉输入KEY2->PE2 上拉输入WK_UP->PA0 下拉输入 按键输入最关键的是对按键的初始化和输入判断。这里按键的初始化与LED的初始化不同的是GPIO的模式不一样了，LED是推挽输出，按键则相反，是输入，这个时候要考虑是哪一种输入方式，这里当我的板子上按键...
【STM32】电容触摸按键
weixin_63726869的博客
08-26 6362
介绍了触摸按键的工作原理，以及代码实现。
基于STM32利用按键点亮LED灯
tsundere_ning的博客
07-12 2万+
基于STM32利用按键点亮LED灯的基本步骤：（1）打开stm32CubeMX，创建新工程文件（2）选择需要的芯片，本次实验采用的是STM32F411RETx（3）黄色代表可被使用的引脚，绿色代表已被确定功能的引脚。左侧设置栏中的红色部分表示：IO口复用造成的重叠，以至不能继续使用。（4）选好芯片，设置好相关系数参量后，选择与keil5相对应的MDK—ARM V5。源程序：1.按键按下LED灯点亮......
STM32-按键检测
weixin_46251230的博客
09-02 1万+
因为key_up被初始化为1，第一次按下时，if(key_up && KEY被按下)判断为真，检测KEY确实被按下后，key_up被置为0，返回 KEY_Value 然后return退出，假如是一直按着按键的，那下一次进行按键检测时，if(mode == 1) 为真，key_up = 1，所以 if(key_up && KEY被按下)判断又为真，继续进入里面执行，继续返回KEY_Value，达到连续按效果。然后通过对寄存器进行操作，采用异或的功能，取反某一位，达到按一次亮，再按一次熄灭的效果。
以STM32为例，实现按键的短按和长按
ShenZhen_zixian的博客
01-03 1万+
以STM32为例，实现按键的短按和长按。
STM32CubeMX之外部中断检测按键
weixin_44453694的博客
06-03 3577
中断，是指处理机处理程序运行中出现的紧急事件的整个过程。程序运行过程中，系统外部、系统内部或者现行程序本身若出现紧急事件，处理机立即中止现行程序的运行，自动转入相应的处理程序(中断服务程序)，待处理完后，再返回原来的程序运行，这整个过程称为程序中断。当处理机接受中断时，只需暂停一个或几个周期而不执行处理程序的中断，称为简单中断，中断又可分为屏蔽中断和非屏蔽中断两类。异常中断向量控制器， 简称 NVIC。
【STM32】HAL库——按键原理及消抖
Q大帅
08-19 1万+
前期准备： STM32CubeMX STM32RCT6核心板 IDE Keil（MDK-ARM） 什么是按键消抖？ 按键消抖通常的按键所用开关为机械弹性开关，当机械触点断开、闭合时，由于机械触点的弹性作用，一个按键开关在闭合时不会马上稳定地接通，在断开时也不会一下子断开。因而在闭合及断开的瞬间均伴随有一连串的抖动，为了不产生这种现象而作的措施就是按键消抖 按键工作原理 这是最基本的按键电路，以KEY1为例： 3.3V流经10k电阻（限流电阻），经过按键再流入地，但是按键常态是松开的，也就是说这条路常态
STM32按键的长按和短按(一)
qq_72890400的博客
10-28 5107
判断按键长按和短按的依据就是按下时间的长短，就需要一个计时器来记录时间。这里有两种选择，一种是延时计时，利用delay延时函数通过不断轮询记录时间；另一种是利用单片机的外设——定时器计时，利用定时器的基础计时功能在溢出中断记录时间，两种方法都可以完成计时功能，选择哪一种就看个人喜好，这里用的是第二种。
STM32按键扫描及按键消抖
memoryers的博客
08-21 6615
①检测按键是否按下②延时10~15ms③再检测按键是否按下④等待按键抬起⑤返回键值。
stm32按键 长按 短按 函数 二
xiaohu1996的博客
11-30 3937
在学习过程中，遇到了要使用很多个按键的情况，（没有同时按下的处理，没有用矩阵键盘）。一增加一个新按键，需要改动的地方太多，在网上看了一篇博客 https://blog.csdn.net/jiejiemcu/article/details/83097992 觉得它使用的方法不错，就进行学习研究，移植到stm32单片机上。这种编程思想值得学习，做个小总结。 typedef struct but...
STM32按键设计二之按键中断
热门推荐
gong_ming的博客
04-29 2万+
按键中断 STM32使用按键中断需要配置端口IO，EXTI和NVIC。 当按键按下的时候，引脚电平发生转变，同时触发沿触发EXTI中断，进而打断CPU(如果正在执行非中断程序或者中断级别低的程序)正在执行的程序，使程序跳转到EXTI中断中执行。 上篇使用了扫描处理中断，本篇将使用按键中断控制LED灯。按键按下则LED灯点亮，松开按键LED灯灭。【传送门：STM32按键设计一之扫描】 按键中断程序设计 首先，在key.h中定义一个中断模式开启开关的宏定义，可以切换按键扫描和按键中断，使在程序设计的过
入门STM32--按键输入
weixin_58670090的博客
08-20 2557
按键输入
STM32按键设计三之两个按键操控整个系统十几乃至几十种功能
gong_ming的博客
04-30 8901
本篇任务 前言： 按键，基本上所有设备的必备，可以毫不夸张的说：目之所及，皆有按键。 几个按键合适？根据系统控制需要，量才而用。按键是大才，能轻易的控制整个系统进行不同状态或者行为的切换，同时也是耗材，浪费IO口，占据大量体积。所以，需要量才而用，买足系统需求的前提下，越精简越好。 本篇将在上一篇按键中断的基础上，实现两个按键控制系统十几乃至几十中状态，节省器件，节约空间，节约IO口，同时又能实现复杂功能，目标就两个字”节约精简“。 按键实现 需要了解本篇，需要对上篇有个大致了解。只需要知道上篇按键中断
Stm32解决按键长按与短按
zhengyuehai的博客
04-10 1万+
Stm32 解决按键的长按和短按 废话不多说， 直接上干货 注意：本文是采用Stm32 HAL库编写， 可以移植成库函数， 其原理是相同的！！！！ 第一步 ： 首先在key.h定义几个变量 ///// 按键的键值 #define KEY1_Press 1 #define KEY2_Press 2 #define KEY3_Press 3 #define KEY4_Press 4 ///// 读取IO口的电平 #define KEY1 HAL_GPIO_ReadPin(GPIOB, GPIO_PI
stm32-硬件SPI
最新发布
youshi6668的博客
08-19 472
软件SPI灵活可变；硬件SPI高性能，可以减轻软件负担SPI1在APB2总线，APB2外设时钟频率=72MHZ;SPI2在APB1总线，APB1总线外设时钟频率=36MHZ。SPI的时钟就来源于外设时钟分频，可以是2~256分频。I2S协议是一种音频协议，和SPI很相似。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

oshan2012

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

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

余额充值