📋 文档信息 ​

📋 变更历史记录 ​

文档变更记录 ​

🎯 类概览 ​

PCIeCardDisplayCustom 类 ​

📊 属性定义详表 ​

必选属性 ​

可选属性 ​

🔗 动态关联机制 ​

语法规范 ​

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

关联说明 ​

• 无动态关联：PCIeCardDisplayCustom类所有属性均通过CSR配置直接赋值，不依赖Scanner、Accessor或Component关联
• 复合主键：QuadrupleId和CustomType共同构成复合主键，唯一标识一条配置记录

📂 分类标准 ​

硬件属性 ​

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

软件属性 ​

• 定义：用于软件层面的PCIe卡自定义显示配置管理
• 特点：包含复合主键标识和卡类型配置功能
• 示例：QuadrupleId, CustomType, CardType

📝 配置示例 ​

标准PCIe卡自定义显示配置 ​

{
  "PCIeCardDisplayCustom": {
    "QuadrupleId": "Quad1",
    "CustomType": "TypeA",
    "CardType": "NIC"
  }
}

多自定义类型配置（TypeB） ​

{
  "PCIeCardDisplayCustom_TypeB": {
    "QuadrupleId": "Quad2",
    "CustomType": "TypeB",
    "CardType": "GPU"
  }
}

默认卡类型配置 ​

{
  "PCIeCardDisplayCustom_Default": {
    "QuadrupleId": "Quad3",
    "CustomType": "TypeC"
  }
}

多PCIe卡组合配置 ​

{
  "PCIeCardDisplayCustoms": [
    {
      "QuadrupleId": "Quad1",
      "CustomType": "TypeA",
      "CardType": "NIC"
    },
    {
      "QuadrupleId": "Quad2",
      "CustomType": "TypeB",
      "CardType": "GPU"
    },
    {
      "QuadrupleId": "Quad3",
      "CustomType": "TypeC",
      "CardType": "NA"
    }
  ]
}

🔧 使用指南 ​

配置步骤 ​

1. 设置四元组ID：配置QuadrupleId作为复合主键之一
2. 配置自定义类型：设置CustomType作为复合主键之二
3. 可选设置卡类型：根据需要配置CardType标识PCIe卡类型

注意事项 ​

• 复合主键：QuadrupleId和CustomType共同构成复合主键，必须唯一
• 权限要求：访问需ConfigureSelf权限
• 表名配置：对应数据库表名为 t_pcie_display_custom
• 持久化类型：tableType为 PoweroffPerRetain，断电后配置保留
• 默认值含义：QuadrupleId和CustomType默认值为空字符串，CardType默认值为"NA"

性能建议 ​

• 主键设计：QuadrupleId和CustomType命名应清晰反映PCIe卡标识和类型
• 卡类型配置：根据实际PCIe卡类型配置CardType，避免使用默认值"NA"
• 持久化保障：PoweroffPerRetain确保断电后配置不丢失

ID体系说明 ​

• QuadrupleId: 四元组ID，与CustomType共同构成复合主键
• CustomType: 自定义类型，与QuadrupleId共同构成复合主键
• CardType: 卡类型标识，默认"NA"表示未指定

常见问题 ​

• Q: QuadrupleId和CustomType为什么都是主键？
  • A: 两者共同构成复合主键，确保每条配置记录在四元组ID和自定义类型的组合上唯一
• Q: PoweroffPerRetain的含义是什么？
  • A: tableType为PoweroffPerRetain表示配置在断电后仍可保留，确保关键配置不因断电丢失
• Q: CardType默认值"NA"的含义是什么？
  • A: "NA"表示未指定卡类型，实际使用时应配置为具体类型如"NIC"、"GPU"等
• Q: 表名t_pcie_display_custom的作用是什么？
  • A: 该表名用于CSR配置存储时的数据库表映射，标识PCIe卡自定义显示配置的持久化存储表