企业官网建设流程全解析

摘要

STM32标准库已经不再维护，只有历史项目会用到标准库，底层上标准库相比HAL库更加精简，但外在区别只有函数名，打开正点原子的示例代码就可以对照修改，所以就不介绍标准库了。

现在的STM32开发一般有两种，一种是用CubeMX软件另一种是调库，调库显然更麻烦，但是有些历史项目是调库的或者团队负责人更喜欢调库模式，所以这两种开发方式都得会，这两种开发方式只有在初始化外设时会有不同，所以写初始化代码时就可以先用CubeMX软件生成对应代码然后复制粘贴到项目。

STM32外设很多，各配置项比较复杂，而各种文档内容很多但平时查起来很麻烦，所以本文将常用配置项的含意、函数的作用以及用途做一个汇总。

软件安装及其他教程 点击打开可查看专栏【STM32Cube开发方式】

新建项目的操作可以点击链接跳转到我的文章：STM32-keil+CubeMX快速开发【外设配置篇】：新建项目

外设通用套路

重要资料速查

外设的函数原型可以在 “stm32xxx_hal_xxx.c” 文件中查看。

外设的结构体、中断标志等可以在 “stm32xxx_hal_xxx.h” 文件中查看。

外设初始化配置

先根据需求在CubeMX软件中配置外设和时钟，然后在对应外设的“.c/.h”文件中可以看到类似下面伪代码的代码就是外设配置代码，CubeMX生成的系统时钟配置函数 “SystemClock_Config” 在 “main” 函数的后面）

伪代码如下，其中XXX和xxx表示某外设。

XXX_HandleTypeDef hxxx; // 结构体的定义在“stm32xxx_hal_xxx.h”中，在keil软件中全局搜索对应的 “XXX_InItTypeDef;”即可快速查看结构体成员的意义

/* 外设初始化函数 */
void XXX_Init(void)
{

// hxxx 结构体赋值，与MX软件中配置项相对应，此处省略

if (HAL_XXX_Init(&hxxx) != HAL_OK)
{
Error_Handler();
}

}

/* 此函数在HAL_XXX_Init(&hxxx)中被调用，用于时钟使能、引脚配置和中断优先级设置 */

void HAL_XXX_MspInit(XXX_HandleTypeDef* xxxHandle)
{

GPIO_InitTypeDef GPIO_InitStruct = {0};
if(xxxHandle->Instance==XXX)
{
/* 外设时钟使能 */
__HAL_RCC_XXX_CLK_ENABLE();

__HAL_RCC_GPIOX_CLK_ENABLE(); //外设引脚时钟使能

/* 引脚配置 */
// GPIO_InitStruct 结构体赋值
HAL_GPIO_Init(GPIOX, &GPIO_InitStruct);

/* 中断优先级配置 */

HAL_NVIC_SetPriority(XXX_IRQn, X, X);
HAL_NVIC_EnableIRQ(XXX_IRQn);

}
}

外设中断处理框架

CubeMX生成的全部中断处理函数都在 “stm32xxx_it.c” 文件中的最后部分，伪代码如下。

void XXX_IRQHandler(void)
{
HAL_XXX_IRQHandler(&hxxx);
}

各外设中断的回调函数名（Callback函数）可以在 “stm32xxx_hal_xxx.c”文件的代码生成日志中查看，以“stm32f4xxx_hal_tim.c”为例，如下所示。

各外设内容

包括配置流程、配置项说明、常用HAL函数的记录。

中断与NVIC

流程

1. 选择优先级策略
2. 打开对应中断
3. 配置优先级

中断常用HAL函数

下表中的“XXX”表示某外设

NVIC常用HAL函数

GPIO

流程

1. 选择GPIO引脚选择模式
2. 添加用户标签
3. 配置默认输出电平、模式、上下拉、速度

各配置项的意义

GPIO output level：配置GPIO初始状态下的输出电平。

GPIO mode：进一步配置GPIO模式

output模式下可选择推挽输出或者开漏输出。

EXTI模式下可选择中断触发模式。

GPIO Pull-up/Pull-down：配置引脚上下拉模式。

Maximum speed：配置引脚的最大速度，配置项与速度值对应如下表。

User Lable：用户标签设置。

GPIO常用HAL函数

定时器是MCU的关键功能，其功能多样、配置复杂，所以拆分成多个模式。

TIM基础定时模式

所有定时器都可实现此功能。

流程

1. 选择定时器
2. 选择定时器模式（基础定时器勾选“Activated”，通用/高级定时器勾选/选择“Internal Clock”）
3. 单次定时模式需要勾选“One Pulse Mode”项
4. 根据公式计算并配置；公式：定时时间 = （Prescaler+1）*（Counter Period+1）/（APB Timer clocks）
5. 设置触发模式

所需配置项及意义

Prescaler ：预分频器值，比实际值小1。

Counter Mode ：计数模式，定时模式配置为UP即可。

Counter Period ：计数周期，也就是重装载寄存器的值，比实际值小1。

auto-reload preload：自动重装载，如果需要在运行时修改定时时间并且需要等待此次定时完成后再修改“Counter Period ”的值时，需要使能此项。

Trigger Event Selection：主模式下触发输出信号（TRGO）信号源选择。有3种选项：

• Reset，定时器启动时触发中断且每次溢出后触发中断，使用定时器的复位信号作为TRGO输出；
• Enable，定时器使能后触发一次中断，使用计数器的使能信号作为TRGO输出；
• Update Event，仅在每次溢出后触发中断，使用定时器的溢出事件信号作为TRGO输出。

TIM常用HAL函数

TIM的PWM输出模式

除基础定时器外都可实现此功能。

流程

TIM的输入比较模式

TIM的PWM输入、输入捕获模式

RTC

DMA

USART

配置流程

1、选定所用的引脚，配置为UART模式。

2、配置串口参数。

3、根据需要打开中断。

配置项说明

常用HAL函数

IIC

CAN