STM32CubeMX 是 STMicroelectronics 推出的图形化配置工具，用于快速生成 STM32 微控制器的初始化代码。以下是其基础使用步骤：

1. 安装软件

• 下载地址：访问 ST官网 下载 STM32CubeMX，并安装对应版本（支持 Windows/macOS/Linux）。
• 安装固件库：首次打开软件时，需通过 Help > Manage Embedded Software Packages 安装目标芯片的固件支持包（HAL库）。

2. 创建新项目

1. 选择芯片型号：

   • 点击 File > New Project。
   • 在搜索栏输入芯片型号（如 STM32F103C8T6），或通过芯片系列筛选。
   • 双击目标芯片进入配置界面。

2. 导入现有工程（可选）：可通过 File > Load Project 导入已有 .ioc 配置文件。

3. 配置外设与时钟

• 引脚配置：

  • 在芯片引脚图上直接点击引脚，选择功能（如 GPIO、USART、SPI 等）。
  • 配置参数（如 GPIO 输出模式、USART 波特率等）。

• 时钟树配置：

  • 进入 Clock Configuration 标签页。
  • 选择时钟源（如 HSE 外部晶振），拖动滑块设置主频（如 72MHz）。

• 外设配置：

  • 在左侧外设列表（如 USART1、ADC1）中启用并配置参数（如中断、DMA 等）。

4. 生成代码

1. 项目设置：

   • 进入 Project Manager 标签页：
     • 设置项目名称和保存路径（路径避免中文和空格）。
     • 选择 IDE（如 Keil、IAR、STM32CubeIDE 或 Makefile）。
     • 配置代码生成选项（如勾选 Generate peripheral initialization as a pair of .c/.h files）。

2. 生成代码：

   • 点击右上角 GENERATE CODE，自动生成工程文件和 HAL 库初始化代码。

5. 编写用户代码

• 在生成的工程中：
  • 用户代码区域：在 main.c 的 /* USER CODE BEGIN */ 和 /* USER CODE END */ 之间添加业务逻辑。
  • 调用 HAL 库函数：例如使用 HAL_GPIO_WritePin() 控制 GPIO，或 HAL_UART_Transmit() 发送数据。

6. 编译与下载

• 使用对应 IDE（如 Keil）打开工程，编译后通过 ST-Link 或 J-Link 下载到开发板。
• 复位开发板运行程序。

关键提示

• HAL 库优势：HAL（硬件抽象层）库简化了底层操作，但需熟悉其函数接口。
• 重新生成代码：修改配置后，重新生成代码会保留用户代码区域的内容。
• 调试工具：结合 STM32CubeMonitor 或 IDE 内置调试器进行问题排查。

通过以上步骤，可快速搭建 STM32 开发环境并实现功能验证。遇到具体外设问题时，可参考 STM32CubeMX 内置的示例代码或官方文档。