3. STM32基础外设：GPIO、UART、定时器、中断的基本原理与编程方法

在STM32与ROS2通信的实战体系中，MCU侧的基础外设是构建一切上层应用的物理基石。无论是读取传感器数据、驱动执行器，还是通过串口与ROS2节点交换消息，最终都要落实到对GPIO、UART、定时器和中断的精准操作上。本章将深入剖析这四大外设的硬件工作原理、寄存器配置逻辑及HAL库编程方法，并重点讲解它们在机器人通信场景中的协同工作方式。

3.1 GPIO：数字世界的出入口

GPIO（General Purpose Input/Output）是STM32最基础的外设，它负责MCU与外部数字世界的所有交互。在ROS2机器人系统中，GPIO常用于读取限位开关、编码器零位信号、控制LED状态指示灯，或通过软件模拟PWM驱动简单设备。理解GPIO的硬件结构是正确配置的前提。

核心原理：从引脚到寄存器的映射

STM32的每个GPIO端口（如GPIOA、GPIOB）包含16个引脚，每个引脚对应端口输入数据寄存器（IDR）和输出数据寄存器（ODR）中的一位。引脚的工作模式由端口配置寄存器（MODER）、输出类型寄存器（OTYPER）、上下拉寄存器（PUPDR）和输出速度寄存器（OSPEEDR）共同决定。在复用功能模式下，引脚信号不再走ODR，而是由片上外设（如UART的TX、定时器的PWM输出）直接驱动。

编程方法：HAL库三步配置法

使用STM32CubeMX生成初始化代码后，HAL库的GPIO编程遵循固定流程。首先使能GPIO端口时钟，然后填充GPIO_InitTypeDef结构体，最后调用HAL_GPIO_Init函数。对于输出操作，使用HAL_GPIO_WritePin或HAL_GPIO_TogglePin；对于输入读取，使用HAL_GPIO_ReadPin。

// 以PA5驱动LED为例
__HAL_RCC_GPIOA_CLK_ENABLE();  // 1. 使能GPIOA时钟

GPIO_InitTypeDef GPIO_InitStruct = {0};
GPIO_InitStruct.Pin = GPIO_PIN_5;
GPIO_InitStruct.Mode = GPIO_MODE_OUTPUT_PP;
GPIO_InitStruct.Pull = GPIO_NOPULL;
GPIO_InitStruct.Speed = GPIO_SPEED_FREQ_LOW;
HAL_GPIO_Init(GPIOA, &GPIO_InitStruct);  // 2. 初始化

HAL_GPIO_WritePin(GPIOA, GPIO_PIN_5, GPIO_PIN_SET);  // 3. 输出高电平

3.2 UART：ROS2与MCU的通信桥梁

UART（Universal Asynchronous Receiver/Transmitter）是STM32与ROS2主机之间最常用的通信接口。ROS2通过serial_driver或micro-ROS与MCU交换数据，通常采用115200或更高波特率。UART的硬件结构包含发送移位寄存器、接收移位寄存器和控制逻辑，数据以帧为单位传输，每帧包含起始位、数据位、校验位和停止位。

核心原理：异步串行通信机制

UART通信无需时钟线，收发双方通过约定波特率保持同步。发送端在TX引脚上按位输出数据，接收端在RX引脚上采样。STM32的UART外设支持DMA传输和中断接收，这在ROS2高频数据交互中至关重要。例如，当ROS2以100Hz频率发送速度指令时，若采用阻塞式发送，MCU将浪费大量CPU时间在等待上。

编程方法：中断接收+DMA发送模式

在ROS2通信场景中，推荐使用中断接收和DMA发送的组合。中断接收保证数据不丢失，DMA发送释放CPU资源。配置流程包括：设置波特率、数据位、停止位和校验位，使能UART全局中断，编写接收回调函数。

// UART初始化配置（CubeMX生成）
huart1.Instance = USART1;
huart1.Init.BaudRate = 115200;
huart1.Init.WordLength = UART_WORDLENGTH_8B;
huart1.Init.StopBits = UART_STOPBITS_1;
huart1.Init.Parity = UART_PARITY_NONE;
huart1.Init.Mode = UART_MODE_TX_RX;
HAL_UART_Init(&huart1);

// 中断接收启动
HAL_UART_Receive_IT(&huart1, rx_buffer, 1);

// 接收回调函数
void HAL_UART_RxCpltCallback(UART_HandleTypeDef *huart) {
    if (huart == &huart1) {
        process_byte(rx_buffer[0]);  // 处理接收到的字节
        HAL_UART_Receive_IT(&huart1, rx_buffer, 1);  // 重新启动接收
    }
}

3.3 定时器：精确时间控制的核心

定时器在STM32中扮演着时间基准、PWM生成、输入捕获和编码器接口等多重角色。在ROS2机器人中，定时器用于生成控制周期（如10ms控制循环）、产生PWM驱动电机、测量轮速编码器脉冲。STM32的定时器分为高级定时器（TIM1/8）、通用定时器（TIM2~5）和基本定时器（TIM6/7），不同系列资源差异较大。

核心原理：时基单元与计数模式

定时器的核心是16位或32位自动重载计数器。时钟源经过预分频器（PSC）分频后驱动计数器，计数器从0计数到自动重载值（ARR）后溢出并触发更新事件。PWM模式利用比较寄存器（CCR）控制输出占空比，当计数器值小于CCR时输出高电平，否则输出低电平。

编程方法：PWM输出与定时中断

以TIM3产生50Hz舵机控制PWM为例，需要配置预分频和自动重载值。若APB1时钟为84MHz，要得到50Hz频率，可设置PSC=167，ARR=9999，这样计数器时钟为500kHz，PWM频率为50Hz。占空比通过修改CCR值实现。

// PWM初始化配置
htim3.Instance = TIM3;
htim3.Init.Prescaler = 167;      // 84MHz / (167+1) = 500kHz
htim3.Init.CounterMode = TIM_COUNTERMODE_UP;
htim3.Init.Period = 9999;        // 500kHz / (9999+1) = 50Hz
htim3.Init.ClockDivision = TIM_CLOCKDIVISION_DIV1;
HAL_TIM_PWM_Init(&htim3);

TIM_OC_InitTypeDef sConfigOC = {0};
sConfigOC.OCMode = TIM_OCMODE_PWM1;
sConfigOC.Pulse = 750;           // 初始占空比 7.5%
sConfigOC.OCPolarity = TIM_OCPOLARITY_HIGH;
HAL_TIM_PWM_ConfigChannel(&htim3, &sConfigOC, TIM_CHANNEL_1);
HAL_TIM_PWM_Start(&htim3, TIM_CHANNEL_1);

// 动态修改占空比
__HAL_TIM_SET_COMPARE(&htim3, TIM_CHANNEL_1, 500);  // 5% 占空比

3.4 中断：实时响应的关键机制

中断系统是STM32实时性的保障。在ROS2通信中，UART接收中断、定时器更新中断和外部中断（如急停按钮）共同构建了多优先级响应体系。NVIC（嵌套向量中断控制器）支持抢占优先级和子优先级配置，合理分配优先级是系统稳定运行的关键。

核心原理：中断向量与优先级

STM32的每个外设中断源都有固定的中断向量地址。当中断事件发生时，处理器暂停当前任务，跳转到对应的中断服务函数（ISR）。NVIC的优先级分组决定了抢占优先级和子优先级的位数分配。例如，设置为NVIC_PRIORITYGROUP_2时，2位抢占优先级（0~3）和2位子优先级（0~3）。

编程方法：中断优先级配置与ISR编写

中断编程的核心原则是ISR中执行时间要短，避免阻塞其他中断。通常的做法是在ISR中只做标志位设置或数据拷贝，具体处理逻辑放在主循环中执行。

// 中断优先级配置
HAL_NVIC_SetPriority(USART1_IRQn, 1, 0);  // 抢占优先级1，子优先级0
HAL_NVIC_EnableIRQ(USART1_IRQn);

HAL_NVIC_SetPriority(TIM6_DAC_IRQn, 2, 0);  // 控制周期中断
HAL_NVIC_EnableIRQ(TIM6_DAC_IRQn);

// 定时器中断回调
void HAL_TIM_PeriodElapsedCallback(TIM_HandleTypeDef *htim) {
    if (htim == &htim6) {
        control_loop_flag = 1;  // 设置控制循环标志
    }
}

// 主循环中处理
while (1) {
    if (control_loop_flag) {
        control_loop_flag = 0;
        update_motor_speed();  // 执行控制算法
    }
}

3.5 综合实战：构建ROS2通信节点

将上述外设整合，实现一个完整的ROS2通信节点。假设我们需要构建一个差速驱动机器人的底层驱动板，要求：接收ROS2下发的线速度和角速度指令，通过PWM控制两个电机，同时读取编码器反馈实际速度并上传。

系统架构与资源分配

功能模块	外设资源	配置参数	中断优先级
ROS2指令接收	USART1	115200-8-N-1，DMA接收	抢占1，子0
控制周期生成	TIM6	10ms周期中断	抢占2，子0
左电机PWM	TIM3_CH1/CH2	20kHz PWM频率	—
右电机PWM	TIM3_CH3/CH4	20kHz PWM频率	—
左编码器计数	TIM4	编码器模式，4倍频	—
右编码器计数	TIM5	编码器模式，4倍频	—
急停按钮	PA0 EXTI0	下降沿触发	抢占0，子0

数据流与协议设计

定义ROS2与MCU的通信协议：帧头（0xAA 0x55）+ 数据长度 + 指令类型 + 数据 + CRC校验。ROS2侧通过serial_driver发送速度指令，MCU在DMA接收中断中解析数据帧，更新目标速度变量。控制周期中断中执行PID算法，更新PWM占空比。编码器计数通过定时器硬件完成，主循环中周期读取并计算实际速度。

// 控制周期中断中的核心逻辑
void HAL_TIM_PeriodElapsedCallback(TIM_HandleTypeDef *htim) {
    if (htim == &htim6) {
        // 读取编码器计数
        int32_t left_enc = __HAL_TIM_GET_COUNTER(&htim4);
        int32_t right_enc = __HAL_TIM_GET_COUNTER(&htim5);
        
        // 计算实际速度（编码器线数 * 减速比 * 轮径）
        float left_speed = (float)left_enc * WHEEL_CIRCUMFERENCE / (ENCODER_LINES * GEAR_RATIO * 0.01);
        
        // PID控制计算
        float left_error = target_left_speed - left_speed;
        left_pwm += KP * left_error + KI * integral_left;
        
        // 限制PWM输出范围
        if (left_pwm > 999) left_pwm = 999;
        if (left_pwm < -999) left_pwm = -999;
        
        // 更新PWM占空比
        __HAL_TIM_SET_COMPARE(&htim3, TIM_CHANNEL_1, abs(left_pwm));
        HAL_GPIO_WritePin(GPIOB, GPIO_PIN_0, left_pwm > 0 ? GPIO_PIN_SET : GPIO_PIN_RESET);
    }
}

3.6 常见误区与总结复盘

在STM32外设开发中，以下问题最为常见：时钟配置错误导致外设无法工作，GPIO复用功能未正确映射导致UART无输出，中断优先级配置不当导致系统卡死，DMA与中断冲突导致数据丢失。建议在开发初期使用STM32CubeMX生成初始化代码，并仔细核对引脚分配和时钟树。