前言
**cubeMX** 是一个很好的工具，提高了在配置外设的效率，故本文不对外设寄存器进行讲解，百度和官方参考手册一直都是最好的答案。因此本文会简单介绍板子原理图，cubeMX的配置流程，以及移植代码的关键步骤。
**[本文对应的代码在此，可以提前克隆下来](https://github.com/ALanStewart47/Project-H7A3ZI-Q/tree/main/Software/2.key)**。
原理图
由图可知，当按下按键时候，PC13会得到一个高电平；反之，**没有按键按下时候则是低电平**。
这里稍微说一下，当按键按下时候，电流经过按键流到ESD管，由于器件有齐纳二极管一样的特性，当反向偏置的时候可以流过微小电流，并二极管两端电压保持稳定，由下图可以得知该器件的稳压值（反向截止电压）为3V，选择3V应该也是考虑到齐纳二极管的特性即稳压值会有误差；不过该器件主要功能应该是进行ESD保护。****
CubeMX配置
在cubemx新建工程，选择官方开 发板进行配置（Board Selector），搜索NUCLEO-H7A3ZI-Q，并进入配置界面，弹出是否按照默认配置的时候，选择YES即可。**
blog.csdnimg.cn/direct/90b848fa93384e57b3b6d286fb6cb965.png**)
**进入配置界面后，会看到软件已经帮我们配置好开发板的按键、串口等外设了，我们只需配置想要的系统时钟即可，当然我们也可以不进行修改，按照默认的96MHz系统时钟生成代码工程。
代码移植
本文的按键功能是通过移植安富莱的按键板级支持包来实现的，而板级支持包是如何实现的，请移步到 STM32H7的GPIO应用之按键FIFO 此网站学习。此BSP支持短按，长按和组合按键检测功能，功能还是十分强大的。
简单介绍下移植的代码过程
1、拷贝bsp_key.c和bsp_key.h到你的工程里，如下图**
需要注意的是，我把bsp_key.h的文件放在User\Bsp\inc文件夹里面。
2、通过MDK加入bsp_key.c和把对应头文件地址，如下图
到这里我们已经把bsp_key的代码部分已经拷到自己的工程里面了。
接下来就到了真正的移植代码的部分啦
代码修改部分
- 头文件。源代码是依赖于bsp.h，我们这里并没有这个.h文件，故改为依赖HAL库stm32h7xx_hal.h，但是这里我把hal.h的依赖改到bsp_key.h里面，这样显得更整齐。
#include "bsp_key.h"
#define HARD_KEY_NUM 1 /* 实体按键个数（根据自己的项目实际来） */
#define KEY_COUNT (HARD_KEY_NUM + 0) /* 1个独立建 + 0个组合按键 */
/* 使能GPIO时钟 */
#define ALL_KEY_GPIO_CLK_ENABLE() { \
__HAL_RCC_GPIOB_CLK_ENABLE(); \
__HAL_RCC_GPIOC_CLK_ENABLE(); \
__HAL_RCC_GPIOG_CLK_ENABLE(); \
__HAL_RCC_GPIOH_CLK_ENABLE(); \
__HAL_RCC_GPIOI_CLK_ENABLE(); \
};
这里还有一个HARD_KEY_NUM 需要修改的，改成你硬件上的按键数量，这里板上仅有一个功能按键。因为只有一个按键也无法带来组合按键的玩法，暂时就不展开这个功能了。
- 确定激活电平。激活电平意思是当按键按下的时候，对应IO的电平是低电平还是高电平，H7A3ZI板子按键是低电平（上面有介绍），故激活电平为0，这里bsp_key.c是用结构体数组的方式储存按键端口，pin和激活电平。
/* 依次定义GPIO */
typedef struct
{
GPIO_TypeDef* gpio;
uint16_t pin;
uint8_t ActiveLevel; /* 激活电平 */
}X_GPIO_T;
/* GPIO和PIN定义 */
static const X_GPIO_T s_gpio_list[HARD_KEY_NUM] = {
{GPIOC, GPIO_PIN_13, 1}, /* K1 -- PC13 , 激活电平为1（高电平）*/
};
/* 定义一个宏函数简化后续代码
判断GPIO引脚是否有效按下
*/
static KEY_T s_tBtn[KEY_COUNT] = {0};
static KEY_FIFO_T s_tKey; /* 按键FIFO变量,结构体 */
- 屏蔽或者删除组合按键的代码
/*
*********************************************************************************************************
* 函 数 名: IsKeyDownFunc
* 功能说明: 判断按键是否按下。单键和组合键区分。单键事件不允许有其他键按下。
* 形 参: 无
* 返 回 值: 返回值1 表示按下(导通），0表示未按下（释放）
*********************************************************************************************************
*/
static uint8_t IsKeyDownFunc(uint8_t _id)
{
/* 实体单键 */
if (_id < HARD_KEY_NUM)
{
uint8_t i;
uint8_t count = 0;
uint8_t save = 255;
/* 判断有几个键按下 */
for (i = 0; i < HARD_KEY_NUM; i++)
{
if (KeyPinActive(i))
{
count++;
save = i;
}
}
if (count == 1 && save == _id)
{
return 1; /* 只有1个键按下时才有效 */
}
return 0;
}
/* 组合键 部分 */
if (_id == HARD_KEY_NUM + 0)
{
/*
if (KeyPinActive(KID_K1) && KeyPinActive(KID_K2))
{
return 1;
}
else
{
return 0;
}
*/
}
/* 组合键 部分 */
if (_id == HARD_KEY_NUM + 1)
{
/*
if (KeyPinActive(KID_K2) && KeyPinActive(KID_K3))
{
return 1;
}
else
{
return 0;
}
*/
}
return 0;
}
可以看到此处已经屏蔽了组合按键的代码了
4、(可选)删除一些没用到的宏定义或者结构体内容。在bsp_key.h里面，还有很多其他按键的宏定义，可以根据实际情况屏蔽或者删掉，本文暂不作拓展。
5、编写main函数。定义一个unsigned char的变量s_keyCode
uint8_t s_KeyCode ;
在while循环里面，加入bsp_KeyScan10ms()，该函数为周期性检测按键，然后通过bsp_GetKey()获取按键数值。
/* USER CODE BEGIN WHILE */
while (1)
{
/* USER CODE END WHILE */
HAL_Delay(10);
bsp_KeyScan10ms();
s_KeyCode=bsp_GetKey();
if(s_KeyCode != KEY_NONE)
{
if(s_KeyCode == KEY_DOWN_K1)
{
printf("Key 1 down\r\n");
}
if(s_KeyCode == KEY_1_UP)
{
printf("Key 1 up\r\n");
}
if(s_KeyCode == KEY_1_LONG)
{
printf("Key 1 long\r\n");
}
}
/* USER CODE BEGIN 3 */
}
下载验证
通过本链接即可获得本文的代码**，编译下载到H7A3ZI-Q开发板后，打开串口工具，会发现串口会发送用户按键动作行为。
