“NBDK-L4：基础实验教程”的版本间的差异
（→GPIO实验） |
|||
| 第93行： | 第93行： | ||
|} | |} | ||
| − | == | + | == 01-led实验 == |
第一个实验我们给大家带来的是最简单的外设控制，也就是 IO 口操作，通过这个实验我们可以了解到如何让STM32L476RC的一个 IO 输出高低电平，并以此控制 LED 的点亮和熄灭。 | 第一个实验我们给大家带来的是最简单的外设控制，也就是 IO 口操作，通过这个实验我们可以了解到如何让STM32L476RC的一个 IO 输出高低电平，并以此控制 LED 的点亮和熄灭。 | ||
| 第289行： | 第289行： | ||
</syntaxhighlight> | </syntaxhighlight> | ||
| − | == 马达实验 == | + | == 02-马达实验 == |
振动马达实验通过控制 GPIO 引脚输出高低电平，用于控制马达振动或停止 。 | 振动马达实验通过控制 GPIO 引脚输出高低电平，用于控制马达振动或停止 。 | ||
| 第514行： | 第514行： | ||
</syntaxhighlight> | </syntaxhighlight> | ||
| − | == 蜂鸣器实验 == | + | == 03-蜂鸣器实验 == |
蜂鸣器实验通过控制 GPIO 引脚输出高低电平，用于控制蜂鸣器发出蜂鸣声或者停止发声 。 | 蜂鸣器实验通过控制 GPIO 引脚输出高低电平，用于控制蜂鸣器发出蜂鸣声或者停止发声 。 | ||
2019年1月21日 (一) 10:24的版本
目录
1 教程介绍
1.1 工程简介
NBDK-L4开发板基础实验包含如下，在这里给大家简单说明一下每个例程中讲解的内容及关键节点。
| 实验名称 | 内容简介 | 功能 |
|---|---|---|
| 01-led实验 | 驱动LED点亮 | GPIO推挽输出 |
| 02-马达实验 | 驱动马达振动 | GPIO推挽输出 |
| 03-蜂鸣器实验 | 驱动蜂鸣器发声 | GPIO推挽输出 |
1.2 工程目录简介
大家打开任意一个基础例程，都会看到如下的4个目录（Drivers、Inc、MDK-ARM、Src）及clean.bat文件。
其中clean.bat是用于清除工程编译生成的中间文件。例如我们想拷贝一个编译过的工程，工程有200M左右大小，我们点击clean.bat清除一下编译生成的中间文件，则工程大概会缩小到100M左右，此时工程只剩下了库文件、用户文件，以及编译生成的hex文件。
从上图可以看到，四个主目录下分别包含的一些文件，这边给大家简单的介绍一下这边文件大概的功能。
Drivers：
STM32驱动文件目录，也就是大家常说的hal库，里面包含了hal（硬件抽象层）相关的文件。
主要就是有RCC时钟、Flash内存，以及大家常用的外设（例如uart、spi、adc等等）的一些库文件。
Inc：
用户.h头文件，用户文件的头文件一般都放到这边，也可自己另存其他位置，但是需要在keil中添加头文件所在的路径。
添加新路径的方式如下图所示，可以看到../Inc这个路径已经事先添加进去了。
MDK-ARM：
工程目录，主要是两个工程文件“.uvoptx”以及".uvprojx"（keil打开的是这个）。剩下的文件比较重要的是Output目录下编译生成的“.hex”文件。
Src：
用户.c文件，用户自己开发的一些驱动文件（外设驱动等等），以及main文件所在的目录。
1.3 常用文件简介
针对试验工程中的常见文件，我们以开发者的方式来给大家做一个简单的介绍。具体每个文件中的源码的详细说明，大家可以参照每个试验下的源码详解。
| 文件名 | 说明 |
|---|---|
| stm32l4xx_hal_conf.h | 路径位于Inc目录下，里面主要是一些宏定义，用于选择本工程所使用的库文件。这边选择的库文件，就是目录简介中提到的HAL库。 |
| main.c： | main()所在的文件，keil中我们配置了run to main()，也就是说工程从main()函数开始执行，所以main.c就是我们工程的主文件。 |
| stm32l4xx_hal_msp.c | msp（main stack pointer）主栈堆指针初始化的文件。我们重定义外设引脚选择的时候，STM32Cube生成的硬件引脚重定义函数默认也位于此文件下，但是为了方便，我们一般将其复制到各自的驱动文件下。 |
| stm32l4xx_it.c | 中断配置文件，用于存放工程的中断。STM32Cube生成的中断函数默认位于此文件下，同样为了方便起见，我们一般将各自的中断函数放到各自的驱动文件下。 |
| gyu_util.c | 从STM32Cube生成的main文件中独立出来的部分。主要用于处理工程的时钟选择，包含系统时钟、总线时钟以及外设时钟。 |
| stm32l4xx_hal_xx | HAL库文件。 |
| gyu_xx | 由谷雨物联编写的文件，大部分是外设的驱动文件。 |
2 01-led实验
第一个实验我们给大家带来的是最简单的外设控制，也就是 IO 口操作，通过这个实验我们可以了解到如何让STM32L476RC的一个 IO 输出高低电平，并以此控制 LED 的点亮和熄灭。
2.1 STM32L476 IO简介
每个GPIO引脚都可以通过软件配置为输出（推挽或漏极开路），输入（带或不带上拉或下拉）或外设备用功能。 大多数GPIO引脚与数字或模拟备用功能共用。 由于它们在AHB2总线上的映射，可以实现快速I / O切换。 如果需要，可以锁定I / O备用功能配置序列，以避免虚假写入I / O寄存器。
经过上一段对GPIO口模式的说明，在这里对它的工作模式进行一个小结，它一共有八种组合，即有八种可配置的工作模式，分别是：
- 输入浮空
- 输入上拉
- 输入下拉
- 模拟
- 带上拉或下拉的开漏输出
- 带上拉或下拉的推挽输出
- 带上拉或下拉的复用功能推挽
- 带上拉或下拉的复用功能开漏
2.2 硬件设计
选择STM32L4引脚PA15作为LED的控制引脚，PA15高电平时点亮LED。
2.3 实验准备
- 使用miniUSB线及10pin排线，通过Jlink仿真器连接PC端和开发板。
- 使用Keil打开基础实验 01-led实验工程。
- 下载程序，并完成功能测试。
2.4 实验验证
下载完成后，可以看到开发板上的LED灯周期闪烁，点亮及熄灭的周期时间为500ms。
2.5 源码详解
本节中的源码说明，仅针对此例程中的重要功能，详细的源码介绍请大家参照代码后的注释。
2.5.1 stm32l4xx_hal_conf.h
此文件位于“01-led实验\Inc”路径中，主要用途是选择使能此例程使用到的库文件，一般情况下，我们默认需要使用的为前5个，包含芯片、flash、电源、时钟以及NVIC。
此例程因为我们需要展示IO的使用，所以我们额外使能 HAL_GPIO_MODULE_ENABLED。
103 // 使能的宏
104 #define HAL_MODULE_ENABLED // 芯片
105 #define HAL_FLASH_MODULE_ENABLED // Flash
106 #define HAL_PWR_MODULE_ENABLED // 电源
107 #define HAL_RCC_MODULE_ENABLED // 时钟
108 #define HAL_CORTEX_MODULE_ENABLED // NVIC
109
110 #define HAL_GPIO_MODULE_ENABLED // GPIO
2.5.2 main.c
main函数，我们的例程由此处开始执行，首先调用HAL_Init()函数初始化我们的模块，接着调用SystemClock_Config()函数初始化此例程用到的时钟，具体有哪些时钟被初始化，在gyu_util.c部分有详细说明。
接下来我们初始化LED引脚配置，并且在while()循环中周期点亮、熄灭LED。
31 int main(void)
32 {
33 /* Reset of all peripherals, Initializes the Flash interface and the Systick. */
34 // 重置所有外设、flash界面以及系统时钟
35 HAL_Init();
36
37 // 配置系统时钟（包含振荡器、系统时钟、总线时钟等等）
38 SystemClock_Config();
39
40 // 初始化LED引脚
41 LED_Init();
42
43 //
44 while (1)
45 {
46 LED_SET(GPIO_PIN_SET); // 设置LED引脚（PA15）输出高电平，LED点亮
47 HAL_Delay(500); // 延时500ms
48 LED_SET(GPIO_PIN_RESET); // 设置LED引脚（PA15）输出低电平，LED熄灭
49 HAL_Delay(500); // 延时500ms
50 }
51 }
2.5.3 gyu_util.c
时钟初始化函数，用于配置我们模块运行的系统时钟、AHB高性能总线时钟、APB外设总线时钟以及单个外设的时钟。
主要包含了三个部分的初始化配置。
1.内部或者外部振荡器选择，也就是选择时钟信号的来源，是内部振荡，还是外部晶振。
2.时钟配置，选择系统、AHB总线及APB总线的时钟来源。
3.外设时钟配置，选择外设时钟来源。
为了给大家比较全面的展示各个时钟，我们振荡器选择HSI（内部16MHz高频）、HSE（外部8MHz高频）以及LSE（外部32.768KHz低频）三个。选择HSE作为PLL（锁相回路）时钟源，配置PLLCLK为80MHz。配置系统时钟SYSCLK、AHB高性能总线、APB外设总线（APB1及APB2）为80MHz。另外我们还分别配置了ADC、UART以及I2C的外设时钟。
基础实验中的其他例程，大部分都是使用的相同的时钟配置函数，有特殊的时钟使用，将会在对应例程的源码详解中做针对性说明。
49 void SystemClock_Config(void)
50 {
51 RCC_OscInitTypeDef RCC_OscInitStruct; // 定义RCC内部/外部振荡器结构体
52 RCC_ClkInitTypeDef RCC_ClkInitStruct; // 定义RCC系统，AHB和APB总线时钟配置结构体
53 RCC_PeriphCLKInitTypeDef PeriphClkInit; // 定义RCC扩展时钟结构体
54
55 // 配置LSE驱动器功能为低驱动能力
56 __HAL_RCC_LSEDRIVE_CONFIG(RCC_LSEDRIVE_LOW);
57
58 // 初始化CPU，AHB和APB总线时钟
59 RCC_OscInitStruct.OscillatorType = RCC_OSCILLATORTYPE_HSI|RCC_OSCILLATORTYPE_HSE
60 |RCC_OSCILLATORTYPE_LSE; // 设置需要配置的振荡器为HSI、HSE、LSE
61 // 配置HSE
62 RCC_OscInitStruct.HSEState = RCC_HSE_ON; // 激活HSE时钟（开发板外部为8MHz）
63 // 配置LSE
64 RCC_OscInitStruct.LSEState = RCC_LSE_ON; // 激活LSE时钟（32.768KHz,低驱动）
65 // 配置HSI
66 RCC_OscInitStruct.HSIState = RCC_HSI_ON; // 激活HSI时钟
67 RCC_OscInitStruct.HSICalibrationValue = 16; // 配置HSI为16MHz
68 // 配置PLL
69 RCC_OscInitStruct.PLL.PLLState = RCC_PLL_ON; // 打开PLL
70 RCC_OscInitStruct.PLL.PLLSource = RCC_PLLSOURCE_HSE; // 选择HSE时钟作为PLL入口时钟源，8MHz
71 RCC_OscInitStruct.PLL.PLLM = 1; // 配置PLL VCO输入分频为1，8/1 = 8MHz
72 RCC_OscInitStruct.PLL.PLLN = 20; // 配置PLL VCO输入倍增为20，8MHz*20 = 160MHz
73 RCC_OscInitStruct.PLL.PLLP = RCC_PLLP_DIV7; // SAI时钟7分频，160/7 = 22.857143MHz
74 RCC_OscInitStruct.PLL.PLLQ = RCC_PLLQ_DIV2; // SDMMC、RNG、USB时钟2分频，160/2 = 80MHz
75 RCC_OscInitStruct.PLL.PLLR = RCC_PLLR_DIV2; // 系统主时钟分区2分频，160/2 = 80MHz
76 // RCC时钟配置，出错则进入错误处理函数
77 if (HAL_RCC_OscConfig(&RCC_OscInitStruct) != HAL_OK)
78 {
79 _Error_Handler(__FILE__, __LINE__);
80 }
81
82 // 初始化CPU，AHB和APB总线时钟
83 RCC_ClkInitStruct.ClockType = RCC_CLOCKTYPE_HCLK|RCC_CLOCKTYPE_SYSCLK
84 |RCC_CLOCKTYPE_PCLK1|RCC_CLOCKTYPE_PCLK2; // 需要配置的时钟HCLK、SYSCLK、PCLK1、PCLK2
85 RCC_ClkInitStruct.SYSCLKSource = RCC_SYSCLKSOURCE_PLLCLK; // 配置系统时钟为PLLCLK输入，80MHz
86 RCC_ClkInitStruct.AHBCLKDivider = RCC_SYSCLK_DIV1; // AHB时钟为系统时钟1分频，80/1 = 80MHz
87 RCC_ClkInitStruct.APB1CLKDivider = RCC_HCLK_DIV1; // APB1时钟为系统时钟1分频，80/1 = 80MHz
88 RCC_ClkInitStruct.APB2CLKDivider = RCC_HCLK_DIV1; // APB2时钟为系统时钟1分频，80/1 = 80MHz
89 // RCC时钟配置，出错则进入错误处理函数
90 if (HAL_RCC_ClockConfig(&RCC_ClkInitStruct, FLASH_LATENCY_4) != HAL_OK) // HCLK=80MHz，Vcore=3.3V，所以选择SW4（FLASH_LATENCY_4）
91 {
92 _Error_Handler(__FILE__, __LINE__);
93 }
94
95 // 初始化外设时钟
96 PeriphClkInit.PeriphClockSelection = RCC_PERIPHCLK_USART1|RCC_PERIPHCLK_USART2
97 |RCC_PERIPHCLK_LPUART1|RCC_PERIPHCLK_LPTIM1
98 |RCC_PERIPHCLK_I2C2|RCC_PERIPHCLK_ADC; // 需要初始化的外设时钟:USART1、USART2、LPUART1、LPTIM1、I2C2、ADC
99 PeriphClkInit.Usart1ClockSelection = RCC_USART1CLKSOURCE_PCLK2; // 配置串口USART1时钟为PCLK2，80MHz
100 PeriphClkInit.Usart2ClockSelection = RCC_USART2CLKSOURCE_PCLK1; // 配置串口USART2时钟为PCLK1，80MHz
101 PeriphClkInit.Lpuart1ClockSelection = RCC_LPUART1CLKSOURCE_HSI; // 配置LPUART时钟为HSI，16MHz
102 PeriphClkInit.I2c2ClockSelection = RCC_I2C2CLKSOURCE_PCLK1; // 配置I2C2时钟为PCLK1，80MHz
103 PeriphClkInit.Lptim1ClockSelection = RCC_LPTIM1CLKSOURCE_LSE; // 配置LPTIM1时钟为LSE，32.768KHz
104 PeriphClkInit.AdcClockSelection = RCC_ADCCLKSOURCE_PLLSAI1; // 配置ADC时钟为PLLSAI1，现在为80MHz，下面会重新定义
105 PeriphClkInit.PLLSAI1.PLLSAI1Source = RCC_PLLSOURCE_HSE; // 配置PLLSAI1时钟为HSE，8MHz
106 PeriphClkInit.PLLSAI1.PLLSAI1M = 1; // 配置PLLSAI1分频为1
107 PeriphClkInit.PLLSAI1.PLLSAI1N = 8; // 配置PLLSAI1倍增为8
108 PeriphClkInit.PLLSAI1.PLLSAI1P = RCC_PLLP_DIV7; // SAI时钟7分频，64/7 = 9.142857MHz
109 PeriphClkInit.PLLSAI1.PLLSAI1Q = RCC_PLLQ_DIV2; // SDMMC、RNG、USB时钟2分频，64/2 = 32MHz
110 PeriphClkInit.PLLSAI1.PLLSAI1R = RCC_PLLR_DIV2; // 系统主时钟分区2分频，64/2 = 32MHz
111 PeriphClkInit.PLLSAI1.PLLSAI1ClockOut = RCC_PLLSAI1_ADC1CLK; // 配置PLLSAI1输出为ADC1时钟，也就是配置ADC1时钟，32MHz
112 // 外设时钟配置，出错则进入错误处理函数
113 if (HAL_RCCEx_PeriphCLKConfig(&PeriphClkInit) != HAL_OK)
114 {
115 _Error_Handler(__FILE__, __LINE__);
116 }
117
118 // 配置内部主稳压器输出电压，配置为稳压器输出电压范围1模式，也就是：典型输出电压为1.2V，系统频率高达80MHz
119 if (HAL_PWREx_ControlVoltageScaling(PWR_REGULATOR_VOLTAGE_SCALE1) != HAL_OK)
120 {
121 _Error_Handler(__FILE__, __LINE__);
122 }
123
124 // 配置系统定时器中断时间，配置为HCLK的千分频
125 HAL_SYSTICK_Config(HAL_RCC_GetHCLKFreq()/1000);
126
127 // 配置系统定时器，配置为HCLK
128 HAL_SYSTICK_CLKSourceConfig(SYSTICK_CLKSOURCE_HCLK);
129
130 // 系统定时器中断配置，设置系统定时器中断优先级最高（为0），且子优先级最高（为0）
131 HAL_NVIC_SetPriority(SysTick_IRQn, 0, 0);
132 }
2.5.4 gyu_led.c
此文件用于配置LED控制引脚，在LED_Init()函数中我们初始化PA15为推挽输出，并且使能GPIOA时钟，初始化PA15默认输出低电平。
31 void LED_Init(void)
32 {
33 GPIO_InitTypeDef GPIO_InitStructure; // 定义引脚参数结构体
34
35 __HAL_RCC_GPIOA_CLK_ENABLE(); // 使能GPIOA时钟
36
37 GPIO_InitStructure.Pin= GPIO_PIN_15; // 引脚编号为15
38 GPIO_InitStructure.Mode = GPIO_MODE_OUTPUT_PP; // 推挽输出
39 GPIO_InitStructure.Speed = GPIO_SPEED_FREQ_LOW; // 低频率
40 GPIO_InitStructure.Pull = GPIO_PULLDOWN; // 下拉
41 HAL_GPIO_Init(GPIOA, &GPIO_InitStructure); // 初始化PA15
42
43 HAL_GPIO_WritePin(GPIOA, GPIO_PIN_15, GPIO_PIN_RESET); // 设置PA15默认输出低电平
44 }
LED_SET()函数留给大家控制LED灯点亮或者熄灭，参数可选为GPIO_PIN_RESET（低电平）或者GPIO_PIN_SET（高电平）。
54 void LED_SET(GPIO_PinState pinSate)
55 {
56 HAL_GPIO_WritePin(GPIOA, GPIO_PIN_15, pinSate); // 设置PA15输出
57 }
3 02-马达实验
振动马达实验通过控制 GPIO 引脚输出高低电平，用于控制马达振动或停止 。
3.1 STM32L476 IO简介
每个GPIO引脚都可以通过软件配置为输出（推挽或漏极开路），输入（带或不带上拉或下拉）或外设备用功能。 大多数GPIO引脚与数字或模拟备用功能共用。 由于它们在AHB2总线上的映射，可以实现快速I / O切换。 如果需要，可以锁定I / O备用功能配置序列，以避免虚假写入I / O寄存器。
经过上一段对GPIO口模式的说明，在这里对它的工作模式进行一个小结，它一共有八种组合，即有八种可配置的工作模式，分别是：
- 输入浮空
- 输入上拉
- 输入下拉
- 模拟
- 带上拉或下拉的开漏输出
- 带上拉或下拉的推挽输出
- 带上拉或下拉的复用功能推挽
- 带上拉或下拉的复用功能开漏
3.2 硬件设计
选择STM32L4引脚PC7作为马达的控制引脚，PC7高电平时马达起振。
3.3 实验准备
- 使用miniUSB线及10pin排线，通过Jlink仿真器连接PC端和开发板。
- 使用Keil打开基础实验 02-马达实验工程。
- 下载程序，并完成功能测试。
3.4 实验验证
下载完成后，按下开发板上按键S1，马达起振，按下S3，马达停止。
3.5 源码详解
本节中的源码说明，仅针对此例程中的重要功能，详细的源码介绍请大家参照代码后的注释。
3.5.1 stm32l4xx_hal_conf.h
此文件位于“02-马达实验\Inc”路径中，主要用途是选择使能此例程使用到的库文件，一般情况下，我们默认需要使用的为前5个，包含芯片、flash、电源、时钟以及NVIC。
此例程因为我们需要展示IO的使用，所以我们额外使能 HAL_GPIO_MODULE_ENABLED。
103 // 使能的宏
104 #define HAL_MODULE_ENABLED // 芯片
105 #define HAL_FLASH_MODULE_ENABLED // Flash
106 #define HAL_PWR_MODULE_ENABLED // 电源
107 #define HAL_RCC_MODULE_ENABLED // 时钟
108 #define HAL_CORTEX_MODULE_ENABLED // NVIC
109
110 #define HAL_GPIO_MODULE_ENABLED // GPIO
3.5.2 main.c
main函数，我们的例程由此处开始执行，首先调用HAL_Init()函数初始化我们的模块，接着调用SystemClock_Config()函数初始化此例程用到的时钟，具体有哪些时钟被初始化，在gyu_util.c部分有详细说明。
接下来是初始化按键，有关按键的部分会在04-按键实验中给大家讲解。
这边我们主要关注的是马达的初始化，其实是和LED实验一样的，就是初始化一下马达控制IO。
36 int main(void)
37 {
38 /* Reset of all peripherals, Initializes the Flash interface and the Systick. */
39 // 重置所有外设、flash界面以及系统时钟
40 HAL_Init();
41
42 // 配置系统时钟（包含振荡器、系统时钟、总线时钟等等）
43 SystemClock_Config();
44
45 // 初始化按键引脚
46 MX_KEY_Init();
47
48 //注册按钮回调函数
49 KEY_RegisterCb(AppKey_cb);
50
51 // 初始化马达
52 Motor_Init();
53
54 //
55 while (1)
56 {
57 KEY_Poll(); // 按键轮训，监测是否有按键被按下
58 }
59 }
在按键的处理回调函数中，我们可以看到，按键S1（UP）按下后，设置马达引脚高电平，按键S3（DOWN）按下后，设置马达引脚低电平
69 void AppKey_cb(uint8_t key)
70 {
71 // 如果有相应按键被按下，则串口打印调试信息
72 if(key & KEY_UP)
73 {
74 Motor_SET(GPIO_PIN_SET);
75 }
76 if(key & KEY_LEFT)
77 {
78 //
79 }
80 if(key & KEY_DOWN)
81 {
82 Motor_SET(GPIO_PIN_RESET);
83 }
84 if(key & KEY_RIGHT)
85 {
86 //
87 }
88 }
3.5.3 gyu_util.c
时钟初始化函数，用于配置我们模块运行的系统时钟、AHB高性能总线时钟、APB外设总线时钟以及单个外设的时钟。
主要包含了三个部分的初始化配置。
1.内部或者外部振荡器选择，也就是选择时钟信号的来源，是内部振荡，还是外部晶振。
2.时钟配置，选择系统、AHB总线及APB总线的时钟来源。
3.外设时钟配置，选择外设时钟来源。
为了给大家比较全面的展示各个时钟，我们振荡器选择HSI（内部16MHz高频）、HSE（外部8MHz高频）以及LSE（外部32.768KHz低频）三个。选择HSE作为PLL（锁相回路）时钟源，配置PLLCLK为80MHz。配置系统时钟SYSCLK、AHB高性能总线、APB外设总线（APB1及APB2）为80MHz。另外我们还分别配置了ADC、UART以及I2C的外设时钟。
基础实验中的其他例程，大部分都是使用的相同的时钟配置函数，有特殊的时钟使用，将会在对应例程的源码详解中做针对性说明。
49 void SystemClock_Config(void)
50 {
51 RCC_OscInitTypeDef RCC_OscInitStruct; // 定义RCC内部/外部振荡器结构体
52 RCC_ClkInitTypeDef RCC_ClkInitStruct; // 定义RCC系统，AHB和APB总线时钟配置结构体
53 RCC_PeriphCLKInitTypeDef PeriphClkInit; // 定义RCC扩展时钟结构体
54
55 // 配置LSE驱动器功能为低驱动能力
56 __HAL_RCC_LSEDRIVE_CONFIG(RCC_LSEDRIVE_LOW);
57
58 // 初始化CPU，AHB和APB总线时钟
59 RCC_OscInitStruct.OscillatorType = RCC_OSCILLATORTYPE_HSI|RCC_OSCILLATORTYPE_HSE
60 |RCC_OSCILLATORTYPE_LSE; // 设置需要配置的振荡器为HSI、HSE、LSE
61 // 配置HSE
62 RCC_OscInitStruct.HSEState = RCC_HSE_ON; // 激活HSE时钟（开发板外部为8MHz）
63 // 配置LSE
64 RCC_OscInitStruct.LSEState = RCC_LSE_ON; // 激活LSE时钟（32.768KHz,低驱动）
65 // 配置HSI
66 RCC_OscInitStruct.HSIState = RCC_HSI_ON; // 激活HSI时钟
67 RCC_OscInitStruct.HSICalibrationValue = 16; // 配置HSI为16MHz
68 // 配置PLL
69 RCC_OscInitStruct.PLL.PLLState = RCC_PLL_ON; // 打开PLL
70 RCC_OscInitStruct.PLL.PLLSource = RCC_PLLSOURCE_HSE; // 选择HSE时钟作为PLL入口时钟源，8MHz
71 RCC_OscInitStruct.PLL.PLLM = 1; // 配置PLL VCO输入分频为1，8/1 = 8MHz
72 RCC_OscInitStruct.PLL.PLLN = 20; // 配置PLL VCO输入倍增为20，8MHz*20 = 160MHz
73 RCC_OscInitStruct.PLL.PLLP = RCC_PLLP_DIV7; // SAI时钟7分频，160/7 = 22.857143MHz
74 RCC_OscInitStruct.PLL.PLLQ = RCC_PLLQ_DIV2; // SDMMC、RNG、USB时钟2分频，160/2 = 80MHz
75 RCC_OscInitStruct.PLL.PLLR = RCC_PLLR_DIV2; // 系统主时钟分区2分频，160/2 = 80MHz
76 // RCC时钟配置，出错则进入错误处理函数
77 if (HAL_RCC_OscConfig(&RCC_OscInitStruct) != HAL_OK)
78 {
79 _Error_Handler(__FILE__, __LINE__);
80 }
81
82 // 初始化CPU，AHB和APB总线时钟
83 RCC_ClkInitStruct.ClockType = RCC_CLOCKTYPE_HCLK|RCC_CLOCKTYPE_SYSCLK
84 |RCC_CLOCKTYPE_PCLK1|RCC_CLOCKTYPE_PCLK2; // 需要配置的时钟HCLK、SYSCLK、PCLK1、PCLK2
85 RCC_ClkInitStruct.SYSCLKSource = RCC_SYSCLKSOURCE_PLLCLK; // 配置系统时钟为PLLCLK输入，80MHz
86 RCC_ClkInitStruct.AHBCLKDivider = RCC_SYSCLK_DIV1; // AHB时钟为系统时钟1分频，80/1 = 80MHz
87 RCC_ClkInitStruct.APB1CLKDivider = RCC_HCLK_DIV1; // APB1时钟为系统时钟1分频，80/1 = 80MHz
88 RCC_ClkInitStruct.APB2CLKDivider = RCC_HCLK_DIV1; // APB2时钟为系统时钟1分频，80/1 = 80MHz
89 // RCC时钟配置，出错则进入错误处理函数
90 if (HAL_RCC_ClockConfig(&RCC_ClkInitStruct, FLASH_LATENCY_4) != HAL_OK) // HCLK=80MHz，Vcore=3.3V，所以选择SW4（FLASH_LATENCY_4）
91 {
92 _Error_Handler(__FILE__, __LINE__);
93 }
94
95 // 初始化外设时钟
96 PeriphClkInit.PeriphClockSelection = RCC_PERIPHCLK_USART1|RCC_PERIPHCLK_USART2
97 |RCC_PERIPHCLK_LPUART1|RCC_PERIPHCLK_LPTIM1
98 |RCC_PERIPHCLK_I2C2|RCC_PERIPHCLK_ADC; // 需要初始化的外设时钟:USART1、USART2、LPUART1、LPTIM1、I2C2、ADC
99 PeriphClkInit.Usart1ClockSelection = RCC_USART1CLKSOURCE_PCLK2; // 配置串口USART1时钟为PCLK2，80MHz
100 PeriphClkInit.Usart2ClockSelection = RCC_USART2CLKSOURCE_PCLK1; // 配置串口USART2时钟为PCLK1，80MHz
101 PeriphClkInit.Lpuart1ClockSelection = RCC_LPUART1CLKSOURCE_HSI; // 配置LPUART时钟为HSI，16MHz
102 PeriphClkInit.I2c2ClockSelection = RCC_I2C2CLKSOURCE_PCLK1; // 配置I2C2时钟为PCLK1，80MHz
103 PeriphClkInit.Lptim1ClockSelection = RCC_LPTIM1CLKSOURCE_LSE; // 配置LPTIM1时钟为LSE，32.768KHz
104 PeriphClkInit.AdcClockSelection = RCC_ADCCLKSOURCE_PLLSAI1; // 配置ADC时钟为PLLSAI1，现在为80MHz，下面会重新定义
105 PeriphClkInit.PLLSAI1.PLLSAI1Source = RCC_PLLSOURCE_HSE; // 配置PLLSAI1时钟为HSE，8MHz
106 PeriphClkInit.PLLSAI1.PLLSAI1M = 1; // 配置PLLSAI1分频为1
107 PeriphClkInit.PLLSAI1.PLLSAI1N = 8; // 配置PLLSAI1倍增为8
108 PeriphClkInit.PLLSAI1.PLLSAI1P = RCC_PLLP_DIV7; // SAI时钟7分频，64/7 = 9.142857MHz
109 PeriphClkInit.PLLSAI1.PLLSAI1Q = RCC_PLLQ_DIV2; // SDMMC、RNG、USB时钟2分频，64/2 = 32MHz
110 PeriphClkInit.PLLSAI1.PLLSAI1R = RCC_PLLR_DIV2; // 系统主时钟分区2分频，64/2 = 32MHz
111 PeriphClkInit.PLLSAI1.PLLSAI1ClockOut = RCC_PLLSAI1_ADC1CLK; // 配置PLLSAI1输出为ADC1时钟，也就是配置ADC1时钟，32MHz
112 // 外设时钟配置，出错则进入错误处理函数
113 if (HAL_RCCEx_PeriphCLKConfig(&PeriphClkInit) != HAL_OK)
114 {
115 _Error_Handler(__FILE__, __LINE__);
116 }
117
118 // 配置内部主稳压器输出电压，配置为稳压器输出电压范围1模式，也就是：典型输出电压为1.2V，系统频率高达80MHz
119 if (HAL_PWREx_ControlVoltageScaling(PWR_REGULATOR_VOLTAGE_SCALE1) != HAL_OK)
120 {
121 _Error_Handler(__FILE__, __LINE__);
122 }
123
124 // 配置系统定时器中断时间，配置为HCLK的千分频
125 HAL_SYSTICK_Config(HAL_RCC_GetHCLKFreq()/1000);
126
127 // 配置系统定时器，配置为HCLK
128 HAL_SYSTICK_CLKSourceConfig(SYSTICK_CLKSOURCE_HCLK);
129
130 // 系统定时器中断配置，设置系统定时器中断优先级最高（为0），且子优先级最高（为0）
131 HAL_NVIC_SetPriority(SysTick_IRQn, 0, 0);
132 }
3.5.4 gyu_motor.c
马达引脚初始化函数，初始化PC7推挽输出低电平。
31 void Motor_Init(void)
32 {
33 GPIO_InitTypeDef GPIO_InitStructure; // 定义引脚参数结构体
34
35 __HAL_RCC_GPIOC_CLK_ENABLE(); // 使能GPIOC时钟
36
37 GPIO_InitStructure.Pin= GPIO_PIN_7; // 引脚编号为7
38 GPIO_InitStructure.Mode = GPIO_MODE_OUTPUT_PP; // 推挽输出
39 GPIO_InitStructure.Speed = GPIO_SPEED_FREQ_LOW; // 低频率
40 GPIO_InitStructure.Pull = GPIO_PULLUP; // 上拉
41 HAL_GPIO_Init(GPIOC, &GPIO_InitStructure); // 初始化PC7
42
43 HAL_GPIO_WritePin(GPIOC, GPIO_PIN_7, GPIO_PIN_RESET); // 设置PC7默认输出低电平
44 }
马达引脚电平设置函数，设置为高电平，马达起振，设置低电平，马达停止。
54 void Motor_SET(GPIO_PinState pinSate)
55 {
56 HAL_GPIO_WritePin(GPIOC, GPIO_PIN_7, pinSate); // 设置PC7输出
57 }
4 03-蜂鸣器实验
蜂鸣器实验通过控制 GPIO 引脚输出高低电平，用于控制蜂鸣器发出蜂鸣声或者停止发声 。
4.1 STM32L476 IO简介
每个GPIO引脚都可以通过软件配置为输出（推挽或漏极开路），输入（带或不带上拉或下拉）或外设备用功能。 大多数GPIO引脚与数字或模拟备用功能共用。 由于它们在AHB2总线上的映射，可以实现快速I / O切换。 如果需要，可以锁定I / O备用功能配置序列，以避免虚假写入I / O寄存器。
经过上一段对GPIO口模式的说明，在这里对它的工作模式进行一个小结，它一共有八种组合，即有八种可配置的工作模式，分别是：
- 输入浮空
- 输入上拉
- 输入下拉
- 模拟
- 带上拉或下拉的开漏输出
- 带上拉或下拉的推挽输出
- 带上拉或下拉的复用功能推挽
- 带上拉或下拉的复用功能开漏
4.2 硬件设计
选择STM32L4引脚PB2作为蜂鸣器的控制引脚，PB2高电平时蜂鸣器发出蜂鸣声。
4.3 实验准备
- 使用miniUSB线及10pin排线，通过Jlink仿真器连接PC端和开发板。
- 使用Keil打开基础实验 03-蜂鸣器实验工程。
- 下载程序，并完成功能测试。
4.4 实验验证
下载完成后，按下开发板上按键S1，蜂鸣器发声，按下S3，蜂鸣器停止。
4.5 源码详解
本节中的源码说明，仅针对此例程中的重要功能，详细的源码介绍请大家参照代码后的注释。
4.5.1 stm32l4xx_hal_conf.h
此文件位于“03-蜂鸣器实验\Inc”路径中，主要用途是选择使能此例程使用到的库文件，一般情况下，我们默认需要使用的为前5个，包含芯片、flash、电源、时钟以及NVIC。
此例程因为我们需要展示IO的使用，所以我们额外使能 HAL_GPIO_MODULE_ENABLED。
103 // 使能的宏
104 #define HAL_MODULE_ENABLED // 芯片
105 #define HAL_FLASH_MODULE_ENABLED // Flash
106 #define HAL_PWR_MODULE_ENABLED // 电源
107 #define HAL_RCC_MODULE_ENABLED // 时钟
108 #define HAL_CORTEX_MODULE_ENABLED // NVIC
109
110 #define HAL_GPIO_MODULE_ENABLED // GPIO
4.5.2 main.c
main函数，我们的例程由此处开始执行，首先调用HAL_Init()函数初始化我们的模块，接着调用SystemClock_Config()函数初始化此例程用到的时钟，具体有哪些时钟被初始化，在gyu_util.c部分有详细说明。
接下来是初始化按键，有关按键的部分会在04-按键实验中给大家讲解。
最后我们初始化蜂鸣器引脚，配置蜂鸣器引脚为默认输出低电平。
36 int main(void)
37 {
38 /* Reset of all peripherals, Initializes the Flash interface and the Systick. */
39 // 重置所有外设、flash界面以及系统时钟
40 HAL_Init();
41
42 // 配置系统时钟（包含振荡器、系统时钟、总线时钟等等）
43 SystemClock_Config();
44
45 // 初始化按键引脚
46 MX_KEY_Init();
47
48 //注册按钮回调函数
49 KEY_RegisterCb(AppKey_cb);
50
51 //初始化蜂鸣器
52 Buzzer_Init();
53
54 //
55 while (1)
56 {
57 KEY_Poll(); // 按键轮训，监测是否有按键被按下
58 }
59 }
在按键的处理回调函数中，我们可以看到，按键S1（UP）按下后，设置蜂鸣器引脚高电平，按键S3（DOWN）按下后，设置蜂鸣器引脚低电平
69 void AppKey_cb(uint8_t key)
70 {
71 // 如果有相应按键被按下，则串口打印调试信息
72 if(key & KEY_UP)
73 {
74 Motor_SET(GPIO_PIN_SET);
75 }
76 if(key & KEY_LEFT)
77 {
78 //
79 }
80 if(key & KEY_DOWN)
81 {
82 Motor_SET(GPIO_PIN_RESET);
83 }
84 if(key & KEY_RIGHT)
85 {
86 //
87 }
88 }
4.5.3 gyu_util.c
时钟初始化函数，用于配置我们模块运行的系统时钟、AHB高性能总线时钟、APB外设总线时钟以及单个外设的时钟。
主要包含了三个部分的初始化配置。
1.内部或者外部振荡器选择，也就是选择时钟信号的来源，是内部振荡，还是外部晶振。
2.时钟配置，选择系统、AHB总线及APB总线的时钟来源。
3.外设时钟配置，选择外设时钟来源。
为了给大家比较全面的展示各个时钟，我们振荡器选择HSI（内部16MHz高频）、HSE（外部8MHz高频）以及LSE（外部32.768KHz低频）三个。选择HSE作为PLL（锁相回路）时钟源，配置PLLCLK为80MHz。配置系统时钟SYSCLK、AHB高性能总线、APB外设总线（APB1及APB2）为80MHz。另外我们还分别配置了ADC、UART以及I2C的外设时钟。
基础实验中的其他例程，大部分都是使用的相同的时钟配置函数，有特殊的时钟使用，将会在对应例程的源码详解中做针对性说明。
49 void SystemClock_Config(void)
50 {
51 RCC_OscInitTypeDef RCC_OscInitStruct; // 定义RCC内部/外部振荡器结构体
52 RCC_ClkInitTypeDef RCC_ClkInitStruct; // 定义RCC系统，AHB和APB总线时钟配置结构体
53 RCC_PeriphCLKInitTypeDef PeriphClkInit; // 定义RCC扩展时钟结构体
54
55 // 配置LSE驱动器功能为低驱动能力
56 __HAL_RCC_LSEDRIVE_CONFIG(RCC_LSEDRIVE_LOW);
57
58 // 初始化CPU，AHB和APB总线时钟
59 RCC_OscInitStruct.OscillatorType = RCC_OSCILLATORTYPE_HSI|RCC_OSCILLATORTYPE_HSE
60 |RCC_OSCILLATORTYPE_LSE; // 设置需要配置的振荡器为HSI、HSE、LSE
61 // 配置HSE
62 RCC_OscInitStruct.HSEState = RCC_HSE_ON; // 激活HSE时钟（开发板外部为8MHz）
63 // 配置LSE
64 RCC_OscInitStruct.LSEState = RCC_LSE_ON; // 激活LSE时钟（32.768KHz,低驱动）
65 // 配置HSI
66 RCC_OscInitStruct.HSIState = RCC_HSI_ON; // 激活HSI时钟
67 RCC_OscInitStruct.HSICalibrationValue = 16; // 配置HSI为16MHz
68 // 配置PLL
69 RCC_OscInitStruct.PLL.PLLState = RCC_PLL_ON; // 打开PLL
70 RCC_OscInitStruct.PLL.PLLSource = RCC_PLLSOURCE_HSE; // 选择HSE时钟作为PLL入口时钟源，8MHz
71 RCC_OscInitStruct.PLL.PLLM = 1; // 配置PLL VCO输入分频为1，8/1 = 8MHz
72 RCC_OscInitStruct.PLL.PLLN = 20; // 配置PLL VCO输入倍增为20，8MHz*20 = 160MHz
73 RCC_OscInitStruct.PLL.PLLP = RCC_PLLP_DIV7; // SAI时钟7分频，160/7 = 22.857143MHz
74 RCC_OscInitStruct.PLL.PLLQ = RCC_PLLQ_DIV2; // SDMMC、RNG、USB时钟2分频，160/2 = 80MHz
75 RCC_OscInitStruct.PLL.PLLR = RCC_PLLR_DIV2; // 系统主时钟分区2分频，160/2 = 80MHz
76 // RCC时钟配置，出错则进入错误处理函数
77 if (HAL_RCC_OscConfig(&RCC_OscInitStruct) != HAL_OK)
78 {
79 _Error_Handler(__FILE__, __LINE__);
80 }
81
82 // 初始化CPU，AHB和APB总线时钟
83 RCC_ClkInitStruct.ClockType = RCC_CLOCKTYPE_HCLK|RCC_CLOCKTYPE_SYSCLK
84 |RCC_CLOCKTYPE_PCLK1|RCC_CLOCKTYPE_PCLK2; // 需要配置的时钟HCLK、SYSCLK、PCLK1、PCLK2
85 RCC_ClkInitStruct.SYSCLKSource = RCC_SYSCLKSOURCE_PLLCLK; // 配置系统时钟为PLLCLK输入，80MHz
86 RCC_ClkInitStruct.AHBCLKDivider = RCC_SYSCLK_DIV1; // AHB时钟为系统时钟1分频，80/1 = 80MHz
87 RCC_ClkInitStruct.APB1CLKDivider = RCC_HCLK_DIV1; // APB1时钟为系统时钟1分频，80/1 = 80MHz
88 RCC_ClkInitStruct.APB2CLKDivider = RCC_HCLK_DIV1; // APB2时钟为系统时钟1分频，80/1 = 80MHz
89 // RCC时钟配置，出错则进入错误处理函数
90 if (HAL_RCC_ClockConfig(&RCC_ClkInitStruct, FLASH_LATENCY_4) != HAL_OK) // HCLK=80MHz，Vcore=3.3V，所以选择SW4（FLASH_LATENCY_4）
91 {
92 _Error_Handler(__FILE__, __LINE__);
93 }
94
95 // 初始化外设时钟
96 PeriphClkInit.PeriphClockSelection = RCC_PERIPHCLK_USART1|RCC_PERIPHCLK_USART2
97 |RCC_PERIPHCLK_LPUART1|RCC_PERIPHCLK_LPTIM1
98 |RCC_PERIPHCLK_I2C2|RCC_PERIPHCLK_ADC; // 需要初始化的外设时钟:USART1、USART2、LPUART1、LPTIM1、I2C2、ADC
99 PeriphClkInit.Usart1ClockSelection = RCC_USART1CLKSOURCE_PCLK2; // 配置串口USART1时钟为PCLK2，80MHz
100 PeriphClkInit.Usart2ClockSelection = RCC_USART2CLKSOURCE_PCLK1; // 配置串口USART2时钟为PCLK1，80MHz
101 PeriphClkInit.Lpuart1ClockSelection = RCC_LPUART1CLKSOURCE_HSI; // 配置LPUART时钟为HSI，16MHz
102 PeriphClkInit.I2c2ClockSelection = RCC_I2C2CLKSOURCE_PCLK1; // 配置I2C2时钟为PCLK1，80MHz
103 PeriphClkInit.Lptim1ClockSelection = RCC_LPTIM1CLKSOURCE_LSE; // 配置LPTIM1时钟为LSE，32.768KHz
104 PeriphClkInit.AdcClockSelection = RCC_ADCCLKSOURCE_PLLSAI1; // 配置ADC时钟为PLLSAI1，现在为80MHz，下面会重新定义
105 PeriphClkInit.PLLSAI1.PLLSAI1Source = RCC_PLLSOURCE_HSE; // 配置PLLSAI1时钟为HSE，8MHz
106 PeriphClkInit.PLLSAI1.PLLSAI1M = 1; // 配置PLLSAI1分频为1
107 PeriphClkInit.PLLSAI1.PLLSAI1N = 8; // 配置PLLSAI1倍增为8
108 PeriphClkInit.PLLSAI1.PLLSAI1P = RCC_PLLP_DIV7; // SAI时钟7分频，64/7 = 9.142857MHz
109 PeriphClkInit.PLLSAI1.PLLSAI1Q = RCC_PLLQ_DIV2; // SDMMC、RNG、USB时钟2分频，64/2 = 32MHz
110 PeriphClkInit.PLLSAI1.PLLSAI1R = RCC_PLLR_DIV2; // 系统主时钟分区2分频，64/2 = 32MHz
111 PeriphClkInit.PLLSAI1.PLLSAI1ClockOut = RCC_PLLSAI1_ADC1CLK; // 配置PLLSAI1输出为ADC1时钟，也就是配置ADC1时钟，32MHz
112 // 外设时钟配置，出错则进入错误处理函数
113 if (HAL_RCCEx_PeriphCLKConfig(&PeriphClkInit) != HAL_OK)
114 {
115 _Error_Handler(__FILE__, __LINE__);
116 }
117
118 // 配置内部主稳压器输出电压，配置为稳压器输出电压范围1模式，也就是：典型输出电压为1.2V，系统频率高达80MHz
119 if (HAL_PWREx_ControlVoltageScaling(PWR_REGULATOR_VOLTAGE_SCALE1) != HAL_OK)
120 {
121 _Error_Handler(__FILE__, __LINE__);
122 }
123
124 // 配置系统定时器中断时间，配置为HCLK的千分频
125 HAL_SYSTICK_Config(HAL_RCC_GetHCLKFreq()/1000);
126
127 // 配置系统定时器，配置为HCLK
128 HAL_SYSTICK_CLKSourceConfig(SYSTICK_CLKSOURCE_HCLK);
129
130 // 系统定时器中断配置，设置系统定时器中断优先级最高（为0），且子优先级最高（为0）
131 HAL_NVIC_SetPriority(SysTick_IRQn, 0, 0);
132 }
4.5.4 gyu_buzzer.c
蜂鸣器引脚初始化函数，初始化PB2推挽输出低电平。
31 void Buzzer_Init(void)
32 {
33 GPIO_InitTypeDef GPIO_InitStructure; // 定义引脚参数结构体
34
35 __HAL_RCC_GPIOB_CLK_ENABLE(); // 使能GPIOB时钟
36
37 GPIO_InitStructure.Pin= GPIO_PIN_2; // 引脚编号为2
38 GPIO_InitStructure.Mode = GPIO_MODE_OUTPUT_PP; // 推挽输出
39 GPIO_InitStructure.Speed = GPIO_SPEED_FREQ_LOW; // 低频率
40 GPIO_InitStructure.Pull = GPIO_PULLUP; // 上拉
41 HAL_GPIO_Init(GPIOB, &GPIO_InitStructure); // 初始化PB2
42
43 HAL_GPIO_WritePin(GPIOB, GPIO_PIN_2, GPIO_PIN_RESET); // 设置PB2默认输出低电平
44 }
蜂鸣器引脚电平设置函数，设置为高电平，蜂鸣器发出蜂鸣声，设置低电平，蜂鸣器停止。
54 void Buzzer_SET(GPIO_PinState pinSate)
55 {
56 HAL_GPIO_WritePin(GPIOB, GPIO_PIN_2, pinSate); // 设置PB2输出
57 }