用STM32G0和SH1106 OLED做个PD双向快充状态显示器（附完整代码）

STM32G0与SH1106 OLED打造PD快充状态显示器的实战指南

在嵌入式开发领域，能够实时监控电源状态是许多硬件爱好者的共同需求。本文将详细介绍如何利用STM32G0微控制器和SH1106驱动的OLED显示屏，构建一个功能完善、界面直观的USB PD快充状态显示器。这个项目不仅适用于日常电子设备充电监控，更是电源调试和硬件开发的实用工具。

1. 硬件选型与系统架构设计

1.1 核心组件选择

构建PD快充状态显示器的关键在于选择合适的硬件组件。以下是经过验证的硬件组合：

• 主控芯片：STM32G0系列微控制器，特别是STM32G071RB，具备以下优势：

  • 内置USB PD PHY，直接支持Type-C接口
  • 运行频率达64MHz，满足实时数据处理需求
  • 丰富的外设接口（I2C、SPI、ADC等）

• 显示模块：1.3英寸SH1106驱动OLED显示屏，特点包括：

  • 128×64分辨率，足够显示多参数信息
  • I2C接口，仅需4线连接（VCC、GND、SCL、SDA）
  • 低功耗，适合便携式应用

• 电源管理：根据项目需求选择支持USB PD协议的电源管理IC，如TPS65988等。

1.2 系统架构设计

整个系统的数据流和工作原理如下：

[Type-C接口] ↔ [STM32G0 USB PD协议处理] ↔ [电源管理IC] ↓ [SH1106 OLED显示]

系统工作时，STM32G0通过USB PD协议与充电设备协商电源参数，同时采集电压、电流等实时数据，处理后通过I2C接口发送到OLED显示屏进行可视化展示。

2. 开发环境搭建与基础配置

2.1 工具链准备

开始项目前，需要准备以下开发工具：

1. IDE选择：

   • STM32CubeIDE（推荐）：集成STM32CubeMX配置工具
   • Keil MDK或IAR EWARM（备选）

2. 必备软件：

   • STM32CubeProgrammer（烧录工具）
   • USB PD协议分析工具（如Total Phase协议分析仪）

3. 硬件调试工具：

   • ST-Link V2/V3调试器
   • 逻辑分析仪（用于I2C信号调试）

2.2 STM32CubeMX基础配置

使用STM32CubeMX进行外设初始化配置：

1. 时钟配置：

   // 系统时钟树配置示例 RCC_OscInitTypeDef RCC_OscInitStruct = {0}; RCC_OscInitStruct.OscillatorType = RCC_OSCILLATORTYPE_HSI; RCC_OscInitStruct.HSIState = RCC_HSI_ON; RCC_OscInitStruct.HSIDiv = RCC_HSI_DIV1; RCC_OscInitStruct.HSICalibrationValue = RCC_HSICALIBRATION_DEFAULT; HAL_RCC_OscConfig(&RCC_OscInitStruct);

2. I2C接口配置（用于OLED通信）：

   • 选择I2C1或I2C2
   • 标准模式（100kHz）或快速模式（400kHz）
   • 7位地址模式

3. USB PD配置：

   • 启用USB Type-C和PD控制器
   • 配置为DRP（Dual Role Port）模式

3. SH1106 OLED驱动开发

3.1 基础驱动函数实现

SH1106与常见的SSD1306驱动类似，但存在一些寄存器差异。以下是关键驱动函数：

// I2C写命令函数 void SH1106_WriteCommand(uint8_t cmd) { uint8_t buffer[2] = {0x00, cmd}; // 0x00表示命令 HAL_I2C_Master_Transmit(&hi2c1, SH1106_I2C_ADDR, buffer, 2, HAL_MAX_DELAY); } // 初始化序列 void SH1106_Init(void) { osDelay(100); // 等待电源稳定 SH1106_WriteCommand(0xAE); // 关闭显示 SH1106_WriteCommand(0xD5); // 设置显示时钟分频 SH1106_WriteCommand(0x80); // 建议值 SH1106_WriteCommand(0xA8); // 设置复用率 SH1106_WriteCommand(0x3F); // 1/64 duty SH1106_WriteCommand(0xD3); // 设置显示偏移 SH1106_WriteCommand(0x00); // 无偏移 SH1106_WriteCommand(0x40); // 设置显示起始行 SH1106_WriteCommand(0x8D); // 电荷泵设置 SH1106_WriteCommand(0x14); // 启用电荷泵 SH1106_WriteCommand(0x20); // 内存地址模式 SH1106_WriteCommand(0x00); // 水平地址模式 SH1106_WriteCommand(0xA1); // 段重映射设置 SH1106_WriteCommand(0xC8); // 扫描方向设置 SH1106_WriteCommand(0xDA); // COM引脚配置 SH1106_WriteCommand(0x12); // 备用COM配置 SH1106_WriteCommand(0x81); // 对比度控制 SH1106_WriteCommand(0xCF); // 对比度值 SH1106_WriteCommand(0xD9); // 预充电周期 SH1106_WriteCommand(0xF1); // 推荐值 SH1106_WriteCommand(0xDB); // VCOMH取消选择级别 SH1106_WriteCommand(0x40); // 推荐值 SH1106_WriteCommand(0xA4); // 正常显示 SH1106_WriteCommand(0xA6); // 正常显示（非反色） SH1106_WriteCommand(0xAF); // 开启显示 }

3.2 显示缓存管理

SH1106没有内置显存，需要开发者自行管理显示缓存：

#define OLED_WIDTH 128 #define OLED_HEIGHT 64 #define OLED_PAGES (OLED_HEIGHT/8) uint8_t oled_buffer[OLED_WIDTH][OLED_PAGES]; // 清空缓存 void OLED_ClearBuffer(void) { memset(oled_buffer, 0, sizeof(oled_buffer)); } // 刷新显示 void OLED_Refresh(void) { for(uint8_t page = 0; page < OLED_PAGES; page++) { SH1106_WriteCommand(0xB0 + page); // 设置页地址 SH1106_WriteCommand(0x02); // 设置列地址低4位 SH1106_WriteCommand(0x10); // 设置列地址高4位 // 发送整页数据 for(uint8_t col = 0; col < OLED_WIDTH; col++) { uint8_t data = oled_buffer[col][page]; uint8_t buffer[2] = {0x40, data}; // 0x40表示数据 HAL_I2C_Master_Transmit(&hi2c1, SH1106_I2C_ADDR, buffer, 2, HAL_MAX_DELAY); } } }

4. USB PD协议处理与数据可视化

4.1 PD协议状态监控

STM32G0内置USB PD PHY，可以方便地实现协议通信：

// PD协议处理任务 void PD_Task(void const *argument) { USBPD_HandleTypeDef hpcd; USBPD_ParamsTypeDef params; // 初始化PD堆栈 if (USBPD_OK != USBPD_Init(&hpcd, &params)) { Error_Handler(); } for(;;) { // 处理PD事件 USBPD_NotifyEvent(&hpcd); // 获取当前PD状态 USBPD_PortPowerRole_TypeDef role = USBPD_PE_GetPowerRole(0); uint16_t voltage = USBPD_PE_GetRequestedVoltage(0); uint16_t current = USBPD_PE_GetRequestedCurrent(0); // 更新显示数据 UpdateDisplayData(role, voltage, current); osDelay(100); } }

4.2 数据可视化界面设计

设计一个直观的显示界面，包含以下关键信息：

1. 顶部状态栏：

   • 当前角色（Source/Sink）
   • PD协议版本
   • 连接状态

2. 主参数区：

   • 实时电压（V）
   • 实时电流（A）
   • 实时功率（W）

3. 底部信息区：

   • 工作温度
   • 运行时间
   • 固件版本

界面实现代码示例：

void DrawDisplayFrame(void) { // 清空缓存 OLED_ClearBuffer(); // 绘制顶部状态栏 DrawStatusBar(); // 绘制主参数区 DrawMainParameters(); // 绘制底部信息 DrawFooter(); // 刷新显示 OLED_Refresh(); } void DrawStatusBar(void) { // 绘制边框 for(uint8_t x = 0; x < OLED_WIDTH; x++) { oled_buffer[x][0] |= 0x01; // 顶部线 oled_buffer[x][OLED_PAGES-1] |= 0x80; // 底部线 } // 显示当前角色 const char *role = (current_role == USBPD_PORTPOWERROLE_SRC) ? "SRC" : "SNK"; PutString(2, 0, role, FONT_6X8); // 显示电压电流协议 PutString(OLED_WIDTH-30, 0, "PD3.0", FONT_6X8); }

5. 系统集成与优化技巧

5.1 多任务处理设计

使用FreeRTOS实现多任务处理：

// 任务优先级定义 #define PD_TASK_PRIO (osPriorityHigh) #define DISPLAY_TASK_PRIO (osPriorityNormal) #define MONITOR_TASK_PRIO (osPriorityAboveNormal) // 创建任务 void StartDefaultTask(void const *argument) { // 创建PD协议处理任务 osThreadDef(PDTask, PD_Task, PD_TASK_PRIO, 0, 256); osThreadCreate(osThread(PDTask), NULL); // 创建显示刷新任务 osThreadDef(DisplayTask, Display_Task, DISPLAY_TASK_PRIO, 0, 512); osThreadCreate(osThread(DisplayTask), NULL); // 创建电源监控任务 osThreadDef(MonitorTask, Monitor_Task, MONITOR_TASK_PRIO, 0, 256); osThreadCreate(osThread(MonitorTask), NULL); for(;;) { osDelay(1000); } }

5.2 性能优化技巧

1. 显示刷新优化：

   • 使用局部刷新代替全局刷新
   • 实现脏矩形标记机制，只更新变化区域

2. 电源管理优化：

   // 进入低功耗模式示例 void EnterLowPowerMode(void) { // 降低CPU频率 __HAL_RCC_PLL_CONFIG(RCC_PLLSOURCE_HSI, RCC_PLLM_DIV1, 8, RCC_PLLN_MUL8, RCC_PLLR_DIV2); // 关闭不必要的外设时钟 __HAL_RCC_GPIOB_CLK_DISABLE(); __HAL_RCC_GPIOC_CLK_DISABLE(); // 配置OLED进入睡眠模式 SH1106_WriteCommand(0xAE); // 进入STOP模式 HAL_PWR_EnterSTOPMode(PWR_LOWPOWERREGULATOR_ON, PWR_STOPENTRY_WFI); }

3. 抗干扰设计：

   • I2C总线添加上拉电阻（4.7kΩ）
   • 电源引脚添加去耦电容（100nF+10μF）
   • 信号线走线尽量短，避免平行走线

6. 进阶功能扩展

6.1 多语言支持

通过字体库切换实现多语言显示：

typedef enum { LANG_EN, LANG_ZH, LANG_JP } DisplayLanguage; DisplayLanguage current_lang = LANG_EN; void SetDisplayLanguage(DisplayLanguage lang) { current_lang = lang; // 重新加载对应字体 LoadFont(lang); } // 多语言字符串表 const char* const status_str[3][3] = { {"Voltage", "Current", "Power"}, // EN {"电压", "电流", "功率"}, // ZH {"電圧", "電流", "電力"} // JP }; void DrawParameterLabel(uint8_t x, uint8_t y, ParameterType param) { PutString(x, y, status_str[current_lang][param], current_font); }

6.2 数据记录功能

添加简单的数据记录功能，便于分析：

#define LOG_SIZE 60 // 1分钟数据（每秒1次） typedef struct { uint16_t voltage[LOG_SIZE]; uint16_t current[LOG_SIZE]; uint8_t index; } PowerLog; PowerLog power_log; void LogPowerData(uint16_t v, uint16_t c) { power_log.voltage[power_log.index] = v; power_log.current[power_log.index] = c; power_log.index = (power_log.index + 1) % LOG_SIZE; } void DrawHistoryGraph(void) { // 绘制坐标轴 DrawLine(10, 40, 120, 40, WHITE); // X轴 DrawLine(10, 40, 10, 60, WHITE); // Y轴 // 绘制电压曲线 for(uint8_t i = 0; i < LOG_SIZE-1; i++) { uint8_t x1 = 10 + 2*i; uint8_t y1 = 40 - (power_log.voltage[i] / 200); // 缩放 uint8_t x2 = 10 + 2*(i+1); uint8_t y2 = 40 - (power_log.voltage[i+1] / 200); DrawLine(x1, y1, x2, y2, WHITE); } }

7. 常见问题解决与调试技巧

7.1 OLED显示问题排查

7.2 USB PD协商失败处理

1. 协议版本不匹配：

   • 确保STM32G0配置正确的PD版本
   • 更新固件支持最新PD3.1规范

2. 电源能力不足：

   // 配置源端PDO示例 USBPD_PDO_TypeDef pdo[3] = { {.GenericPdo = { .VoltageIn50mVunits = 100, // 5V .CurrentIn10mAunits = 300, // 3A .PeakCurrent = 0, .UnconstrainedPower = 0, .USBCommunicationsCapable = 1, .DualRoleData = 1, .FixedSupply = 1 }}, // 添加更多PDO... }; USBPD_PE_InitSourcePDOs(0, pdo, 3);

3. 电缆质量问题：

   • 使用认证的Type-C电缆
   • 检查CC引脚电阻（5.1kΩ）

8. 项目进阶方向

8.1 无线数据传输

添加蓝牙或Wi-Fi模块，实现远程监控：

// 通过蓝牙发送数据示例 void SendPowerDataOverBLE(uint16_t v, uint16_t c) { char buffer[32]; snprintf(buffer, sizeof(buffer), "V:%dmV,I:%dmA", v, c); BLE_Send(buffer); }

8.2 智能充电策略

基于历史数据优化充电参数：

void OptimizeCharging(void) { // 计算平均充电效率 float avg_efficiency = CalculateAvgEfficiency(); // 根据效率调整充电参数 if(avg_efficiency < 0.85) { AdjustChargingVoltage(-50); // 降低50mV } }

8.3 外壳设计与产品化

考虑以下产品化要素：

• 3D打印外壳设计
• 防水防尘处理
• 批量生产优化
• 认证要求（CE、FCC等）

在完成基础功能后，尝试将项目移植到更小的STM32G0型号（如STM32G031）以降低成本，或者升级到STM32G0B1以获得更多外设资源。实际测试中发现，合理调整OLED刷新率可以显著降低系统功耗，在电池供电场景下尤为重要。