super_agent_bot
5538af829b
根因（真机定案，问题 #79）：旧 dhara_nand_erase/prog() 把一切失败一律 mark_bad，而 mark_block_bad 每次**立即持久化**板级 BBT（不可撤销）—— 一次传输层/等忙抖动就把好块永久记成坏块。台架 129 个好块（1016–1142 连续段）被固化，journal prepare_head() 连续 8 次撞 is_bad → TOO_BAD → Cache flush FAIL → reformat 又被同一页挡住 → 整卷禁用、重启不恢复。 - 修复①：只有芯片明确回 E_FAIL/P_FAIL（状态位证据）才标坏； 传输/超时失败只报 DHARA_E_BAD_BLOCK 让 dhara 重试，不标坏 - 修复②：nand_ftl_format() 尽力刷一次脏缓存，失败即丢弃并继续 dhara_map_clear()（格式化语义本就是销毁映射；旧实现第一步返回， 恢复动作在同一页死锁，f_mkfs 全在旧映射上必失败） - C4 还债：新增跨调用失败类快照 nand_ftl_fault_get/clear（20 B， resume/读/刷/同步四点位记账）；defaultTask 探针按类分流， BSP_ERR_NO_SPACE 跳过重格式化（容量问题不该用 mkfs 解） - 哨兵与诊断：init 解锁块保护（A0h）后补回读校验（与 B0h ECC 同族 缺口，实测本板 A0h=0，非本次根因，留作哨兵）；gd5f_bbt_load() 合并后坏块数 > 出厂扫描时打「BBT after merge」，现场可区分 真坏与误标固化 - 测试：主机单测 149→178 全绿；新增 format 死锁（TC-NANDPORT-800.. 813b）、传输失败不标坏（207 语义翻转 + 208/505）；牙齿检查过—— 把修复回退即见红 - 真机：恢复动作 A 重建 BBT 清除已固化误标（3/3 PASSED，BBT version=71）；产品镜像复烧 [FS] FATFS mounted、配置出厂模板 落盘、0 条 flush FAIL——#79 真机闭环（旧卷内容随 map clear 作废，台架卷为可弃数据） - 文档：存储架构说明 §10.4 口径修正 + 新增 §10.4.1/§10.4.2（页级 失败升级链与误标持久化机理），存储维护与容量恢复 §2 补板级 BBT 独立持久化注记 + §2.1（动作 A 此前静默失效），登记簿 C4 销项 - Keil 0 错 0 警（Code=255552，与烧录验证镜像一致）；doc-links 213 文档通过
53 lines
2.2 KiB
C
53 lines
2.2 KiB
C
/*
|
||
* 模块名称：Storage Test Suite
|
||
* 模块功能：FTL + FatFS 存储测试的声明与断言宏。实现见 storage_test_task.c，
|
||
* 统一由 testTask 调度；正常产品构建下由 defaultTask 调用，
|
||
* 行为与原 defaultTask 内联逻辑一致。
|
||
* 适用平台：STM32F4 系列
|
||
* 作者：王建锋
|
||
* 创建日期：2026-08-26
|
||
*/
|
||
|
||
#ifndef STORAGE_TEST_H
|
||
#define STORAGE_TEST_H
|
||
|
||
#ifdef __cplusplus
|
||
extern "C" {
|
||
#endif
|
||
|
||
#include <stdint.h>
|
||
#include "test_common.h"
|
||
|
||
typedef test_stats_t storage_test_stats_t;
|
||
|
||
extern storage_test_stats_t g_storage_stats;
|
||
|
||
#define STORAGE_TEST_CHECK(cond, fmt, ...) \
|
||
TEST_CHECK_IMPL(g_storage_stats, cond, fmt, ##__VA_ARGS__)
|
||
|
||
#define STORAGE_TEST_REPORT(name) TEST_REPORT_IMPL(g_storage_stats, name)
|
||
|
||
/* 存储测试入口：FTL + FatFS 文件系统与性能测试 */
|
||
void storage_test_run(void);
|
||
|
||
/* 存储套件恢复测试（默认关闭）：取消注释并编译 STORAGE 套件运行一次，
|
||
* 即可重建 BBT（清除 TC-STORAGE-03 等注入的坏块）并重新格式化，恢复设备干净态。
|
||
* 恢复完成后建议重新注释并编译正常构建。 */
|
||
//#define ENABLE_STORAGE_RECOVERY_TESTS /* #79：2026-11-04 已用本开关清除 129 个误标坏块并 format 成功，保持注释 */
|
||
|
||
/* 恢复模式的扩展（默认关闭，需与上面 ENABLE_STORAGE_RECOVERY_TESTS 同时打开）：
|
||
* 把 dhara 可见区**整片擦净**（连 journal checkpoint 一起），用于**把被扣掉的容量恢复回来**。
|
||
* 原理（2026-09-21 读码 + 台架实证）：dhara 把坏块计数持久化在 checkpoint 头里
|
||
* （journal.c `hdr_set_bb_current/bb_last`），而 `dhara_journal_clear()` 只是
|
||
* `bb_last = bb_current`（**不归零**）——所以 `nand_ftl_format()` 恢复不了容量（95200 卡住）；
|
||
* 只有让下次启动 `dhara_map_resume` 失败、走 `dhara_map_clear` 的**全新初始化**分支
|
||
* （此时 bb_last = bb_current = 0）才能回满。2026-09-21 台架实测：95200 → **96064**（健康满值 ✓）。
|
||
* 代价：卷内容全失（启动时 FatFs 自动重建）、约 2044 次块擦除（数十秒）。 */
|
||
//#define STORAGE_RECOVERY_FULL_WIPE
|
||
|
||
#ifdef __cplusplus
|
||
}
|
||
#endif
|
||
|
||
#endif /* STORAGE_TEST_H */
|