【HAL库每天一例】第002例：GPIO-流水灯

haohao663 提问时间：2016-5-7 09:49 /

【HAL库每天一例】系列例程从今天开始持续更新。。。。。
我们将坚持每天至少发布一个基于YS-F1Pro开发板的HAL库例程，
该系列例程将带领大家从零开始使用HAL库，后面会持续添加模块应用例程。
同样的，我们还程序发布基于HAL库的指导文档和视频教程，欢迎持续关注，并提出改进意见。

例程下载：
资料包括程序、相关说明资料以及软件使用截图
链接：https://pan.baidu.com/s/1i574oPv
密码：r3s3
（硬石YS-F1Pro开发板HAL库例程持续更新\1. 软件设计之基本裸机例程(HAL库版本)\YSF1_HAL-002. GPIO-流水灯）

/**
  ******************************************************************************
  *                         硬石YS-F1Pro开发板例程功能说明
  *
  *  例程名称: YSF1_HAL-002. 流水灯
  *
  ******************************************************************************
  * 说明：
  * 本例程配套硬石stm32开发板YS-F1Pro使用。
  *
  * 淘宝：
  * 论坛：
  * 版权归硬石嵌入式开发团队所有，请勿商用。
  ******************************************************************************
  */

【1】例程简介
  使用stm32 HAL库函数实现LED流水灯效果。通过这个例程熟悉stm32 HAL库函数编程思想。

  stm32拥有非常多的IO引脚，这些IO引脚可以用作最简单的控制电平控制，可以设置为输出高电
平(数字量:1，对应3.3V)或者低电平(数字量:0,对应0V)，也可以设置为输入模式，读取这个IO引
脚的电平(比如用于按键状态读取)。  本例程我们调用HAL库函数方法来实现对IO引脚的输出高低
电平进行控制。

  通过开发板原理图我们可以知道：

  LED1灯负极接在GND(0V)上，正极通过一个电阻接在stm32f103zet6芯片的PB0引脚上（中间还
有一个JP3默认使用跳线帽短路），如果我们控制PB0引脚为高电平(3.3V)的话，此时电路存在电压
差，电流从LED1灯正极流向负极再经电阻流入GND，此时LED1灯是亮的；另外，如果我们控制PB0
引脚为低电平(0V)的话，此时电路没有电流，所以LED1灯是灭的。如此看来，只要我们控制PB0引
脚的高或者低电平就可以自由控制LED1灯的亮灭。

  LED2和LED3控制原理与LED1是相同的。

  在使用IO引脚之前我们需要对IO引脚相关资源进行初始化配置，首先我们需要调用使能GPIOB
端口时钟函数LED1_RCC_CLK_ENABLE函数(实际是__HAL_RCC_GPIOB_CLK_ENABLE函数)。开启时钟
之后，我们就先通过HAL_GPIO_WritePin(LED1_GPIO, LED1_GPIO_PIN, GPIO_PIN_SET)函数设置
PB0初始化为高电平。然后设置可以来配置IO引脚的功能，这里我们需要把PB0引脚配置为推挽
输出模式，调用HAL_GPIO_Init(LED1_GPIO, &GPIO_InitStruct)函数实现初始化配置。
  在初始化PB0之后，就可以使用HAL_GPIO_WritePin函数非常方便控制输出的高电平或者低电平。


【2】跳线帽情况
******* 为保证例程正常运行，必须插入以下跳线帽 **********
丝印编号    IO端口    目标功能引脚       出厂默认设置
  JP3       PB0          LED1             已接入
  JP4       PG6          LED2             已接入
  JP5       PG7          LED3             已接入

【3】操作及现象
  使用开发板配套的MINI USB线连接到开发板标示“调试串口”字样的MIMI USB接口为开发板供电。
下载完程序之后，可以观察到开发板上三颗LED以不同形式先后亮灭。

/******************* (C) COPYRIGHT 2015-2020 硬石嵌入式开发团队 *****END OF FILE****/

bsp_led.h文件内容：

#ifndef __BSP_LED_H__
#define __BSP_LED_H__
/* 包含头文件 ----------------------------------------------------------------*/
#include "stm32f1xx_hal.h"
/* 类型定义 ------------------------------------------------------------------*/
typedef enum
{
LED_OFF = 0,
LED_ON = 1,
LED_TOGGLE = 2,
}LEDState_TypeDef;
#define IS_LED_STATE(STATE) (((STATE) == LED_OFF) || ((STATE) == LED_ON) || ((STATE) == LED_TOGGLE))
/* 宏定义 --------------------------------------------------------------------*/
#define LED1 (uint8_t)0x01
#define LED2 (uint8_t)0x02
#define LED3 (uint8_t)0x04
#define IS_LED_TYPEDEF(LED) (((LED) == LED1) || ((LED) == LED2) || ((LED) == LED3))
/*
* 以下宏定义内容跟开发板硬件息息相关，需要查看开发板电路原理图才能正确编写。
* 例如，查原理图可在LED1灯接在stm32f103芯片的PB0引脚上，所以有关LED1的宏定义
* 都是与GPIOB，GPIO_Pin_0相关的，我们专门把这些与开发板硬件相关的内容定义为宏，
* 这对于修改或者移植程序非常方便。
*/
#define LED1_RCC_CLK_ENABLE() __HAL_RCC_GPIOB_CLK_ENABLE()
#define LED1_GPIO_PIN GPIO_PIN_0
#define LED1_GPIO GPIOB
#define LED2_RCC_CLK_ENABLE() __HAL_RCC_GPIOG_CLK_ENABLE()
#define LED2_GPIO_PIN GPIO_PIN_6
#define LED2_GPIO GPIOG
#define LED3_RCC_CLK_ENABLE() __HAL_RCC_GPIOG_CLK_ENABLE()
#define LED3_GPIO_PIN GPIO_PIN_7
#define LED3_GPIO GPIOG
#define LED1_ON HAL_GPIO_WritePin(LED1_GPIO,LED1_GPIO_PIN,GPIO_PIN_SET) // 输出高电平
#define LED1_OFF HAL_GPIO_WritePin(LED1_GPIO,LED1_GPIO_PIN,GPIO_PIN_RESET) // 输出低电平
#define LED1_TOGGLE HAL_GPIO_TogglePin(LED1_GPIO,LED1_GPIO_PIN) // 输出反转
#define LED2_ON HAL_GPIO_WritePin(LED2_GPIO,LED2_GPIO_PIN,GPIO_PIN_SET) // 输出高电平
#define LED2_OFF HAL_GPIO_WritePin(LED2_GPIO,LED2_GPIO_PIN,GPIO_PIN_RESET) // 输出低电平
#define LED2_TOGGLE HAL_GPIO_TogglePin(LED2_GPIO,LED2_GPIO_PIN) // 输出反转
#define LED3_ON HAL_GPIO_WritePin(LED3_GPIO,LED3_GPIO_PIN,GPIO_PIN_SET) // 输出高电平
#define LED3_OFF HAL_GPIO_WritePin(LED3_GPIO,LED3_GPIO_PIN,GPIO_PIN_RESET) // 输出低电平
#define LED3_TOGGLE HAL_GPIO_TogglePin(LED3_GPIO,LED3_GPIO_PIN) // 输出反转
/* 扩展变量 ------------------------------------------------------------------*/
/* 函数声明 ------------------------------------------------------------------*/
void LED_GPIO_Init(void);
void LEDx_StateSet(uint8_t LEDx,LEDState_TypeDef state);
#endif // __BSP_LED_H__
/******************* (C) COPYRIGHT 2015-2020 硬石嵌入式开发团队 *****END OF FILE****/