蓝桥杯CT117E-M4平台ADC实战：从CubeMX配置到LCD电压显示（STM32G431RBT6）

蓝桥杯CT117E-M4平台ADC实战：从CubeMX配置到LCD电压显示（STM32G431RBT6）

在嵌入式竞赛中，ADC（模数转换器）的应用往往是区分选手水平的关键技能点之一。对于使用蓝桥杯CT117E-M4开发板的参赛者而言，如何快速实现一个稳定可靠的电压监测系统，不仅关系到比赛成绩，更是嵌入式开发基本功的体现。本文将从一个真实的竞赛场景出发，带你完整走通从CubeMX配置到LCD显示的ADC开发全流程，其中包含多个在官方文档中不会提及的实战技巧。

1. 硬件平台与任务拆解

CT117E-M4开发板搭载的STM32G431RBT6微控制器，其ADC模块具有16位硬件过采样能力，但在竞赛环境中我们通常采用12位分辨率以获得更好的响应速度。板上R37和R38两个电位器分别连接PB15(ADC2_IN15)和PB12(ADC1_IN11)，这构成了我们的电压采样硬件基础。

关键硬件参数速查表：

实际开发中容易忽略的三个硬件细节：

1. 电位器旋钮的物理行程与ADC值并非线性对应
2. 开发板供电质量会直接影响ADC基准电压稳定性
3. 未使用的ADC通道应配置为模拟输入以减少噪声

2. CubeMX工程配置实战

打开CubeMX新建工程时，务必选择正确的芯片型号STM32G431RBT6。在Pinout视图中找到PB12和PB15引脚，将其配置为ADC1_IN11和ADC2_IN15。此时大多数人会直接进入ADC参数配置，但竞赛老手通常会先做这两步：

// 在main.c的MX_ADC1_Init()中添加校准代码 if (HAL_ADCEx_Calibration_Start(&hadc1, ADC_SINGLE_ENDED) != HAL_OK) { Error_Handler(); }

ADC1配置参数详解：

• Resolution: 12 bits
• Data Alignment: Right alignment
• Scan Conversion Mode: Disabled
• Continuous Conversion Mode: Enabled
• Discontinuous Conversion Mode: Disabled
• DMA Continuous Requests: Disabled
• End Of Conversion Selection: EOC flag at the end of single conversion

注意：竞赛环境下建议关闭DMA以降低调试复杂度，实际产品开发中则应启用

时钟树配置有个隐藏技巧：将ADC时钟设为系统时钟的1/4（当系统时钟为170MHz时，设为42.5MHz），这样可以在转换速度和精度间取得最佳平衡。

3. HAL库编程与数据处理

官方例程中的ADC读取函数往往过于简单，无法应对竞赛中的异常情况。下面这个增强版getADC函数加入了多重保护：

#define ADC_MAX_RETRY 3 float getStableADC(ADC_HandleTypeDef* hadc) { uint32_t rawValue = 0; uint8_t retry = 0; while(retry < ADC_MAX_RETRY) { if(HAL_ADC_Start(hadc) != HAL_OK) continue; if(HAL_ADC_PollForConversion(hadc, 10) != HAL_OK) { HAL_ADC_Stop(hadc); continue; } uint32_t currentValue = HAL_ADC_GetValue(hadc); if(abs(currentValue - rawValue) < 20 || retry == 0) { rawValue = currentValue; } HAL_ADC_Stop(hadc); retry++; } return (rawValue * 3.3f) / 4095.0f; }

电压显示处理中有几个常见陷阱：

1. 直接使用(value * 3300)/4096会导致整数运算截断误差
2. 频繁调用sprintf会影响系统实时性
3. LCD刷新率过高会导致显示闪烁

优化后的显示方案：

void updateVoltageDisplay(float voltage) { static char buffer[16]; static uint32_t lastUpdate = 0; if(HAL_GetTick() - lastUpdate > 100) { // 100ms刷新周期 snprintf(buffer, sizeof(buffer), "Volt:%.3fV", voltage); LCD_DisplayStringLine(LINE8, (uint8_t*)buffer); lastUpdate = HAL_GetTick(); } }

4. 竞赛调试技巧与性能优化

在紧张的比赛环境中，ADC调试需要特殊策略。建议在初期开发时添加以下调试代码：

#ifdef DEBUG_ADC printf("[ADC] Raw=%d, Voltage=%.3fV\r\n", rawValue, voltage); #endif

常见问题排查表：

高级技巧：利用STM32G4的硬件过采样功能，可以在不增加软件复杂度的情况下提升有效分辨率：

hadc1.Init.Oversampling.Ratio = ADC_OVERSAMPLING_RATIO_16; hadc1.Init.Oversampling.Shift = ADC_OVERSAMPLING_SHIFT_4; hadc1.Init.Oversampling.Trigger = ADC_OVERSAMPLING_TRIGGER_REG;

5. 完整项目集成与实战演练

将各个模块组合成完整项目时，推荐采用以下架构：

main.c ├── 系统时钟配置 ├── 外设初始化 │ ├── LCD_Init() │ └── ADC_Init() └── 主循环 ├── 读取ADC值 ├── 数据处理滤波 └── LCD显示更新

一个经过实战检验的main循环结构：

while(1) { static uint32_t adcSampleTime = 0; if(HAL_GetTick() - adcSampleTime > 20) { // 50Hz采样率 float voltage = getStableADC(&hadc1); applyLowPassFilter(&voltage); // 软件滤波 updateVoltageDisplay(voltage); adcSampleTime = HAL_GetTick(); } // 其他任务处理 HAL_Delay(1); }

在最后的竞赛准备阶段，建议预先准备好这些测试用例：

1. 极限值测试（0V和3.3V输入）
2. 快速旋转变压器测试响应速度
3. 同时运行其他外设时的ADC性能测试
4. 长时间运行稳定性测试