基于 STM32F407 的 SPI Flash下载算法

---

一、概述

本文将介绍如何使用 MDK 创建 STM32F407 的 SPI Flash 下载算法。

其中，SPI Flash 芯片使用的是 W25Q128，其相关操作源码可以参考 STM32 通过 SPI 驱动 W25Q128，本文所使用的驱动 SPI Flash 的 API 和里面是一样的。

单片机的 Flash 下载算法是一个 FLM 文件，FLM 通过编译链接得到，其内部包含一系列对 FLASH 的操作，包括初始化、擦除、写、读、校验等等操作。

想要制作下载算法，先要了解下载算法的工作原理。我们下载一个程序的流程大概是这样的：

1. 下载工具（比如 jlink）读取 FLM 文件
2. 然后 JLINK 提取 FLM 文件的信息，将其传输到单片机的内部 SRAM
3. 下载算法开始在 SRAM 中运行，由于下载算法包含了一系列对 Flash 的操作，那么下载工具通过下发初始化、擦除、写入、校验等指令给单片机，单片机去执行这些指令操作，实现对单片机 Flash 的下载。

二、自制 FLM 文件

我参照的是 MDK 给的程序模板来完成 Flash 下载程序，然后在模板的基础上加上自己的代码。

模板路径如下：D:\Keil_v5\ARM\Packs\ARM\CMSIS\5.8.0\Device\_Template_Flash，不同的 MDK 版本可能路径不一样。

然后将项目拷贝到你的工作目录下，并取消该工程项目的只读属性。

打开项目如下：

然后开始我们的工作。

1、修改使用的芯片

首先选择你的芯片类型和型号。

2、修改输出算法的名称

这一步不是必须的，改个名称方便自己查看。

注意这个名称只是项目最终生成输出的 FLM 文件的名称，和下面位置识别出的算法名（后面会介绍这个名称如何修改）无关。

3、其它设置

注意：

这里的设置在模板文件中已经设置好了，这里主要是介绍一些，可以跳过

这两个设置是为了保证生成的算法文件中 RO 和 RW 段的独立性，即与地址无关。

如果程序的所有只读段都与位置无关，则该程序为只读位置无关（ROPI，Read-only position independence）。ROPI 段通常是位置无关代码（PIC，position-independent code），但可以是只读数据，也可以是 PIC 和只读数据的组合。选择“ ROPI”选项，可以避免用户不得不将代码加载到内存中的特定位置。这对于以下例程特别有用：

• 加载以响应运行事件。
• 在不同情况下使用其他例程的不同组合加载到内存中。
• 在执行期间映射到不同的地址。

使用 Read-Write position independence 同理，表示的可读可写数据段。

通过下面的命令就可以将生成的 axf 可执行文件修改为 FLM。

我们这里的分散加载文件直接使用 MDK 模板工程里提供好的即可，无需任何修改。

4、修改配置文件 FlashDev.c

模板工程里面提供简单的配置说明：

struct FlashDevice const FlashDevice  =  {FLASH_DRV_VERS,             // Driver Version, do not modify!"New Device 256kB Flash",   // Device Name ONCHIP,                     // Device Type0x00000000,                 // Device Start Address0x00040000,                 // Device Size in Bytes (256kB)1024,                       // Programming Page Size0,                          // Reserved, must be 00xFF,                       // Initial Content of Erased Memory100,                        // Program Page Timeout 100 mSec3000,                       // Erase Sector Timeout 3000 mSec// Specify Size and Address of Sectors0x002000, 0x000000,         // Sector Size  8kB (8 Sectors)0x010000, 0x010000,         // Sector Size 64kB (2 Sectors) 0x002000, 0x030000,         // Sector Size  8kB (8 Sectors)SECTOR_END
};

这里的注释已经说得很明白了，大家根据自己的芯片来进行修改即可，我使用的是 W25Q128，其存储大小为 16MB，一个扇区 4KB，所以修改如下：

W25Q128 一页是 256KB，但这里写的 4096 是为了提高下载速率和擦除速率，如果你把 4096 改为 8，可以很明显得感受到下载速度变慢了

struct FlashDevice const FlashDevice  =  {FLASH_DRV_VERS,                  /* 驱动算法，由 MDK 制定，勿动 */"Yux_STM32F407VE_SPI_W25Q128",   /* 算法名称 */ EXTSPI,                          /* 设备类型，外扩展 SPI-Flash */SPI_FLASH_MEM_ADDR,              /* Flash 起始地址 */0x01000000,                      /* Flash 大小，16MB */4096,                            /* 编程页大小 */0,                               /* 保留，必须为 0 */0xFF,                            /* 擦除后的数值 */3000,                            /* 页编程等待时间 */3000,                            /* 扇区擦除等待时间 */0x001000, 0x000000,              /* 扇区大小，扇区地址 */SECTOR_END
};

其中，SPI_FLASH_MEM_ADDR 是我在 FlashOS.h 文件中定义的一个宏，表示 Flash 的起始地址：

#define SPI_FLASH_MEM_ADDR     0x00000000

这里的算法名称就体现在这里：

5、文件 FlashPrg.c 的实现

模板文件中提供了这几个函数，也是我们完成 Flash 下载算法最关键的地方：

// Flash 初始化
int Init (unsigned long adr, unsigned long clk, unsigned long fnc) {/* Add your Code */return (0);                                  // Finished without Errors
}// Flash 复位
int UnInit (unsigned long fnc) {/* Add your Code */return (0);                                  // Finished without Errors
}// 擦除整个 Flah 芯片
int EraseChip (void) {/* Add your Code */return (0);                                  // Finished without Errors
}// 擦除指定扇区
int EraseSector (unsigned long adr) {/* Add your Code */return (0);                                  // Finished without Errors
}// 页编程
int ProgramPage (unsigned long adr, unsigned long sz, unsigned char *buf) {/* Add your Code */return (0);                                  // Finished without Errors
}// 校验
unsigned long Verify (unsigned long adr, unsigned long sz, unsigned char *buf)
{/* Add your Code */return (0);                                  // Finished without Errors
}

这里涉及到了对 W25Q128 的相关操作，详细内容参照： STM32 通过 SPI 驱动 W25Q128，这里主要是调用之前实现的函数。

我使用的是标准库，所以还要添加一些相关的文件进来：

实现如下：

• 初始化函数

int Init (unsigned long adr, unsigned long clk, unsigned long fnc) {SystemInit();   // 初始化系统和时钟w25qxx_init();  // 初始化 w25q128 /* Add your Code */return (0);                                  // Finished without Errors
}

这里的 SystemInit 是 system_stm32f4xx.c 中的函数，在 STM32 时钟树（基于 STM32F407） 一文中讨论过。

• 复位函数

Uninit 没有用到，所以不用改。

• 擦除整个芯片

int EraseChip (void) {w25qxx_erase_chip();/* Add your Code */return (0);                                  // Finished without Errors
}

• 擦除指定扇区

int EraseSector (unsigned long adr) {uint32_t sector = 0;adr -= SPI_FLASH_MEM_ADDR;sector = adr / 4096;w25qxx_erase_sector(sector);/* Add your Code */return (0);                                  // Finished without Errors
}

• 页编程

int ProgramPage (unsigned long adr, unsigned long sz, unsigned char *buf) {adr -= SPI_FLASH_MEM_ADDR;w25qxx_write(buf, adr, sz);/* Add your Code */return (0);                                  // Finished without Errors
}

• 校验

unsigned char aux_buf[4096];
unsigned long Verify (unsigned long adr, unsigned long sz, unsigned char *buf)
{unsigned long remain = sz;	//剩余的字节数unsigned long current_add = 0;//当前的地址unsigned int index = 0;//用于buf的索引current_add = adr - 0xC0000000;while(remain >= 4096){w25qxx_read(aux_buf, current_add, 4096);for(int i = 0; i < 4096; i++){if(aux_buf[i] != buf[index+i])return adr+index+i;}current_add += 4096;remain -= 4096;index += 4096;}w25qxx_read(aux_buf, current_add, remain);for(int i = 0; i < remain; i++){if(aux_buf[i] != buf[index+i])return adr + index + i;}return (adr + sz);                      // 校验成功
}

为什么要 adr -= SPI_FLASH_MEM_ADDR; ？

因为实际传递进来的地址是带了首地址的，即 0x00000000（如果你定义的是其它地址，而不执行 adr -= SPI_FLASH_MEM_ADDR; 就会出错）。特别注意，我们这里的 0xC0000000 是随意设置的，因为 STM32F4 的标准 SPI 外设并不支持内存映射。

这里执行的擦除大小要前面 FlashDev.c 文件中配置的扇区大小一致，这里是执行的 4KB 为扇区进行擦除。

现在编译之后就可以在项目目录下看见一个 FLM 文件。下面就来验证一下我们的下载算法是否正确。

三、验证算法

首先把我们的 FLM 文件放到如下目录中：D:\Keil_v5\ARM\Flash，可以看到这里有很多 FLM 和 FLX 文件。

这里我随便找了一个项目，按如下方式添加自己的 Flash 下载算法：

然后，编译下载，然后我报了如下的错误：


报错原因是下载算法没有找到 08000000H 这个地址，我这里使用的是默认的链接脚本：

LR_IROM1 0x08000000 0x00100000  {    ; load region size_regionER_IROM1 0x08000000 0x00100000  {  ; load address = execution address*.o (RESET, +First)*(InRoot$$Sections).ANY (+RO).ANY (+XO)}RW_IRAM1 0x20000000 0x00020000  {  ; RW data.ANY (+RW +ZI)}
}

有关链接脚本的部分可以参考：
浅析 Keil 中的 sct 文件，
分散加载文件 scatter files。

这部分的内容比较复杂，我就直接给出解决方案了：

LR_IROM1 0x00000000 0x00100000  {    ; load region size_regionER_IROM1 0x0000000 0x00100000  {  ; load address = execution address*.o (RESET, +First)*(InRoot$$Sections).ANY (+RO).ANY (+XO)}RW_IRAM1 0x20000000 0x00020000  {  ; RW data.ANY (+RW +ZI)}
}

这下编译成功了。但至于写没写入并不清楚，写没写对也不知道。所以我又写了个 W25Q128 的读取程序：

	w25q32_dev.rd(data, 0x00000000, sizeof(data));for (int i = 0; i < sizeof(data); ++i){printf("%2x ", data[i]);if ( (i + 1) % 16 == 0 )printf("\r\n");}

话不多说，看结果（比较的是 bin 文件）：

说明算法编写成功 (^人^)。