STM32 CubeMx

### STM32CubeMX 使用教程和配置指南

#### 工具概述
STM32CubeMX 和 STM32CubeIDE 是 STMicroelectronics 提供的强大工具，用于开发 STM32 微控制器。STM32CubeMX 是一个图形化配置工具，允许用户配置外设、时钟树、引脚等，并生成初始化代码[^3]。

#### 新建工程项目
启动 STM32CubeMX 软件后，如果首次使用该软件，则需检查是否有可用的更新以及安装必要的固件库。创建新项目涉及选择特定的微控制器型号，这一步骤对于确保后续配置与所选硬件兼容至关重要[^2]。

#### 配置外设功能
通过 STM32CubeMX 可以为多种外设设置参数，包括但不限于 UART、GPIO、外部中断、ADC（模数转换）、CRC（循环冗余校验）、定时器及其 PWM 输出或输入捕捉模式、I²C 总线接口、SPI 接口以及 NAND Flash 或 FMC (Flexible Memory Controller) 总线连接方式[^1]。

#### 设置时钟系统
调整内部振荡源频率和其他与时基有关的因素来优化性能表现；同时也可以定义系统的最大工作速度以满足应用需求。

#### GPIO 引脚分配
指定各个通用目的 I/O 的用途，比如将其设定为推挽输出型态或是上拉/下拉电阻状态下的浮空输入形式等等。

#### 生成初始化代码
完成上述各项设定之后，可以利用此工具自动生成适用于不同 IDE 平台上的 C/C++ 源文件框架结构，从而简化编程过程并减少人为错误的发生几率。

// 示例：UART 初始化函数模板
void MX_USART1_UART_Init(void)
{
    huart1.Instance = USART1;
    huart1.Init.BaudRate = 9600; // 波特率
    huart1.Init.WordLength = UART_WORDLENGTH_8B; // 数据位长度
    huart1.Init.StopBits = UART_STOPBITS_1; // 停止位数量
    huart1.Init.Parity = UART_PARITY_NONE; // 校验类型
    HAL_UART_Init(&huart1); // 初始化串口通信句柄对象
}