以下是一个基于STM32的PID控制电机转速的示例程序框架，使用中文注释说明。假设使用定时器PWM驱动电机，编码器反馈转速：

#include "stm32f1xx_hal.h"

// PID结构体定义
typedef struct {
    float Kp;       // 比例系数
    float Ki;       // 积分系数
    float Kd;       // 微分系数
    float integral; // 积分项
    float prev_error; // 上次误差
    float output;    // PID输出
    float out_max;   // 输出最大值（PWM占空比限制）
    float out_min;   
} PID_TypeDef;

// 全局变量
PID_TypeDef pid;
uint16_t target_rpm = 1000;  // 目标转速（转/分钟）
uint16_t current_rpm = 0;    // 当前转速

// PID初始化
void PID_Init(PID_TypeDef *pid, float Kp, float Ki, float Kd, float out_min, float out_max) {
    pid->Kp = Kp;
    pid->Ki = Ki;
    pid->Kd = Kd;
    pid->integral = 0;
    pid->prev_error = 0;
    pid->output = 0;
    pid->out_min = out_min;
    pid->out_max = out_max;
}

// PID计算函数
float PID_Calculate(PID_TypeDef *pid, float setpoint, float input) {
    float error = setpoint - input;

    // 比例项
    float P = pid->Kp * error;

    // 积分项（带抗饱和）
    pid->integral += error;
    if(pid->integral > pid->out_max/pid->Ki) pid->integral = pid->out_max/pid->Ki;
    else if(pid->integral < pid->out_min/pid->Ki) pid->integral = pid->out_min/pid->Ki;
    float I = pid->Ki * pid->integral;

    // 微分项
    float D = pid->Kd * (error - pid->prev_error);
    pid->prev_error = error;

    // 总和输出
    pid->output = P + I + D;

    // 输出限幅
    if(pid->output > pid->out_max) pid->output = pid->out_max;
    if(pid->output < pid->out_min) pid->output = pid->out_min;

    return pid->output;
}

// 编码器转速测量（示例：使用定时器输入捕获）
void TIM2_IRQHandler(void) {
    // 在此实现编码器脉冲计数与转速计算
    // current_rpm = ... （根据脉冲频率计算实际转速）
}

// PWM输出初始化（示例：TIM1 CH1）
void PWM_Init(void) {
    TIM_OC_InitTypeDef sConfigOC = {0};
    htim1.Instance = TIM1;
    htim1.Init.Prescaler = 71;          // 72MHz/(71+1)=1MHz
    htim1.Init.CounterMode = TIM_COUNTERMODE_UP;
    htim1.Init.Period = 999;            // 1MHz/1000 = 1kHz PWM频率
    HAL_TIM_PWM_Init(&htim1);

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

int main(void) {
    HAL_Init();
    SystemClock_Config();

    // 初始化PID参数（需根据实际系统调试）
    PID_Init(&pid, 0.5, 0.01, 0.05, 0, 999);  // 输出对应PWM的0-100%

    PWM_Init();     // 初始化PWM
    Encoder_Init(); // 初始化编码器（需自行实现）

    while (1) {
        // 周期执行PID计算（建议放在定时中断中）
        float output = PID_Calculate(&pid, target_rpm, current_rpm);

        // 更新PWM输出
        __HAL_TIM_SET_COMPARE(&htim1, TIM_CHANNEL_1, (uint16_t)output);

        HAL_Delay(10); // 控制周期10ms（根据需求调整）
    }
}

关键实现步骤说明：

1. 硬件配置

   • PWM输出：使用定时器（如TIM1）产生PWM波控制电机驱动电路
   • 编码器接口：配置定时器（如TIM2）为编码器模式，测量电机转速
   • 转速计算：通过定时器捕获脉冲数，计算实际转速（RPM）

2. PID参数整定

   • Kp：影响系统响应速度，过大易震荡
   • Ki：消除稳态误差，过大易导致超调
   • Kd：抑制振荡，改善动态特性
   • 调试建议：先调Kp至系统出现轻微震荡，然后加入Ki消除静差，最后加Kd抑制震荡

3. 转速测量方法

   • M法测速：固定时间测量脉冲数

     // 示例公式（需根据编码器线数和测量时间调整）
     current_rpm = (pulse_count * 60) / (encoder_lines * measurement_time);

4. 注意事项

   • 确保控制周期固定（建议使用定时器中断）
   • 添加软件滤波处理编码器信号
   • 对积分项进行限幅防止积分饱和
   • 实际输出需匹配电机驱动器的PWM响应范围

实际应用中需要根据具体硬件（电机类型、驱动电路、编码器分辨率等）调整参数和算法细节。建议使用STM32CubeMX进行外设初始化配置。