3. STM32基础外设

在机器人AI交付项目中，STM32作为主控MCU承担着传感器数据采集、执行器驱动、通信协议解析和实时控制决策等关键任务。无论是简单的巡线小车还是复杂的机械臂视觉抓取系统，所有上层AI算法最终都需要通过底层外设与物理世界交互。本章将系统梳理STM32七大核心外设——GPIO、定时器、PWM、ADC、UART、I2C、SPI的工作原理、寄存器操作逻辑、HAL库编程方法及工程调试要点，帮助读者建立从芯片手册到实际代码的完整映射关系。

3.1 GPIO：数字输入输出的基础

GPIO（General Purpose Input/Output）是STM32最基础的外设，承担着数字信号的读取与输出功能。在机器人项目中，GPIO常用于控制LED指示灯、读取按键状态、驱动蜂鸣器、控制电机方向引脚等。STM32的GPIO端口被组织为GPIOA~GPIOG（具体取决于芯片型号），每个端口包含16个引脚，每个引脚可独立配置为输入、输出、复用功能或模拟模式。

核心原理与配置流程

STM32的GPIO引脚内部结构包含施密特触发器输入、推挽/开漏输出驱动、上下拉电阻和复用功能选择器。配置GPIO时，需要关注以下关键参数：

• 模式（Mode）：输入模式（浮空、上拉、下拉）、输出模式（推挽、开漏）、复用功能（AF）、模拟模式。
• 速度（Speed）：2MHz、25MHz、50MHz、100MHz（不同系列有差异），高速输出用于通信接口，低速用于LED等。
• 上下拉（Pull-up/Pull-down）：用于确定引脚空闲状态，按键输入通常配置上拉。

在HAL库中，GPIO配置通过GPIO_InitTypeDef结构体完成，典型代码如下：

GPIO_InitTypeDef GPIO_InitStruct = {0};
__HAL_RCC_GPIOA_CLK_ENABLE();  // 使能GPIOA时钟
GPIO_InitStruct.Pin = GPIO_PIN_5;          // PA5
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);

// 输出操作
HAL_GPIO_WritePin(GPIOA, GPIO_PIN_5, GPIO_PIN_SET);   // 置高
HAL_GPIO_TogglePin(GPIOA, GPIO_PIN_5);                // 翻转

实战场景：按键检测与消抖

在机器人控制面板中，按键输入是常见的人机交互方式。机械按键在按下和释放瞬间会产生抖动，如果不做消抖处理，一次按键可能被误判为多次触发。常用的消抖方法包括硬件RC滤波和软件延时消抖。软件消抖的核心思路是：检测到电平变化后，延时10~20ms再次确认电平状态。

// 按键消抖示例（PA0接按键到GND，内部上拉）
if (HAL_GPIO_ReadPin(GPIOA, GPIO_PIN_0) == GPIO_PIN_RESET) {
    HAL_Delay(20);  // 延时消抖
    if (HAL_GPIO_ReadPin(GPIOA, GPIO_PIN_0) == GPIO_PIN_RESET) {
        // 确认按键按下，执行动作
        HAL_GPIO_TogglePin(GPIOB, GPIO_PIN_1);  // 翻转LED
        while (HAL_GPIO_ReadPin(GPIOA, GPIO_PIN_0) == GPIO_PIN_RESET);
    }
}

常见误区

• 未使能时钟：STM32外设默认时钟关闭，必须先通过__HAL_RCC_GPIOx_CLK_ENABLE()使能对应端口时钟。
• 模式选择错误：开漏输出无法输出高电平，必须外接上拉电阻；模拟模式下施密特触发器关闭，不能用于数字读取。
• 引脚冲突：部分引脚在芯片复位后默认用于调试接口（如PA13/PA14/PA15），使用前需确认是否被占用。

3.2 定时器：时间基准与输入捕获

定时器是STM32中功能最丰富的外设模块，不仅提供精确的时间基准，还支持输入捕获、输出比较、PWM生成和编码器接口等功能。在机器人AI系统中，定时器常用于产生控制周期中断（如10ms PID控制循环）、测量传感器脉冲宽度（如超声波测距）、生成舵机控制信号等。

定时器分类与核心原理

定时器的核心是一个递增/递减计数器，其时钟源来自内部时钟（APB1/APB2分频）或外部触发。计数频率计算公式为：f_cnt = f_clk / (PSC + 1)，溢出周期为T = (ARR + 1) / f_cnt。其中PSC为预分频系数，ARR为自动重装载值。

操作流程：定时中断实现精确延时

// 配置TIM3为1ms中断（假设APB1时钟=72MHz）
TIM_HandleTypeDef htim3;
htim3.Instance = TIM3;
htim3.Init.Prescaler = 72 - 1;        // 72MHz/72 = 1MHz
htim3.Init.Period = 1000 - 1;         // 1MHz/1000 = 1kHz
htim3.Init.CounterMode = TIM_COUNTERMODE_UP;
HAL_TIM_Base_Init(&htim3);
HAL_TIM_Base_Start_IT(&htim3);        // 使能更新中断

// 中断回调函数
void HAL_TIM_PeriodElapsedCallback(TIM_HandleTypeDef *htim) {
    if (htim->Instance == TIM3) {
        // 每1ms执行一次，可用于控制周期任务
        control_loop_flag = 1;
    }
}

3.3 PWM：脉宽调制与执行器控制

PWM（Pulse Width Modulation）通过调节方波的占空比来控制输出功率或模拟量。在机器人中，PWM广泛应用于舵机角度控制、直流电机调速、LED亮度调节和蜂鸣器音调控制。STM32通过定时器的输出比较通道生成PWM波形，频率由定时器时基决定，占空比由比较寄存器CCR决定。

PWM生成原理与配置

当计数器值小于CCR时输出高电平，大于CCR时输出低电平（PWM模式1），从而产生占空比可调的方波。配置PWM的关键参数包括：频率（决定控制周期）、占空比（决定输出功率）、极性（决定有效电平）。舵机控制通常需要50Hz频率，占空比5%~10%对应0°~180°。

// 配置TIM2_CH1输出50Hz PWM（PA0）
TIM_OC_InitTypeDef sConfigOC = {0};
htim2.Init.Prescaler = 72 - 1;        // 1MHz计数频率
htim2.Init.Period = 20000 - 1;        // 50Hz (1MHz/20000)
HAL_TIM_PWM_Init(&htim2);

sConfigOC.OCMode = TIM_OCMODE_PWM1;
sConfigOC.Pulse = 1500;               // 初始占空比 1500/20000 = 7.5%
sConfigOC.OCPolarity = TIM_OCPOLARITY_HIGH;
HAL_TIM_PWM_ConfigChannel(&htim2, &sConfigOC, TIM_CHANNEL_1);
HAL_TIM_PWM_Start(&htim2, TIM_CHANNEL_1);

// 动态调整占空比（舵机角度控制）
__HAL_TIM_SET_COMPARE(&htim2, TIM_CHANNEL_1, 1000);  // 0°位置

实战案例：双电机差速驱动

在轮式机器人中，通过PWM控制两个直流电机的转速实现差速转向。假设使用TIM2_CH1控制左电机、TIM2_CH2控制右电机，PWM频率设为10kHz以减少电机噪音。控制逻辑如下：

1. 初始化两个PWM通道，频率10kHz，初始占空比0%。
2. 设定目标速度对应的占空比（如50%占空比对应额定转速）。
3. 通过改变左右电机占空比差值实现转向：左轮占空比增加、右轮减少则右转。
4. 使用PID控制器根据编码器反馈动态调整占空比，实现速度闭环。

实际调试中发现，PWM频率过低（<1kHz）会导致电机发出明显啸叫，频率过高（>20kHz）则可能超出驱动芯片的开关能力。10kHz是大多数直流电机驱动器的推荐工作频率。

3.4 ADC：模拟信号数字化

ADC（Analog-to-Digital Converter）将连续变化的模拟电压转换为离散的数字值。STM32内置12位逐次逼近型ADC，采样范围通常为0~3.3V，转换结果范围为0~4095。在机器人中，ADC常用于读取电位器位置、电池电压监测、红外距离传感器、光敏电阻等模拟信号。

ADC工作模式与配置要点

STM32的ADC支持单次转换、连续转换、扫描模式（多通道）和注入转换。配合DMA（直接内存访问）可以实现多通道无CPU干预的连续采样。关键配置参数包括：

• 分辨率：12位（默认）、10位、8位、6位，分辨率越低转换速度越快。
• 采样时间：1.5~239.5个ADC时钟周期，采样时间越长精度越高。
• 转换模式：单次/连续/扫描，多通道时需配置通道序列。
• 触发源：软件触发、定时器触发、外部引脚触发。

// 单通道ADC读取（PA1，ADC1_IN1）
ADC_HandleTypeDef hadc1;
hadc1.Instance = ADC1;
hadc1.Init.ScanConvMode = DISABLE;
hadc1.Init.ContinuousConvMode = DISABLE;
hadc1.Init.Resolution = ADC_RESOLUTION_12B;
hadc1.Init.ExternalTrigConv = ADC_SOFTWARE_START;
HAL_ADC_Init(&hadc1);

HAL_ADC_Start(&hadc1);
HAL_ADC_PollForConversion(&hadc1, 100);  // 等待转换完成
uint16_t adc_value = HAL_ADC_GetValue(&hadc1);
float voltage = adc_value * 3.3f / 4095.0f;  // 转换为电压值

3.5 UART：异步串行通信

UART（Universal Asynchronous Receiver/Transmitter）是最常用的串行通信接口，通过TX和RX两根线实现全双工异步通信。在机器人项目中，UART用于与蓝牙模块、WiFi模块、GPS模块通信，以及通过USB转串口工具进行调试信息输出。

UART通信原理与配置

UART通信以字符帧为单位，每帧包含起始位（1位低电平）、数据位（通常8位）、可选的校验位和停止位（1或2位）。通信双方必须约定相同的波特率（每秒传输的位数）。STM32的UART支持DMA传输和中断接收，在机器人中推荐使用中断或DMA方式接收不定长数据。

// UART1初始化：115200-8-N-1
UART_HandleTypeDef huart1;
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);

// 中断接收一个字节
uint8_t rx_byte;
HAL_UART_Receive_IT(&huart1, &rx_byte, 1);

// 中断回调
void HAL_UART_RxCpltCallback(UART_HandleTypeDef *huart) {
    if (huart->Instance == USART1) {
        process_rx_byte(rx_byte);  // 处理接收到的字节
        HAL_UART_Receive_IT(&huart1, &rx_byte, 1);  // 重新使能接收
    }
}

实战场景：串口调试协议解析

在机器人调试阶段，通常通过串口发送指令控制机器人动作。定义简单的文本协议：CMD:PARAM\r\n，例如MOVE:100,50\r\n表示左轮速度100、右轮速度50。接收端需要实现帧同步和解析：

1. 在中断回调中将字节存入环形缓冲区。
2. 主循环中检测\r\n作为帧结束标志。
3. 提取CMD和PARAM字段，使用sscanf或字符串分割函数解析。
4. 根据命令码执行对应动作，并返回应答帧OK\r\n。

这种文本协议虽然效率不高，但便于人工调试和上位机开发。在正式产品中，建议改用二进制协议（如MAVLink）以提高传输效率。

3.6 I2C与SPI：板级总线通信

I2C和SPI是机器人中连接传感器、存储器和显示屏的两大板级总线。I2C使用两根线（SCL时钟、SDA数据）以半双工方式通信，支持多设备挂载，通过7位或10位地址寻址；SPI使用四根线（SCK、MOSI、MISO、CS）实现全双工高速通信，通过片选信号选择从设备。

I2C通信要点

I2C通信速率标准模式100kbps、快速模式400kbps。每个从设备有唯一地址，主机通过起始条件、从机地址和读写位发起通信。STM32的I2C外设支持主机/从机模式、多主机仲裁和时钟同步。在HAL库中，I2C通信通常使用阻塞式或中断/DMA方式：

// 读取MPU6050加速度计数据（地址0xD0）
uint8_t reg_addr = 0x3B;  // ACCEL_XOUT_H寄存器
uint8_t data[6];
HAL_I2C_Mem_Read(&hi2c1, 0xD0, reg_addr, I2C_MEMADD_SIZE_8BIT, data, 6, 100);

SPI通信要点

SPI没有地址概念，通过CS片选线选择从设备。通信速率可达数十MHz，适合高速数据传输。STM32的SPI支持4种模式（CPOL/CPHA组合），必须与从设备匹配。典型应用包括读写外部Flash、驱动TFT显示屏、连接SD卡等。

// SPI发送接收一个字节
uint8_t spi_transfer(uint8_t byte) {
    uint8_t rx_data;
    HAL_SPI_TransmitReceive(&hspi1, &byte, &rx_data, 1, 100);
    return rx_data;
}

3.7 外设综合调试与性能对比

在机器人AI交付项目中，多个外设往往协同工作。例如，一个视觉巡线机器人可能同时使用：GPIO读取摄像头中断、定时器产生10ms控制周期、PWM驱动转向舵机、ADC读取灰度传感器、UART与上位机通信、I2C读取IMU姿态数据。此时需要合理分配资源，避免外设冲突。

综合调试方法论

当多个外设同时工作时，建议遵循以下调试步骤：

1. 分模块验证：先单独测试每个外设的基本功能，确保硬件连接和初始化正确。
2. 时钟与中断优先级检查：使用HAL_NVIC_SetPriority()合理分配中断优先级，避免关键控制中断被低优先级任务阻塞。
3. DMA优化：对于ADC多通道采样、UART长数据接收、SPI大块数据传输，使用DMA减少CPU负载。
4. 逻辑分析仪辅助：使用逻辑分析仪抓取I2C、SPI、UART波形，验证时序是否符合协议规范。
5. 电源完整性：ADC采样时，如果电机同时启动，电源纹波会导致采样值跳变，需在电源端增加滤波电容。

总结与工程建议

STM32外设编程的核心是理解"时钟使能→引脚配置→外设初始化→数据操作"的四步流程。在机器人AI项目中，建议采用以下工程规范：

• 使用HAL库的MX_xxx_Init()函数集中管理外设初始化，便于代码维护。
• 为每个外设封装独立驱动模块（如motor.c、sensor.c），提供简洁的API接口。
• 在调试阶段使用UART输出关键变量，配合串口助手或Python脚本进行数据可视化。
• 对于实时性要求高的控制循环（如PID），使用定时器中断触发，确保固定控制周期。
• 定期检查外设错误标志（如UART的ORE、I2C的AF），及时处理通信异常。