三亩地 三亩地SAN MU DI · CODE DIARY
交流投稿
ARTICLE DETAIL

日记详情

真实记录编程学习的某一天，欢迎挑你感兴趣的翻一翻。

首页/学习日记/日记详情

别再手动敲代码了！用STM32CubeMX配置USART1串口打印，5分钟搞定基础通信

发布时间：2026/9/19 23:02:37 三亩地 编程学习日记
别再手动敲代码了！用STM32CubeMX配置USART1串口打印，5分钟搞定基础通信

STM32CubeMX实战：5分钟构建USART1通信系统的完整指南

第一次接触STM32开发时，面对密密麻麻的寄存器手册和复杂的初始化流程，相信不少开发者都有过"从入门到放弃"的念头。但今天，我们将彻底改变这种体验——借助STM32CubeMX这款图形化配置工具，即使是刚接触嵌入式开发的新手，也能在5分钟内完成USART1串口通信系统的搭建。这不仅仅是效率的提升，更是一种开发思维的革新。

1. 开发环境准备与工具链配置

1.1 必备软件安装清单

在开始之前，我们需要确保开发环境完整。以下是经过实际验证的软件组合方案：

  • STM32CubeMX：当前稳定版本为6.6.1（截至2023年8月），支持全系列STM32芯片
  • Keil MDK-ARM：建议使用5.36及以上版本，包含最新的设备支持包
  • 串口调试助手：推荐使用功能完善且稳定的工具如Tera Term或Putty
  • ST-Link驱动：确保已安装最新版，避免下载调试时出现连接问题

提示：所有软件均可从官网免费获取，安装时注意勾选"Add to PATH"选项以便命令行调用

1.2 硬件连接检查要点

以常见的STM32F103C8T6开发板为例，硬件连接需要特别注意以下三点：

  1. USART1引脚对应关系：
    • PA9(TX) → USB转串口模块的RX
    • PA10(RX) → USB转串口模块的TX
  2. 供电检查：
    • 开发板供电电压应为3.3V
    • 确保USB转串口模块与开发板共地
  3. 下载接口：
    • SWDIO → SWDIO
    • SWCLK → SWCLK
    • GND → GND
# 快速验证串口设备是否识别（Linux/macOS） ls /dev/tty.* # Windows可通过设备管理器查看端口号

2. CubeMX工程创建与基础配置

2.1 芯片选择与工程初始化

启动CubeMX后，按照以下步骤建立工程框架：

  1. 点击"New Project"，在芯片选择器中输入"STM32F103C8"（根据实际型号调整）
  2. 双击目标芯片进入配置界面
  3. 在"Pinout & Configuration"视图中开始核心配置

关键决策点：对于资源受限的C8T6芯片，建议关闭不用的外设以节省资源。例如，如果仅使用USART1，可以禁用其他UART接口。

2.2 时钟树配置实战

时钟配置是STM32初始化的核心环节，也是CubeMX最具价值的可视化功能之一。按照以下参数设置可实现72MHz主频：

  1. 在"Clock Configuration"标签页中：
    • 选择HSE（外部高速时钟）作为时钟源
    • 设置PLLMUL为9倍频
    • 确保APB1 Prescaler为2（36MHz）
    • APB2 Prescaler保持1（72MHz）
// 生成的时钟初始化代码关键片段 RCC_OscInitTypeDef RCC_OscInitStruct = {0}; RCC_OscInitStruct.OscillatorType = RCC_OSCILLATORTYPE_HSE; RCC_OscInitStruct.HSEState = RCC_HSE_ON; RCC_OscInitStruct.HSEPredivValue = RCC_HSE_PREDIV_DIV1; RCC_OscInitStruct.PLL.PLLState = RCC_PLL_ON; RCC_OscInitStruct.PLL.PLLSource = RCC_PLLSOURCE_HSE; RCC_OscInitStruct.PLL.PLLMUL = RCC_PLL_MUL9;

注意：不同芯片型号的时钟树结构可能有所差异，CubeMX会自动防止非法配置，这是相比手动配置的巨大优势

3. USART1深度配置与代码生成

3.1 参数化配置界面详解

在"Connectivity"分类下找到USART1，进行如下配置：

参数项推荐值技术说明
ModeAsynchronous异步通信模式
Baud Rate115200常用波特率，兼容多数设备
Word Length8 bits标准ASCII字符长度
ParityNone无奇偶校验
Stop Bits1单停止位
Over Sampling16标准过采样率

高级技巧：在"NVIC Settings"中启用USART1全局中断，为后续接收数据做准备。同时建议在"DMA Settings"中添加TX/RX的DMA通道，可大幅提升大数据量传输效率。

3.2 代码生成策略优化

点击"Project Manager"进入生成设置：

  1. 在"Project"标签页：

    • 设置有意义的工程名称（如"USART1_Demo"）
    • 选择"MDK-ARM"作为Toolchain/IDE
    • 勾选"Generate peripheral initialization as a pair of .c/.h files"

  2. 在"Code Generator"标签页：

    • 启用"Generate peripheral initialization as a pair of .c/.h files"
    • 勾选"Backup previously generated files when re-generating"
# 典型生成的工程结构 USART1_Demo/ ├── Core/ ├── Drivers/ ├── MDK-ARM/ ├── STM32CubeIDE/ ├── .mxproject └── README.md

重要：每次修改配置后，点击"GENERATE CODE"前，建议先备份user code区域（位于/* USER CODE BEGIN/和/USER CODE END */之间的代码）

4. 代码集成与功能验证

4.1 基础通信实现方案

在生成的工程中，打开main.c文件，在while循环中添加测试代码：

/* USER CODE BEGIN WHILE */ while (1) { char message[] = "Hello CubeMX!\r\n"; HAL_UART_Transmit(&huart1, (uint8_t *)message, strlen(message), HAL_MAX_DELAY); HAL_Delay(1000); // 1秒间隔 /* USER CODE END WHILE */ /* USER CODE BEGIN 3 */ } /* USER CODE END 3 */

性能考量：HAL_UART_Transmit是阻塞式函数，在高速或实时性要求高的场景下，应考虑使用中断或DMA方式。

4.2 重定向printf高级用法

实现printf重定向可以极大提升调试效率，具体步骤如下：

  1. 在usart.c文件中添加标准库支持：
/* USER CODE BEGIN 0 */ #include <stdio.h> /* USER CODE END 0 */
  1. 在文件末尾实现fputc函数：
/* USER CODE BEGIN 1 */ int __io_putchar(int ch) { HAL_UART_Transmit(&huart1, (uint8_t *)&ch, 1, HAL_MAX_DELAY); return ch; } /* USER CODE END 1 */
  1. 在main.c中使用标准输出：
printf("System Clock: %lu Hz\r\n", HAL_RCC_GetSysClockFreq());

调试技巧：使用sprintf组合复杂输出时，注意栈空间分配，避免缓冲区溢出

5. 常见问题排查与优化建议

5.1 典型故障处理指南

以下是新手最常遇到的三个问题及解决方案：

  1. 无输出信号：

    • 检查PA9/PA10引脚是否被其他功能占用
    • 确认跳线帽连接正确（特别是Boot0/1设置）
    • 测量引脚电压，TX线在空闲时应为高电平(3.3V)

  2. 乱码问题：

    • 确认双方波特率完全一致（误差应<3%）
    • 检查时钟配置是否正确（特别是HSE_VALUE定义）
    • 尝试降低波特率测试（如改为9600）

  3. 下载失败：

    • 检查SWD连接线序
    • 在CubeMX中确认Debug配置为"Serial Wire"
    • 尝试复位开发板后立即点击下载

5.2 性能优化进阶技巧

当系统运行不稳定或需要提升效率时，可以考虑以下优化措施：

  1. 时钟精度提升：

    • 使用8MHz晶振而非内部HSI
    • 在CubeMX中开启时钟输出(MCO)功能监测实际频率

  2. DMA传输配置：

// 添加DMA发送配置 hdma_usart1_tx.Instance = DMA1_Channel4; hdma_usart1_tx.Init.Direction = DMA_MEMORY_TO_PERIPH; hdma_usart_tx.Init.PeriphInc = DMA_PINC_DISABLE; hdma_usart_tx.Init.MemInc = DMA_MINC_ENABLE; hdma_usart_tx.Init.PeriphDataAlignment = DMA_PDATAALIGN_BYTE; hdma_usart_tx.Init.MemDataAlignment = DMA_MDATAALIGN_BYTE;
  1. 功耗优化：
    • 在CubeMX中配置USART唤醒功能
    • 使用HAL_UARTEx_ReceiveToIdle_DMA等新特性

在实际项目中，我习惯为每个外设创建独立的.c/.h文件模块，比如将USART1相关操作封装成uart_manager模块，这样即使更换硬件平台，应用层代码也只需修改适配层。CubeMX生成的代码已经做了很好的模块化分离，我们完全可以在此基础上构建更健壮的软件架构。

编程学习 学习日记 实战经验
← 返回列表