Keil5 Flash 下载算法配置要点与实战

如果这一步失败，你会看到 'Cannot Initialize Algorithm' 错误。

第四步：分块写入数据

主机将编译生成的二进制映像（来自.axf 中的 load region）按页为单位发送给算法，调用 ProgramPage(address, size, buffer) 实现编程。

每写完一页，还会触发 Verify() 进行比对校验。若发现数据不一致，则报 'Verify Error'。

第五步：释放资源并启动程序

全部写入完成后，调用 UnInit() 关闭 Flash 控制器，释放相关外设。随后 MCU 复位，跳转至 main() 函数开始执行新固件。

整个过程完全脱离操作系统和应用程序，属于典型的'半主机调试'范畴。

标准算法 vs 自定义算法：什么时候你需要自己动手？

Keil 自带大量厂商预置的 Flash 算法，例如：

• STM32F1xx_Flash.FLM
• NXP_LPC800_Flash.FLM
• GD32F30x_Flash.FLM

对于常见的 STM32 系列，通常只需在项目设置中选择对应型号即可自动关联算法。

但以下几种情况，你就必须考虑 自定义 Flash 下载算法 了：

🧩 典型案例：某客户用 GD32F303RC 替代 STM32F103RC，在 Keil 中直接套用原算法，始终报'Verify Error'。排查后发现：GD32 默认开启 ICache 和预取缓冲，导致读回数据滞后。解决方法是在 Init() 中添加如下代码关闭缓存：

// GD32 系列需显式禁用 Cache 以避免 Verify 失败
#define RCU_CFG0 (*(volatile uint32_t*)0x40021000)
RCU_CFG0 |= (1 << 16); // disable pre-fetch
RCU_CFG0 |= (1 << 17); // disable I-Cache
RCU_CFG0 |= (1 << 18); // disable D-Cache

这说明：即使引脚兼容、指令集相同，不同厂商的微调差异也可能导致标准算法失效。

手把手教你创建一个自定义 Flash 下载算法

如果你想支持一款 Keil 没有内置支持的 MCU，就必须自己做一个 .FLM 文件。以下是完整流程。

步骤一：新建 Flash Programmer 工程

在 Keil 中选择：

Project → Manage → Project Items → Flash Banks → Add

然后点击'Create New Algorithm'，Keil 会自动生成一个模板项目，包含以下核心文件：

• FlashPrg.c —— 主要实现函数
• config.txt —— 算法参数描述
• startup.s —— 启动代码
• FlashDev.c —— 设备信息定义
• 分散加载文件（scatter file）

步骤二：实现三大核心函数

1. int Init(unsigned long adr, unsigned long clk, unsigned long fnc)

初始化 Flash 控制器。

int Init(unsigned long adr, unsigned long clk, unsigned long fnc) { 
    // 示例：STM32F1 解锁 Flash
    FLASH_KEYR = 0x45670123;
    FLASH_KEYR = 0xCDEF89AB;
    FLASH_SR = 0x3F; // 清除所有状态标志
    return 0;
}

🔍 参数说明： - adr : 当前操作的目标地址（一般不用） - clk : 系统主频（可用于延时计算） - fnc : 功能标志（0=编程，1=擦除等）

2. int UnInit(unsigned long fnc)

释放资源，关闭外设时钟。

int UnInit(unsigned long fnc) { 
    // 可选：关闭 Flash 时钟、恢复电源设置
    return 0;
}

3. int EraseSector(unsigned long adr)

擦除指定扇区（注意：不能跨区操作！）

int EraseSector(unsigned long adr) {
    FLASH_CR |= (1 << 1); // SER 置位，选择扇区擦除
    FLASH_AR = adr; // 设置目标地址
    FLASH_CR |= (1 << 6); // STRT 置位，启动擦除
    while (FLASH_SR & (1 << 0)); // 等待 BSY 清零
    return (FLASH_SR & (1<<4)) ? 1 : 0; // 检查 PGERR/WRERR
}

4. int ProgramPage(unsigned long adr, unsigned long sz, unsigned char *buf)

编程一页数据（最小可编程单位）。

int ProgramPage(unsigned long adr, unsigned long sz, unsigned char *buf) {
    uint16_t *pSrc = (uint16_t*)buf;
    uint16_t *pDst = (uint16_t*)adr;
    FLASH_CR |= (1 << 0); // PG 位使能
    while (sz > 0) {
        *pDst++ = *pSrc++;
        while (FLASH_SR & (1 << 0)); // 等待完成
        if (FLASH_SR & (1 << 2)) return 1; // 写保护错误
        sz -= 2;
    }
    FLASH_CR &= ~(1 << 0); // 关闭编程模式
    return 0;
}

步骤三：配置算法参数（FlashDev.c）

编辑 FlashDev.c，填写关键参数：

struct FlashDevice const FlashDevice = {
    FLASH_DRV_VERS, // Driver Version
    "STM32F103C8T6_Custom", // Device Name
    EXTSRAM, // Device Type
    0x08000000, // Base Address
    0x00008000, // Total Size (32KB)
    1024, // Page Size
    0xFF, // Reserved values
    0x00, // Erase Value
    {{0x400, 0x0000}, // Sector Info: 64 sectors × 1KB
     {0x00000000, 0x00000000}}
}; 

步骤四：设置链接脚本（Scatter File）

确保算法代码被定位到 SRAM 中，而不是 Flash：

LR_IROM1 0x20000000 0x00002000 {
    ; Load region starts at SRAM base
    ER_IROM1 0x20000000 0x00002000 {
        ; Execution region
        *.o (RESET, +first)
        *(InRoot$$Sections)
        .ANY (+RO)
    }
    RW_IRAM1 0x20002000 0x00001000 {
        .ANY (+RW +ZI)
    }
}

步骤五：编译生成.FLM 文件

使用 ARMCC 编译器构建项目，输出 .FLM 动态库文件。

⚠️ 注意：必须使用 Keil MDK 自带的编译工具链，GCC 无法生成兼容的.FLM 格式。

步骤六：注册到目标工程

回到主工程，在：

Options for Target → Debug → Settings → Flash Download

点击'Add'按钮，导入你生成的 .FLM 文件，并确认参数无误。

至此，你就可以像使用标准算法一样点击'Download'烧录程序了！

常见问题诊断手册：快速定位'烧录失败'根源

💡 实用技巧：在开发阶段，可以在 FlashPrg.c 中加入 ITM 打印调试信息：

#define ITM_Port8(n) (*((volatile unsigned char*)(0xE0000000+4*n)))
ITM_Port8(0) = 'I'; // 输出调试字符

配合 Keil 的 'Debug Printf Viewer' 功能，实时观察算法执行流。

最佳实践指南：写出稳定可靠的 Flash 算法

1. 命名规范统一
   MCUFamily_FlashSize_Algorithm.flm 例：CH32V307_128KB_Custom.flm
2. SRAM 分配留足余量
   - 至少预留 2KB 给堆栈和局部变量；
   - 避免与主工程使用的 SRAM 区域重叠。
3. 启用-O2 优化
   - 减小代码体积，提升执行效率；
   - 但不要过度优化（-O3 可能导致行为异常）。
4. 处理边界条件
   - 地址对齐检查（如必须半字对齐）；
   - 越界访问防护；
   - 多次擦写耐久性测试。
5. 版本化管理.FLM 文件
   - 加入 Git/SVN，避免团队成员使用不同版本；
   - 注释清楚适配的芯片型号与修订日期。
6. 多平台验证
   - 在不同主频、供电电压下测试稳定性；
   - 模拟通信中断场景，确保不会留下'半擦除扇区'。

结语：掌握底层，方能游刃有余

Flash 下载算法看似只是一个小小的配置项，实则是嵌入式开发者通往底层世界的'第一道门槛'。

当你不再满足于'点一下就能下载'，而是开始思考：'它是怎么跑起来的？'、'为什么换个芯片就不行？'、'我能自己改吗？'——恭喜你，已经迈入了真正的嵌入式开发深水区。

随着国产 MCU 生态蓬勃发展，越来越多非标准架构涌现，未来能够 自主构建调试支持体系 的能力，将成为工程师的核心竞争力之一。

下次再遇到'Download Failed'，别再盲目百度重启了。打开 FlashPrg.c，看看那几行看似枯燥的寄存器操作，也许答案就在其中。