4. Flash驱动核心数据结构设计

在车载MCU的Flash驱动架构中，核心数据结构是连接硬件抽象层与上层应用（如FOTA、日志存储、标定数据管理）的桥梁。设计良好的数据结构能够显著提升代码的可移植性、可维护性以及磨损均衡算法的执行效率。本章节将详细阐述四个关键数据结构：Flash设备描述符、扇区映射表、错误状态码以及操作句柄。

4.1 Flash设备描述符 (Flash Device Descriptor)

设备描述符用于抽象不同型号Flash芯片的物理特性与配置参数。通过将硬件参数集中管理，驱动代码无需硬编码特定芯片的时序或容量信息，从而支持多平台复用。

4.2 扇区映射表 (Sector Mapping Table)

扇区映射表是磨损均衡算法的核心数据结构，负责维护逻辑扇区号（LSN）到物理扇区号（PSN）的动态映射关系。每次擦写操作后，映射表会更新，将新的写入操作分配到磨损程度较低的物理扇区。

4.3 错误状态码 (Error Status Code)

统一的错误状态码枚举类型能够帮助上层应用快速定位故障原因。设计时应覆盖硬件异常、参数校验、磨损均衡策略以及超时等场景。

/* flash_error.h */
typedef enum {
    FLASH_OK                     = 0x00,  /* 操作成功 */
    FLASH_ERR_PARAM              = 0x01,  /* 参数无效 */
    FLASH_ERR_ADDR_ALIGN         = 0x02,  /* 地址未对齐 */
    FLASH_ERR_WRITE_PROTECT      = 0x03,  /* 写保护使能 */
    FLASH_ERR_ERASE_FAILED       = 0x04,  /* 擦除操作失败 */
    FLASH_ERR_PROGRAM_FAILED     = 0x05,  /* 编程操作失败 */
    FLASH_ERR_READ_FAILED        = 0x06,  /* 读取操作失败 */
    FLASH_ERR_TIMEOUT            = 0x07,  /* 操作超时 */
    FLASH_ERR_BAD_BLOCK          = 0x08,  /* 坏块检测 */
    FLASH_ERR_WEAR_LEVEL_FULL    = 0x09,  /* 磨损均衡池已满 */
    FLASH_ERR_MAP_CORRUPT        = 0x0A,  /* 映射表损坏 */
    FLASH_ERR_CRC_MISMATCH       = 0x0B,  /* CRC校验失败 */
    FLASH_ERR_BUSY               = 0x0C,  /* 设备忙 */
    FLASH_ERR_UNSUPPORTED        = 0x0D   /* 不支持的操作 */
} Flash_ErrorCode;

4.4 操作句柄 (Operation Handle)

操作句柄是驱动对外暴露的唯一接口对象，封装了设备上下文、当前操作状态、回调函数以及超时控制。通过句柄机制，驱动可以支持多实例并发操作（如同时管理内部Flash和外部SPI Flash）。

操作句柄的典型定义如下，它聚合了设备描述符指针、当前操作上下文以及回调函数表：

/* flash_handle.h */
typedef struct {
    const Flash_DeviceDescriptor  *device;       /* 指向设备描述符 */
    Flash_ErrorCode               lastError;     /* 最近一次错误码 */
    uint32_t                      timeoutMs;     /* 操作超时阈值 */
    uint8_t                       retryCount;    /* 当前重试次数 */
    uint8_t                       maxRetries;    /* 最大重试次数 */
    Flash_OpState                 state;         /* 句柄状态枚举 */
    void                         *userContext;   /* 用户自定义上下文 */
    Flash_Callback                onComplete;    /* 完成回调 */
    Flash_Callback                onError;       /* 错误回调 */
    uint32_t                      reserved[4];   /* 保留字段，用于扩展 */
} Flash_Handle;

4.5 数据结构关系总览

下表总结了四个核心数据结构在驱动架构中的角色与交互关系：