STM32:GPIO口的使用

Posted caesura-k

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了STM32:GPIO口的使用相关的知识,希望对你有一定的参考价值。

1 GPIO port

  STM32一共有7组GPIO port,分别是GPIOA[15:0]~GPIOG[15:0],每组GPIO port 有16个 pin;每组GPIO port都有一组寄存器;

  GPIO寄存器的控制单位是GPIO port,而不是pin;所以寄存器的最小处理单位是一个16位的字长(0xFF);

  至于寄存器的配置我们之后小节在解析,首先来了解一下标准库是如何将GPIO映射到地址上的;

  技术图片

/*stm32f10x.h 1408-1414行声明如下*/
#define GPIOA               ((GPIO_TypeDef *) GPIOA_BASE)
#define GPIOB               ((GPIO_TypeDef *) GPIOB_BASE)
#define GPIOC               ((GPIO_TypeDef *) GPIOC_BASE)
#define GPIOD               ((GPIO_TypeDef *) GPIOD_BASE)
#define GPIOE               ((GPIO_TypeDef *) GPIOE_BASE)
#define GPIOF               ((GPIO_TypeDef *) GPIOF_BASE)
#define GPIOG               ((GPIO_TypeDef *) GPIOG_BASE)

/* stm32f10x.h  1001-1010行;
*把结构体的首地址映射到GPIO的首寄存器地址,就可以通过该结构体对硬件寄存器操作;
*结构体的地址通过结构体指针来赋值对应上*/
#define __IO  volatile /*core_cm3.h  NO.116*/
typedef struct
{
  __IO uint32_t CRL;
  __IO uint32_t CRH;
  __IO uint32_t IDR;
  __IO uint32_t ODR;
  __IO uint32_t BSRR;
  __IO uint32_t BRR;
  __IO uint32_t LCKR;
} GPIO_TypeDef;

/*stm32f10x.h 1315-1321;*/
#define GPIOA_BASE            (APB2PERIPH_BASE + 0x0800)
#define GPIOB_BASE            (APB2PERIPH_BASE + 0x0C00)
#define GPIOC_BASE            (APB2PERIPH_BASE + 0x1000)
#define GPIOD_BASE            (APB2PERIPH_BASE + 0x1400)
#define GPIOE_BASE            (APB2PERIPH_BASE + 0x1800)
#define GPIOF_BASE            (APB2PERIPH_BASE + 0x1C00)
#define GPIOG_BASE            (APB2PERIPH_BASE + 0x2000)

/*stm32f10x.h 1282-1283; GPIO都属于APB2总线,使用的时候要使能APB2总线的时钟源;*/
#define APB1PERIPH_BASE       PERIPH_BASE
#define APB2PERIPH_BASE       (PERIPH_BASE + 0x10000)

/*stm32f10x.h 1274*/
#define PERIPH_BASE           ((uint32_t)0x40000000)

2 GPIO 寄存器

  GPIO涉及的寄存器较多,复用功能和重映射功能都需要配置专门的AFIO寄存器,但是本节暂时没有涉及;

  本节主要介绍了通用GPIO口涉及到的7个寄存器,具体寄存器的说明和使用如下;

  2.1 CRL端口配置低寄存器,CRH端口配置高寄存器 control register low,control register high;

    CRL和CRH都是32位寄存器,如下图所示,一起用来控制该组GPIO port的16个引脚配置;

   技术图片

    2.1.1 寄存器复位值为0x4444_4444;CRL偏移地址:0x00,CRH偏移地址:0x04;配置信息封装如下;

//定义了CRH和CRL寄存器需要的参数;以下声明在stm32f10x_gpio.h的前200行;
typedef struct
{
  uint16_t GPIO_Pin;                /*用16位bit的每一位分别表示一个引脚*/            
  GPiospeed_TypeDef GPIO_Speed;     /*用2位bit来表示输出模式的最大速度*/ 
  GPIOMode_TypeDef GPIO_Mode;       /*CNF MODE,具体见结构体*/
}GPIO_InitTypeDef;

#define GPIO_Pin_0                 ((uint16_t)0x0001)  /*0000 0000 0000 0001b*/
#define GPIO_Pin_1                 ((uint16_t)0x0002)  /*0000 0000 0000 0010b*/
#define GPIO_Pin_2                 ((uint16_t)0x0004)  /*0000 0000 0000 0100b*/
#define GPIO_Pin_3                 ((uint16_t)0x0008)  /*0000 0000 0000 1000b*/
#define GPIO_Pin_4                 ((uint16_t)0x0010)  /*0000 0000 0001 0000b*/
#define GPIO_Pin_5                 ((uint16_t)0x0020)  /*0000 0000 0010 0000b*/
#define GPIO_Pin_6                 ((uint16_t)0x0040)  /*0000 0000 0100 0000b*/
#define GPIO_Pin_7                 ((uint16_t)0x0080)  /*0000 0000 1000 0000b*/
#define GPIO_Pin_8                 ((uint16_t)0x0100)  /*0000 0001 0000 0000b*/
#define GPIO_Pin_9                 ((uint16_t)0x0200)  /*!< Pin 9 selected */
#define GPIO_Pin_10                ((uint16_t)0x0400)  /*!< Pin 10 selected */
#define GPIO_Pin_11                ((uint16_t)0x0800)  /*!< Pin 11 selected */
#define GPIO_Pin_12                ((uint16_t)0x1000)  /*!< Pin 12 selected */
#define GPIO_Pin_13                ((uint16_t)0x2000)  /*!< Pin 13 selected */
#define GPIO_Pin_14                ((uint16_t)0x4000)  /*!< Pin 14 selected */
#define GPIO_Pin_15                ((uint16_t)0x8000)  /*!< Pin 15 selected */
#define GPIO_Pin_All               ((uint16_t)0xFFFF)  /*!< All pins selected */
#define IS_GPIO_PIN(PIN) ((((PIN) & (uint16_t)0x00) == 0x00) && ((PIN) != (uint16_t)0x00))

typedef enum
{ 
  GPIO_Speed_10MHz = 1,     /*output MODE[1:0]*/
  GPIO_Speed_2MHz,          /*output MODE[1:0]*/
  GPIO_Speed_50MHz          /*output MODE[1:0]*/
}GPIOSpeed_TypeDef;
#define IS_GPIO_SPEED(SPEED) (((SPEED) == GPIO_Speed_10MHz) || ((SPEED) == GPIO_Speed_2MHz) || 
                              ((SPEED) == GPIO_Speed_50MHz))
                              
typedef enum
{ GPIO_Mode_AIN = 0x0,                /*0000 0000b input [3:0]CNF+MODE*/
  GPIO_Mode_IN_FLOATING = 0x04,       /*0000 0100b input [3:0]CNF+MODE*/
  GPIO_Mode_IPD = 0x28,               /*0010 1000b input [6]下拉,[3:0]CNF+MODE*/
  GPIO_Mode_IPU = 0x48,               /*0100 1000b input [7]上拉,[3:0]CNF+MODE*/
  GPIO_Mode_Out_OD = 0x14,            /*0001 0100b [5]output,[3:2]CNF*/
  GPIO_Mode_Out_PP = 0x10,            /*0001 0000b [5]output,[3:2]CNF*/
  GPIO_Mode_AF_OD = 0x1C,             /*0001 1100b [5]output,[3:2]CNF*/
  GPIO_Mode_AF_PP = 0x18              /*0001 1000b [5]output,[3:2]CNF*/
}GPIOMode_TypeDef; 
#define IS_GPIO_MODE(MODE) (((MODE) == GPIO_Mode_AIN) || ((MODE) == GPIO_Mode_IN_FLOATING) || 
                            ((MODE) == GPIO_Mode_IPD) || ((MODE) == GPIO_Mode_IPU) ||                             ((MODE) == GPIO_Mode_Out_OD) || ((MODE) == GPIO_Mode_Out_PP) ||                             ((MODE) == GPIO_Mode_AF_OD) || ((MODE) == GPIO_Mode_AF_PP))
#define IS_GET_GPIO_PIN(PIN) (((PIN) == GPIO_Pin_0) || ((PIN) == GPIO_Pin_1) ||((PIN) == GPIO_Pin_2) || 
                              ((PIN) == GPIO_Pin_3) || ((PIN) == GPIO_Pin_4) || ((PIN) == GPIO_Pin_5) ||                               ((PIN) == GPIO_Pin_6) || ((PIN) == GPIO_Pin_7) || ((PIN) == GPIO_Pin_8) ||                               ((PIN) == GPIO_Pin_9) || ((PIN) == GPIO_Pin_10) || ((PIN) == GPIO_Pin_11) ||                               ((PIN) == GPIO_Pin_12) ||((PIN) == GPIO_Pin_13) || ((PIN) == GPIO_Pin_14) ||                               ((PIN) == GPIO_Pin_15))

typedef enum
{ Bit_RESET = 0,
  Bit_SET
}BitAction;

    2.1.2 配置CRL和CRH的初始化代码如下;

 /*以下代码位于stm32f10x_gpio.c中,配置相应port的CRL和CRH*/
void GPIO_Init(GPIO_TypeDef* GPIOx, GPIO_InitTypeDef* GPIO_InitStruct)
{
  uint32_t currentmode = 0x00, currentpin = 0x00, pinpos = 0x00, pos = 0x00;
  uint32_t tmpreg = 0x00, pinmask = 0x00;
  assert_param(IS_GPIO_ALL_PERIPH(GPIOx));
  assert_param(IS_GPIO_MODE(GPIO_InitStruct->GPIO_Mode));
  assert_param(IS_GPIO_PIN(GPIO_InitStruct->GPIO_Pin));  
  
  currentmode = ((uint32_t)GPIO_InitStruct->GPIO_Mode) & ((uint32_t)0x0F); //currentmode保留了GPIO_Mode[3:0];

  if ((((uint32_t)GPIO_InitStruct->GPIO_Mode) & ((uint32_t)0x10)) != 0x00)//如果GPIO_Mode[4]为1,表示为输出模式;
  { 
     /*if(输出模式),将CNF[1:0]和MODE[1:0]的信息保存到currentmode[3:0]*/
    assert_param(IS_GPIO_SPEED(GPIO_InitStruct->GPIO_Speed));
    currentmode |= (uint32_t)GPIO_InitStruct->GPIO_Speed;//currentmode或上GPIO_Speed[1:0];
  }
  
  /*以下部分为CRL Configuration*/
  if (((uint32_t)GPIO_InitStruct->GPIO_Pin & ((uint32_t)0x00FF)) != 0x00)        //if(是低8位pin);
  {
    tmpreg = GPIOx->CRL;                                //temreg存放CRL寄存器的信息;
    for (pinpos = 0x00; pinpos < 0x08; pinpos++)        //pinpos为几,表示引脚几;        
    {
      pos = ((uint32_t)0x01) << pinpos;                    
      currentpin = (GPIO_InitStruct->GPIO_Pin) & pos;    //currentpin:要么为当前pin值,要么为0;
      if (currentpin == pos)
      {
        pos = pinpos << 2;                                //pos:引脚对应的CRL配置位
        pinmask = ((uint32_t)0x0F) << pos;                //pinmask:引脚对应的CRL[3:0]置1
        tmpreg &= ~pinmask;                                //temreg中对应引脚的[3:0]清0
        tmpreg |= (currentmode << pos);                    //temreg中对应引脚的[3:0]配置成currentmode[3:0]

        //此处的if else应该是通过ODR来配置硬件,由中文参考手册8.1.7原理图推测可知       
        if (GPIO_InitStruct->GPIO_Mode == GPIO_Mode_IPD) //if(输入连下拉电阻)
        {
          GPIOx->BRR = (((uint32_t)0x01) << pinpos);     //通过配置ODR的16bit,对应pin的bit置0,连接下拉电阻;
        }
        else
        {
          if (GPIO_InitStruct->GPIO_Mode == GPIO_Mode_IPU)//if(输入连上拉电阻)
          {
            GPIOx->BSRR = (((uint32_t)0x01) << pinpos);     //通过配置ODR的16bit,对应pin的bit置1,连接上拉电阻;
          }
        }
      }
    }
    GPIOx->CRL = tmpreg;  //把配置好对应pin脚的temreg放回CRL中
  }
  
/*---------------------------- GPIO CRH Configuration ------------------------*/
  /* Configure the eight high port pins */
  if (GPIO_InitStruct->GPIO_Pin > 0x00FF)
  {
    tmpreg = GPIOx->CRH;
    for (pinpos = 0x00; pinpos < 0x08; pinpos++)
    {
      pos = (((uint32_t)0x01) << (pinpos + 0x08));
      /* Get the port pins position */
      currentpin = ((GPIO_InitStruct->GPIO_Pin) & pos);
      if (currentpin == pos)
      {
        pos = pinpos << 2;
        /* Clear the corresponding high control register bits */
        pinmask = ((uint32_t)0x0F) << pos;
        tmpreg &= ~pinmask;
        /* Write the mode configuration in the corresponding bits */
        tmpreg |= (currentmode << pos);
        /* Reset the corresponding ODR bit */
        if (GPIO_InitStruct->GPIO_Mode == GPIO_Mode_IPD)
        {
          GPIOx->BRR = (((uint32_t)0x01) << (pinpos + 0x08));
        }
        /* Set the corresponding ODR bit */
        if (GPIO_InitStruct->GPIO_Mode == GPIO_Mode_IPU)
        {
          GPIOx->BSRR = (((uint32_t)0x01) << (pinpos + 0x08));
        }
      }
    }
    GPIOx->CRH = tmpreg;
  }
}

  2.2 LCKR端口配置锁定寄存器:lock register

    复位值为0x0000_0000;偏移地址:0x18;

    用来锁存对应端口的CRL,CRH寄存器的配置;修改完LCK[15:0]然后锁定[LCKK],对应的CRL,CRH配置将会持续到下次系统复位信号来临;

    技术图片

  2.3 IDR端口输入数据寄存器,ODR端口输出数据寄存器:input data register,output data register;

    复位值为0x0000_0000;IDR偏移地址:0x08;ODR偏移地址:0x0C

    对于输入数据而言,每个APB2时钟会采样I/O脚上的数据存入数据寄存器中,对寄存器的读取可以获得输入数据;

    对于输出数据而言,应该也是通过APB2时钟控制,把数据放入ODR即可;

    技术图片

    2.3.1 IDR寄存器的使用函数

/*以下代码位于stm32f10x_gpio.c中
*1 读取IDR寄存器某一位的值,即pin值;
*2 读取IDR寄存器的值,即port值;
*/ uint8_t GPIO_ReadInputDataBit(GPIO_TypeDef* GPIOx, uint16_t GPIO_Pin) { uint8_t bitstatus = 0x00; /* Check the parameters */ assert_param(IS_GPIO_ALL_PERIPH(GPIOx)); assert_param(IS_GET_GPIO_PIN(GPIO_Pin)); /*先读取整个IDR寄存器,然后通过&来读取bit,IDR寄存器的最小处理单位是16bit*/ if ((GPIOx->IDR & GPIO_Pin) != (uint32_t)Bit_RESET) { bitstatus = (uint8_t)Bit_SET; } else { bitstatus = (uint8_t)Bit_RESET; } return bitstatus; } uint16_t GPIO_ReadInputData(GPIO_TypeDef* GPIOx) { /* Check the parameters */ assert_param(IS_GPIO_ALL_PERIPH(GPIOx)); return ((uint16_t)GPIOx->IDR); }

    2.3.2 ODR寄存器的使用函数

/*以下代码位于stm32f10x_gpio.c中;
*1 读取ODR寄存器某一位的值;即读取pin值;
*2 读取ODR寄存器的值;即读取port值;
*3 向ODR寄存器写入port值;
*/ uint8_t GPIO_ReadOutputDataBit(GPIO_TypeDef* GPIOx, uint16_t GPIO_Pin) { uint8_t bitstatus = 0x00; assert_param(IS_GPIO_ALL_PERIPH(GPIOx)); assert_param(IS_GET_GPIO_PIN(GPIO_Pin)); /*先读取整个ODR寄存器,然后通过&来读取bit,ODR寄存器的最小处理单位是16bit*/ if ((GPIOx->ODR & GPIO_Pin) != (uint32_t)Bit_RESET){ bitstatus = (uint8_t)Bit_SET; } else{ bitstatus = (uint8_t)Bit_RESET; } return bitstatus; } uint16_t GPIO_ReadOutputData(GPIO_TypeDef* GPIOx) { assert_param(IS_GPIO_ALL_PERIPH(GPIOx)); return ((uint16_t)GPIOx->ODR); } void GPIO_Write(GPIO_TypeDef* GPIOx, uint16_t PortVal) { assert_param(IS_GPIO_ALL_PERIPH(GPIOx)); GPIOx->ODR = PortVal; }

  2.4 BSRR端口置位/复位寄存器,BRR端口复位寄存器:bit set/reset register,bit reset register;

    复位值为0x0000_0000;BSRR偏移地址:0x10;BRR偏移地址:0x14;

    对BSRR,BRR的操作,就是对该组GPIO口的ODR寄存器寄存器的操作;

    技术图片

    2.4.1 BSRR寄存器:pin置1

void GPIO_SetBits(GPIO_TypeDef* GPIOx, uint16_t GPIO_Pin)
{
  assert_param(IS_GPIO_ALL_PERIPH(GPIOx));
  assert_param(IS_GPIO_PIN(GPIO_Pin));
  
  GPIOx->BSRR = GPIO_Pin;
}

    2.4.2 BRR寄存器:pin清0

void GPIO_ResetBits(GPIO_TypeDef* GPIOx, uint16_t GPIO_Pin)
{
  assert_param(IS_GPIO_ALL_PERIPH(GPIOx));
  assert_param(IS_GPIO_PIN(GPIO_Pin));
  
  GPIOx->BRR = GPIO_Pin;
}

    2.4.3 设置pin脚相应的数值:pin的置1清0

void GPIO_WriteBit(GPIO_TypeDef* GPIOx, uint16_t GPIO_Pin, BitAction BitVal)
{
  assert_param(IS_GPIO_ALL_PERIPH(GPIOx));
  assert_param(IS_GET_GPIO_PIN(GPIO_Pin));
  assert_param(IS_GPIO_BIT_ACTION(BitVal)); 
  
  if (BitVal != Bit_RESET)
  {
    GPIOx->BSRR = GPIO_Pin;
  }
  else
  {
    GPIOx->BRR = GPIO_Pin;
  }
}

  虽然BSRR和BRR都可以用来设置单独bit位,但是它们也是通过16bit长度来设置的,不要被函数具有迷惑性的名字给欺骗;

3 GPIO的复用和重映射寄存器

  关于GPIO的复用重映射应该要加到上面寄存器的小节中,只是复用重映射似乎内容似乎有点多,可以另开一小节;

  具体GPIO的复用重映射,有点懒,感觉补充起来也要一些时间,浏览了一下<STM32F10xxx中文参考手册>,具体内容在8.3和8.4小节;

  GPIO口的重映射和复用功能是通过AFIO寄存器配置的;先占个坑,有缘在补充把;

  3.1 另外标准库还为GPIO口提供了位带操作,大概就是有两个区域地址块的寄存器是可以直接以bit为单位进行设置;

    相当于给GPIO开了个小灶方便某些不想使用标准库的人可以直接设置寄存器,个人不太中意这个功能;

4 通用GPIO的示例代码

  配置GPIO端口,在寄存器层面来说:首先使能所在外设的时钟源,然后配置完CRL和CRH后GPIO口就可以使用了;

  如果GPIO pin 配置成了输入引脚,则从IDR读取数据即可;

  如果GPIO pin 配置成了输出引脚,输出的信号可以直接写入ODR寄存器,也可以通过BSRR和BRR来设置;

#include "delay.h"

int main(void)
{ 
    RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOA, ENABLE);
    GPIO_InitTypeDef GPIO_Struct;

    //portA pin1 as input;     
    GPIO_Struct.GPIO_Pin = GPIO_Pin_1;             
    GPIO_Struct.GPIO_Mode =GPIO_Mode_IPD ;     
    GPIO_Init(GPIOA, &GPIO_Struct); 
    
    //portA pin2 as output;                        
    GPIO_Struct.GPIO_Pin = GPIO_Pin_2; 
    GPIO_Struct.GPIO_Speed = GPIO_Speed_50MHz;
    GPIO_Struct.GPIO_Mode = GPIO_Mode_Out_PP;
    GPIO_Init(GPIOA, &GPIO_Struct);                                          
    while(1)
    {
        GPIO_SetBits(GPIOA,GPIO_Pin_2);
        delay_ms(100);
        GPIO_ResetBits(GPIOA,GPIO_Pin_2);
        delay_ms(100);
    } 
}

5 小结

  本文主要是结合通用GPIO口的寄存器,对标准库中通用GPIO口的代码进行了分析和概括;

  然后提供了一个代码示例;如果只是使用而不想理解标准库原理,则直接使用接口函数即可,如代码示例所示;

以上是关于STM32:GPIO口的使用的主要内容,如果未能解决你的问题,请参考以下文章

stm32中GPIO口的最大输出速度如何理解?

stm32如何判读输入IO口的高低电平

stm32读取gpio高低电平速度

STM32--GPIO口的八种工作模式

STM32的GPIO口的复用功能

stm32寄存器版学习笔记01 GPIO口的配置(LED按键)