SFC#
SFC (Serial Flash Controller) 驱动 | sample:
src/application/samples/peripheral/sfc/sfc_demo.c| 前置:SPI (Serial Peripheral Interface)
学习目标#
理解 NOR Flash 的 Erase-Before-Write 特性——bit 只能从 1 变 0,擦除将整块恢复为全 1
掌握 SFC 控制器的初始化、寄存器接口读写(
uapi_sfc_reg_read/write)及区域擦除(uapi_sfc_reg_erase)理解 QSPI (Quad Serial Peripheral Interface) 四线模式相比标准 SPI 的带宽差异,以及擦除粒度的选择策略
基本概念#
NOR Flash 为什么必须先擦除再写入#
NOR Flash 存储单元的物理特性决定了每个 bit 只能被编程为 0(写操作),不能从 0 恢复为 1。要将某个区域恢复为全 1,必须执行擦除操作——擦除以扇区/块/全片为单位,将该区域内所有 bit 同时恢复为 1。这种机制被称为 Erase-Before-Write:
flowchart TD
W["<div style='width: 220px;'>写入请求</div>"] --> C{"目标区域<br/>是否为全1?"}
C -->|是| D["<div style='width: 220px;'>直接写入<br/>1→0 按位编程</div>"]
C -->|否| E["<div style='width: 220px;'>先擦除<br/>全区域恢复为1</div>"]
E --> D
D --> V["<div style='width: 220px;'>回读验证</div>"]
擦除粒度#
NOR Flash 通常提供扇区、块或全片等不同擦除粒度,但具体大小、对齐要求、支持的指令和耗时取决于实际 Flash 器件及驱动配置。使用前应查阅目标器件手册,不能把通用的 4KB、64KB 或典型耗时直接当作 WS53 当前硬件的固定参数。
QSPI 四线 vs 标准 SPI#
对比项 |
标准 SPI |
QSPI |
|---|---|---|
数据线数量 |
2(MOSI (Master Out Slave In) + MISO (Master In Slave Out),全双工各1) |
4(IO0~IO3,半双工复用) |
指令/地址/数据模式 |
1-1-1 |
1-1-4 / 1-4-4 |
读取带宽 |
~12.5 MB/s @ 100MHz |
~50 MB/s @ 100MHz |
引脚占用 |
4(CS (Carrier Synchronization)+CLK+MOSI+MISO) |
6(CS+CLK+IO0~3) |
涉及 API#
API |
用途 |
头文件 |
|---|---|---|
|
从 Flash 寄存器接口读取数据 |
|
|
通过寄存器接口写入 Flash(须先擦除) |
|
|
擦除 Flash 指定区域 |
|
Sample 中使用的是 SFC 寄存器接口(
sfc_reg_*),而非更高层的sfc_*API。两者区别:sfc_reg_*直接操作 SFC 控制寄存器,提供更细粒度的控制;高层 API 内部封装了指令编码和等待逻辑。
案例说明#
案例简介#
在 Flash 客户预留区中执行擦除 → 写入 → 回读观察的流程。测试数据为 0~31 的递增序列,擦除范围由 CONFIG_SFC_SAMPLE_USER_ADDR 和 CONFIG_SFC_SAMPLE_USER_SIZE 指定,每次操作 32 字节。
功能规格#
规格项 |
说明 |
|---|---|
Flash 接口 |
QSPI 四线模式(SFC 控制器自动管理) |
操作模式 |
|
默认测试区域 |
客户预留区 |
擦除范围 |
|
操作粒度 |
每次 32 字节( |
验证方式 |
写入后回读,逐字节打印对比 |
案例流程#
sequenceDiagram
participant T as sfc_task 任务
participant S as SFC 控制器
participant F as NOR Flash
T->>T: 填充 write_buf 0~31
T->>S: uapi_sfc_reg_erase(start_addr, size)
S->>F: 擦除指令 + 等待完成
F-->>S: 完成
loop while remained_len > 0
T->>S: uapi_sfc_reg_read(addr, buf, 32)
S->>F: 读指令 + 读取数据
F-->>S: 数据
T->>T: 打印原始数据(擦除后应为全 FF)
T->>S: uapi_sfc_reg_write(addr, buf, 32)
S->>F: 写使能 + 写入数据
F-->>S: 完成
end
loop 回读验证
T->>S: uapi_sfc_reg_read(addr, buf, 32)
S->>F: 读指令
F-->>S: 数据
T->>T: 打印写入后的数据(应为递增序列)
end
案例操作指导#
检查
CONFIG_SFC_SAMPLE_USER_ADDR和CONFIG_SFC_SAMPLE_USER_SIZE。默认会擦除0x003F3000~0x003F3FFF,即客户预留区前 4KB;确认其中没有有效数据并完成必要备份编译:
fbb build ws53_liteos_app
烧录固件,串口观察输出:
Erasing for API sample...→ 擦除中Start API read sample...→ 开始读写验证第一轮打印:擦除后原始数据(应为 FF FF FF ...)
第二轮打印:写入验证数据 00 01 02 03 ... 1E 1F(应为写入的值)
对比两轮输出:第一轮全 FF,第二轮为递增序列即验证通过
关键配置#
配置项 |
案例设置 |
使用要求 |
|---|---|---|
擦除起始地址 |
|
按实际 Flash 擦除粒度对齐 |
擦除长度 |
|
满足器件对齐要求,且不超出可擦除区域 |
测试区域 |
客户预留区前 4KB |
确认无有效数据;不得覆盖固件、启动或参数区域 |
单次读写长度 |
32 字节 |
修改时需确认器件页编程限制和驱动能力 |
擦除等待 |
擦除接口返回后继续 |
检查返回值;擦除期间不要操作同一 Flash |
Trade-off:更大的擦除粒度会扩大数据影响范围;频繁擦写还会消耗 Flash 寿命。实际设计应依据所用器件的擦除粒度、寿命指标和耗时,并在应用层评估磨损均衡与掉电保护。
代码详解#
1. 全局变量与测试数据准备#
#define SFC_SAMPLE_LEN 0x80000
#define SFC_PRINT_BUFF_LEN 32
uint8_t g_print_data_buff[SFC_PRINT_BUFF_LEN] = {0}; /* 读出缓冲区 */
uint8_t g_write_data_buff[SFC_PRINT_BUFF_LEN] = {0}; /* 写入数据源 */
/* sfc_task 开头填充写入数据为 0~31 递增序列 */
for (uint8_t i = 0; i < SFC_PRINT_BUFF_LEN; i++) {
g_write_data_buff[i] = i;
}
2. 擦除用户区域#
擦除操作必须最先执行——如果区域已有旧数据,直接写入会因 bit 无法 0→1 而失败:
errcode_t ret = uapi_sfc_reg_erase(CONFIG_SFC_SAMPLE_USER_ADDR,
CONFIG_SFC_SAMPLE_USER_SIZE);
if (ret != ERRCODE_SUCC) {
osal_printk("flash erase failed! ret = %x\r\n", ret);
return NULL;
}
3. 读取原始数据并写入新数据#
遍历整个测试区域,每次操作 32 字节。先读取并打印擦除后的原始状态(应为全 0xFF),再写入测试数据:
static void sfc_sample_start_api_test(void)
{
uint32_t remained_len = CONFIG_SFC_SAMPLE_USER_SIZE;
uint32_t start_addr = CONFIG_SFC_SAMPLE_USER_ADDR;
/* 第一轮:读取原始数据并写入测试数据 */
while (remained_len > 0) {
uint32_t cur_len = remained_len > SFC_PRINT_BUFF_LEN ?
SFC_PRINT_BUFF_LEN : remained_len;
uapi_sfc_reg_read(start_addr, g_print_data_buff, cur_len);
for (uint8_t i = 0; i < cur_len; i++) {
osal_printk("%02x ", g_print_data_buff[i]); /* 打印原始数据 */
}
uapi_sfc_reg_write(start_addr, g_write_data_buff, cur_len);
start_addr += cur_len;
remained_len -= cur_len;
osal_printk("\r\n");
}
4. 回读验证#
重新从头读取,验证写入是否正确:
/* 第二轮:回读验证写入的数据 */
start_addr = CONFIG_SFC_SAMPLE_USER_ADDR;
remained_len = CONFIG_SFC_SAMPLE_USER_SIZE;
while (remained_len > 0) {
uint32_t cur_len = remained_len > SFC_PRINT_BUFF_LEN ?
SFC_PRINT_BUFF_LEN : remained_len;
uapi_sfc_reg_read(start_addr, g_print_data_buff, cur_len);
for (uint8_t i = 0; i < cur_len; i++) {
osal_printk("%02x ", g_print_data_buff[i]); /* 打印回读数据 */
}
start_addr += cur_len;
remained_len -= cur_len;
osal_printk("\r\n");
}
}
本 Sample 通过串口打印两轮数据进行人工对比。在量产代码中,应使用
memcmp()自动验证并在写入前检查 Flash 忙状态。