基于HAL库的LED驱动库

led.h

/** ******************************************************************************** * @file led.h * @brief 本文件包含一些led基本操作函数的定义,包括LED的亮、灭，闪烁 * @author Jia Yasen * @date 2022-5-23 * @version V0.0.1 * @copyright Etherealize ******************************************************************************** * @attention 1.本文件的函数均基于HAL库，由于LED的初始化基于GPIO的初始化，GPIO的初始化 * 直接在CubeMX中配置，用CubeMX生成的GPIO初始化函数来初始化. * 2.由于不同板子的对应引脚不同，使用前需先对照原理图修改LED引脚的对应及LED * 亮灭状态与引脚高低电平的对应 ******************************************************************************** */
#ifndef __LED_H__
#define __LED_H__
/*-----------------------------Includes---------------------------------------*/
//根据使用的芯片型号进行修改
#include "stm32f1xx_hal.h" 
/*-----------------------------Define-----------------------------------------*/
//定义LED的GPIO组号和引脚号；使用前需要根据板子的原理图进行修改
#define LED1_PORT GPIOx
#define LED1_PIN GPIO_PIN_x
//若需要多个LED可再添加定义
//定义LED亮与灭对应的引脚电平状态，不同电路设计的对应不同，使用前需先对照原理图修改
#define LED_STATE_ON GPIO_PIN_RESET
#define LED_STATE_OFF GPIO_PIN_SET
/*-----------------------------TypeDef----------------------------------------*/
typedef struct 
{
    
    GPIO_TypeDef* led_port;
    uint16_t led_pin;

}LED_TypeDef;
/*-----------------------------variables--------------------------------------*/
//声明成外部变量,这样可以在引用了该头文件的文件中使用这个变量
//若需要使用多个LED则自行定义
extern LED_TypeDef LED1;
/*-----------------------------Function---------------------------------------*/
void LED_Init(void);
void LED_ON(LED_TypeDef LED_Ptr);
void LED_OFF(LED_TypeDef LED_Ptr);
void LED_Blink(LED_TypeDef LED_Ptr, uint32_t Delay);

#endif
/************************ (C) COPYRIGHT Etherealize*****END OF FILE***********/

led.c

/** ******************************************************************************** * @file led.c * @brief led操作源文件，整体操作均通过一个LED结构体来实现 * @author Jia Yasen * @date 2022-5-23 * @version V0.0.1 * @copyright Etherealize ******************************************************************************** */
/*-----------------------------Includes---------------------------------------*/
#include "led.h"
/*-----------------------------variables--------------------------------------*/
//若需要使用多个LED，可再定义多个LED结构体
//LED_TypeDef* LED1_Ptr;
//若定义结构体指针,则需要给指针开辟空间,只是定义指针的话是不会开辟空间的.可以直接定义结构体
//定义结构体的同时就开辟好了空间,当需要在函数内对结构体的值进行修改时,传递地址即可
LED_TypeDef LED1;
/*-----------------------------Function---------------------------------------*/

/** * @brief LED结构体指针初始化 * @param[in] None * @return None * @details 使用时手动修改要赋值的指针与其对应值 */
void LED_Init(void)
{
    
    //初始化LED对应的GPIO组号与引脚序号
    LED1.led_port = LED1_PORT;
    LED1.led_port = LED1_PIN;
}

/** * @brief 点亮LED * @param[in] LED 要操作的LED结构体 * @return None * @details 因为不需要修改结构体内的值,只是读取,所以不用传递指针,只传递结构体即可 */
void LED_ON(LED_TypeDef LED)
{
    
    //引脚置对应的位
    HAL_GPIO_WritePin(LED.led_port, LED.led_pin, LED_STATE_ON);
}

/** * @brief 熄灭LED * @param[in] LED 要操作的LED结构体 * @return None * @details 因为不需要修改结构体内的值,只是读取,所以不用传递指针,只传递结构体即可 */
void LED_OFF(LED_TypeDef LED)
{
    
    //引脚置对应的位
    HAL_GPIO_WritePin(LED.led_port, LED.led_pin, LED_STATE_OFF);
}

/** * @brief LED闪烁 * @param[in] LED 要操作的LED结构体 * Delay LED闪烁的半周期（ms），即一次亮或暗持续的时间，一次亮+暗为一个闪烁周期。 * @return None * @attention 使用时若想达到LED持续闪烁的效果，需要把该函数放到死循环中 */
void LED_Blink(LED_TypeDef LED, uint32_t Delay)
{
    
    LED_ON(LED);//点亮LED
    HAL_Delay(Delay);//亮的状态持续Delay ms
    LED_OFF(LED);//熄灭LED
    HAL_Delay(Delay);//暗的状态持续Delay ms

}

/************************ (C) COPYRIGHT Etherealize*****END OF FILE***********/