STM32F103_LL库+寄存器学习笔记03 - GPIO设置输入模式,并轮询GPIO的电平状态
《STM32F103_LL库+寄存器学习笔记02 - 开启SysTick(滴答定时器)》中断上一章节完成SysTick中断。接着,开始梳理大家肯定逃不过的外设GPIO。
 首先,先梳理一下LL库怎样去设置GPIO的模式,读取GPIO的电平的状态。
项目地址:https://github.com/q164129345/MCU_Develop/tree/main/stm32f103_ll_library03_gpio_input
一、CubeMX

 
 如上所示,使用CubeMX设置PB4为输入模式,Pull-up(上拉)。
二、代码
2.1、MX_GPIO_Init()

 如上所示,使用外设之前记得先打开对应的时钟。 LL库函数LL_APB2_GRP1_EnableClock(LL_APB2_GRP1_PERIPH_GPIOB)的目的是打开GPIOB的时钟。然后,使用结构体LL_GPIO_InitTypeDef来填写GPIO的功能,然后调用LL_GPIO_Init()进行GPIO初始化。
 
 如上所示,结构体LL_GPIO_InitTypeDef定义了5个结构体成员,通过这5个成员的组合,配置GPIO的工作模式。
 为了实现抽象,方便使用结构体来设置GPIO的各个模式,函数LL_GPIO_Init()的定义相当复杂,如下所示:
ErrorStatus LL_GPIO_Init(GPIO_TypeDef *GPIOx, LL_GPIO_InitTypeDef *GPIO_InitStruct)
{
  uint32_t pinmask;
  uint32_t pinpos;
  uint32_t currentpin;
  /* Check the parameters */
  assert_param(IS_GPIO_ALL_INSTANCE(GPIOx));
  assert_param(IS_LL_GPIO_PIN(GPIO_InitStruct->Pin));
  /* ------------------------- Configure the port pins ---------------- */
  /* Initialize  pinpos on first pin set */
  pinmask = ((GPIO_InitStruct->Pin) << GPIO_PIN_MASK_POS) >> GPIO_PIN_NB;
  pinpos = POSITION_VAL(pinmask);
  /* Configure the port pins */
  while ((pinmask  >> pinpos) != 0u)
  {
    /* skip if bit is not set */
    if ((pinmask & (1u << pinpos)) != 0u)
    {
      /* Get current io position */
      if (pinpos < GPIO_PIN_MASK_POS)
      {
        currentpin = (0x00000101uL << pinpos);
      }
      else
      {
        currentpin = ((0x00010001u << (pinpos - GPIO_PIN_MASK_POS)) | 0x04000000u);
      }
      if (GPIO_InitStruct->Mode == LL_GPIO_MODE_INPUT)
      {
        /* Check The Pull parameter */
        assert_param(IS_LL_GPIO_PULL(GPIO_InitStruct->Pull));
        /* Pull-up Pull-down resistor configuration*/
        LL_GPIO_SetPinPull(GPIOx, currentpin, GPIO_InitStruct->Pull);
      }
      
      /* Check Pin Mode parameters */
      assert_param(IS_LL_GPIO_MODE(GPIO_InitStruct->Mode));
      
      /* Pin Mode configuration */
      LL_GPIO_SetPinMode(GPIOx, currentpin, GPIO_InitStruct->Mode);
      if ((GPIO_InitStruct->Mode == LL_GPIO_MODE_OUTPUT) || (GPIO_InitStruct->Mode == LL_GPIO_MODE_ALTERNATE))
      {
        /* Check speed and Output mode parameters */
        assert_param(IS_LL_GPIO_SPEED(GPIO_InitStruct->Speed));
        assert_param(IS_LL_GPIO_OUTPUT_TYPE(GPIO_InitStruct->OutputType));
        /* Speed mode configuration */
        LL_GPIO_SetPinSpeed(GPIOx, currentpin, GPIO_InitStruct->Speed);
        /* Output mode configuration*/
        LL_GPIO_SetPinOutputType(GPIOx, currentpin, GPIO_InitStruct->OutputType);
      }
    }
    pinpos++;
  }
  return (SUCCESS);
}
2.2、读取GPIO的电平状态LL_GPIO_IsInputPinSet()
通过2.1章节的函数MX_GPIO_Init()对PB4进行初始化后,接着可以通过函数LL_GPIO_IsInputPinSet()来获取当前PB4是高电平还是低电平。
 
 
 如上图所示,pinStatus刚开始等于1,因为PB4的初始状态是上拉。当我将PB4连接到GND,pinStatus变成0。当我再一次将PB4与GND断开,pinStatus又变回1。
2.3、通过LL库设置GPIO输入模式的另外一种方法

 如上所示,通过函数LL_GPIO_SetPinMode()与函数LL_GPIO_SetPinPull()就能完成GPIO的输入模式配置。
三、寄存器梳理
3.1、GPIOB的RCC时钟

 如上所示,从《STM32F1参考手册》的章节2.1-系统结构的系统结构看到,外设GPIOB的时钟源来自APB2。
 
 
 如上所示,《STM32F1参考手册》的章节6.3.7,将外设RCC的寄存器ARB2ENR的bit3置1,即打开GPIOB的时钟。
RCC->APB2ENR |= 0x01UL << 3UL; // 使能GPIOB的时钟
// RCC->APB2ENR |= RCC_APB2ENR_IOPBEN; //两种方法等效的
3.2、GPIO相关寄存器
3.2.1、GPIOx_CRL

 如上所示,《STM32F1参考手册》的章节8.2.1,首先要配置GPIO的寄存器CRL(PB0~PB7)或者CRH(PB8~PB15)。比如PB4要设置段MODE4 = 00(输入模式),段CNF4 = 10(上拉/下拉输入模式)。
GPIOB->CRL &= ~(0xF << 16UL); // 清除段CNF4与段MODE4
GPIOB->CRL |= 0x08 << 16UL;   // 设置段CNF4 = 10,段MODE4 = 00
// 或者使用LL库提供的宏MODIFY_REG(),考虑到原子性的话,优先使用MODIFY_REG()
// MODIFY_REG(GPIOB->CRL, 0x0F << 16UL, 0x08 << 16UL); 
3.2.2、GPIOx_ODR

 如上所示,《STM32F1参考手册》的章节8.2.4,寄存器ODR对应的位置1相当于上拉,置0相当于下拉。
GPIOB->ODR |= (0x01 << 4UL); // 置1相当于上拉
GPIOB->ODR &= ~(0x01 << 4UL); // 置0相当于下拉
3.2.3、PB4输入模式,上拉
// 假设已经使能GPIOB的时钟
MODIFY_REG(GPIOB->CRL, 0x0F << 16UL, 0x08 << 16UL); // PB4输入模式、上拉/下拉输入模式
SET_BIT(GPIOB->ODR, 0x01 << 4UL); // 上拉 , 等效GPIOB->ODR |= (0x01 << 4UL)
通过上面两句代码,让PB4设置输入模式,且上拉。
3.2.4、读取PB4的电平状态(GPIOB_IDR)

 如上所示,《STM32F1中文参考手册》的章节8.2.3,寄存器IDR4对应的是PB4的电平状态。IDR4 = 1相当于PB4高电平,IDR4 = 0相当于PB4低电平。
if(GPIOB->IDR & (0x01 << 4UL)) {
	// PB4为高电平
} else {
	// PB4为低电平
}
// 等效实现方式
if (READ_BIT(GPIOB->IDR, 0x01 << 4UL)) {
    // PB4为高电平
} else {
	// PB4为低电平
}
四、寄存器方式的实现

 
 
 如上所示,测试效果一直。
 
 如上所示,通过debug模式的寄存器状态看到,寄存器GPIOB_CRL的MODE4 = 0x00(输入模式)与CNF4 = 0x02(上拉/下拉的输入模式)。
