STM32G491芯片在stlink工具中的Flash编程问题分析与修复

问题背景

在stlink开源项目中，针对STM32G4系列微控制器的Flash编程功能存在一个特定问题。具体表现为在使用stlink工具对STM32G491芯片(属于G4系列的Category 4设备)进行Flash编程时，会遇到"non-erased value"错误。这个问题最初被报告为issue #1310，但后续发现之前的修复方案并不完全有效。

技术分析

STM32G4系列微控制器根据其Flash容量和特性被划分为不同类别(Category)。Category 3和Category 4设备在Flash控制寄存器(FLASH_CR)的页面编号位(PNB)字段宽度上存在差异：

1. Category 3设备：使用7位(0x7F)来表示Flash页面编号
2. Category 4设备：需要8位(0xFF)来表示Flash页面编号

原代码中统一使用了7位掩码(0x7F)来处理所有G4系列设备，这导致在对STM32G491(Category 4)进行Flash擦除操作时，无法正确设置高位页面编号，从而引发编程错误。

解决方案

经过深入分析，确定了以下修复方案：

1. 修改Flash擦除操作的位掩码：将原来的7位掩码(0x7F)扩展为8位掩码(0xFF)，以适应Category 4设备的页面编号需求
2. 移除不必要的条件判断：简化了设备参数加载逻辑，避免对Category 4设备进行不必要的特殊处理

核心修改体现在Flash擦除操作的寄存器配置部分：

val &= ~(0xFF << 3);  // 修改掩码为8位
val |= ((flash_page & 0xFF) << 3) | (1 << FLASH_CR_PER);

技术考量

在解决方案的设计过程中，考虑了以下几点：

1. 兼容性：虽然主要解决Category 4设备的问题，但修改后的代码仍能兼容Category 3设备，因为高位在Category 3设备上默认为0
2. 性能优化：评估了是否需要添加Flash缓存无效化操作，最终确定在stlink工具的使用场景下此操作非必需
3. 代码简洁性：选择最直接的解决方案，避免引入复杂的条件判断

验证与测试

该修复方案已经过实际硬件验证，确认可以解决STM32G491的Flash编程问题。建议用户在以下情况下特别关注此修复：

1. 使用STM32G4系列Category 4设备(如STM32G491)
2. 进行Flash擦除和编程操作时遇到"non-erased value"错误
3. 使用较新版本的stlink工具链

总结

这个案例展示了嵌入式开发中硬件特性差异带来的软件适配挑战。通过对STM32G4系列不同类别设备的深入理解，我们能够定位并解决Flash编程中的兼容性问题。这也提醒开发者在支持多款微控制器时，需要仔细研究各型号的技术参考手册，确保软件实现与硬件特性完全匹配。

该修复已合并到stlink项目的主干代码中，将为使用STM32G4系列Category 4设备的开发者提供更稳定的Flash编程体验。