用STM32CubeMX和HAL库搞定电机驱动板（DRV8701）与编码器测速，附完整代码

基于STM32CubeMX与HAL库的电机驱动与编码器测速实战指南

在嵌入式开发领域，电机控制一直是一个既基础又关键的技术点。无论是机器人、自动化设备还是智能家居产品，精准的电机控制都是实现预期功能的核心。对于刚接触STM32 HAL库和电机控制的开发者来说，如何快速搭建一个稳定可靠的电机控制系统往往是一个挑战。本文将带你从零开始，使用STM32CubeMX和HAL库，一步步实现DRV8701电机驱动板的控制与编码器测速功能。

1. 硬件准备与环境搭建

在开始编码之前，我们需要确保硬件连接正确，并准备好开发环境。DRV8701是一款高性能的栅极驱动器，能够驱动N沟道MOSFET，非常适合用于电机驱动应用。

所需硬件清单：

• STM32开发板（如STM32F103C8T6）
• DRV8701电机驱动板
• 带编码器的直流电机
• 逻辑分析仪（可选，用于调试）
• USB转串口模块（用于调试输出）

软件环境配置：

1. 安装STM32CubeMX（最新版本）
2. 安装Keil MDK或STM32CubeIDE
3. 安装对应STM32系列的HAL库
4. 安装串口调试工具（如Putty、Tera Term）

硬件连接时需特别注意：

• 确保电机电源与MCU电源隔离
• 编码器信号线建议使用双绞线以减少干扰
• DRV8701的使能(EN)和方向(PH)引脚需正确连接到STM32

2. STM32CubeMX工程配置

STM32CubeMX是ST官方提供的图形化配置工具，可以大大简化外设初始化工作。下面我们将重点配置与电机控制相关的几个关键外设。

2.1 时钟配置

首先设置系统时钟为72MHz（对于STM32F103系列）：

1. 在"Pinout & Configuration"选项卡中选择"RCC"
2. 设置HSE为"Crystal/Ceramic Resonator"
3. 切换到"Clock Configuration"选项卡
4. 配置PLL倍频参数，确保系统时钟为72MHz

2.2 PWM输出配置

我们需要配置定时器产生PWM信号来控制电机速度：

/* PWM配置示例参数 */ TIM_HandleTypeDef htim1; htim1.Instance = TIM1; htim1.Init.Prescaler = 71; // 72MHz/72 = 1MHz htim1.Init.CounterMode = TIM_COUNTERMODE_UP; htim1.Init.Period = 999; // 1MHz/1000 = 1kHz PWM频率 htim1.Init.ClockDivision = TIM_CLOCKDIVISION_DIV1;

在CubeMX中的配置步骤：

1. 选择TIM1
2. 设置Channel1为"PWM Generation CH1"
3. 配置Prescaler为71，Counter Period为999
4. 启用自动重装载预装载(ARPE)

2.3 编码器接口配置

编码器接口需要使用定时器的编码器模式：

/* 编码器模式配置示例 */ TIM_Encoder_InitTypeDef sConfig = {0}; TIM_MasterConfigTypeDef sMasterConfig = {0}; htim2.Instance = TIM2; htim2.Init.Prescaler = 0; htim2.Init.CounterMode = TIM_COUNTERMODE_UP; htim2.Init.Period = 65535; htim2.Init.ClockDivision = TIM_CLOCKDIVISION_DIV1; htim2.Init.AutoReloadPreload = TIM_AUTORELOAD_PRELOAD_DISABLE; sConfig.EncoderMode = TIM_ENCODERMODE_TI12; // 4倍频模式 sConfig.IC1Polarity = TIM_ICPOLARITY_RISING; sConfig.IC1Selection = TIM_ICSELECTION_DIRECTTI; sConfig.IC1Prescaler = TIM_ICPSC_DIV1; sConfig.IC1Filter = 0; sConfig.IC2Polarity = TIM_ICPOLARITY_RISING; sConfig.IC2Selection = TIM_ICSELECTION_DIRECTTI; sConfig.IC2Prescaler = TIM_ICPSC_DIV1; sConfig.IC2Filter = 0;

配置要点：

• 选择Encoder Mode为"Encoder Mode TI1 and TI2"（4倍频）
• 设置合适的滤波器值（根据编码器信号质量）
• 配置最大计数值（根据电机转速和测量需求）

3. 电机驱动与PWM控制实现

DRV8701驱动板的使用相对简单，主要通过三个信号控制：

• EN（使能）：PWM信号，控制电机速度
• PH（方向）：高低电平，控制电机转向
• nSLEEP（睡眠模式）：通常保持高电平

3.1 初始化代码

在生成的工程中，我们需要添加电机控制相关的初始化代码：

/* 电机初始化函数 */ void Motor_Init(void) { // 启动PWM定时器 HAL_TIM_PWM_Start(&htim1, TIM_CHANNEL_1); // 设置初始占空比为0（电机停止） __HAL_TIM_SET_COMPARE(&htim1, TIM_CHANNEL_1, 0); // 初始化方向引脚 HAL_GPIO_WritePin(GPIOA, GPIO_PIN_1, GPIO_PIN_RESET); // 使能nSLEEP HAL_GPIO_WritePin(GPIOA, GPIO_PIN_2, GPIO_PIN_SET); }

3.2 速度控制函数

实现一个简单的速度控制函数：

/* 设置电机速度 */ void Set_Motor_Speed(int16_t speed) { // 限制速度范围 speed = (speed > 1000) ? 1000 : speed; speed = (speed < -1000) ? -1000 : speed; // 设置方向 if(speed >= 0) { HAL_GPIO_WritePin(GPIOA, GPIO_PIN_1, GPIO_PIN_RESET); // 正转 } else { HAL_GPIO_WritePin(GPIOA, GPIO_PIN_1, GPIO_PIN_SET); // 反转 speed = -speed; // 取绝对值 } // 设置PWM占空比 uint16_t pwm_val = (uint16_t)(speed * 999 / 1000); __HAL_TIM_SET_COMPARE(&htim1, TIM_CHANNEL_1, pwm_val); }

注意：实际应用中应考虑加入加速度限制，避免电机突然启停导致电流过大。

4. 编码器测速与位置反馈

编码器是闭环控制的关键传感器，它能提供精确的速度和位置反馈。我们使用定时器的编码器接口模式来读取编码器信号。

4.1 编码器初始化

在CubeMX配置完成后，需要在代码中启动编码器接口：

/* 编码器初始化 */ void Encoder_Init(void) { // 启动编码器接口 HAL_TIM_Encoder_Start(&htim2, TIM_CHANNEL_ALL); // 启动测速定时器中断（10ms周期） HAL_TIM_Base_Start_IT(&htim3); // 重置计数器 __HAL_TIM_SET_COUNTER(&htim2, 0); }

4.2 速度计算算法

在定时器中断中计算电机转速：

// 全局变量 float motor_rpm; // 转速，单位RPM int32_t total_pulses; // 总脉冲数（用于位置反馈） /* 定时器中断回调函数 */ void HAL_TIM_PeriodElapsedCallback(TIM_HandleTypeDef *htim) { if(htim == &htim3) // 10ms定时器 { static int16_t last_count = 0; int16_t current_count = __HAL_TIM_GET_COUNTER(&htim2); int16_t delta = current_count - last_count; // 处理计数器溢出 if(delta > 32767) delta -= 65536; else if(delta < -32767) delta += 65536; // 更新总脉冲数 total_pulses += delta; // 计算转速（RPM） // 假设编码器线数为500，4倍频后为2000脉冲/转 motor_rpm = (delta * 6000.0f) / (2000 * 0.01f); // 6000=60*100 // 更新上次计数值 last_count = current_count; } }

4.3 调试输出

为了方便调试，我们可以通过串口输出转速信息：

/* 重定义printf函数 */ int __io_putchar(int ch) { HAL_UART_Transmit(&huart1, (uint8_t *)&ch, 1, HAL_MAX_DELAY); return ch; } /* 定期输出转速信息 */ void Print_Motor_Info(void) { printf("Speed: %.1f RPM, Position: %ld pulses\r\n", motor_rpm, total_pulses); HAL_Delay(200); }

5. 系统集成与性能优化

将各个模块整合后，我们还需要考虑一些实际应用中的问题和优化措施。

5.1 抗干扰措施

电机系统常见的干扰问题及解决方案：

问题现象	可能原因	解决方案
编码器读数异常	信号线干扰	使用双绞线，增加RC滤波
单片机复位	电源波动	增加电源滤波电容，使用隔离电源
PWM控制不稳定	地线噪声	单点接地，加粗地线

5.2 控制环路实现

简单的速度闭环控制实现：

/* PID参数 */ float Kp = 0.5f, Ki = 0.01f, Kd = 0.0f; float error_sum = 0, last_error = 0; /* 速度闭环控制 */ void Speed_Control(float target_rpm) { float error = target_rpm - motor_rpm; error_sum += error; float delta_error = error - last_error; // 计算PID输出 float output = Kp*error + Ki*error_sum + Kd*delta_error; // 限制输出范围 output = (output > 1000) ? 1000 : output; output = (output < -1000) ? -1000 : output; // 设置电机速度 Set_Motor_Speed((int16_t)output); // 保存当前误差 last_error = error; }

5.3 高级功能扩展

基于现有框架可以进一步实现的功能：

• 位置闭环控制
• 运动轨迹规划
• 多电机同步控制
• 故障检测与保护

/* 位置闭环控制示例 */ void Position_Control(int32_t target_pulses) { int32_t error = target_pulses - total_pulses; float speed_command = error * 0.1f; // 简单的比例控制 // 限制最大速度 speed_command = (speed_command > 300) ? 300 : speed_command; speed_command = (speed_command < -300) ? -300 : speed_command; Set_Motor_Speed((int16_t)speed_command); }

6. 常见问题与解决方案

在实际开发过程中，可能会遇到各种问题。下面列出一些常见问题及其解决方法。

6.1 编码器读数不稳定

可能原因及解决方案：

1. 信号干扰
   • 使用屏蔽电缆连接编码器
   • 在信号线上增加RC滤波（如100Ω电阻和100nF电容）
2. 电源噪声
   • 为编码器提供干净的电源
   • 在电源端增加去耦电容
3. 机械振动
   • 检查电机安装是否牢固
   • 考虑使用柔性联轴器

6.2 PWM控制不精确

调试步骤：

1. 使用逻辑分析仪检查PWM波形
2. 确认定时器配置是否正确
   • 检查预分频值和自动重装载值
   • 确认时钟源频率
3. 检查DRV8701的输入信号
   • 确认EN和PH信号电平正确
   • 检查nSLEEP是否已使能

6.3 电机启动困难

可能原因：

• 启动电流不足
• PWM频率不合适
• 电机负载过大

优化建议：

/* 软启动实现 */ void Soft_Start(int16_t target_speed, uint16_t duration_ms) { const uint16_t steps = 100; uint16_t delay_time = duration_ms / steps; int16_t step_size = target_speed / steps; for(int i=0; i<steps; i++) { Set_Motor_Speed(step_size * i); HAL_Delay(delay_time); } Set_Motor_Speed(target_speed); }

7. 进阶技巧与最佳实践

在掌握了基本功能实现后，可以考虑以下进阶技巧来提升系统性能。

7.1 定时器资源优化

当需要控制多个电机时，合理分配定时器资源：

功能	推荐定时器	备注
PWM生成	高级定时器(TIM1,TIM8)	支持互补输出
编码器接口	通用定时器(TIM2-TIM5)	32位计数器更佳
控制周期	基本定时器(TIM6,TIM7)	中断优先级最高

7.2 中断优先级管理

合理设置中断优先级确保系统实时性：

/* 中断优先级配置示例 */ HAL_NVIC_SetPriority(TIM3_IRQn, 0, 0); // 控制周期定时器，最高优先级 HAL_NVIC_SetPriority(USART1_IRQn, 1, 0); // 串口中断，中等优先级 HAL_NVIC_SetPriority(TIM2_IRQn, 2, 0); // 编码器接口，较低优先级

7.3 低功耗考虑

对于电池供电设备，可加入低功耗模式：

/* 进入低功耗模式 */ void Enter_Low_Power_Mode(void) { // 停止电机 Set_Motor_Speed(0); // 关闭不必要的外设 HAL_TIM_PWM_Stop(&htim1, TIM_CHANNEL_1); HAL_UART_DeInit(&huart1); // 配置唤醒源 HAL_SuspendTick(); HAL_PWR_EnterSTOPMode(PWR_LOWPOWERREGULATOR_ON, PWR_STOPENTRY_WFI); // 唤醒后重新初始化 SystemClock_Config(); HAL_ResumeTick(); MX_TIM1_Init(); MX_USART1_UART_Init(); }