【蓝桥杯物联网】第三章 stm32l0xx_hal_gpio.c的常见函数

发布时间:2024-06-04  

本章将介绍几个在比赛中常见的函数,这几个函数都是非常简单,关系到LED,按键,继电器等简单的外设。


第一节HAL_GPIO_Init

函数原型:

voidHAL_GPIO_Init(GPIO_TypeDef *GPIOx, GPIO_InitTypeDef *GPIO_Init);

函数解析:

这个是GPIO的初始化的函数,这个函数主要用来初始化我们需要用到的引脚的工作模式,包括具体引脚的工作速度、是否复用模式、上下拉等等参数。形参解析:

一共两名形参,该形参的具体功能如下:

GPIO_TypeDef *GPIOx:该形参是对GPIO的类型的定义,比如:GPIOA,GPIOC等等。

GPIO_InitTypeDef *GPIO_Init:该形参是对结构体GPIO_InitTypeDef的指针的初始化,包含了外设GPIO的配置信息,比如GPIO引脚,模式,速度等等。该配置信息如下:(见stm32l0xx_hal_gpio.h)

cad1b110-f862-11eb-abe6-000c2944909e.png


返回值:

void函数无返回值。

第二节HAL_GPIO_DeInit

函数原型:

void HAL_GPIO_DeInit(GPIO_TypeDef *GPIOx, uint32_t GPIO_Pin);

函数解析:

该函数是承接HAL_GPIO_Init函数的,将初始化之后的引脚恢复成默认的状态,即各个寄存器复位时的值。

形参解析:

一共两名形参,该形参的具体功能如下:

GPIO_TypeDef *GPIOx:该形参是对GPIO的类型的定义,比如:GPIOA,GPIOC等等。

uint32_t GPIO_Pin:该形参是对GPIO引脚的定义,比如:GPIO_PIN_14,GPIO_PIN_15等等。

返回值:

void函数无返回值。

第三节HAL_GPIO_ReadPin

函数原型:

GPIO_PinStateHAL_GPIO_ReadPin(GPIO_TypeDef*GPIOx,uint16_tGPIO_Pin)

函数解析:

该函数是GPIO读函数,将GPIO的电平状态读取出来,一般读取之后,就明白该GPIO的状态了。

形参解析:

一共两名形参,该形参的具体功能如下:

GPIO_TypeDef *GPIOx:该形参是对GPIO的类型的定义,比如:GPIOA,GPIOC等等。

uint16_t GPIO_Pin:该形参是对GPIO引脚的定义,比如:GPIO_PIN_14,GPIO_PIN_15等等。

返回值:

如果读取到高电平,返回GPIO_PIN_SET;如果是低电平,返回GPIO_PIN_RESET。

第四节HAL_GPIO_WritePin

函数原型:

voidHAL_GPIO_WritePin(GPIO_TypeDef*GPIOx,uint16_tGPIO_Pin,GPIO_PinState PinState);

函数解析:

该函数是GPIO写函数,通过该函数操作GPIO的状态。

形参解析:

一共三名形参,该形参的具体功能如下:

GPIO_TypeDef *GPIOx:该形参是对GPIO的类型的定义,比如:GPIOA,GPIOC等等。

uint16_t GPIO_Pin:该形参是对GPIO引脚的定义,比如:GPIO_PIN_14,GPIO_PIN_15等等。

GPIO_PinState PinState:该形参是对GPIO引脚的电平状态的定义,如果是GPIO_PIN_SET,那么对该GPIO赋值为高电平;如果是GPIO_PIN_RESET,那么对该GPIO赋值为底电平。

返回值:

void函数无返回值。

第五节HAL_GPIO_TogglePin

函数原型:

void HAL_GPIO_TogglePin(GPIO_TypeDef *GPIOx, uint16_t GPIO_Pin);

函数解析:

该函数是GPIO引脚电平状态的翻转函数,通过该函数操作GPIO的电平的状态的翻转。

形参解析:

一共两名形参,该形参的具体功能如下:

GPIO_TypeDef *GPIOx:该形参是对GPIO的类型的定义,比如:GPIOA,GPIOC等等。

uint16_t GPIO_Pin:该形参是对GPIO引脚的定义,比如:GPIO_PIN_14,GPIO_PIN_15等等。

返回值:

void函数无返回值。

第六节HAL_GPIO_LockPin

函数原型:

HAL_StatusTypeDef HAL_GPIO_LockPin(GPIO_TypeDef *GPIOx, uint16_t GPIO_Pin);

函数解析:

该函数是GPIO引脚电平状态的锁存函数,使用该函数之后,将锁定GPIO的状态,写函数也无法改变,除非重置。

形参解析:

一共两名形参,该形参的具体功能如下:

GPIO_TypeDef *GPIOx:该形参是对GPIO的类型的定义,比如:GPIOA,GPIOC等等。

uint16_t GPIO_Pin:该形参是对GPIO引脚的定义,比如:GPIO_PIN_14,GPIO_PIN_15等等。

返回值:

由结构体HAL_StatusTypeDef(如下图,stm32l0xx_hal_def.h)可知,如果锁存成功,返回HAL_OK(0x00U),如果失败,返回HAL_ERROR(0x01U)。

caf793b0-f862-11eb-9162-000c2944909e.png

需要注意的是,只能返回这两种值,即使该寄存器有四个变量。为什么呢?仔细看HAL_GPIO_LockPin函数的最后看明白了。

第七节HAL_GPIO_EXTI_IRQHandler

函数原型:

voidHAL_GPIO_EXTI_IRQHandler(uint16_t GPIO_Pin);

函数解析:

外部中断服务函数,用来响应外部中断的触发。

形参解析:

一共一名形参,该形参的具体功能如下:

uint16_t GPIO_Pin:该形参是对GPIO引脚的定义,比如:GPIO_PIN_14,GPIO_PIN_15等等。

返回值:

void函数无返回值。

第八节HAL_GPIO_EXTI_Callback

函数原型:

__weakvoid HAL_GPIO_EXTI_Callback(uint16_t GPIO_Pin);

函数解析:

该函数是回调函数,说白了就是中断之后,需要什么功能,就写在这个函数里面。至于__weak,它是一个弱化标识,带有这个的函数就是一个弱化函数,就是你可以在其他地方写一个名称和参数都一模一样的函数,编译器就会忽略这一个函数,而去执行你写的那个函数。

形参解析:

一共一名形参,该形参的具体功能如下:

uint16_t GPIO_Pin:该形参是对GPIO引脚的定义,比如:GPIO_PIN_14,GPIO_PIN_15等等。

返回值:

该函数无返回值。


文章来源于:电子工程世界    原文链接
本站所有转载文章系出于传递更多信息之目的,且明确注明来源,不希望被转载的媒体或个人可与我们联系,我们将立即进行删除处理。

我们与500+贴片厂合作,完美满足客户的定制需求。为品牌提供定制化的推广方案、专属产品特色页,多渠道推广,SEM/SEO精准营销以及与公众号的联合推广...详细>>

利用葫芦芯平台的卓越技术服务和新产品推广能力,原厂代理能轻松打入消费物联网(IOT)、信息与通信(ICT)、汽车及新能源汽车、工业自动化及工业物联网、装备及功率电子...详细>>

充分利用其强大的电子元器件采购流量,创新性地为这些物料提供了一个全新的窗口。我们的高效数字营销技术,不仅可以助你轻松识别与连接到需求方,更能够极大地提高“闲置物料”的处理能力,通过葫芦芯平台...详细>>

我们的目标很明确:构建一个全方位的半导体产业生态系统。成为一家全球领先的半导体互联网生态公司。目前,我们已成功打造了智能汽车、智能家居、大健康医疗、机器人和材料等五大生态领域。更为重要的是...详细>>

我们深知加工与定制类服务商的价值和重要性,因此,我们倾力为您提供最顶尖的营销资源。在我们的平台上,您可以直接接触到100万的研发工程师和采购工程师,以及10万的活跃客户群体...详细>>

凭借我们强大的专业流量和尖端的互联网数字营销技术,我们承诺为原厂提供免费的产品资料推广服务。无论是最新的资讯、技术动态还是创新产品,都可以通过我们的平台迅速传达给目标客户...详细>>

我们不止于将线索转化为潜在客户。葫芦芯平台致力于形成业务闭环,从引流、宣传到最终销售,全程跟进,确保每一个potential lead都得到妥善处理,从而大幅提高转化率。不仅如此...详细>>