3. GD32微控制器入门

在低成本FOC（Field-Oriented Control，磁场定向控制）项目中，微控制器（MCU）是整个系统的“大脑”，负责电流采样、坐标变换、PWM生成、速度环与电流环运算等核心任务。GD32系列作为国产ARM Cortex-M内核MCU的代表，凭借其与STM32高度兼容的引脚定义、丰富的外设资源以及极具竞争力的价格，已成为众多电机控制工程师的首选平台。本章将围绕GD32的选型逻辑、开发环境搭建以及GPIO、定时器、ADC、DAC四大关键外设展开，为后续实现FOC算法打下坚实的硬件与代码基础。

上图展示了GD32在FOC控制系统中的核心位置与信号流向。从电源时钟到PWM输出，再到ADC反馈与DAC调试，每一个环节都依赖对GD32外设的深入理解。下面我们将逐一拆解选型、环境与四大外设的实战要点。

3.1 GD32系列选型：从FOC需求反推芯片配置

核心原理：FOC控制对MCU的资源需求集中在三方面：一是运算能力，电流环频率通常为10-20kHz，每次中断需完成Clarke变换、Park变换、PI调节和SVPWM计算，约需200-400个时钟周期，因此主频最好在72MHz以上，且具备硬件乘法器或FPU（浮点运算单元）；二是定时器资源，至少需要1个高级定时器（带互补PWM输出和死区插入）用于驱动三相全桥，以及1个通用定时器用于ADC采样触发或编码器接口；三是ADC精度与通道数，至少3路模拟输入用于相电流采样，分辨率建议12位，采样时间需与PWM周期同步。

选型判断方法：GD32家族中，GD32F303系列（Cortex-M4，120MHz）和GD32E230系列（Cortex-M23，72MHz）是FOC项目的两大热门。前者适合高性能、多传感器反馈的场合，后者适合成本极敏感、控制逻辑相对简单的场景。具体选型时可参考以下对比表：

3.2 开发环境搭建：从零到点亮第一颗LED

操作流程：GD32的开发环境推荐使用Keil MDK-ARM或IAR Embedded Workbench，配合GD32官方固件库（GD32F30x_Firmware_Library）或HAL库。搭建步骤如下：

1. 安装Keil MDK：从Keil官网下载MDK-Arm，安装时勾选CMSIS组件。
2. 安装GD32设备支持包：在Keil的Pack Installer中搜索“GD32F30x”或“GD32E23x”，点击Install。若网络不畅，可手动下载Pack文件后双击安装。
3. 获取固件库：从GD32官网下载对应系列的固件库压缩包，解压后复制到项目目录。固件库中包含了gd32f30x.h（寄存器定义）、system_gd32f30x.c（系统时钟初始化）以及各外设驱动源文件。
4. 创建工程模板：新建Keil工程，选择对应芯片型号（如GD32F303VET6）。将固件库中的CMSIS、Peripheral源文件添加到工程分组中，并配置Include路径。
5. 配置时钟：在system_gd32f30x.c中，默认使用外部8MHz晶振，通过PLL倍频到120MHz。若使用内部RC振荡器，需修改宏定义__SYSTEM_CLOCK_120M_PLL_8M为对应值。
6. 编写GPIO测试代码：初始化一个LED引脚，实现闪烁效果，验证环境是否正常。

// 以GD32F303为例，点亮PC13引脚上的LED
void gpio_config(void) {
    rcu_periph_clock_enable(RCU_GPIOC);      // 使能GPIOC时钟
    gpio_init(GPIOC, GPIO_MODE_OUT_PP, GPIO_OSPEED_50MHZ, GPIO_PIN_13);
    gpio_bit_reset(GPIOC, GPIO_PIN_13);      // 输出低电平，点亮LED
}
int main(void) {
    systick_config();                        // 配置系统滴答定时器
    gpio_config();
    while(1) {
        gpio_bit_set(GPIOC, GPIO_PIN_13);    // 熄灭
        delay_1ms(500);
        gpio_bit_reset(GPIOC, GPIO_PIN_13);  // 点亮
        delay_1ms(500);
    }
}

3.3 GPIO外设：FOC中的数字信号枢纽

核心原理：GPIO（General Purpose Input/Output）是MCU与外界交互的最基本通道。在FOC系统中，GPIO承担三类任务：控制信号（如使能驱动芯片、继电器通断）、状态指示（如LED显示运行状态、故障报警）、编码器/霍尔接口（通过外部中断或定时器输入捕获读取电机位置）。GD32的GPIO支持多种模式：推挽输出、开漏输出、浮空输入、上拉/下拉输入、复用功能（AFIO）等。

配置要点：FOC项目中，GPIO配置需注意以下三点：

• 驱动能力：若直接驱动LED或光耦，需设置GPIO为推挽输出，并选择合适的翻转速度（2MHz/10MHz/50MHz）。高速翻转（50MHz）会增加EMI，非必要不选用。
• 复用功能映射：当GPIO用作定时器PWM输出或ADC输入时，必须调用gpio_af_set()函数将引脚映射到对应外设。例如PA8可复用为TIMER0_CH0，需设置为GPIO_AF_2。
• 上下拉电阻：用于霍尔传感器或按键输入时，建议使能内部上拉，避免浮空电平导致误触发。

3.4 定时器：FOC的PWM生成与时间基准

核心原理：定时器是FOC控制中最重要的外设。高级定时器（TIMER0/7）可产生6路互补PWM（3对），支持死区插入、刹车功能和重复计数，专为电机驱动设计。通用定时器（TIMER1/2/3等）可用于产生ADC采样触发信号、编码器接口或简单的延时。FOC的电流环中断通常由定时器更新事件触发，确保PWM周期与采样频率严格同步。

配置流程（以TIMER0产生中心对齐PWM为例）：

1. 使能TIMER0时钟和GPIO时钟，配置PA8/PA9/PA10为复用推挽输出（AF2）。
2. 设置TIMER0的预分频值（PSC）和自动重载值（CAR）。例如，APB2时钟为120MHz，PSC=0，CAR=6000，则PWM频率=120MHz/(6000+1)≈20kHz。
3. 配置通道模式为PWM模式1或2，设置比较值（CH0CV）控制占空比。
4. 使能互补输出和死区时间（如1μs），并配置刹车功能（可选）。

// TIMER0 PWM初始化（20kHz，中心对齐，死区1us）
timer_parameter_struct timer_initpara;
timer_initpara.prescaler = 0;
timer_initpara.period = 6000;          // 20kHz
timer_initpara.clockdivision = TIMER_CKDIV_DIV1;
timer_initpara.alignedmode = TIMER_COUNTER_CENTER_ALIGNED; // 中心对齐
timer_initpara.counterdirection = TIMER_COUNTER_UP;
timer_initpara.repetitioncounter = 0;
timer_init(TIMER0, &timer_initpara);
timer_channel_output_config(TIMER0, CH0, TIMER_OC_PWM1, TIMER_OC_PE_DISABLE);
timer_channel_output_pulse_value_config(TIMER0, CH0, 3000); // 50%占空比
timer_channel_output_mode_config(TIMER0, CH0, TIMER_OC_MODE_PWM1);
timer_channel_output_shadow_config(TIMER0, CH0, TIMER_OC_SHADOW_ENABLE);
timer_break_config(TIMER0, TIMER_BREAK_DISABLE, TIMER_BREAK_POLARITY_HIGH, 1000); // 死区1us
timer_auto_reload_shadow_enable(TIMER0);
timer_enable(TIMER0);

3.5 ADC与DAC：电流采样的精度与调试手段

核心原理：FOC的电流环性能直接取决于ADC采样精度。GD32的12位ADC支持规则组和注入组，可配置为软件触发、定时器触发或外部引脚触发。在FOC中，通常使用定时器更新事件或通道比较事件触发ADC采样，确保在PWM周期的特定时刻（如中心对齐计数的下溢点）采集相电流，此时电流纹波最小。DAC则常用于输出模拟量，例如将速度环的给定电压输出到示波器，或作为外部电路的参考电压。

采样配置要点：

• 采样时间：GD32 ADC的采样时间可配置为1.2μs~239.5μs。对于电机电流采样，建议采样时间≥7.5个ADC时钟周期，以保证内部采样电容充分充电。
• 多通道顺序采样：若使用3路电流采样，需配置ADC扫描模式，并设置通道顺序。为避免通道间串扰，可在两次采样之间插入短延时。
• 参考电压：ADC参考电压通常为VREF+（3.3V），若需更高精度，可外接精密基准源（如2.5V）。

案例拆解：某项目中，我们使用GD32F303的ADC0的通道0、1、2分别采样U、V、W三相电流。采样电阻为0.01Ω，放大倍数为20倍，则满量程电流=3.3V/(0.01Ω×20)=16.5A。实际调试中发现，当电机转速升高时，电流波形出现明显毛刺。经排查，原因是ADC采样时刻恰好落在PWM开关边沿附近，导致开关噪声耦合到模拟输入。解决方案是将定时器触发ADC的相位提前约2μs，避开开关瞬态。修改后，电流波形明显平滑，FOC运行噪声降低。

3.6 常见误区与复盘

误区一：忽视时钟树配置。GD32的APB1/APB2总线时钟频率不同，定时器挂载在APB2上时，其时钟频率可能高达120MHz，而APB1上的定时器最高60MHz。若未正确配置预分频，PWM频率会偏离预期。建议在初始化外设前，先打印或调试查看rcu_clock_freq_get()返回值。

误区二：ADC采样时间不足。当ADC输入阻抗较高（如运放输出串联1kΩ电阻）时，采样时间过短会导致采样值偏低。此时应增加采样时间，或在引脚对地并联10nF电容，但需注意电容过大会影响信号带宽。

误区三：GPIO复用功能配置遗漏。许多初学者只初始化了GPIO模式，却忘记调用gpio_af_set()，导致PWM或ADC功能无法工作。检查代码时，务必确认每个复用引脚都正确映射。

复盘：在完成本章学习后，建议读者动手搭建一个最小系统板，依次实现LED闪烁、PWM呼吸灯、ADC读取电位器电压、DAC输出正弦波四个练习。这四项技能覆盖了FOC项目中的大部分外设操作。下一阶段，我们将基于这些外设，开始编写FOC的核心算法——电流采样与坐标变换。