在 FOC（磁场定向控制）被广泛用于无人机、电动工具和家电电机的今天，STM32F103C8T6 仍然是很多业余项目和学习者接触最多的入门芯片。这篇文章要讨论的开源项目，核心是在一块不到十元的最小系统板上，用极坐标形式的电压矢量控制，驱动从洗衣机拆下来的永磁同步电机（PMSM/BLDC）。它没有使用昂贵的开发板，也没有一开始就引入完整的 Clark/Park 变换和 SVPWM 扇区判断，而是把 FOC 控制器需要处理的“电流多大、磁场角度在哪、PWM 怎么给”三个问题，用更直观的方式在 C 语言里实现出来。
这篇内容面向具备基础 STM32 HAL 库使用经验、想从“点灯”跨到“电机控制”的开发者。读完你可以理解 FOC 控制的基本链路，知道为什么极坐标表达能降低实现门槛，能在一张标准的最小系统板上搭建可复现的硬件接线和软件框架，也能在电机不转、抖动、过流、烧管子这些典型故障出现时，按照日志和波形缩小排查范围。文章给出的代码是简化的核心片段，用于说明控制思路，实际落地时需要结合你自己的电机参数、驱动板原理图和工程结构调整。
1. 为什么选 STM32F103C8T6 和极坐标 FOC 这条路线
1.1 FOC 控制器到底在干什么
FOC 的全称是 Field Oriented Control，也就是磁场定向控制。它的核心目标不是简单地把三相电源接给电机，而是让定子产生的磁场方向始终和转子磁极保持接近 90 度的夹角，就像直流电机那样可控地产生转矩。
更直白地说：三相电机内部有三个绕组，任意时刻给三相桥臂施加不同的 PWM 占空比，就能合成一个电压矢量。这个矢量的大小决定电流大小，方向决定磁场方向。FOC 要做的，就是实时知道转子磁极现在在哪里、需要把电压矢量送到哪个角度、送多大强度，然后持续更新三相 PWM 输出。
标准 FOC 的做法是先把三相电流采样回来，做 Clark 变换从 a/b/c 三相转到 α/β 两相，再做 Park 变换从静止坐标转到和转子一起旋转的 d/q 坐标。在 d/q 坐标下，电流的 d 轴分量控制磁场强度，q 轴分量控制转矩，两个 PI 环分别调节。最后再通过逆 Park 变换和 SVPWM 算法生成三相桥臂占空比。整套流程计算量大，三角函数和坐标变换代码也比较多。
1.2 极坐标 FOC 与直角坐标 FOC 的区别
极坐标 FOC 的思路是：定子电流或电压矢量同样可以用大小和方向两个量描述。直角坐标用 x、y 两个分量表示矢量，极坐标则用幅值 r 和角度 θ 表示。标准 FOC 内层控制的是 d/q 两个电流分量，也就是直角坐标；极坐标 FOC 则直接控制电流矢量的幅值和角度。
对学习型项目来说，这样做有几个实际好处：
- 不需要频繁调用 sin/cos 计算 d/q 轴电流，转子角度可以直接用霍尔换相表或反电动势过零事件来逼近。
- 不需要写 SVPWM 的扇区判断和矢量作用时间推导，三相占空比可以直接由电压幅值和角度通过查表生成。
- 控制变量变成“推多大力”和“往哪个方向推”，方便通过串口观察，也方便手动调试。
代价是控制动态性能和转矩线性度通常不如完整 FOC。极坐标形式更适合速度控制场景，比如风机、水泵、洗衣机电机这类不需要极高动态响应的负载。
| 对比项 | 标准 FOC | 极坐标 FOC |
|---|---|---|
| 电流控制量 | d/q 轴分量 | 幅值 r 与角度 θ |
| 坐标变换 | Clark + Park + 逆 Park | 少量变换或查表 |
| 调制方式 | SVPWM | 查表生成三相占空比 |
| 计算开销 | 较高 | 较低 |
| 动态响应 | 好 | 一般 |
| 适合学习者 | 有数学门槛 | 直观、易调试 |
1.3 这套方案适合什么场景
用 STM32F103C8T6 做极坐标 FOC，不是要证明芯片能跑多快的控制环，而是为了降低理解门槛。F103 的主频只有 72 MHz，Flash 也只有 64 KB，RAM 20 KB，运行完整高性能 FOC 会比较紧张，但运行一个 10 kHz 到 20 kHz 左右的极坐标控制环是可行的。
这里要特别注意：洗衣机拆机电机参数差异非常大，有些是低压无刷直流电机，有些是高压 PMSM，额定电压、极对数、相电阻、相电感完全不同。项目标题中的“简易”就体现在这里——先让电机转起来，再谈精度。正确做法是先确认电机额定电压，再用万用表和电感表测量相电阻、相电感，最后决定母线电压和电流采样电阻的参数。
2. 硬件清单、引脚规划与接线检查
2.1 需要准备的器件
项目之所以适合复现，是因为大部分器件可以直接买到，不需要专门画板。完整清单见下表。
| 器件 | 作用 | 说明 |
|---|---|---|
| STM32F103C8T6 最小系统板 | 主控 | 蓝色 pill 板即可，注意最小系统板与驱动板共地 |
| 三相全桥驱动板 | 功率放大 | 常见 DRV8301、EG2134、IR2101 方案，需支持低压侧电流采样 |
| 采样电阻和运放电路 | 电流采集 | 至少采集两相电流，第三相由基尔霍夫定律计算 |
| 洗衣机拆机永磁电机 | 被控对象 | 先测量额定电压和相电阻，再决定母线电压 |
| 24V 开关电源 | 低压调试供电 | 学习阶段先用低压，不要直接上 220V |
| ST-Link 或串口工具 | 下载和调试 | 串口至少留一路，用于打印角度、电流和错误码 |
| 霍尔传感器或编码器 | 转子角度 | 项目以霍尔方案为主；无感方案需要额外反电动势检测电路 |
| 示波器或逻辑分析仪 | 观测 PWM 和电流 | 如果没有，也可以用串口波形输出替代 |
2.2 引脚分配要避开调试口和 ADC 冲突
STM32F103C8T6 是 48 脚封装，可用引脚不多。一个容易踩的坑是 PWM 输出、串口、ADC 和 SWD 调试口互相抢占。下面是一组参考分配，实际项目要以你自己的最小系统板原理图为准。
| 功能 | 引脚 | 说明 |
|---|---|---|
| TIM1_CH1 | PA8 | 三相桥上桥臂 A |
| TIM1_CH1N | PB13 | 三相桥下桥臂 A |
| TIM1_CH2 | PA9 | 三相桥上桥臂 B |
| TIM1_CH2N | PB14 | 三相桥下桥臂 B |
| TIM1_CH3 | PA10 | 三相桥上桥臂 C |
| TIM1_CH3N | PB15 | 三相桥下桥臂 C |
| ADC1_IN0 | PA0 | 相电流采样 1 |
| ADC1_IN1 | PA1 | 相电流采样 2 |
| USART2_TX | PA2 | 调试串口输出 |
| USART2_RX | PA3 | 调试串口输入 |
| 霍尔 A/B/C | PB4/PB6/PB7 | 根据手头霍尔排列调整，避开 SWD 和 ADC |
这里不建议把调试串口放在 USART1，因为 PA9 和 PA10 已经用于 TIM1_CH2 和 TIM1_CH3。霍尔引脚要避开 PB3/PB4 的默认 JTAG 功能，如果非要用这两个引脚，需要先关闭 JTAG 复用功能，但这会影响 ST-Link 调试，一般不建议。
2.3 电流采样与驱动板接线要点
极坐标 FOC 同样需要相电流反馈，否则角度修正和幅值控制没有依据。常见低压驱动板使用三电阻采样或两电阻采样，在 PWM 周期的特定时刻读取采样电阻上的电压，还原相电流。
接线时最需要注意的是地线。控制板、驱动板、电源、采样运放的地必须可靠连接，否则 ADC 读数会跳动，电机甚至会在启动瞬间失控。推荐顺序是：先把控制板与驱动板信号地接好，再接入母线电源，最后才连接电机三相线。
驱动板逻辑电源通常和控制板共用 3.3V 或 5V，但同一颗稳压芯片可能无法同时给 MCU 和驱动芯片提供足够电流。建议给最小系统板单独供电，驱动板逻辑侧单独供电，但要保证两者共地。如果驱动板功率地和信号地是分开的，要按照驱动板原理图在合适位置单点连接，不要随意短接。
2.4 必须先做的上电安全检查
任何功率电子项目，上电前检查都值得养成习惯。调试阶段建议按以下顺序验证：
- 不接电机，只给控制板供电，用示波器确认 TIM1 六路 PWM 存在，死区时间设置正确。
- 给驱动板通低压母线电，不接电机，确认母线电压没有异常跌落，驱动芯片没有发烫。
- 用示波器看三相输出对地波形，确认上管和下管没有同时导通。
- 断开母线电源，等待母线电容放电后，再接电机三相线。
- 首次上电建议在母线上串联一个限流电阻或灯泡，限制故障电流。
不建议在没有任何输出保护的情况下直接上 220V 交流经整流的母线电压。学习阶段先用 24V 或 48V 低压直流，安全性和故障排查效率都会高很多。
3. 用 STM32CubeMX 生成工程，先解决 PWM 和 ADC 同步
3.1 时钟与外设配置
工程基于 STM32CubeMX 和 HAL 库生成，时钟配置为 HSE 外部晶振或 HSI 内部时钟。F103 的 ADC 最高支持 14 MHz 时钟，而 APB2 总线是 72 MHz，所以 ADC 预分频至少要除以 6。PWM 频率建议设置在 10 kHz 到 20 kHz 之间，太低会有噪音，太高会受限于定时器分辨率和 MOSFET 开关损耗。
在 CubeMX 中需要开启的外设如下：
- RCC：外部晶振或者内部时钟，根据板子跳线决定。
- TIM1：选择 PWM Generation CH1/CH2/CH3，并启用 CH1N/CH2N/CH3N 互补输出。
- ADC1：开启两个通道，扫描模式或注入模式。
- USART2：异步串口，波特率 115200。
- GPIO：霍尔输入引脚配置为输入模式，可以开启上拉。
时钟树建议保持 72 MHz 主频，APB1 36 MHz，APB2 72 MHz。TIM1 挂在 APB2 上，ADC1 也挂在 APB2 上。
3.2 TIM1 中心对齐 PWM 配置
电机控制中，TIM1 通常配置为中心对齐模式，也就是计数从 0 加到 ARR，再从 ARR 减到 0。这样 PWM 波形关于周期中心对称，电流纹波更小，而且中心点对应计数最大值或最小值时刻，正好适合 ADC 采样。
TIM_OC_InitTypeDef sConfigOC = {0}; sConfigOC.OCMode = TIM_OCMODE_PWM1; sConfigOC.Pulse = 0; sConfigOC.OCPolarity = TIM_OCPOLARITY_HIGH; sConfigOC.OCNPolarity = TIM_OCNPOLARITY_HIGH; sConfigOC.OCFastMode = TIM_OCFAST_DISABLE; sConfigOC.IdleState = TIM_OCIDLESTATE_RESET; sConfigOC.OCNIdleState = TIM_OCNIDLESTATE_RESET; HAL_TIM_PWM_ConfigChannel(&htim1, &sConfigOC, TIM_CHANNEL_1); HAL_TIM_PWM_ConfigChannel(&htim1, &sConfigOC, TIM_CHANNEL_2); HAL_TIM_PWM_ConfigChannel(&htim1, &sConfigOC, TIM_CHANNEL_3); HAL_TIM_PWM_Start(&htim1, TIM_CHANNEL_1); HAL_TIM_PWM_Start(&htim1, TIM_CHANNEL_2); HAL_TIM_PWM_Start(&htim1, TIM_CHANNEL_3); HAL_TIMEx_PWMN_Start(&htim1, TIM_CHANNEL_1); HAL_TIMEx_PWMN_Start(&htim1, TIM_CHANNEL_2); HAL_TIMEx_PWMN_Start(&htim1, TIM_CHANNEL_3);这段代码里有两个关键点。第一个是互补输出必须使用HAL_TIMEx_PWMN_Start，只启动普通 PWM 函数不会输出下管波形。第二个是OCMode选择TIM_OCMODE_PWM1后，在中心对齐模式下计数向上时比较值控制输出翻转，具体输出电平由极性决定。死区时间在HAL_TIMEx_ConfigBreakDeadTime中配置，全桥电路的死区不可以省略，否则上下管直通会烧 MOSFET。
3.3 用 TIM1 TRGO 触发 ADC，采样点要对齐
相电流采样必须发生在 PWM 周期的确定时刻。因为电流采样电阻上的电压只在特定开关状态下才能正确反映相电流，比如三电阻采样通常在下管全部导通时读取。使用 TIM1 的 TRGO 触发 ADC，可以让采样时刻自动和 PWM 周期对齐，避免在主循环中随机采样。
HAL_TIMEx_MasterConfigSynchronization(&htim1, TIM_TRGO_UPDATE); ADC_ChannelConfTypeDef sConfig = {0}; sConfig.Channel = ADC_CHANNEL_0; sConfig.Rank = 1; sConfig.SamplingTime = ADC_SAMPLETIME_239CYCLES_5; HAL_ADC_ConfigChannel(&hadc1, &sConfig);配置完成后，需要把 ADC 的触发方式设置为外部触发。F103 的 ADC1 可以响应 TIM1 的 TRGO 信号。选择更新事件作为 TRGO，对应中心对齐模式下的计数值过零时刻。这个时刻三相桥臂开关状态相对确定，适合读取采样电阻电压。
实际项目中还要注意 ADC 采样保持时间。如果采样时间太短，采样电容没有充到稳定值，换算出的电流会偏小或抖动。F103 的采样时间最多可配置到 239.5 个 ADC 时钟周期，以 12 MHz ADC 时钟计算大约是 20 微秒，对 10 kHz 的 PWM 周期来说足够用。
3.4 工程目录与代码分层
即使是一个学习项目，也应该把代码分成几个文件，否则 PWM、ADC、控制算法混在 main.c 里，后面根本没法排查。推荐目录结构如下：
Core/ Inc/ main.h foc_ctrl.h hall.h current_sense.h Src/ main.c foc_ctrl.c hall.c current_sense.c Drivers/ STM32F1xx_HAL_Driver/分层原则是：main.c 只负责初始化和周期循环，foc_ctrl.c 存放极坐标 FOC 算法，hall.c 读取霍尔并估算角度，current_sense.c 处理 ADC 数据并转换成电流值。这样后续把霍尔方案换成无感方案时，只需要替换 hall.c 或新增观测器文件，不需要重写控制主框架。
4. 极坐标 FOC 控制器的核心算法与代码
4.1 角度来源：霍尔估算与开环启动
极坐标 FOC 的角度信息决定电压矢量应该指向哪里。最简单的做法是使用霍尔传感器。洗衣机电机通常带有三个霍尔，在一个电角度周期内会输出 6 种组合，每个区间占 60 度。霍尔信号变化时，就可以确定转子磁极所在的扇区。
#define HALL_ANGLE_TABLE 6 const uint16_t hall_angle[6] = { 0, // 霍尔组合 1 1024, // 60 度，对应 1024/4096 * 360 2048, // 120 度 3072, // 180 度 4096, // 240 度 5120 // 300 度 };这里使用 12 位查表角度，0 到 4095 对应 0 到 360 度，避免全程使用浮点三角函数。霍尔换相只能提供 60 度分辨率，直接使用会造成明显转矩脉动。改进方法是在两次霍尔跳变之间，用定时器测量时间并线性插值角度，代码里再对角度做低通滤波和限幅。
启动阶段角度不可靠时，可以先采用开环启动：不依赖电流反馈，直接给一个固定幅值的电压矢量，让角度从 0 开始以斜坡方式增加，把转子拖到同步转速后，再切换成霍尔反馈的闭环运行。这是一个非常实用的学习技巧，能够避开“没有角度反馈就转不起来”的死循环。
4.2 三相电流采样与重构
FOC 至少要拿到两相电流。第三相可以通过三相电流之和为零计算得到：
float ia = current_sense_get_phase_a(); float ib = current_sense_get_phase_b(); float ic = -(ia + ib);ADC 读到的原始值是采样电阻上的电压，需要先换算成电流。换算公式是：电流 = 电压 / 采样电阻阻值，电压 = ADC 原始值 / 4095 * 参考电压。如果采样信号经过运放放大，还要除以放大倍数。采样电阻阻值和运放增益必须和硬件原理图一致，这一步骤也是电流环参数整定的基础。
电流采样最常见的坑是 ADC 转换结果出现明显的偏移和毛刺。偏移来自运放零漂和采样时刻选择不正确，毛刺来自开关噪声。软件上可以加滑动平均滤波或一阶低通滤波，但更有效的办法是调整采样时刻，避开开关管刚动作的瞬态噪声。
4.3 电压矢量用极坐标生成
得到转子角度 theta 后，控制器的任务变成：根据转速误差计算电压幅值 amplitude，根据电流角度误差修正电压角度，然后生成三相占空比。
极坐标输出与传统 SVPWM 的差异就在这里。传统方案要通过扇区判断和矢量分解计算占空比，而极坐标方案可以预先制作一张正弦表，根据期望电压矢量的电角度直接查表得到三相分量。
uint16_t sin_table[256]; void foc_generate_voltage(uint16_t angle_12bit, uint16_t amplitude, uint16_t *duty_a, uint16_t *duty_b, uint16_t *duty_c) { uint16_t angle_idx = angle_12bit >> 4; int32_t sin_a = sin_table[angle_idx]; int32_t sin_b = sin_table[(angle_idx + 85) & 0xFF]; int32_t sin_c = sin_table[(angle_idx + 171) & 0xFF]; *duty_a = (uint16_t)(TIM1_ARR / 2 + (int32_t)amplitude * sin_a / 1024); *duty_b = (uint16_t)(TIM1_ARR / 2 + (int32_t)amplitude * sin_b / 1024); *duty_c = (uint16_t)(TIM1_ARR / 2 + (int32_t)amplitude * sin_c / 1024); }这段代码的核心是给三个 PWM 通道同时叠加一个直流中点和三相互差 120 度的正弦分量。amplitude 是电压幅值，决定力矩大小；angle_12bit 是转子的电气角度，决定磁场方向。使用查表而不是调用 sin 库函数，是因为 F103 的软件浮点运算能力有限，在 10 kHz 中断里反复调用三角函数会占用大量 CPU 时间。
中点偏置值是TIM1_ARR / 2，如果 ARR 是 7200，那么占空比围绕 3600 上下变化，最大不超过 7200。amplitude 上限需要留出死区时间和电压裕量，不能达到理论最大值，否则 PWM 波形畸变，电流会出现明显毛刺。
4.4 主循环与中断框架
控制环必须在定时中断中执行，不能在 main 循环中延时等待。常用方案是用 TIM1 更新事件触发 ADC，再由 ADC 转换完成中断启动控制算法。这样 PWM、电流采样、角度更新和控制计算全部对齐，不会互相干扰。
void HAL_ADC_ConvCpltCallback(ADC_HandleTypeDef *hadc) { if (hadc->Instance == ADC1) { foc_current_sample(); foc_angle_update(); foc_control_loop(); } } int main(void) { HAL_Init(); SystemClock_Config(); MX_GPIO_Init(); MX_TIM1_Init(); MX_ADC1_Init(); MX_USART2_Init(); foc_init(); HAL_ADC_Start_DMA(&hadc1, (uint32_t *)adc_buf, 2); HAL_TIM_PWM_Start(&htim1, TIM_CHANNEL_1); HAL_TIM_PWM_Start(&htim1, TIM_CHANNEL_2); HAL_TIM_PWM_Start(&htim1, TIM_CHANNEL_3); while (1) { foc_uart_report(10); // 每 10 个周期打印一次调试信息 HAL_Delay(1); } }注意 HAL_ADC_ConvCpltCallback 里的代码要保持精简。PI 计算、查表、占空比装载都应该避免使用阻塞延时和调试打印，串口打印放在 main 循环里低频执行。中断里不要调用HAL_UART_Transmit这种阻塞接口，否则会严重影响控制环周期。
5. 运行调试：先让电机转起来，再谈精度
5.1 调试顺序要分四步走
第一步，烧写程序后不接电机，用示波器看 PWM 波形。重点确认通道 1 和通道 1N 之间没有同时导通，死区时间存在。
第二步，接入霍尔信号，在低速手动旋转电机，通过串口观察霍尔组合值和估算角度是否平滑变化。这一步能排除霍尔接线错误。
第三步，开环运行。设置一个较小的固定电压幅值和斜坡角度，电机如果接线正常，应该会开始缓慢旋转。这一步先确认相序，不要运行在闭环状态。
第四步，闭环运行。霍尔角度稳定后，加入电流环和速度环，逐渐加大目标转速，观察电流波形和转速波动。
| 调试阶段 | 目标 | 关注信号 | 通过标准 |
|---|---|---|---|
| PWM 输出检查 | 确认死区和极性 | 六路 PWM 波形 | 无上下管同通 |
| 角度检查 | 确认霍尔接线 | 霍尔组合、估算角度 | 角度平滑变化 |
| 开环启动 | 确认相序 | 电机转向和声音 | 转向一致、无啸叫 |
| 闭环带载 | 验证控制环 | 电流、转速、PI 输出 | 电流平稳、转速稳定 |
5.2 串口观测量与启动参数
调试阶段建议在串口输出以下数据：
- 霍尔角度原始值
- 经过插值和滤波后的电气角度
- 三相电流中的两相值
- 电压幅值和角度修正量
- 目标转速和当前估算转速
- 错误标志位
每 10 到 20 个控制周期输出一次即可，频率太高会占用大量时间。数据格式可以简单采用逗号分隔值，方便用串口助手或 Python 脚本保存后绘图。
首次启动参数建议如下：PWM 频率 10 kHz，开环电压幅值初始为最大值的 15%，角度斜坡速度对应 1 Hz 到 5 Hz 电频率。如果电机抖动，优先减小电压幅值而不是加大 PI 参数。很多初学者一看到电机不动就猛加比例系数，结果导致过流和 MOS 管烧毁。
5.3 调参顺序：先电流环，再速度环
极坐标 FOC 同样有电流环和速度环的分层。由于极坐标形式下电流反馈是幅值和角度，调参顺序要跟着控制结构走。
先调电流幅值环。让电机在开环状态下用恒定角度旋转，给定固定电流幅值目标，观察采样电流是否和给定值接近，响应是否快速，超调是否严重。调节时先加大比例系数 P，如果出现高频抖动，说明 P 过大；再加入积分 I，用来消除稳态误差。
再调角度修正环。霍尔插值角度在轻载和低速时误差不大，高速和带载时实际磁场滞后会变大。角度修正环的输出限制在正负 15 度以内，不要给太大权限，否则系统会进入正反馈，表现为转速越高电流越大、电机啸叫。
最后速度环放在最外层，输出作为电流幅值环的给定。速度环的 PI 参数不要一次给太激进，每次修改后都要观察电流波形是否超限。
5.4 正常现象和异常现象对比
| 现象 | 判断 | 下一步动作 |
|---|---|---|
| 电机静止时有轻微嗡声但不转 | 可能是开环电压太小或角度反向 | 加大电压幅值，或交换三相线 |
| 电机转起来但声音很尖 | PWM 频率太低或死区设置不对 | 提高 PWM 频率，重查死区 |
| 转速不稳定，电流周期性跳动 | 霍尔角度不准确或电流采样毛刺大 | 查霍尔接线，调整采样时刻 |
| 电机发热严重 | 电流偏大或电压矢量角度偏 | 查相序，减小电流环目标 |
| 高速时突然堵转 | 角度修正环正反馈 | 限制角度修正范围，检查霍尔插值 |
6. 常见问题排查：从烧功率管到转速抖动
6.1 上电无反应、电源异常
现象是最小系统板指示灯亮，但驱动板没有输出，或者一上电就复位。
先检查控制板和驱动板是否共地。这是最容易被忽略的问题，信号地不共，PWM 电平没有参考点，驱动芯片可能一直处在上管导通状态。
再用万用表测驱动板逻辑电源。驱动芯片的 VDD 和 MCU 的 3.3V 不能直接并联在同一个低压差稳压器上，电机启动瞬间的电流会拉低电压，导致 MCU 复位。建议分开供电，只让两个电源的地相连。
6.2 电机不转、有嗡嗡声、堵转
嗡嗡声说明 PWM 有输出，电机也通电了，但合成磁场方向和转子位置不对，转子被卡在某个固定位置振荡。
可能是相序不对，比如三相线接反了。排查方法是保持霍尔不动，交换任意两相电机线，观察是否改善。
可能是电压幅值太小。转子从静止到同步需要克服静摩擦和齿槽转矩，开环电压幅值至少要达到让电机能自行启动的程度。
也可能是角度方向错误。霍尔组合对应的角度表写反了，电机磁场方向总是拉转子往错误方向走。此时可以用串口打印的角度推算，手动旋转电机时角度应该上升，如果下降则交换霍尔接线或者重新分配霍尔角度表。
6.3 电流采样跳变、数值漂移
电流采样跳变会直接影响极坐标 FOC 的幅值控制，通常表现为电机抖动或者用示波器能看到电流波形畸变。
先看 ADC 采样时刻。如果使用普通软件延时触发 ADC，而不是 TIM1 TRGO 触发，采样点可能落在开关管动作瞬间，采样电阻上噪声非常大。建议改为硬件触发。
再看采样时间。F103 ADC 采样时间如果设置为 1.5 周期或 7.5 周期，在采样电容较大时可能采不准。配置为 239.5 周期后观察是否改善。
最后检查运放偏置。如果采样电路是双极性电流，运放输出通常会叠加一个 1.65V 或 2.5V 的偏置电压。软件里要把这个偏置减掉，并且做零电流校准。上电不接电机时记录的 ADC 值作为零偏基准，之后再从这个基准上计算电流。
6.4 角度突变导致反转和过流
霍尔换相天然有 60 度跳变，如果没有插值滤波，角度每次跳变都会让电压矢量瞬间改变方向，电流尖峰很大，严重时会烧管子。
需要在霍尔跳变时重新记录起点角度和定时器时间，在下一个跳变前线性插值。代码里可以这样处理：
uint32_t hall_pulse_time; uint16_t hall_start_angle; uint16_t hall_end_angle; void hall_isr_callback(void) { uint32_t now = TIM2->CNT; uint32_t dt = now - hall_pulse_time; hall_pulse_time = now; hall_start_angle = hall_end_angle; hall_end_angle = hall_angle[hall_read()]; }插值后的角度仍然需要在每个控制周期做限幅。如果霍尔信号本身因为机械安装问题出现毛刺，角度可能突然反向，限幅会避免控制系统把这种毛刺当成真实转向变化。
角度突变还有一种原因是霍尔传感器供电不稳。霍尔通常需要稳定的 5V 或 3.3V 电源，如果霍尔电源和电机功率电源混合走线，大电流切换时霍尔电源跌落，会产生错误换相信号。霍尔电源建议单独滤波，靠近霍尔器件放 0.1uF 去耦电容。
7. 从“手搓”到工程化：开源项目的下一步
7.1 先补齐保护与安全功能
学习项目可以只跑通转速闭环，但开源出去给别人复现，或者用在非实验室环境时，保护功能就必须补上。
最基础的保护包括母线过流保护、母线欠压保护、过温保护和堵转检测。F103 的 ADC 除了采样相电流，还应该留一路采样母线电压，一路采样 NTC 温度。任何一路超过阈值，立即关闭 TIM1 六路 PWM 输出，并进入错误状态。
void foc_fault_check(void) { if (current_peak > CURRENT_LIMIT) { foc_fault_flag |= FAULT_OVERCURRENT; HAL_TIM_PWM_Stop(&htim1, TIM_CHANNEL_1); HAL_TIMEx_PWMN_Stop(&htim1, TIM_CHANNEL_1); // 同样关闭另外两路 } if (foc_fault_flag != 0) { foc_control_enable = 0; } }错误状态需要保持，不能自动恢复。要解除错误，需要明确的外部复位信号，比如按键或串口命令。这样能避免故障现场被覆盖，也方便排查根因。
7.2 学习环境与生产环境的差距
学习环境里用面包板、杜邦线、稳压电源就能跑通，这没问题。但面向生产场景，差距体现在几个方面。
第一是 PCB 布局。采样电阻到运放的走线过长会产生噪声，PWM 信号和采样信号并行走线会引入耦合干扰。开源项目如果只是学习，面包板可以接受；如果要做小批量，需要重新设计驱动板，控制板和功率板分层。
第二是启动策略。学习项目用简单开环斜坡启动就能转起来，但在带载和低温环境中，开环启动可能失败。工程上常用注入高频信号、预定位、闭环逐步切换等策略。
第三是控制性能。极坐标 FOC 的开环启动和简单霍尔插值，在空载风机上够用，但如果带负载突变，动态响应不足。工程上需要完整的闭环 FOC 和无感观测器，或者至少是电流内环闭环运行。
7.3 复现清单：开源项目发布前建议检查
如果要把这个项目发布到开源社区，建议先过一遍以下清单，很多“读者下载代码后跑不起来”的问题都出在细节上。
| 检查项 | 说明 |
|---|---|
| 引脚分配表是否完整 | 每个外设引脚必须和 CubeMX 工程一致 |
| 电机参数是否需要标定 | 至少说明测量相电阻、电感的方法 |
| 死区和 PWM 频率是否明确 | 不同驱动板死区要求不同 |
| 采样电阻阻值和运放增益 | 必须写出换算公式和软件调整位置 |
| 串口输出格式说明 | 需要提供解析方式或绘图脚本 |
| 母线电压适用范围 | 说明哪些情况下会过压或过流 |
| 已知问题和边界条件 | 坦诚写出极坐标方案的限制 |
7.4 可扩展方向：从霍尔极坐标 FOC 走向完整 FOC
这个项目跑通之后，下一步有两条比较自然的方向。
一条是做无感 FOC。把霍尔角度估算换成基于反电动势的滑模观测器或龙伯格观测器，这样就不需要传感器，只用电流采样就能估算转子角度。这会让代码复杂度上一个台阶，但也是目前最常用的低成本电机控制方案。
另一条是优化电流环。极坐标形式下角度修正环只是一个简单比例调节，如果改成完整 Park 变换后的 d/q 轴电流 PI 控制，动态性能会明显提升。此时可以保留现有霍尔角度，只是把控制量从幅值/角度切换成 d/q 电压分量。
对刚接触电机控制的开发者来说，这个极坐标 FOC 项目的最大价值，不是算法有多先进，而是它用最少的数学和最小的系统板，把 PWM 三相桥、电流采样、转子角度、PI 调参这几件事串成了一个完整闭环。真正动手跑过一遍、烧过一次管子、用串口和示波器看过波形，再去看标准 FOC 的资料，理解速度会比直接啃公式快很多。
