当前位置：首页 > news >正文

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

news 2026/6/8 9:22:12

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开发板为例，硬件连接需要特别注意以下三点：

USART1引脚对应关系：
- PA9(TX) → USB转串口模块的RX
- PA10(RX) → USB转串口模块的TX
供电检查：
- 开发板供电电压应为3.3V
- 确保USB转串口模块与开发板共地
下载接口：
- SWDIO → SWDIO
- SWCLK → SWCLK
- GND → GND

# 快速验证串口设备是否识别（Linux/macOS） ls /dev/tty.* # Windows可通过设备管理器查看端口号

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

2.1 芯片选择与工程初始化

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

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

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

2.2 时钟树配置实战

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

在"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，进行如下配置：

参数项	推荐值	技术说明
Mode	Asynchronous	异步通信模式
Baud Rate	115200	常用波特率，兼容多数设备
Word Length	8 bits	标准ASCII字符长度
Parity	None	无奇偶校验
Stop Bits	1	单停止位
Over Sampling	16	标准过采样率

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

3.2 代码生成策略优化

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

在"Project"标签页：
- 设置有意义的工程名称（如"USART1_Demo"）
- 选择"MDK-ARM"作为Toolchain/IDE
- 勾选"Generate peripheral initialization as a pair of .c/.h files"
在"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重定向可以极大提升调试效率，具体步骤如下：

在usart.c文件中添加标准库支持：

/* USER CODE BEGIN 0 */ #include <stdio.h> /* USER CODE END 0 */

在文件末尾实现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 */

在main.c中使用标准输出：

printf("System Clock: %lu Hz\r\n", HAL_RCC_GetSysClockFreq());

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

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

5.1 典型故障处理指南

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

无输出信号：
- 检查PA9/PA10引脚是否被其他功能占用
- 确认跳线帽连接正确（特别是Boot0/1设置）
- 测量引脚电压，TX线在空闲时应为高电平(3.3V)
乱码问题：
- 确认双方波特率完全一致（误差应<3%）
- 检查时钟配置是否正确（特别是HSE_VALUE定义）
- 尝试降低波特率测试（如改为9600）
下载失败：
- 检查SWD连接线序
- 在CubeMX中确认Debug配置为"Serial Wire"
- 尝试复位开发板后立即点击下载

5.2 性能优化进阶技巧

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

时钟精度提升：
- 使用8MHz晶振而非内部HSI
- 在CubeMX中开启时钟输出(MCO)功能监测实际频率
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;