2、GD32微控制器基础：GD32系列选型、开发环境搭建、GPIO与定时器基本操作

GD32系列微控制器作为国产ARM Cortex-M内核MCU的代表，凭借其出色的性价比、丰富的外设资源以及与STM32高度兼容的引脚定义，已成为边缘告警系统、工业控制、物联网终端等场景的主流选择。在构建“传感器异常检测、本地判断逻辑、通信上报”的完整链路时，GD32承担着数据采集、实时运算与协议封装的核心角色。本章将围绕GD32的选型策略、开发环境搭建、GPIO与定时器的底层操作展开，为后续实现边缘告警算法与通信协议栈打下坚实的工程基础。

2.1 GD32系列选型：从边缘告警需求出发

GD32系列产品线覆盖从入门级到高性能的多个子系列，包括GD32E230（Cortex-M23）、GD32F103（Cortex-M3）、GD32F303（Cortex-M4）、GD32F450（Cortex-M4带以太网MAC）等。对于边缘告警系统而言，选型不能简单追求高主频或大Flash，而应围绕“传感器接口匹配、实时判断能力、通信外设资源、功耗约束”四个维度进行权衡。

在边缘告警系统中，推荐优先考虑GD32F303系列。其Cortex-M4内核支持硬件浮点运算单元（FPU），当传感器输出为模拟电压信号需要做滑动平均滤波或标准差计算时，FPU能将运算时间缩短约40%。此外，GD32F303的定时器支持互补PWM输出和编码器接口，若告警系统需要驱动蜂鸣器产生不同频率的报警音，或需要读取旋转编码器判断阀门位置，该系列能提供充足的外设映射灵活性。

2.2 开发环境搭建：从零到可调试工程

GD32的开发环境搭建遵循“固件库+IDE+调试器”三件套模式。官方提供GD32 Firmware Library（包含标准外设库和例程），IDE可选择Keil MDK、IAR EWARM或基于Eclipse的GCC工具链。对于边缘告警项目，推荐使用Keil MDK + J-Link的组合，因为其调试界面直观，且支持实时变量监视和定时器寄存器查看。

1. 获取固件库：从GigaDevice官网下载GD32F30x_Firmware_Library，解压后确认目录结构包含Firmware（核心库）、Example（外设例程）、Utilities（板级支持包）。
2. 创建工程模板：在Keil中新建项目，选择对应芯片型号（如GD32F303VCT6），将固件库中的启动文件、系统初始化文件（system_gd32f30x.c）和核心外设源文件添加至工程。
3. 配置时钟树：GD32F303默认使用内部8MHz RC振荡器，通过PLL倍频至120MHz。在system_gd32f30x.c中修改宏定义__SYSTEM_CLOCK_120M_PLL_8M，确保系统时钟稳定。
4. 配置调试器：在Keil的Options for Target中选择J-Link，勾选Reset and Run，SWD接口速度建议设为4MHz，避免因线缆过长导致下载失败。
5. 验证点灯程序：编写GPIO翻转程序，通过示波器测量引脚输出频率，确认时钟配置正确。

// 系统时钟初始化示例（GD32F303，外部8MHz晶振，PLL倍频至120MHz）
void system_clock_config(void) {
    /* 使能外部高速晶振 */
    RCU_OSC_ON(RCU_OSC_HXTAL);
    while(RCU_OSC_STB_GET(RCU_OSC_HXTAL) != SET);
    
    /* 配置PLL：8MHz * 30 / 2 = 120MHz */
    RCU_PLL_Config(RCU_PLLSRC_HXTAL_IRC48M, RCU_PLL_MUL30);
    RCU_OSC_ON(RCU_OSC_PLL);
    while(RCU_OSC_STB_GET(RCU_OSC_PLL) != SET);
    
    /* 切换系统时钟至PLL */
    RCU_SYSCLK_SRC_SET(RCU_SYSCLKSRC_PLL);
    while(RCU_SYSCLK_SRC_GET() != RCU_SCSS_PLL);
}

2.3 GPIO基本操作：从点亮LED到按键消抖

GPIO（通用输入输出）是边缘告警系统与物理世界交互的最基本通道。在GD32中，GPIO操作遵循“时钟使能→模式配置→电平读写”三步法。每个GPIO端口有7个32位配置寄存器，包括CTL（控制）、OMODE（输出模式）、OSPD（输出速度）、PUD（上下拉）、ISTAT（输入状态）、OCTL（输出控制）和LOCK（锁定）。

对于告警系统中的LED指示灯，应配置为推挽输出模式，驱动能力可达±25mA；对于外部传感器数字信号输入（如红外对射传感器的报警输出），应配置为上拉输入模式，并开启施密特触发器触发以增强抗干扰能力。按键输入则需要结合定时器实现软件消抖，避免机械抖动导致的误触发。

// GPIO初始化示例：PA1接LED（推挽输出），PA2接按键（上拉输入）
void gpio_config(void) {
    /* 使能GPIOA时钟 */
    rcu_periph_clock_enable(RCU_GPIOA);
    
    /* PA1推挽输出，50MHz速度 */
    gpio_mode_set(GPIOA, GPIO_MODE_OUTPUT, GPIO_PUPD_NONE, GPIO_PIN_1);
    gpio_output_options_set(GPIOA, GPIO_OTYPE_PP, GPIO_OSPEED_50MHZ, GPIO_PIN_1);
    
    /* PA2上拉输入 */
    gpio_mode_set(GPIOA, GPIO_MODE_INPUT, GPIO_PUPD_PULLUP, GPIO_PIN_2);
}

// 按键消抖检测（配合定时器10ms中断调用）
uint8_t key_scan(void) {
    static uint8_t key_buf = 0xFF;
    uint8_t current = gpio_input_bit_get(GPIOA, GPIO_PIN_2) ? 1 : 0;
    key_buf = (key_buf << 1) | current;
    if((key_buf & 0x07) == 0x00) return 1;  // 连续3次读到低电平，确认按下
    if((key_buf & 0x07) == 0x07) return 0;  // 连续3次读到高电平，确认释放
    return 0xFF;  // 抖动中
}

2.4 定时器基本操作：PWM输出与输入捕获

GD32F303的定时器资源丰富，包括2个高级定时器（TIMER0、TIMER7）、4个通用定时器（TIMER1、TIMER2、TIMER3、TIMER4）和2个基本定时器（TIMER5、TIMER6）。在边缘告警系统中，定时器主要承担两类任务：一是产生PWM波形驱动蜂鸣器或LED调光；二是通过输入捕获模式测量传感器脉冲信号的频率或脉宽。

以TIMER1为例，其时钟源来自APB2总线（默认120MHz），通过预分频器（PSC）和自动重载寄存器（CAR）设定PWM频率。若需产生1kHz的PWM信号，可设置PSC=119（分频后1MHz），CAR=999（周期1ms），占空比由通道比较寄存器（CHxCV）控制。对于输入捕获，需将GPIO配置为复用功能，并设置捕获边沿（上升沿/下降沿），通过连续两次捕获的计数值差值计算信号周期。

// TIMER1 PWM输出配置：PA8输出1kHz，50%占空比
void timer_pwm_config(void) {
    /* 使能TIMER1和GPIOA时钟 */
    rcu_periph_clock_enable(RCU_TIMER1);
    rcu_periph_clock_enable(RCU_GPIOA);
    
    /* PA8复用为TIMER1_CH0 */
    gpio_af_set(GPIOA, GPIO_AF_2, GPIO_PIN_8);
    gpio_mode_set(GPIOA, GPIO_MODE_AF, GPIO_PUPD_NONE, GPIO_PIN_8);
    gpio_output_options_set(GPIOA, GPIO_OTYPE_PP, GPIO_OSPEED_50MHZ, GPIO_PIN_8);
    
    /* 定时器配置 */
    timer_deinit(TIMER1);
    timer_prescaler_config(TIMER1, 119, TIMER_PSC_RELOAD_NOW);  // 1MHz计数
    timer_autoreload_value_set(TIMER1, 999);                     // 1kHz周期
    timer_channel_output_mode_config(TIMER1, TIMER_CH_0, TIMER_OC_MODE_PWM0);
    timer_channel_output_pulse_value_set(TIMER1, TIMER_CH_0, 500); // 50%占空比
    timer_channel_output_state_config(TIMER1, TIMER_CH_0, TIMER_CCX_ENABLE);
    timer_enable(TIMER1);
}

// 输入捕获测量脉冲宽度（TIMER2_CH0，PA0）
void timer_input_capture_config(void) {
    rcu_periph_clock_enable(RCU_TIMER2);
    rcu_periph_clock_enable(RCU_GPIOA);
    
    gpio_af_set(GPIOA, GPIO_AF_2, GPIO_PIN_0);
    gpio_mode_set(GPIOA, GPIO_MODE_AF, GPIO_PUPD_NONE, GPIO_PIN_0);
    
    timer_deinit(TIMER2);
    timer_prescaler_config(TIMER2, 119, TIMER_PSC_RELOAD_NOW);  // 1MHz计数
    timer_autoreload_value_set(TIMER2, 0xFFFF);
    timer_input_capture_config(TIMER2, TIMER_CH_0, TIMER_IC_POLARITY_RISING, TIMER_IC_SELECTION_DIRECTTI);
    timer_input_capture_enable(TIMER2, TIMER_CH_0);
    timer_enable(TIMER2);
}

2.5 实战案例：基于GD32F303的多传感器告警节点

某数据中心机房需要部署温度异常告警节点，要求实时监测IT机柜进风温度，当温度超过设定阈值（如35℃）时，本地LED闪烁报警，同时通过UART将告警帧上报至监控主机。系统约束：传感器为模拟电压输出型（0~3.3V对应-20℃~80℃），采样周期100ms，告警响应时间不超过200ms。

硬件连接：温度传感器输出接PA1（ADC通道1），LED接PB0（推挽输出），UART1_TX/PA9接RS485收发器。使用TIMER5产生1kHz时基中断，每100ms触发一次ADC采样和阈值判断。

软件实现：ADC配置为软件触发模式，采样值通过DMA搬运至内存变量。定时器中断中执行滑动平均滤波（窗口大小5），将滤波后的温度值与阈值比较。若超阈值，置位告警标志，主循环中翻转LED并发送告警帧。

// 定时器中断回调（100ms周期）
void TIMER5_IRQHandler(void) {
    if(timer_interrupt_flag_get(TIMER5, TIMER_INT_FLAG_UP)) {
        timer_interrupt_flag_clear(TIMER5, TIMER_INT_FLAG_UP);
        adc_software_trigger_enable(ADC0, ADC_CHANNEL_1);  // 触发采样
        if(adc_flag_get(ADC0, ADC_FLAG_END)) {
            uint16_t raw = adc_regular_data_read(ADC0);
            temp_buf[filter_idx] = (float)raw * 100.0f / 4095.0f - 20.0f;  // 转换为℃
            filter_idx = (filter_idx + 1) % 5;
            // 计算滑动平均
            float sum = 0;
            for(int i=0; i<5; i++) sum += temp_buf[i];
            current_temp = sum / 5.0f;
            if(current_temp > 35.0f) alarm_flag = 1;
            else alarm_flag = 0;
        }
    }
}

测试结果：使用信号发生器模拟传感器输出，在25℃（1.03V）和40℃（1.65V）之间跳变，实测告警响应时间为150ms（满足200ms要求），UART上报帧格式为0xAA 0x55 0x01 0x28 0x00 0x7F（帧头+类型+温度值+校验）。在连续运行72小时测试中，未出现误告警或漏告警。

2.6 常见误区与总结复盘

在GD32开发过程中，工程师常陷入以下误区：一是盲目照搬STM32的寄存器配置代码，忽略了两者在GPIO复用映射、定时器时钟源选择上的差异；二是忽视电源去耦和时钟稳定性，导致系统在强干扰环境下频繁复位；三是将定时器中断当作“万能工具”，在中断中执行耗时操作，破坏了实时性。

正确的做法是：首先，建立“芯片数据手册+参考手册+固件库例程”三位一体的查阅习惯，任何外设配置前先确认时钟使能、引脚复用和中断向量三个关键点。其次，在PCB设计阶段就规划好电源树和地平面，模拟地与数字地单点连接。最后，合理划分任务优先级：定时器中断只做时间敏感操作（如采样触发、标志置位），通信协议解析和告警逻辑放在主循环或低优先级任务中。

掌握GD32的基础操作后，下一阶段将进入传感器数据采集与信号调理的深入讨论，届时将利用本章的GPIO和定时器配置，实现更复杂的边缘判断逻辑。