2. STM32基础回顾

在进入STM32与ROS2通信开发之前，我们必须先夯实STM32的基础外设知识。本章不是对STM32的全面入门，而是针对后续通信开发中最常用的五大外设——GPIO、定时器、UART、SPI、I2C——进行快速、精准的复习，并完成开发环境的搭建。这些外设是ROS2节点与底层硬件交互的“手脚”和“神经”，理解它们的核心机制、配置方法和常见陷阱，将直接决定上层通信协议的稳定性和实时性。本章将采用“原理回顾→配置流程→实战案例→误区总结”的结构，帮助你在最短时间内恢复并提升STM32的开发手感。

上图展示了STM32五大外设与ROS2通信开发之间的映射关系。在后续章节中，我们将围绕这张图展开：GPIO负责底层信号控制，定时器产生精确的PWM和时序，UART作为与ROS2主机通信的主干道，而SPI和I2C则用于连接各类传感器和执行器。理解这些外设如何协同工作，是构建可靠机器人系统的前提。

2.1 GPIO：数字世界的“开关”与“眼睛”

核心原理

GPIO（General Purpose Input/Output）是STM32最基础的外设，每个引脚都可以独立配置为输入或输出模式。在STM32F4系列中，GPIO挂载在AHB1总线上，具有高达100MHz的翻转速度。关键配置参数包括：模式（输入/输出/复用/模拟）、类型（推挽/开漏）、速度（2/25/50/100MHz）以及上下拉电阻（上拉/下拉/浮空）。对于ROS2通信开发，GPIO常用于读取编码器信号、控制电机使能、检测限位开关等场景。

配置流程

1. 使能GPIO端口时钟：__HAL_RCC_GPIOA_CLK_ENABLE()
2. 初始化GPIO引脚：使用HAL_GPIO_Init()函数，配置结构体GPIO_InitTypeDef
3. 对于输出模式，使用HAL_GPIO_WritePin()或HAL_GPIO_TogglePin()控制电平
4. 对于输入模式，使用HAL_GPIO_ReadPin()读取电平状态
5. 如需外部中断，配置NVIC并编写中断回调函数

实战场景：电机使能与方向控制

在机器人底盘驱动中，我们通常使用两个GPIO引脚控制电机的使能（EN）和方向（DIR）。以下是一个典型的初始化代码片段：

GPIO_InitTypeDef GPIO_InitStruct = {0};
__HAL_RCC_GPIOB_CLK_ENABLE();

GPIO_InitStruct.Pin = GPIO_PIN_0 | GPIO_PIN_1;
GPIO_InitStruct.Mode = GPIO_MODE_OUTPUT_PP;
GPIO_InitStruct.Pull = GPIO_NOPULL;
GPIO_InitStruct.Speed = GPIO_SPEED_FREQ_LOW;
HAL_GPIO_Init(GPIOB, &GPIO_InitStruct);

// 使能电机，方向为正转
HAL_GPIO_WritePin(GPIOB, GPIO_PIN_0, GPIO_PIN_SET);
HAL_GPIO_WritePin(GPIOB, GPIO_PIN_1, GPIO_PIN_RESET);

常见误区

• 误区一：忘记使能GPIO时钟，导致引脚无响应。这是最常见的低级错误。
• 误区二：开漏模式未接上拉电阻，导致无法输出高电平。
• 误区三：在中断回调函数中执行耗时操作，导致中断阻塞，影响系统实时性。

2.2 定时器：精确时间的“节拍器”

核心原理

STM32定时器分为高级定时器（TIM1/8）、通用定时器（TIM2~5）和基本定时器（TIM6/7）。在ROS2通信开发中，定时器主要用于：PWM输出（控制舵机、电机速度）、输入捕获（测量脉冲宽度）、编码器接口（读取轮速）以及定时中断（周期性发送传感器数据）。定时器的核心是预分频器（PSC）和自动重载寄存器（ARR），通过它们可以精确设定计数频率和周期。

配置流程

1. 使能定时器时钟：__HAL_RCC_TIM2_CLK_ENABLE()
2. 配置时基单元：HAL_TIM_Base_Init()，设置PSC和ARR
3. 对于PWM模式，配置通道：HAL_TIM_PWM_Init()和HAL_TIM_PWM_Start()
4. 设置占空比：__HAL_TIM_SET_COMPARE(&htim2, TIM_CHANNEL_1, pulse_value)
5. 如需定时中断，使能中断并编写回调函数

案例拆解：舵机控制

舵机控制需要50Hz的PWM信号，脉宽0.5ms~2.5ms对应0°~180°。假设系统时钟168MHz，PSC设为167，则计数频率为1MHz。要得到50Hz，ARR应设为20000-1=19999。脉宽1.5ms对应比较值1500，即舵机中位。以下为关键配置：

htim2.Init.Prescaler = 167;      // 168MHz / (167+1) = 1MHz
htim2.Init.Period = 19999;       // 1MHz / 20000 = 50Hz
HAL_TIM_PWM_Init(&htim2);
__HAL_TIM_SET_COMPARE(&htim2, TIM_CHANNEL_1, 1500); // 1.5ms 中位

常见误区

• 误区一：PSC和ARR计算错误，导致PWM频率偏差过大。
• 误区二：使用定时器中断时，未清除中断标志位，导致中断反复触发。
• 误区三：编码器模式下未正确配置计数方向，导致轮速数据反向。

2.3 UART：ROS2通信的“主干道”

核心原理

UART（Universal Asynchronous Receiver/Transmitter）是STM32与ROS2主机通信最常用的接口。它采用异步串行通信，通过TX和RX两根线实现全双工传输。在STM32F4中，UART支持DMA传输和中断接收，最高波特率可达10.5Mbps。对于ROS2通信，我们通常使用115200或更高的波特率，并采用帧格式（帧头+数据+校验）来保证数据完整性。

操作流程

1. 使能UART时钟和GPIO时钟（TX/RX引脚复用为UART功能）
2. 配置GPIO复用：GPIO_InitStruct.Alternate = GPIO_AF7_USART2
3. 初始化UART：HAL_UART_Init()，设置波特率、字长、停止位、校验位
4. 使能接收中断或DMA：HAL_UART_Receive_IT()或HAL_UART_Receive_DMA()
5. 编写中断回调函数处理接收数据

实战场景：与ROS2节点通信

假设我们需要将STM32采集的传感器数据通过UART发送给ROS2节点。定义如下帧格式：0xAA 0x55 [长度] [数据...] [校验和]。发送函数如下：

uint8_t tx_buffer[64];
tx_buffer[0] = 0xAA;
tx_buffer[1] = 0x55;
tx_buffer[2] = data_len;
memcpy(&tx_buffer[3], sensor_data, data_len);
tx_buffer[3 + data_len] = checksum;
HAL_UART_Transmit(&huart2, tx_buffer, data_len + 4, 100);

常见误区

• 误区一：未配置GPIO复用功能，导致TX/RX引脚无信号。
• 误区二：中断接收时缓冲区溢出，未及时处理数据。
• 误区三：使用阻塞式发送（HAL_UART_Transmit）在中断中调用，导致系统卡死。

2.4 SPI与I2C：高速与低速的“传感器总线”

核心原理对比

SPI配置要点

1. 配置SCK、MOSI、MISO为复用功能，CS为GPIO输出
2. 设置SPI模式（CPOL/CPHA）、数据位宽（8/16位）、时钟分频
3. 使用HAL_SPI_TransmitReceive()进行全双工通信

I2C配置要点

1. 配置SCL、SDA为开漏输出，并接上拉电阻（典型4.7kΩ）
2. 设置I2C时钟频率和自身地址
3. 使用HAL_I2C_Master_Transmit()和HAL_I2C_Master_Receive()通信

案例拆解：读取IMU数据

以MPU6050（I2C接口）为例，其从机地址为0x68。读取加速度数据的流程为：先发送寄存器地址0x3B，然后连续读取6个字节。关键代码：

uint8_t reg_addr = 0x3B;
uint8_t accel_data[6];
HAL_I2C_Mem_Read(&hi2c1, 0x68 << 1, reg_addr, I2C_MEMADD_SIZE_8BIT, accel_data, 6, 100);
// 合并高低字节得到16位加速度值
int16_t accel_x = (accel_data[0] << 8) | accel_data[1];

常见误区

• 误区一：SPI的CPOL/CPHA配置与从设备不匹配，导致数据错位。
• 误区二：I2C上拉电阻过大（如100kΩ），导致信号上升沿过缓。
• 误区三：多个I2C设备地址冲突，未通过地址线或软件配置区分。

2.5 开发环境搭建：CubeMX + Keil/STM32CubeIDE

环境组成

完整的STM32开发环境包括：STM32CubeMX（图形化配置工具）、编译工具链（Keil MDK或STM32CubeIDE）、调试器驱动（ST-Link/J-Link）以及串口终端（用于调试输出）。对于ROS2开发，还需要在PC端安装串口通信库（如pyserial）或micro-ROS中间件。

搭建步骤

1. 安装STM32CubeMX和STM32CubeIDE（或Keil MDK）
2. 在CubeMX中选择芯片型号（如STM32F407VET6）
3. 配置时钟树（HSE 8MHz，PLL倍频至168MHz）
4. 配置所需外设（GPIO、UART、SPI、I2C等）
5. 生成初始化代码，并在IDE中编译下载

工程验证

搭建完成后，编写一个简单的LED闪烁程序验证环境。若LED正常闪烁，说明时钟、GPIO、编译下载链路均正常。随后可逐步添加UART打印功能，验证串口通信。

常见误区

• 误区一：CubeMX生成的代码中，用户代码写在USER CODE BEGIN和USER CODE END之间，否则重新生成代码时会被覆盖。
• 误区二：调试器连接失败，通常是因为SWDIO/SWCLK引脚被复用为其他功能。
• 误区三：串口终端乱码，检查波特率设置和USB转串口驱动是否正常。

2.6 综合复盘：从外设到ROS2的思维转换

回顾本章内容，我们快速复习了STM32的五大核心外设。在ROS2通信开发中，需要建立“外设即资源”的思维：GPIO是数字信号接口，定时器是时间基准，UART是数据管道，SPI/I2C是传感器总线。开发时，建议先使用CubeMX完成硬件初始化，再编写应用层逻辑。同时，务必重视调试手段——逻辑分析仪、示波器和串口打印是三大必备工具。