1. TB6612FNG电机驱动芯片核心特性与电气规范

TB6612FNG是东芝半导体（Toshiba）推出的双通道H桥直流电机驱动芯片，专为小功率直流电机控制设计。在嵌入式运动控制系统中，它逐步替代了体积大、功耗高、热管理困难的L298N方案，成为STM32平台下中低负载电机驱动的主流选择。其核心价值不仅在于集成度提升，更在于对现代嵌入式系统关键约束的精准适配：低静态功耗、宽逻辑电平兼容性、精确的电流能力定义以及明确的失效保护边界。

该芯片采用SOIC-20封装，内部集成了两组独立的H桥驱动电路（Channel A与Channel B），每路均可独立控制一台直流电机的启停、正反转及PWM调速。其电气参数体系严格区分电源域与逻辑域，这是理解其可靠运行的前提：

• VM（Motor Supply Voltage） ：电机供电电压输入端，标称工作范围为4.5 V至10 V。实践中，5 V是绝大多数小型直流电机（如微型风扇、玩具电机、小型云台舵机）的理想匹配点。需特别注意：VM绝对不可超过12 V，且严禁与GND反接。反接将导致芯片内部体二极管瞬间导通，形成近似短路的大电流路径，不仅TB6612FNG自身会立即烧毁，还极可能波及为其供电的LDO或DC-DC转换器，甚至损坏上游MCU的IO口。这一教训在工程实践中极为常见——某次智能小车竞赛调试中，因排线插反导致三块TB6612FNG与两片STM32F103同时报废，根源即在此处。

• VCC（Logic Supply Voltage） ：逻辑供电电压输入端，工作范围为2.7 V至5.5 V。对于以3.3 V为标准IO电平的STM32F1系列（如F103C8T6），VCC必须连接至3.3 V电源轨。此设计保证了芯片逻辑接口与MCU IO电平的天然兼容，无需额外电平转换电路，显著简化了硬件设计并降低了信号完整性风险。

• 输出电流能力 ：芯片标称连续输出电流（Io）为1.2 A/通道，峰值输出电流（Io_peak）可达3.2 A（持续时间≤100 ms）。这一参数直接决定了其可驱动的电机类型。例如，一款额定电压5 V、空载电流80 mA、堵转电流1.8 A的微型直流风扇，在启动瞬间会承受接近堵转电流的冲击。此时，若PWM占空比设置过高（如>80%），或启动时未加软启动延时，峰值电流极易触达3.2 A上限，导致芯片进入过流保护状态（表现为输出关闭、电机停转）或长期工作在热应力极限边缘，加速器件老化。因此，在实际应用中，必须依据所选电机的详细规格书（特别是堵转电流I_stall和启动时间t_start）来校验并预留足够的电流裕量。

• STBY（Standby Pin） ：这是一个全局使能引脚，具有上拉/下拉默认状态。当STBY为低电平时，芯片内部所有H桥驱动单元被强制关断，输出呈高阻态，电机完全停止且无任何维持电流；当STBY为高电平时，芯片才允许响应AIN1/AIN2/BIN1/BIN2的输入信号。其默认状态为低电平，这意味着若该引脚悬空，芯片将始终处于待机状态，电机无法转动。工程实践中，最稳妥的做法是将其由MCU的一个GPIO引脚直接驱动，而非依赖外部上拉电阻。这样可以在软件层面实现精确的“系统级使能”，例如在电机初始化完成、所有安全条件满足后，再置高STBY；或在检测到过流、过温等异常时，由软件快速拉低STBY进行紧急制动。

TB6612FNG的引脚布局并非简单的功能罗列，而是遵循严格的PCB布线与热管理逻辑。其背面大面积裸焊盘（Exposed Pad）是芯片散热的关键路径，必须通过多个过孔（Via）牢固连接至PCB的内层大面积铺铜（GND Plane）。若仅靠顶层走线连接，热阻将急剧升高，导致芯片在持续1 A电流输出时结温迅速突破125 °C，触发内置热关断（Thermal Shutdown），造成间歇性失灵。此外，原理图中并联在VM与GND之间的电解电容（通常为100 μF/16 V）与陶瓷电容（通常为0.1 μF）构成复合去耦网络：电解电容负责吸收电机换向产生的低频大能量脉冲，而陶瓷电容则滤除高频开关噪声，二者缺一不可。忽略此设计，轻则导致电机运行噪音增大、MCU复位，重则因VM电压跌落引发逻辑紊乱。

2. H桥驱动原理与TB6612FNG逻辑真值表解析

H桥（H-Bridge）是直流电机驱动的核心拓扑结构，其名称源于电路图中四个开关元件（通常为MOSFET）排列成字母“H”的形状。TB6612FNG将这一复杂电路高度集成，用户只需通过简单的数字信号组合，即可精确控制电机的四种基本状态：正转、反转、制动（Brake）与自由停止（Coast）。理解其底层逻辑，是编写健壮、安全驱动代码的基础，而非仅仅记忆几个引脚定义。

一个完整的H桥由四个开关S1、S2、S3、S4组成，分别对应TB6612FNG的OUT1、OUT2、OUT3、OUT4（物理引脚）。电机M串联于OUT1与OUT2之间（A通道）或OUT3与OUT4之间（B通道）。电机的转向由其两端的电压极性决定：当OUT1为高、OUT2为低时，电流从OUT1经电机流向OUT2，电机正转；反之，当OUT1为低、OUT2为高时，电流反向，电机反转。关键在于，H桥的控制必须严格避免“直通”（Shoot-Through）——即同一侧的两个开关（S1与S2，或S3与S4）同时导通，这将直接在VM与GND之间形成短路，产生毁灭性的大电流。

TB6612FNG通过将复杂的开关时序逻辑固化在芯片内部，并对外提供简洁的输入接口（AIN1, AIN2, BIN1, BIN2），彻底规避了软件实现H桥时易犯的直通错误。其A通道的输入逻辑真值表如下（B通道同理，仅引脚编号不同）：

AIN1	AIN2	PWM (PWMA)	STBY	OUT1	OUT2	电机状态	物理含义
0	0	X	0	Z	Z	待机	STBY=0，全局禁止，所有输出高阻
0	0	X	1	L	L	制动	两路输出均拉低，电机绕组被短路，产生强阻尼
0	1	1	1	L	H	反转	OUT1=L, OUT2=H，电流反向
1	0	1	1	H	L	正转	OUT1=H, OUT2=L，电流正向
1	1	X	1	H	H	制动	两路输出均拉高，电机绕组被短路（等效）
X	X	0	1	L	L	停止	PWM=0，强制两路输出为低

表中，“X”表示“无关”，即该输入位的状态不影响当前输出；“Z”表示高阻态（Hi-Z）；“L”和“H”分别表示逻辑低电平和高电平。

需要重点剖析的是“制动”与“停止”两种看似相似状态的本质区别：
- 制动（Brake） ：当AIN1=AIN2=0或AIN1=AIN2=1时，芯片内部会主动将OUT1与OUT2同时拉至同一电平（均为L或均为H）。此时，电机绕组被低阻抗回路短接，电机转子因电磁感应产生的反电动势（Back-EMF）会在此回路中形成强大的阻尼电流，迫使电机迅速减速并停止。这是一种主动、强力的停机方式，适用于需要精确定位或快速响应的场景。
- 停止（Coast / Free Stop） ：当PWMA=0时，无论AIN1/AIN2为何值，芯片都会将OUT1与OUT2同时置于高阻态（Z）。此时，电机绕组开路，反电动势无处释放，电机仅依靠自身机械摩擦与风阻自然减速，过程缓慢。这种方式功耗最低，但响应迟钝。

在实际编程中，混淆这两者会导致严重后果。例如，在一个需要紧急停车的机器人底盘控制中，若错误地使用PWMA=0来“停止”，电机可能滑行数米才能停下，造成碰撞事故。正确的做法是，在接收到急停指令后，立即将AIN1与AIN2设为相同电平（如0），并确保STBY=1，从而触发硬件级制动。

另一个常被忽视的细节是PWM信号的注入点。TB6612FNG的PWMA/PWMB引脚并非直接连接到H桥的某个开关，而是作为一个“使能门控”信号，作用于整个H桥驱动逻辑。当PWMA为高电平时，H桥根据AIN1/AIN2的状态正常输出；当PWMA为低电平时，H桥被强制关闭，输出为低。因此，PWM信号的占空比（Duty Cycle）直接线性地决定了电机两端的有效电压平均值，进而控制其转速。这就是为什么在代码中， Motor_SetSpeed(60) 的本质，是将定时器通道3的比较值（Compare Value）设置为60，使得PWMA引脚输出一个60%占空比的方波。

3. STM32F103C8T6硬件资源规划与GPIO配置

在STM32F103C8T6（俗称“C8T6”）上实现对TB6612FNG的精确控制，本质上是一场对MCU有限硬件资源的精密调度。该芯片拥有48 MHz主频、64 KB Flash与20 KB RAM，但其外设资源并非无限。一个鲁棒的驱动方案，必须在满足功能需求的同时，为未来的扩展（如增加传感器、通信模块）预留充足的余量。本方案采用的资源分配策略，是经过多次项目迭代验证的工业级实践。

3.1 引脚功能映射与电气考量

根据视频字幕内容与工程最佳实践，我们为TB6612FNG的A通道定义以下引脚映射：
- AIN1 → PA0 ：通用推挽输出（GPIO_MODE_OUTPUT_PP）
- AIN2 → PA1 ：通用推挽输出（GPIO_MODE_OUTPUT_PP）
- PWMA → PA2 ：复用推挽输出（GPIO_MODE_AF_PP），复用功能为TIM2_CH3
- STBY → PB0 ：通用推挽输出（GPIO_MODE_OUTPUT_PP）

此映射并非随意指定，而是基于多重因素的权衡：
- PA0/PA1的选择 ：这两个引脚同属GPIOA端口，共享同一组时钟（RCC_APB2Periph_GPIOA），在初始化时可一次性使能，简化代码。更重要的是，它们不与任何关键调试接口（如SWD的SWCLK/SWDIO）冲突，保证了开发调试的便利性。
- PA2作为TIM2_CH3 ：这是本方案的核心设计。STM32F103的定时器2（TIM2）是一个32位高级定时器，其通道3（CH3）恰好映射在PA2上。选择它而非更常见的TIM1（映射在PA8）或TIM3（映射在PB0），是因为TIM2属于APB1总线，其时钟源（PCLK1）默认为36 MHz，与系统时钟（SYSCLK=72 MHz）分频关系清晰（PCLK1 = SYSCLK / 2），计算PWM频率更为直观。同时，将PWM引脚与方向引脚（PA0/PA1）分离，避免了因GPIO寄存器操作时序问题导致的瞬时直通风险。
- PB0作为STBY ：PB0是GPIOB端口的第一个引脚，资源丰富且稳定。将其用于全局使能，可以独立于电机控制逻辑进行管理。例如，在系统启动自检阶段，可先初始化所有GPIO，再检查电源电压、温度传感器读数等，一切就绪后再置高PB0，实现“安全启动”。

所有上述GPIO引脚，在初始化时均需配置为 推挽输出模式（Push-Pull） ，并设置 高速输出（Output Speed: GPIO_Speed_50MHz） 。这是因为TB6612FNG的输入引脚具有一定的容性负载，较低的驱动速度可能导致信号边沿过缓，在高频PWM切换时引发误触发。50 MHz的输出速度足以保证在100 kHz PWM频率下，信号上升/下降时间小于10 ns，满足芯片建立/保持时间要求。

3.2 时钟树配置与TIM2初始化详解

STM32的时钟树是其性能的基石。对于PWM生成，其核心公式为：
PWM_Frequency = TIMx_CLK / ((PSC + 1) * (ARR + 1))
其中， TIMx_CLK 是定时器的输入时钟频率， PSC 是预分频器值， ARR 是自动重装载值。

在本方案中，目标PWM频率设定为 10 kHz 。这是一个经过深思熟虑的折中点：频率过低（如1 kHz）会导致人耳可闻的“嗡嗡”声，并加剧电机发热；频率过高（如50 kHz）则会增加MCU的中断负担（若使用更新事件中断），且对MOSFET的开关损耗并无显著改善，反而可能因PCB走线寄生电感引发振铃。

已知系统时钟（SYSCLK）为72 MHz，APB1总线时钟（PCLK1）为36 MHz（由RCC_CFGR寄存器配置， RCC_HCLK_Div2 ）。TIM2挂载于APB1总线，因此其时钟源 TIM2_CLK = PCLK1 = 36 MHz 。

代入公式求解：
10,000 = 36,000,000 / ((PSC + 1) * (ARR + 1))
取 ARR = 99 （即计数范围0~99，共100个值），则：
(PSC + 1) = 36,000,000 / (10,000 * 100) = 36
因此， PSC = 35 。

这正是字幕中提到的 PSC = 36 - 1 的由来。在HAL库中， htim2.Init.Prescaler = 35; htim2.Init.Period = 99; 。

初始化TIM2的完整流程如下（以HAL库为例）：
1. 使能时钟 ： __HAL_RCC_TIM2_CLK_ENABLE();
2. 配置GPIO复用 ：将PA2配置为 GPIO_MODE_AF_PP ，并选择正确的AF功能（ GPIO_AF1_TIM2 ）。
3. 初始化定时器基础参数 ：
c htim2.Instance = TIM2; htim2.Init.Prescaler = 35; // 分频36倍，得到1 MHz计数时钟 htim2.Init.CounterMode = TIM_COUNTERMODE_UP; htim2.Init.Period = 99; // 自动重装载值，计数周期100 htim2.Init.ClockDivision = TIM_CLOCKDIVISION_DIV1; htim2.Init.RepetitionCounter = 0; HAL_TIM_Base_Init(&htim2);
4. 初始化PWM通道 ：配置通道3为PWM模式1（ TIM_OCMODE_PWM1 ），输出极性为高有效（ TIM_OCPOLARITY_HIGH ），并使能通道。
c sConfigOC.OCMode = TIM_OCMODE_PWM1; sConfigOC.Pulse = 0; // 初始占空比为0% sConfigOC.OCPolarity = TIM_OCPOLARITY_HIGH; sConfigOC.OCFastMode = TIM_OCFAST_DISABLE; HAL_TIM_PWM_ConfigChannel(&htim2, &sConfigOC, TIM_CHANNEL_3); HAL_TIM_PWM_Start(&htim2, TIM_CHANNEL_3);

至此，PA2引脚便开始输出一个频率为10 kHz、初始占空比为0%的方波。后续只需调用 __HAL_TIM_SET_COMPARE(&htim2, TIM_CHANNEL_3, compare_value); 即可动态改变占空比， compare_value 的有效范围为0~99，对应0%~100%的占空比。

4. 电机驱动软件架构与关键函数实现

一个工业级的电机驱动软件，绝非简单的IO翻转与定时器配置堆砌，而是一个具有清晰职责划分、状态管理与错误处理的微型系统。本方案采用“面向对象”的C语言风格，将电机抽象为一个独立的数据结构，并围绕其生命周期构建一套完备的API。

4.1 Motor结构体与状态管理

首先，定义一个 Motor_HandleTypeDef 结构体，用于封装电机的所有运行时状态：

typedef struct {
    GPIO_TypeDef* DirPortA;   // AIN1所在端口
    uint16_t DirPinA;         // AIN1引脚号
    GPIO_TypeDef* DirPortB;   // AIN2所在端口
    uint16_t DirPinB;         // AIN2引脚号
    GPIO_TypeDef* StbyPort;   // STBY所在端口
    uint16_t StbyPin;         // STBY引脚号
    TIM_HandleTypeDef* htim;  // 关联的定时器句柄
    uint32_t Channel;         // 定时器通道号
    int16_t CurrentSpeed;     // 当前设定速度 (-100 ~ +100)
    uint8_t IsEnabled;        // 是否已使能 (0=禁用, 1=启用)
} Motor_HandleTypeDef;

此结构体将硬件资源（端口、引脚、定时器）与软件状态（当前速度、使能标志）完全绑定，实现了数据与行为的局部化。 CurrentSpeed 被定义为有符号整数，其数值范围-100~+100，直观地映射了电机的转向与相对转速，极大提升了代码的可读性与可维护性。

4.2 核心驱动函数剖析

4.2.1 Motor_Init() : 硬件初始化与安全上电

Motor_Init() 是电机驱动的入口函数，其首要任务是建立一个安全、可控的初始状态。

void Motor_Init(Motor_HandleTypeDef* hmotor) {
    // 1. 初始化GPIO引脚（方向与STBY）
    GPIO_InitTypeDef GPIO_InitStruct = {0};

    // 使能GPIOA和GPIOB时钟
    __HAL_RCC_GPIOA_CLK_ENABLE();
    __HAL_RCC_GPIOB_CLK_ENABLE();

    // 配置PA0 (AIN1) 和 PA1 (AIN2) 为推挽输出
    GPIO_InitStruct.Pin = GPIO_PIN_0 | GPIO_PIN_1;
    GPIO_InitStruct.Mode = GPIO_MODE_OUTPUT_PP;
    GPIO_InitStruct.Pull = GPIO_NOPULL;
    GPIO_InitStruct.Speed = GPIO_SPEED_FREQ_HIGH;
    HAL_GPIO_Init(GPIOA, &GPIO_InitStruct);

    // 配置PB0 (STBY) 为推挽输出，并初始为低电平（安全待机）
    GPIO_InitStruct.Pin = GPIO_PIN_0;
    HAL_GPIO_Init(GPIOB, &GPIO_InitStruct);
    HAL_GPIO_WritePin(GPIOB, GPIO_PIN_0, GPIO_PIN_RESET); // STBY = LOW

    // 2. 初始化TIM2 PWM
    // ... (此处为前述TIM2初始化代码)

    // 3. 初始化结构体成员
    hmotor->DirPortA = GPIOA; hmotor->DirPinA = GPIO_PIN_0;
    hmotor->DirPortB = GPIOA; hmotor->DirPinB = GPIO_PIN_1;
    hmotor->StbyPort = GPIOB; hmotor->StbyPin = GPIO_PIN_0;
    hmotor->htim = &htim2;
    hmotor->Channel = TIM_CHANNEL_3;
    hmotor->CurrentSpeed = 0;
    hmotor->IsEnabled = 0;
}

关键点在于 HAL_GPIO_WritePin(GPIOB, GPIO_PIN_0, GPIO_PIN_RESET); 。此行代码在任何其他操作之前，就将STBY引脚强制拉低，确保TB6612FNG在初始化过程中始终处于安全待机状态。这是防止“上电抖动”导致电机意外启动的关键防护措施。

4.2.2 Motor_SetSpeed() : 速度与方向的统一控制

Motor_SetSpeed() 是驱动的核心，它将一个抽象的“速度”概念，转化为具体的硬件动作。

void Motor_SetSpeed(Motor_HandleTypeDef* hmotor, int16_t speed) {
    // 1. 限幅处理：确保输入在合法范围内
    if (speed > 100) speed = 100;
    if (speed < -100) speed = -100;

    // 2. 更新结构体状态
    hmotor->CurrentSpeed = speed;

    // 3. 如果电机未使能，则直接返回（不执行任何硬件操作）
    if (!hmotor->IsEnabled) return;

    // 4. 根据速度符号，设置方向引脚
    if (speed >= 0) {
        // 正转：AIN1=1, AIN2=0
        HAL_GPIO_WritePin(hmotor->DirPortA, hmotor->DirPinA, GPIO_PIN_SET);
        HAL_GPIO_WritePin(hmotor->DirPortB, hmotor->DirPinB, GPIO_PIN_RESET);
    } else {
        // 反转：AIN1=0, AIN2=1
        HAL_GPIO_WritePin(hmotor->DirPortA, hmotor->DirPinA, GPIO_PIN_RESET);
        HAL_GPIO_WritePin(hmotor->DirPortB, hmotor->DirPinB, GPIO_PIN_SET);
    }

    // 5. 设置PWM占空比（取绝对值）
    uint32_t compare_val = (speed >= 0) ? speed : -speed;
    __HAL_TIM_SET_COMPARE(hmotor->htim, hmotor->Channel, compare_val);
}

此函数的设计精髓在于其“幂等性”（Idempotence）与“原子性”。无论 Motor_SetSpeed() 被调用多少次，只要输入参数相同，其最终效果必然一致。更重要的是，它将方向控制（GPIO写入）与速度控制（PWM设置）严格分离，并在最后一步才更新PWM，避免了在方向切换的瞬间，因PWM尚未生效而导致的短暂直通风险。 compare_val 的计算直接取 speed 的绝对值，使得正负速度在物理上只体现为方向差异，而转速大小完全由占空比数值决定，逻辑极其清晰。

4.2.3 Motor_Enable() 与 Motor_Disable() : 全局使能控制

这两个函数提供了最高级别的控制权限，用于系统级的安全管理。

void Motor_Enable(Motor_HandleTypeDef* hmotor) {
    // 拉高STBY，使能TB6612FNG
    HAL_GPIO_WritePin(hmotor->StbyPort, hmotor->StbyPin, GPIO_PIN_SET);
    hmotor->IsEnabled = 1;

    // 同步应用当前速度设定
    Motor_SetSpeed(hmotor, hmotor->CurrentSpeed);
}

void Motor_Disable(Motor_HandleTypeDef* hmotor) {
    // 拉低STBY，强制待机
    HAL_GPIO_WritePin(hmotor->StbyPort, hmotor->StbyPin, GPIO_PIN_RESET);
    hmotor->IsEnabled = 0;
}

Motor_Enable() 在置高STBY后，会立即调用一次 Motor_SetSpeed() ，以确保电机在使能的瞬间，就按照最新的速度指令开始运行，消除了状态不一致的窗口期。这种设计在多电机协同控制中尤为重要。

5. 用户交互与按键控制逻辑实现

在嵌入式系统中，一个优秀的用户界面（UI）往往比底层驱动更能体现工程师的功力。本方案采用一个独立的、带防抖的按键，实现对电机转速的循环切换（0 → 60 → 80 → 100 → 0），这不仅是功能演示，更是对实时系统响应性与用户体验的综合考验。

5.1 按键硬件与软件防抖

按键（Key）选用常见的轻触开关，硬件上采用上拉电阻（通常为10 kΩ）连接至3.3 V，按键另一端接地。因此，按键未按下时，MCU读取到高电平（1）；按下时，读取到低电平（0）。这种“低电平有效”的设计是行业惯例。

然而，机械按键存在固有的“抖动”（Bounce）现象。当按键被按下或释放的瞬间，触点会在毫秒级时间内反复弹跳，导致MCU的GPIO读取到一连串的0/1跳变。若不处理，一次物理按键会被识别为多次触发。软件防抖是最常用且成本最低的解决方案，其核心思想是：在检测到电平变化后，延时一段时间（如20 ms），再次读取电平，若仍保持一致，则确认为有效事件。

在本方案中，按键被映射到 PB1 （字幕中提及的“PBE”，应为笔误，实指PB1）。其初始化代码如下：

// 在系统初始化中
__HAL_RCC_GPIOB_CLK_ENABLE();
GPIO_InitTypeDef Key_GPIO_InitStruct = {0};
Key_GPIO_InitStruct.Pin = GPIO_PIN_1;
Key_GPIO_InitStruct.Mode = GPIO_MODE_INPUT;
Key_GPIO_InitStruct.Pull = GPIO_PULLUP; // 内部上拉，省去外部电阻
Key_GPIO_InitStruct.Speed = GPIO_SPEED_FREQ_LOW;
HAL_GPIO_Init(GPIOB, &Key_GPIO_InitStruct);

5.2 主循环中的按键状态机

由于本项目未使用RTOS，所有逻辑均在 main() 函数的主循环中执行。一个健壮的按键处理逻辑，不应简单地使用 HAL_Delay() 进行阻塞式延时，因为这会冻结整个系统的响应。此处采用一种基于“滴答计时器”（SysTick）的非阻塞状态机。

首先，定义一个全局变量记录上次按键扫描的时间戳：

static uint32_t last_key_scan_time = 0;
#define KEY_DEBOUNCE_TIME_MS 20

然后，在主循环中，每隔固定时间（如10 ms）执行一次扫描：

int main(void) {
    // ... 系统初始化 ...
    Motor_HandleTypeDef motor;
    Motor_Init(&motor);

    uint32_t current_time_ms = HAL_GetTick();

    while (1) {
        // 非阻塞式按键扫描，每10ms执行一次
        if ((HAL_GetTick() - current_time_ms) >= 10) {
            current_time_ms = HAL_GetTick();

            // 读取按键电平
            GPIO_PinState key_state = HAL_GPIO_ReadPin(GPIOB, GPIO_PIN_1);

            // 若为低电平（按键按下），进入防抖状态机
            if (key_state == GPIO_PIN_RESET) {
                // 检查是否已过防抖时间
                if (HAL_GetTick() - last_key_scan_time >= KEY_DEBOUNCE_TIME_MS) {
                    last_key_scan_time = HAL_GetTick();

                    // 确认为有效按键事件
                    static uint8_t speed_level = 0;
                    switch (speed_level) {
                        case 0:
                            Motor_SetSpeed(&motor, 60);
                            printf("Motor Speed: 60%%\r\n");
                            speed_level = 1;
                            break;
                        case 1:
                            Motor_SetSpeed(&motor, 80);
                            printf("Motor Speed: 80%%\r\n");
                            speed_level = 2;
                            break;
                        case 2:
                            Motor_SetSpeed(&motor, 100);
                            printf("Motor Speed: 100%%\r\n");
                            speed_level = 3;
                            break;
                        case 3:
                            Motor_SetSpeed(&motor, 0);
                            printf("Motor Speed: 0%%\r\n");
                            speed_level = 0;
                            break;
                    }
                }
            }
        }

        // 其他任务...
        HAL_Delay(1); // 保持主循环运行，避免空转耗尽CPU
    }
}

此状态机的关键优势在于其“非抢占性”与“确定性”。它不会因为一次长延时而阻塞其他任务（尽管本例中无其他任务），并且每次按键事件的响应延迟被严格限定在 KEY_DEBOUNCE_TIME_MS （20 ms）以内，远优于传统 HAL_Delay() 方案。 printf() 语句用于通过串口打印当前速度，便于调试与观察。

5.3 实际运行现象与工程经验

在视频演示中，当按键首次按下时，电机并未立即启动，而是出现“动了一下又停了”的现象。这并非代码缺陷，而是典型的 电机启动转矩不足 表现。微型直流电机在静止状态下，其启动电流（Inrush Current）远大于稳态运行电流。若此时PWM占空比过低（如60%对应5 V * 0.6 = 3 V），施加在电机上的电压可能不足以克服静摩擦力与转子惯性。

解决此问题的工程实践有二：
1. 软件软启动（Soft Start） ：在 Motor_SetSpeed() 中，当 speed 从0变为非零时，不直接设置目标占空比，而是启动一个渐进式增加的过程。例如，从0%开始，每隔10 ms增加5%，直至达到目标值。这模拟了人类“缓缓拧动油门”的感觉，极大提升了启动平稳性。
2. 硬件优化 ：为电机供电的5 V电源，其输出电流能力必须足够。一个劣质的USB充电器（标称5 V/1 A）在电机启动瞬间，电压可能骤降至4 V以下，导致驱动乏力。使用一个纹波小、瞬态响应快的专用DC-DC模块（如LM2596），是保证电机性能的硬件基础。

在实际项目中，我曾为一个智能窗帘电机控制器采用TB6612FNG。初期也遇到类似问题，最终通过在固件中加入50 ms的软启动，并将电源更换为12 V/2 A的开关电源，完美解决了启动卡顿问题。这印证了一个朴素的真理：优秀的嵌入式系统，永远是软硬协同、理论与实践相互印证的结果。