本文将详细介绍如何搭建STM32F103的开发环境。STM32F103是STMicroelectronics推出的一款基于ARM Cortex-M3内核的32位微控制器（MCU），广泛应用于嵌入式开发。以下是搭建开发环境的详细步骤，涵盖硬件准备、软件安装、工具链配置及简单的开发示例。

---

1. 硬件准备

在搭建STM32F103开发环境之前，需要准备以下硬件：

• STM32F103开发板：常见型号包括STM32F103C8T6（“蓝板”）或STM32F103ZET6开发板（如正点原子、野火等）。
• 调试器/编程器：推荐使用ST-Link V2、J-Link或DAP-Link，用于程序下载和调试。
• USB-TTL模块：如CH340、FT232R，用于串口通信调试。
• 连接线：杜邦线、USB线等，用于连接开发板与PC。
• 电源：通常开发板通过USB供电（5V），确保供电稳定。
• PC：Windows、Linux或macOS系统均可，推荐Windows 10/11以获得更好的工具支持。

---

2. 软件工具链准备

STM32F103的开发需要以下软件工具，包括IDE、驱动、固件库和烧录工具。以下是推荐的工具及安装步骤：

2.1 集成开发环境（IDE）

推荐使用以下两种主流IDE：

• STM32CubeIDE（推荐）：
  • STM32CubeIDE是ST官方推出的免费IDE，集成了代码编辑、调试、配置工具和固件库。
  • 安装步骤：
    1. 访问ST官方网站，下载最新版本的STM32CubeIDE（支持Windows/Linux/macOS）。
    2. 安装时选择默认设置，确保安装路径无中文字符。
    3. 安装完成后，启动STM32CubeIDE，登录ST账户（可选）以激活完整功能。
• Keil MDK-ARM：
  • Keil是专业的嵌入式开发工具，支持ARM Cortex-M系列，适合需要高性能调试的用户。
  • 安装步骤：
    1. 访问Keil官网，下载MDK-ARM（需购买许可证，免费版有代码大小限制）。
    2. 安装Keil MDK和STM32相关Pack（如STM32F1xx_DFP）。
    3. 配置ARM编译器（通常随MDK安装）。

选择建议：初学者推荐STM32CubeIDE，免费且功能全面；专业开发者可选择Keil以获得更强大的调试功能。

2.2 驱动安装

• ST-Link驱动：
  • 如果使用ST-Link调试器，需安装驱动。
  • 下载地址：ST-Link驱动。
  • 安装后，连接ST-Link到PC，在设备管理器中检查是否识别为“STM32 STLink”。
• USB-TTL驱动：
  • 若使用CH340/CH341模块，需安装对应驱动（从模块供应商官网或芯片厂家网站下载）。

2.3 STM32CubeMX（可选，但推荐）

• STM32CubeMX是ST官方的图形化配置工具，用于生成初始化代码、配置外设（如GPIO、UART、TIM等）。
• 安装步骤：
  1. 从ST官网下载STM32CubeMX。
  2. 安装并确保Java环境已配置（若未安装，下载Java SE）。
  3. 启动CubeMX，下载STM32F1系列固件库（在CubeMX中选择“Manage Software Installations”）。

2.4 固件库

STM32F103开发支持以下两种固件库：

• 标准外设库（SPL）：传统方式，代码手动配置，适合小型项目。
  • 下载地址：STM32F1标准库。
• HAL库（推荐）：STM32Cube框架下的硬件抽象层，代码可移植性强，适合复杂项目。
  • HAL库通过STM32CubeMX自动生成，或从ST官网下载。

2.5 烧录工具

• STM32CubeProgrammer：
  • ST官方烧录工具，支持ST-Link、J-Link、串口等多种烧录方式。
  • 下载地址：STM32CubeProgrammer。
  • 安装后，用于固件下载和Flash擦除。
• ST-Link Utility（旧工具）：功能类似，但CubeProgrammer更现代化。

2.6 终端工具（用于串口调试）

• PuTTY或Tera Term：用于查看串口输出，调试程序。
• 安装步骤：
  1. 下载PuTTY（官网）或Tera Term。
  2. 配置串口参数（波特率通常为115200，具体视程序而定）。

---

3. 开发环境配置

以下以STM32CubeIDE + STM32CubeMX + ST-Link为例，说明配置步骤：

3.1 配置STM32CubeMX

1. 打开STM32CubeMX，选择“New Project”。
2. 在MCU选择界面，搜索“STM32F103”（如STM32F103C8T6），选择对应型号。
3. 配置外设：
   • 例如，配置PA9/PA10为UART1，设置波特率为115200。
   • 配置系统时钟（HSE/PLL），如使用8MHz外部晶振，设置主频为72MHz。
4. 在“Project Manager”中：
   • 设置项目名称和保存路径。
   • 选择工具链为“STM32CubeIDE”。
   • 选择固件包（HAL或LL）。
5. 点击“Generate Code”，生成初始化代码。

3.2 在STM32CubeIDE中开发

1. 打开STM32CubeIDE，导入CubeMX生成的项目（选择.ioc文件）。
2. 编写用户代码：
   • 在main.c中，找到/* USER CODE BEGIN */和/* USER CODE END */区域，添加功能代码。
   • 示例：点亮LED（假设LED接在PC13）：

     #include "main.h"
     void SystemClock_Config(void); // 确保包含时钟配置
     int main(void) {HAL_Init();SystemClock_Config();__HAL_RCC_GPIOC_CLK_ENABLE(); // 使能GPIOC时钟GPIO_InitTypeDef GPIO_InitStruct = {0};GPIO_InitStruct.Pin = GPIO_PIN_13;GPIO_InitStruct.Mode = GPIO_MODE_OUTPUT_PP;GPIO_InitStruct.Pull = GPIO_NOPULL;GPIO_InitStruct.Speed = GPIO_SPEED_FREQ_LOW;HAL_GPIO_Init(GPIOC, &GPIO_InitStruct);while (1) {HAL_GPIO_TogglePin(GPIOC, GPIO_PIN_13); // 翻转LED状态HAL_Delay(500); // 延时500ms}
     }
     

3. 配置调试器：
   • 在“Run > Debug Configurations”中，选择ST-Link，设置端口和调试模式（SWD）。
4. 编译并下载：
   • 点击“Build”按钮编译项目。
   • 连接ST-Link，点击“Debug”按钮下载程序到开发板。

3.3 验证环境

• 编译无错误后，程序将通过ST-Link烧录到STM32F103。
• 观察开发板上LED闪烁，确认程序运行正常。
• 若使用串口调试，可添加以下代码发送数据：

  uint8_t msg[] = "Hello, STM32!\r\n";
  HAL_UART_Transmit(&huart1, msg, sizeof(msg), 100);
  

  在PuTTY中配置串口，查看输出。

---

4. 常见问题及解决

• ST-Link无法识别：
  • 检查驱动是否正确安装。
  • 确保ST-Link固件版本与工具兼容（可用STM32CubeProgrammer升级固件）。
• 程序无法运行：
  • 检查时钟配置是否正确（CubeMX中HSE/PLL设置）。
  • 确认开发板BOOT引脚配置（BOOT0=0为Flash启动）。
• 串口无输出：
  • 检查USB-TTL模块连接（TX接RX，RX接TX）。
  • 确认波特率匹配。

---

5. 扩展建议

• 学习资源：
  • ST官网文档：STM32F1参考手册。
  • 社区教程：正点原子、野火等提供的STM32教程。
  • 在线论坛：STM32社区、CSDN、知乎等。
• 进阶开发：
  • 学习FreeRTOS，扩展实时操作系统开发。
  • 使用CubeMX配置复杂外设（如SPI、I2C、DMA）。
  • 探索低功耗模式和中断处理。
• 其他工具：
  • 逻辑分析仪（如Saleae Logic）用于信号调试。
  • VS Code + PlatformIO，适合轻量级开发。

---

6. 总结

搭建STM32F103开发环境需要准备硬件（开发板、调试器）、安装软件（STM32CubeIDE、CubeMX、驱动等）并进行配置。通过STM32CubeMX生成初始化代码，结合STM32CubeIDE进行开发和调试，初学者可以快速上手。推荐从简单的LED闪烁程序开始，逐步深入外设和系统开发。