【HAL库每天一例】第004例：GPIO-按键状态判断之扫描式

haohao663

【HAL库每天一例】系列例程从今天开始持续更新。。。。。
我们将坚持每天至少发布一个基于YS-F1Pro开发板的HAL库例程，
该系列例程将带领大家从零开始使用HAL库，后面会持续添加模块应用例程。
同样的，我们还程序发布基于HAL库的指导文档和视频教程，欢迎持续关注，并提出改进意见。
例程下载：
资料包括程序、相关说明资料以及软件使用截图
链接：https://pan.baidu.com/s/1i574oPv
密码：r3s3
（硬石YS-F1Pro开发板HAL库例程持续更新\1. 软件设计之基本裸机例程(HAL库版本)\YSF1_HAL-004. GPIO-按键状态判断之扫描式）

/**
  ******************************************************************************
  *                           硬石YS-F1Pro开发板例程功能说明
  *
  *  例程名称: YSF1_HAL-004. GPIO-按键状态判断之扫描式
  *   
  ******************************************************************************
  * 说明：
  * 本例程配套硬石stm32开发板YS-F1Pro使用。
  * 版权归硬石嵌入式开发团队所有，请勿商用。
  ******************************************************************************
  */

【1】例程简介
  GPIO输入功能操作实现，之前控制GPIO输出高低电平实现LED灯亮灭，现在是时钟GPIO为输
入模式，按键按下时会改变GPIO的电平，对应的STM32检测到KEY对应IO电平发生变化，得出
按键状态，从而实现LED灯状态改变。  本例程在while(1)无限循环中不断检测按键状态，一
旦发现有状态改变就相应改变LED灯状态。
  在下个例程我们将讲解另外一种按键检测模式--中断式。
  
【2】跳线帽情况
******* 为保证例程正常运行，必须插入以下跳线帽 **********
丝印编号     IO端口      目标功能引脚        出厂默认设置
  JP3        PB0           LED1               已接入
  JP4        PG6           LED2               已接入
  JP5        PG7           LED3               已接入
  
【3】操作及现象
  使用开发板配套的MINI USB线连接到开发板标示“调试串口”字样的MIMI USB接口为开发板供电。
    下载完程序之后，板上三个LED灯全灭状态，按下KEY1或KEY2对应LED和蜂鸣器状态发生改变。

/******************* (C) COPYRIGHT 2015-2020 硬石嵌入式开发团队 *****END OF FILE****/

bsp_key.h文件内容：

1. #ifndef __BSP_KEY_H__
   
2. #define __BSP_KEY_H__
   
3. 
   
4. /* 包含头文件 ----------------------------------------------------------------*/
   
5. #include "stm32f1xx_hal.h"
   
6. 
   
7. /* 类型定义 --------------------------------------------------------------*/
   
8. typedef enum
   
9. {
   
10.   KEY_UP   = 0,
    
11.   KEY_DOWN = 1,
    
12. }KEYState_TypeDef;
    
13. 
    
14. /* 宏定义 --------------------------------------------------------------------*/
    
15. #define KEY1_RCC_CLK_ENABLE           __HAL_RCC_GPIOA_CLK_ENABLE
    
16. #define KEY1_GPIO_PIN                 GPIO_PIN_0
    
17. #define KEY1_GPIO                     GPIOA
    
18. #define KEY1_DOWN_LEVEL               1  /* 根据原理图设计，KEY1按下时引脚为高电平，所以这里设置为1 */
    
19. 
    
20. #define KEY2_RCC_CLK_ENABLE           __HAL_RCC_GPIOC_CLK_ENABLE
    
21. #define KEY2_GPIO_PIN                 GPIO_PIN_13
    
22. #define KEY2_GPIO                     GPIOC
    
23. #define KEY2_DOWN_LEVEL               0  /* 根据原理图设计，KEY1按下时引脚为低电平，所以这里设置为0 */
    
24. 
    
25. /* 扩展变量 ------------------------------------------------------------------*/
    
26. /* 函数声明 ------------------------------------------------------------------*/
    
27. void KEY_GPIO_Init(void);
    
28. KEYState_TypeDef KEY1_StateRead(void);
    
29. KEYState_TypeDef KEY2_StateRead(void);
    
30. 
    
31. #endif  // __BSP_KEY_H__
    
32. 
    
33. /******************* (C) COPYRIGHT 2015-2020 硬石嵌入式开发团队 *****END OF FILE****/
    

复制代码

bsp_key.h文件内容：

1. /**
   
2.   ******************************************************************************
   
3.   * 文件名程: bsp_key.c
   
4.   * 作    者: 硬石嵌入式开发团队
   
5.   * 版    本: V1.0
   
6.   * 编写日期: 2015-10-04
   
7.   * 功    能: 板载独立按键底层驱动函数
   
8.   ******************************************************************************
   
9.   * 说明：
   
10.   * 本例程配套硬石stm32开发板YS-F1Pro使用。
    
11.   *
    
12.   * 淘宝：
    
13.   * 论坛：ing10bbs
    
14.   * 版权归硬石嵌入式开发团队所有，请勿商用。
    
15.   ******************************************************************************
    
16.   */
    
17. 
    
18. /* 包含头文件 ----------------------------------------------------------------*/
    
19. #include "key/bsp_key.h"
    
20. 
    
21. /* 私有类型定义 --------------------------------------------------------------*/
    
22. /* 私有宏定义 ----------------------------------------------------------------*/
    
23. /* 私有变量 ------------------------------------------------------------------*/
    
24. /* 扩展变量 ------------------------------------------------------------------*/
    
25. /* 私有函数原形 --------------------------------------------------------------*/
    
26. /* 函数体 --------------------------------------------------------------------*/
    
27. 
    
28. /**
    
29.   * 函数功能: 板载按键IO引脚初始化.
    
30.   * 输入参数: 无
    
31.   * 返 回 值: 无
    
32.   * 说    明：使用宏定义方法代替具体引脚号，方便程序移植，只要简单修改bsp_key.h
    
33.   *           文件相关宏定义就可以方便修改引脚。
    
34.   */
    
35. void KEY_GPIO_Init(void)
    
36. {
    
37.    /* 定义IO硬件初始化结构体变量 */
    
38.   GPIO_InitTypeDef GPIO_InitStruct;
    
39.         
    
40.         /* 使能(开启)KEY引脚对应IO端口时钟 */  
    
41.   KEY1_RCC_CLK_ENABLE();
    
42.   KEY2_RCC_CLK_ENABLE();
    
43.   
    
44.   /* 配置KEY1 GPIO:输入下拉模式 */
    
45.   GPIO_InitStruct.Pin = KEY1_GPIO_PIN;
    
46.   GPIO_InitStruct.Mode = GPIO_MODE_INPUT;
    
47.   GPIO_InitStruct.Pull = GPIO_PULLDOWN;
    
48.   HAL_GPIO_Init(KEY1_GPIO, &GPIO_InitStruct);  
    
49.   
    
50.   /* 配置KEY2 GPIO:输入上拉模式 */
    
51.   GPIO_InitStruct.Pin = KEY2_GPIO_PIN;
    
52.   GPIO_InitStruct.Mode = GPIO_MODE_INPUT;
    
53.   GPIO_InitStruct.Pull = GPIO_PULLUP;
    
54.   HAL_GPIO_Init(KEY2_GPIO, &GPIO_InitStruct);
    
55. 
    
56. }
    
57. 
    
58. /**
    
59.   * 函数功能: 读取按键KEY1的状态
    
60.   * 输入参数：无
    
61.   * 返 回 值: KEY_DOWN：按键被按下；
    
62.   *           KEY_UP  ：按键没被按下
    
63.   * 说    明：无。
    
64.   */
    
65. KEYState_TypeDef KEY1_StateRead(void)
    
66. {
    
67.   /* 读取此时按键值并判断是否是被按下状态，如果是被按下状态进入函数内 */
    
68.   if(HAL_GPIO_ReadPin(KEY1_GPIO,KEY1_GPIO_PIN)==KEY1_DOWN_LEVEL)
    
69.   {
    
70.     /* 延时一小段时间，消除抖动 */
    
71.     HAL_Delay(10);
    
72.     /* 延时时间后再来判断按键状态，如果还是按下状态说明按键确实被按下 */
    
73.     if(HAL_GPIO_ReadPin(KEY1_GPIO,KEY1_GPIO_PIN)==KEY1_DOWN_LEVEL)
    
74.     {
    
75.       /* 等待按键弹开才退出按键扫描函数 */
    
76.       while(HAL_GPIO_ReadPin(KEY1_GPIO,KEY1_GPIO_PIN)==KEY1_DOWN_LEVEL);
    
77.        /* 按键扫描完毕，确定按键被按下，返回按键被按下状态 */
    
78.       return KEY_DOWN;
    
79.     }
    
80.   }
    
81.   /* 按键没被按下，返回没被按下状态 */
    
82.   return KEY_UP;
    
83. }
    
84. 
    
85. /**
    
86.   * 函数功能: 读取按键KEY2的状态
    
87.   * 输入参数：无
    
88.   * 返 回 值: KEY_DOWN：按键被按下；
    
89.   *           KEY_UP  ：按键没被按下
    
90.   * 说    明：无。
    
91.   */
    
92. KEYState_TypeDef KEY2_StateRead(void)
    
93. {
    
94.   /* 读取此时按键值并判断是否是被按下状态，如果是被按下状态进入函数内 */
    
95.   if(HAL_GPIO_ReadPin(KEY2_GPIO,KEY2_GPIO_PIN)==KEY2_DOWN_LEVEL)
    
96.   {
    
97.     /* 延时一小段时间，消除抖动 */
    
98.     HAL_Delay(10);
    
99.     /* 延时时间后再来判断按键状态，如果还是按下状态说明按键确实被按下 */
    
100.     if(HAL_GPIO_ReadPin(KEY2_GPIO,KEY2_GPIO_PIN)==KEY2_DOWN_LEVEL)
     
101.     {
     
102.       /* 等待按键弹开才退出按键扫描函数 */
     
103.       while(HAL_GPIO_ReadPin(KEY2_GPIO,KEY2_GPIO_PIN)==KEY2_DOWN_LEVEL);
     
104.        /* 按键扫描完毕，确定按键被按下，返回按键被按下状态 */
     
105.       return KEY_DOWN;
     
106.     }
     
107.   }
     
108.   /* 按键没被按下，返回没被按下状态 */
     
109.   return KEY_UP;
     
110. }
     
111. 
     
112. /******************* (C) COPYRIGHT 2015-2020 硬石嵌入式开发团队 *****END OF FILE****/
     

复制代码

freeelectron

HAL库和stm32cubeMX是什么区别？

haohao663

HAL库是一个软件库比如：
HAL_GPIO_ReadPin函数就是其中的一个函数，是标准库的更新换代产品
STM32CubeMX是个代码生成器软件，生成的代码是基于HAL库写的

anny

谢谢分享

沐紫

谢谢楼主

烟花绽放

楼主有没有使用HAL库进行过us级延时呢？

haohao663

1. /**
   
2.   * 函数功能: 系统时钟配置
   
3.   * 输入参数: 无
   
4.   * 返 回 值: 无
   
5.   * 说    明: 无
   
6.   */
   
7. void SystemClock_Config(void)
   
8. {
   
9.   RCC_OscInitTypeDef RCC_OscInitStruct;
   
10.   RCC_ClkInitTypeDef RCC_ClkInitStruct;
    
11. 
    
12.   RCC_OscInitStruct.OscillatorType = RCC_OSCILLATORTYPE_HSE;  // 外部晶振，8MHz
    
13.   RCC_OscInitStruct.HSEState = RCC_HSE_ON;
    
14.   RCC_OscInitStruct.HSEPredivValue = RCC_HSE_PREDIV_DIV1;
    
15.   RCC_OscInitStruct.PLL.PLLState = RCC_PLL_ON;
    
16.   RCC_OscInitStruct.PLL.PLLSource = RCC_PLLSOURCE_HSE;
    
17.   RCC_OscInitStruct.PLL.PLLMUL = RCC_PLL_MUL9;  // 9倍频，得到72MHz主时钟
    
18.   HAL_RCC_OscConfig(&RCC_OscInitStruct);
    
19. 
    
20.   RCC_ClkInitStruct.ClockType = RCC_CLOCKTYPE_HCLK|RCC_CLOCKTYPE_SYSCLK
    
21.                               |RCC_CLOCKTYPE_PCLK1|RCC_CLOCKTYPE_PCLK2;
    
22.   RCC_ClkInitStruct.SYSCLKSource = RCC_SYSCLKSOURCE_PLLCLK;       // 系统时钟：72MHz
    
23.   RCC_ClkInitStruct.AHBCLKDivider = RCC_SYSCLK_DIV1;              // AHB时钟：72MHz
    
24.   RCC_ClkInitStruct.APB1CLKDivider = RCC_HCLK_DIV2;               // APB1时钟：36MHz
    
25.   RCC_ClkInitStruct.APB2CLKDivider = RCC_HCLK_DIV1;               // APB2时钟：72MHz
    
26.   HAL_RCC_ClockConfig(&RCC_ClkInitStruct, FLASH_LATENCY_2);
    
27. 
    
28.         // HAL_RCC_GetHCLKFreq()/1000    1ms中断一次，即HAL_Delay函数延时基准为1ms
    
29.         // HAL_RCC_GetHCLKFreq()/100000         10us中断一次，即HAL_Delay函数延时基准为10us
    
30.         // HAL_RCC_GetHCLKFreq()/1000000 1us中断一次，即HAL_Delay函数延时基准为1us
    
31.   HAL_SYSTICK_Config(HAL_RCC_GetHCLKFreq()/1000000);  // 配置并启动系统滴答定时器
    
32.   /* 系统滴答定时器时钟源 */
    
33.   HAL_SYSTICK_CLKSourceConfig(SYSTICK_CLKSOURCE_HCLK);
    
34.   /* 系统滴答定时器中断优先级配置 */
    
35.   HAL_NVIC_SetPriority(SysTick_IRQn, 0, 0);
    
36. }

复制代码

要是需要us延时，我一般是直接设置系统滴答定时器为1us中断

tanr

feichangganxie

3年后的我

谢谢大神分享 顶礼膜拜  刚好是想要学习的东西

Ian-392967

多谢楼主分享