📋 文档信息 ​

📋 变更历史记录 ​

文档变更记录 ​

🎯 类概览 ​

PCIeCardFlashChecker 类 ​

📊 属性定义详表 ​

必选属性 ​

可选属性 ​

无可选属性。

🔗 动态关联机制 ​

语法规范 ​

PCIeCardFlashChecker类属性均为静态配置属性，无动态关联机制。

关联说明 ​

• 无动态关联：PCIeCardFlashChecker类所有属性均通过CSR配置直接赋值，不依赖Scanner、Accessor或Component关联
• ResetPer机制：FaultStatus属性支持ResetPer（重启恢复）机制，系统重启后可恢复故障状态
• SHM共享：FaultStatus属性同时用于CSR和SHM场景，支持跨进程共享

📂 分类标准 ​

硬件属性 ​

• 无硬件属性：PCIeCardFlashChecker类不含直接从硬件获取或控制硬件的参数

软件属性 ​

• 定义：用于软件层面的PCIe卡Flash校验配置管理
• 特点：包含主键标识、故障状态、四元组列表等配置功能
• 示例：GroupPosition, FaultStatus, PCIeQuadrupleList

📝 配置示例 ​

标准PCIe卡Flash校验配置 ​

{
  "PCIeCardFlashChecker": {
    "GroupPosition": "Slot1",
    "FaultStatus": 0,
    "PCIeQuadrupleList": [
      {
        "Id": "1",
        "Description": "Card1"
      }
    ]
  }
}

多PCIe卡组配置 ​

{
  "PCIeCardFlashChecker_Multi": {
    "GroupPosition": "Slot2",
    "FaultStatus": 0,
    "PCIeQuadrupleList": [
      {
        "Id": "1",
        "Description": "Card1"
      },
      {
        "Id": "2",
        "Description": "Card2"
      },
      {
        "Id": "3",
        "Description": "Card3"
      },
      {
        "Id": "4",
        "Description": "Card4"
      }
    ]
  }
}

故障状态配置 ​

{
  "PCIeCardFlashChecker_Fault": {
    "GroupPosition": "Slot3",
    "FaultStatus": 1,
    "PCIeQuadrupleList": [
      {
        "Id": "1",
        "Description": "FaultCard"
      }
    ]
  }
}

🔧 使用指南 ​

配置步骤 ​

1. 设置主键标识：配置GroupPosition作为PCIe卡组位置标识
2. 配置故障状态：设置FaultStatus，默认为0（无故障）
3. 定义四元组列表：配置PCIeQuadrupleList，定义PCIe卡的四元组信息

注意事项 ​

• 主键唯一性：GroupPosition为主键，必须唯一标识PCIe卡组位置
• 权限要求：访问需ConfigureSelf权限
• 表名配置：对应数据库表名为 t_pcie_card_flash_checker
• 故障状态：FaultStatus支持ResetPer机制，系统重启后可恢复故障状态值
• SHM共享：FaultStatus同时用于CSR和SHM场景，支持跨进程共享
• 四元组列表：PCIeQuadrupleList引用IdAndDescription结构体数组

性能建议 ​

• 主键设计：GroupPosition命名应清晰反映PCIe卡组物理位置
• 故障监控：合理设置FaultStatus初始值，配合ResetPer机制实现故障持久化
• 四元组管理：根据实际PCIe卡数量配置四元组列表，避免冗余

ID体系说明 ​

• GroupPosition: 主键，唯一标识PCIe卡组位置
• FaultStatus (0-255): PCIe卡Flash校验故障状态，0表示无故障
• PCIeQuadrupleList: 四元组列表数组，每个元素包含Id和Description

故障检测机制 ​

• FaultStatus: PCIe卡Flash校验故障状态标识
• ResetPer: FaultStatus支持重启恢复机制，确保故障状态不因重启丢失
• SHM共享: FaultStatus在SHM场景下支持跨进程共享

常见问题 ​

• Q: GroupPosition作为主键有什么要求？
  • A: GroupPosition必须唯一标识PCIe卡组位置，不可重复
• Q: FaultStatus的ResetPer机制是什么？
  • A: ResetPer表示该属性在系统重启后可以恢复之前的值，确保故障状态持久化
• Q: PCIeQuadrupleList引用的结构体是什么？
  • A: PCIeQuadrupleList引用IdAndDescription结构体，每个元素包含Id和Description字段
• Q: 表名t_pcie_card_flash_checker的作用是什么？
  • A: 该表名用于CSR配置存储时的数据库表映射，标识PCIe卡Flash校验配置的持久化存储表