📋 文档信息 ​

📋 变更历史记录 ​

文档变更记录 ​

🎯 类概览 ​

NodePortAddr 类 ​

📊 属性定义详表 ​

必选属性 ​

可选属性 ​

无可选属性。

🔗 动态关联机制 ​

语法规范 ​

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

关联说明 ​

• 无动态关联：NodePortAddr类所有属性均通过CSR配置直接赋值，不依赖Scanner、Accessor或Component关联
• 层级结构：NodeId → CPUId → DieId → MacroId构成从节点到Macro的层级标识体系

📂 分类标准 ​

硬件属性 ​

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

软件属性 ​

• 定义：用于软件层面的节点端口地址配置管理
• 特点：包含节点到端口的多层级地址标识体系
• 示例：NodeId, CPUId, DieId, MacroId, InterfaceDeviceSlotId, InterfaceDevicePortId

📝 配置示例 ​

标准节点端口地址配置 ​

{
  "NodePortAddr": {
    "NodeId": 1,
    "CPUId": 0,
    "DieId": 0,
    "MacroId": 0,
    "InterfaceDeviceSlotId": 1,
    "InterfaceDevicePortId": 0
  }
}

多Die场景配置 ​

{
  "NodePortAddr_MultiDie": {
    "NodeId": 1,
    "CPUId": 0,
    "DieId": 1,
    "MacroId": 0,
    "InterfaceDeviceSlotId": 2,
    "InterfaceDevicePortId": 0
  }
}

多节点配置（Node2） ​

{
  "NodePortAddr_Node2": {
    "NodeId": 2,
    "CPUId": 1,
    "DieId": 0,
    "MacroId": 0,
    "InterfaceDeviceSlotId": 3,
    "InterfaceDevicePortId": 1
  }
}

多端口配置 ​

{
  "NodePortAddr_Port1": {
    "NodeId": 1,
    "CPUId": 0,
    "DieId": 0,
    "MacroId": 1,
    "InterfaceDeviceSlotId": 1,
    "InterfaceDevicePortId": 1
  }
}

🔧 使用指南 ​

配置步骤 ​

1. 设置节点标识：配置NodeId标识互联节点
2. 配置CPU标识：设置CPUId标识节点对应的CPU
3. 设置Die标识：配置DieId标识CPU内的Die编号
4. 配置Macro标识：设置MacroId标识Die内的Macro编号
5. 设置接口设备标识：配置InterfaceDeviceSlotId和InterfaceDevicePortId

注意事项 ​

• 权限要求：访问需ConfigureSelf权限
• 层级关系：NodeId → CPUId → DieId → MacroId构成从节点到Macro的层级标识，需保持层级一致性
• 唯一性：各ID在同一层级内应唯一，避免地址冲突
• 端口组合：InterfaceDeviceSlotId和InterfaceDevicePortId共同标识一个具体的接口设备端口

性能建议 ​

• 层级配置：按从节点到端口的层级顺序配置，确保层级关系清晰
• 地址唯一性：确保NodeId+CPUId+DieId+MacroId的组合在系统内唯一
• 端口映射：InterfaceDeviceSlotId和InterfaceDevicePortId应与物理端口映射一致

ID体系说明 ​

• NodeId (0-255): 节点ID，标识互联节点
• CPUId (0-255): CPU ID，标识节点对应的CPU
• DieId (0-255): Die ID，标识CPU内的Die编号
• MacroId (0-255): Macro ID，标识Die内的Macro编号
• InterfaceDeviceSlotId (0-255): 接口设备槽位ID
• InterfaceDevicePortId (0-255): 接口设备端口ID

常见问题 ​

• Q: NodeId到MacroId的层级关系是什么？
  • A: 构成从节点到Macro的多层级标识体系：NodeId → CPUId → DieId → MacroId，逐级细化地址定位
• Q: InterfaceDeviceSlotId和InterfaceDevicePortId有什么区别？
  • A: SlotId标识接口设备的槽位，PortId标识槽位内的具体端口，两者共同定位一个接口设备端口
• Q: 如何确保端口地址唯一性？
  • A: 确保NodeId+CPUId+DieId+MacroId+InterfaceDeviceSlotId+InterfaceDevicePortId的组合在系统内唯一