📋 文档信息 ​

📋 变更历史记录 ​

文档变更记录 ​

🎯 类概览 ​

NPUBDFConfig 类 ​

📊 属性定义详表 ​

必选属性 ​

可选属性 ​

无

🔗 动态关联机制 ​

语法规范 ​

使用 #/xxx 和 <=/xxx 格式实现属性间的动态关联：

# NPUBDFConfig类当前无动态关联属性
# 所有属性均为直接配置值

关联说明 ​

• 直接配置: 所有属性均通过CSR配置直接设置，无需动态关联
• BDF映射: Maps属性为BDFConfiguration结构体数组，用于配置NPU设备的PCIe BDF编号

📂 分类标准 ​

软件属性 ​

• 定义：用于软件层面的NPU设备BDF管理和配置
• 特点：包含设备类型标识和BDF配置映射等功能
• 示例：DeviceType, Maps

📝 配置示例 ​

标准单NPU BDF配置 ​

{
  "NPUBDFConfig": {
    "DeviceType": "NPU",
    "Maps": [
      {
        "Bus": 1,
        "Device": 0,
        "Function": 0
      }
    ]
  }
}

多功能NPU BDF配置 ​

{
  "NPUBDFConfig_MultiFunction": {
    "DeviceType": "NPU",
    "Maps": [
      {
        "Bus": 1,
        "Device": 0,
        "Function": 0
      },
      {
        "Bus": 1,
        "Device": 0,
        "Function": 1
      }
    ]
  }
}

多NPU设备BDF配置 ​

{
  "NPUBDFConfig_MultiNPU": {
    "DeviceType": "NPU",
    "Maps": [
      {
        "Bus": 1,
        "Device": 0,
        "Function": 0
      },
      {
        "Bus": 2,
        "Device": 0,
        "Function": 0
      }
    ]
  }
}

🔧 使用指南 ​

配置步骤 ​

1. 设置设备类型：配置DeviceType，标识NPU设备的类型
2. 设置BDF映射：配置Maps，指定NPU设备的PCIe BDF编号映射表

注意事项 ​

• 设备类型一致性：DeviceType应与实际硬件设备类型匹配
• BDF编号唯一性：Maps中每个BDFConfiguration的Bus/Device/Function组合应全局唯一
• 数组配置：Maps为结构体数组，支持配置多个BDF映射关系
• PCIe拓扑：BDF编号应与实际PCIe拓扑结构一致

性能建议 ​

• BDF映射规范：合理规划BDF编号体系，确保与PCIe拓扑一致
• 多功能配置：同一Device下不同Function用于多功能设备场景

BDF配置说明 ​

• Bus: PCIe总线编号
• Device: PCIe设备编号
• Function: PCIe功能编号
• BDFConfiguration: 包含Bus、Device、Function的结构体

常见问题 ​

• Q: BDF是什么含义？
  • A: BDF是Bus/Device/Function的缩写，是PCIe设备的标准编号方式
• Q: Maps为什么是数组类型？
  • A: 支持配置多个BDF映射关系，适用于多功能设备或多设备场景
• Q: DeviceType可以配置哪些值？
  • A: DeviceType为String类型，可根据实际设备类型灵活配置，如"NPU"等