以下是一个基于STM32的编码器电机PID控制程序示例框架（使用中文注释）：

#include "stm32f1xx_hal.h"

// PID参数结构体
typedef struct {
  float Kp;         // 比例系数
  float Ki;         // 积分系数
  float Kd;         // 微分系数
  float target;     // 目标值（转速或位置）
  float actual;     // 实际值
  float error;      // 当前误差
  float last_error; // 上一次误差
  float integral;   // 积分项
  float output;     // PID输出
  float max_output; // 输出限幅
} PID;

// 编码器计数器变量
int32_t encoder_count = 0;

// PID初始化函数
void PID_Init(PID *pid) {
  pid->Kp = 2.0;
  pid->Ki = 0.5;
  pid->Kd = 0.1;
  pid->target = 0.0;
  pid->actual = 0.0;
  pid->error = 0.0;
  pid->last_error = 0.0;
  pid->integral = 0.0;
  pid->output = 0.0;
  pid->max_output = 1000; // 根据PWM范围设置
}

// PID计算函数
void PID_Calc(PID *pid) {
  // 计算误差
  pid->error = pid->target - pid->actual;

  // 积分项（带抗积分饱和）
  pid->integral += pid->error;
  if(pid->integral >  1000) pid->integral = 1000;
  if(pid->integral < -1000) pid->integral = -1000;

  // PID计算
  pid->output = pid->Kp * pid->error 
              + pid->Ki * pid->integral 
              + pid->Kd * (pid->error - pid->last_error);

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

  // 保存误差
  pid->last_error = pid->error;
}

// 编码器接口（示例：定时器编码器模式）
void TIM4_IRQHandler(void) {
  if(__HAL_TIM_GET_FLAG(&htim4, TIM_FLAG_UPDATE)) {
    __HAL_TIM_CLEAR_FLAG(&htim4, TIM_FLAG_UPDATE);
    // 读取编码器计数值
    encoder_count = (int32_t)TIM4->CNT;
    TIM4->CNT = 0; // 重置计数器（根据编码器类型选择是否清零）
  }
}

// 主控制循环
void motor_control(void) {
  PID speed_pid;
  PID_Init(&speed_pid);

  while(1) {
    // 1. 获取实际速度（示例：通过编码器计算转速）
    // 假设定时器1ms中断一次，编码器每脉冲对应0.1RPM
    speed_pid.actual = encoder_count * 0.1f;

    // 2. 设置目标速度（示例：500 RPM）
    speed_pid.target = 500.0f;

    // 3. 执行PID计算
    PID_Calc(&speed_pid);

    // 4. 输出PWM控制电机
    __HAL_TIM_SET_COMPARE(&htim2, TIM_CHANNEL_1, (uint32_t)speed_pid.output);

    // 5. 延时或等待定时器触发
    HAL_Delay(10); // 控制周期10ms
  }
}

关键点说明：

1. 编码器接口：

   • 使用定时器的编码器模式（需要配置TIMx相关参数）
   • 通过中断或DMA读取计数值
   • 根据编码器分辨率计算实际转速/位置

2. PID参数整定：

   • 建议先调Kp（比例项），再调Kd（微分项），最后调Ki（积分项）
   • 通过阶跃响应观察超调量和稳定时间
   • 可使用试凑法或Ziegler-Nichols方法

3. 速度计算：

   // 更精确的速度计算示例（需定时采样）：
   float calculate_rpm(uint32_t sample_time_ms) {
   static int32_t last_count = 0;
   int32_t delta = encoder_count - last_count;
   last_count = encoder_count;
   
   // 编码器线数：1024，减速比：30:1，采样时间：10ms
   return (delta * 60.0f * 1000.0f) / (1024 * 30 * sample_time_ms);
   }

4. PWM输出：

   • 需要配置定时器的PWM输出模式
   • 注意PWM频率选择（一般10kHz-20kHz）
   • 根据电机驱动芯片要求调整有效电平

5. 注意事项：

   • 中断优先级配置（编码器中断 > PID计算）
   • 添加软件滤波处理编码器噪声
   • 对积分项做抗饱和处理（Clamping）
   • 实际应用时建议使用位置式PID或增量式PID

建议结合具体硬件进行以下修改：

1. 根据实际编码器类型配置定时器
2. 调整PID参数和采样时间
3. 添加电机使能控制和方向控制
4. 增加保护逻辑（过流、堵转检测等）

实际参数需要根据电机特性通过实验整定，建议先用示波器观察系统响应曲线。