ZHCUBW5 April   2024

 

  1.   1
  2.   摘要
  3.   商标
  4. 1简介
    1. 1.1 参考资料
    2. 1.2 函数清单格式
  5. 2TMS320F28P55x 闪存 API 概述
    1. 2.1 简介
    2. 2.2 API 概述
    3. 2.3 使用 API
      1. 2.3.1 初始化流程
        1. 2.3.1.1 器件上电后
        2. 2.3.1.2 闪存包装程序和存储体设置
        3. 2.3.1.3 关于系统频率变化
      2. 2.3.2 使用 API 进行构建
        1. 2.3.2.1 对象库文件
        2. 2.3.2.2 分布文件
        3. 2.3.2.3 闪存 API 使用的关键事实
  6. 3API 函数
    1. 3.1 初始化函数
      1. 3.1.1 Fapi_initializeAPI()
    2. 3.2 闪存状态机函数
      1. 3.2.1  Fapi_setActiveFlashBank()
      2. 3.2.2  Fapi_setupBankSectorEnable()
      3. 3.2.3  Fapi_issueAsyncCommandWithAddress()
      4. 3.2.4  Fapi_issueBankEraseCommand()
      5. 3.2.5  Fapi_issueProgrammingCommand()
      6. 3.2.6  Fapi_issueProgrammingCommandForEccAddresses()
      7. 3.2.7  Fapi_issueAutoEcc512ProgrammingCommand()
      8. 3.2.8  Fapi_issueDataAndEcc512ProgrammingCommand()
      9. 3.2.9  Fapi_issueDataOnly512ProgrammingCommand()
      10. 3.2.10 Fapi_issueEccOnly64ProgrammingCommand()
      11. 3.2.11 Fapi_issueAsyncCommand()
      12. 3.2.12 Fapi_checkFsmForReady()
      13. 3.2.13 Fapi_getFsmStatus()
    3. 3.3 读取函数
      1. 3.3.1 Fapi_doBlankCheck()
      2. 3.3.2 Fapi_doVerify()
    4. 3.4 信息函数
      1. 3.4.1 Fapi_getLibraryInfo()
    5. 3.5 实用功能
      1. 3.5.1 Fapi_flushPipeline()
      2. 3.5.2 Fapi_calculateEcc()
      3. 3.5.3 Fapi_isAddressEcc()
      4. 3.5.4 Fapi_remapEccAddress()
      5. 3.5.5 Fapi_calculateFletcherChecksum()
  7. 4推荐的 FSM 流程
    1. 4.1 新出厂器件
    2. 4.2 推荐的擦除流程
    3. 4.3 推荐的存储体擦除流程
    4. 4.4 推荐的编程流程
  8. 5与安全相关的软件应用程序使用假设
  9.   A 闪存状态机命令
  10.   B typedef、定义、枚举和结构
    1.     B.1 类型定义
    2.     B.2 定义
    3.     B.3 枚举
      1.      B.3.1 Fapi_FlashProgrammingCommandsType
      2.      B.3.2 Fapi_FlashBankType
      3.      B.3.3 Fapi_FlashStateCommandsType
      4.      B.3.4 Fapi_StatusType
      5.      B.3.5 Fapi_ApiProductionStatusType
    4.     B.4 结构
      1.      B.4.1 Fapi_FlashStatusWordType
      2.      B.4.2 Fapi_LibraryInfoType
  11.   参考资料

2.3.2.2 分布文件

以下 API 文件分布在 C2000Ware\libraries\flash_api\f28p55x\ 文件夹中：

  • 库文件
    • TMS320F28P55x 闪存 API 未嵌入到该器件的引导 ROM 中，该 API 完全属于软件类型。提供的软件库采用 EABI elf (FAPI_F28P55x_EABI_v4.00.00.lib) 和 COFF (FAPI_F28P55x_COFF_v4.00.00.lib) 目标文件格式。应用程序中应包含这两种库文件的其中一个（具体取决于应用程序所使用的输出目标文件格式），以便能够擦除闪存/OTP 或对其进行编程。
  • FAPI_F28P55x_EABI_v4.00.00.lib – 这是用于 TMS320F28P55x 器件的闪存 API EABI elf 目标格式库（为构建启用了 FPU32 标志）
  • FAPI_F28P55x_COFF_v4.00.00.lib – 这是用于 TMS320F28P55x 器件的闪存 API COFF 目标格式库（为构建启用了 FPU32 标志）
  • 未提供 API 库的定点版本。
  • 头文件：
    • FlashTech_F28p55x_C28x.h – TMS320F28P55x 器件的主头文件。该文件设置特定于编译的定义并包括 FlashTech.h 主头文件。
    • hw_flash_command.h – 闪存写入/擦除保护寄存器的定义
  • 以下头文件不应直接包含在用户代码中，但此处列出了此类文件以供用户参考：
    • FlashTech.h – 该头文件列出了所有公共 API 函数并包括所有其他头文件。
    • Registers.h – 所有寄存器实现通用的定义，包括所选器件类型的相应寄存器头文件。
    • Registers_C28x.h – 闪存配置寄存器。
    • Types.h – 包含 API 使用的所有枚举和结构。
    • Constants/F28P55x.h – F28P55x 器件的常量定义。