CSR配置字典之SuperPodLabel类
更新时间: 2026/05/27
在Gitcode上查看源码文档信息
| 项目 | 内容 |
|---|---|
| 文档标题 | SuperPodLabel类配置字典 |
| 版本 | v1.0 |
| 创建日期 | 2026-05-27 |
| 最后更新 | 2026-05-27 |
| 维护状态 | 活跃维护 |
变更历史记录
文档变更记录
| 版本 | 发布日期 | 变更类型 | 变更内容 | 影响范围 | 维护人员 |
|---|---|---|---|---|---|
| v1.0 | 2026-05-27 | 初始版本 | 创建SuperPodLabel类配置字典 | 全新文档 | 系统管理员 |
类概览
SuperPodLabel 类
| 属性 | 值 |
|---|---|
| 类名称 | SuperPodLabel |
| 功能描述 | SuperPod标签管理对象,提供SuperPod集群标识、拓扑配置和UBM部署模式管理功能 |
| 所属SIG组 | hardware |
| 所属组件 | chassis |
| 责任人 | 机框管理组 |
| 最后更新 | 2026-05-27 |
| 状态 | 正常运行 |
属性定义详表
必选属性
| 属性名 | 类型 | 默认值 | 取值范围 | 动态关联 | 描述 | 使用场景 | 举例 | 来源 | 分类 |
|---|---|---|---|---|---|---|---|---|---|
Id | U8 | 1 | U8 | - | SuperPod标签ID,主键,只读 | SuperPod标签唯一标识 | 1 | CSR配置 | 软件 |
SuperPodId | U32 | 4294967295 | U32 | - | 超节点集合Id,默认值4294967295 | SuperPod集群标识 | 4294967295 | CSR配置 | 软件 |
ServerIndex | U16 | 65535 | U16 | - | 超节点内的计算节点Id编号,默认值65535 | 服务器在集群中的位置 | 65535 | CSR配置 | 软件 |
SuperPodSize | U16 | 384 | U16 | - | 超节点规模(npu卡的数),默认值384 | SuperPod集群大小 | 384 | CSR配置 | 软件 |
SuperPodEnabled | Boolean | false | Boolean | - | 是否是超节点模式,未配置默认为false | 是否启用SuperPod功能 | false | CSR配置 | 软件 |
可选属性
| 属性名 | 类型 | 默认值 | 取值范围 | 动态关联 | 描述 | 使用场景 | 举例 | 来源 | 分类 |
|---|---|---|---|---|---|---|---|---|---|
TopologyType | U8 | 0 | U8 | - | 节点拓扑类型,1:1D;2:2D | 集群拓扑类型 | 0 | CSR配置 | 软件 |
ChassisId | U16 | 65535 | U16 | - | 超节点机框号 | 机箱在集群中的标识 | 65535 | CSR配置 | 软件 |
UBMDeployMode | U8 | 0 | U8 | - | 计算服务器UBM部署位置:0:带内物理机;1:带外物理机(运行在独立的CPU上);2:带内虚拟机 | UBM部署配置模式 | 0 | CSR配置 | 软件 |
IsUBFabricMode | Boolean | false | Boolean | - | 计算服务器是否通过UB设备组集群,True:集群;False:单机 | UB Fabric模式标志 | false | CSR配置 | 软件 |
IsUBControlNode | Boolean | false | Boolean | - | 是否为UB控制节点 true:控制节点 false:代理节点 | UB控制节点标志 | false | CSR配置 | 软件 |
LogicalSlotNumber | U8 | 255 | U8 | - | 节点柜内逻辑槽位号,默认值255 | 逻辑槽位编号 | 255 | CSR配置 | 软件 |
PresentDPUCount | U8 | 0 | U8 | - | 物理在位的DPU数量 | DPU设备数量统计 | 0 | CSR配置 | 软件 |
NPUBootOption | U8 | 0 | U8 | - | NPU启动方式 | NPU启动配置选项 | 0 | CSR配置 | 软件 |
InterconType | U8 | 0 | U8 | - | 节点互联类型 | 互联网络类型 | 0 | CSR配置 | 软件 |
SuperPodIdAcc | U32 | - | U32 | - | 关联硬件SuperPodId寄存器,进行写值,支持CSR持久化 | SuperPodId硬件寄存器 | "#/Accessor_SuperPodId.Value" | 硬件提供 | 硬件 |
ServerIndexAcc | U16 | - | U16 | - | 关联硬件ServerIndex寄存器,进行写值,支持CSR持久化 | ServerIndex硬件寄存器 | "#/Accessor_ServerIndex.Value" | 硬件提供 | 硬件 |
SuperPodSizeAcc | U16 | - | U16 | - | 关联硬件SuperPodSize寄存器,进行写值,支持CSR持久化 | SuperPodSize硬件寄存器 | "#/Accessor_SuperPodSize.Value" | 硬件提供 | 硬件 |
DefaultSuperPodId | U32 | 4294967295 | U32 | - | 默认SuperPodId,支持CSR持久化 | 默认集群ID配置 | 4294967295 | CSR配置 | 软件 |
DefaultServerIndex | U16 | 65535 | U16 | - | 默认服务器索引,支持CSR持久化 | 默认服务器位置 | 65535 | CSR配置 | 软件 |
DefaultSuperPodSize | U16 | 384 | U16 | - | 默认SuperPod集群规模,支持CSR持久化 | 默认集群大小 | 384 | CSR配置 | 软件 |
Crc16 | U16 | 0 | U16 | - | 计算ServerIndex、SuperPodSize、SuperPodId crc16值,支持CSR持久化 | 配置校验值 | 0 | CSR配置 | 软件 |
CrcCalcParams | String[] | ["ServerIndex", "SuperPodSize", "SuperPodId"] | String[] | - | 参与计算CRC的属性名称列表,支持CSR持久化 | CRC计算参数列表 | ["ServerIndex", "SuperPodSize", "SuperPodId"] | CSR配置 | 软件 |
ConfigurationCompletedFlag | U16 | - | U16 | - | 配置完成标志,支持CSR持久化 | 配置完成状态 | 0 | CSR配置 | 软件 |
ConfigurationCompletedReg | U16 | - | U16 | - | 配置完成寄存器,支持CSR持久化 | 配置完成硬件寄存器 | "#/Accessor_ConfigComplete.Value" | 硬件提供 | 硬件 |
ChassisIdReg | U16 | - | U16 | - | 机箱ID寄存器,支持CSR持久化 | 机箱ID硬件寄存器 | "#/Accessor_ChassisId.Value" | 硬件提供 | 硬件 |
TopologyTypeReg | U8 | - | U8 | - | 拓扑类型寄存器,支持CSR持久化 | 拓扑类型硬件寄存器 | "#/Accessor_TopologyType.Value" | 硬件提供 | 硬件 |
InterconTypeReg | U8 | - | U8 | - | 互联类型寄存器,支持CSR持久化 | 互联类型硬件寄存器 | "#/Accessor_InterconType.Value" | 硬件提供 | 硬件 |
PresentDPUCountReg | U8 | - | U8 | - | 当前DPU数量寄存器,支持CSR持久化 | DPU数量硬件寄存器 | "#/Accessor_DPUCount.Value" | 硬件提供 | 硬件 |
NPUBootOptionReg | U8 | - | U8 | - | NPU启动选项寄存器,支持CSR持久化 | NPU启动硬件寄存器 | "#/Accessor_NPUBoot.Value" | 硬件提供 | 硬件 |
UBMDeployModeReg | U8 | - | U8 | - | UBM部署模式寄存器,支持CSR持久化 | UBM部署硬件寄存器 | "#/Accessor_UBMDeploy.Value" | 硬件提供 | 硬件 |
DefaultChassisId | U16 | - | U16 | - | 默认机箱ID,支持CSR持久化 | 默认机箱标识 | 65535 | CSR配置 | 软件 |
DefaultTopologyType | U8 | - | U8 | - | 默认拓扑类型,支持CSR持久化 | 默认拓扑配置 | 0 | CSR配置 | 软件 |
DefaultInterconType | U8 | - | U8 | - | 默认互联类型,支持CSR持久化 | 默认互联配置 | 0 | CSR配置 | 软件 |
DefaultPresentDPUCount | U8 | - | U8 | - | 默认当前DPU数量,支持CSR持久化 | 默认DPU数量 | 0 | CSR配置 | 软件 |
DefaultNPUBootOption | U8 | - | U8 | - | 默认NPU启动选项,支持CSR持久化 | 默认NPU启动配置 | 0 | CSR配置 | 软件 |
DefaultUBMDeployMode | U8 | - | U8 | - | 默认UBM部署模式,支持CSR持久化 | 默认UBM部署配置 | 0 | CSR配置 | 软件 |
分类标准
硬件属性
- 定义:与SuperPod硬件控制和寄存器相关的参数
- 特点:涉及硬件寄存器读写和配置同步
- 示例:
SuperPodIdAcc,ServerIndexAcc,SuperPodSizeAcc,ConfigurationCompletedReg,ChassisIdReg,TopologyTypeReg,InterconTypeReg,PresentDPUCountReg,NPUBootOptionReg,UBMDeployModeReg
件属性
- 定义:用于SuperPod标签管理和控制的参数
- 特点:标签配置、拓扑管理和持久化设置
- 示例:
Id,SuperPodId,ServerIndex,SuperPodSize,SuperPodEnabled,TopologyType,ChassisId,UBMDeployMode,IsUBFabricMode,IsUBControlNode,LogicalSlotNumber,PresentDPUCount,NPUBootOption,InterconType,DefaultSuperPodId,DefaultServerIndex,DefaultSuperPodSize,Crc16,CrcCalcParams,ConfigurationCompletedFlag,DefaultChassisId,DefaultTopologyType,DefaultInterconType,DefaultPresentDPUCount,DefaultNPUBootOption,DefaultUBMDeployMode
配置示例
标准SuperPod标签配置
json
{
"SuperPodLabel": {
"Id": 1,
"SuperPodId": 1,
"ServerIndex": 1,
"SuperPodSize": 384,
"SuperPodEnabled": true,
"TopologyType": 1,
"ChassisId": 1,
"UBMDeployMode": 1,
"IsUBFabricMode": false,
"IsUBControlNode": false,
"LogicalSlotNumber": 1,
"PresentDPUCount": 8,
"NPUBootOption": 0,
"InterconType": 1,
"SuperPodIdAcc": "#/Accessor_SuperPodId.Value",
"ServerIndexAcc": "#/Accessor_ServerIndex.Value",
"SuperPodSizeAcc": "#/Accessor_SuperPodSize.Value",
"DefaultSuperPodId": 4294967295,
"DefaultServerIndex": 65535,
"DefaultSuperPodSize": 384,
"Crc16": 0,
"CrcCalcParams": ["ServerIndex", "SuperPodSize", "SuperPodId"],
"ConfigurationCompletedFlag": 0,
"ConfigurationCompletedReg": "#/Accessor_ConfigComplete.Value",
"ChassisIdReg": "#/Accessor_ChassisId.Value",
"TopologyTypeReg": "#/Accessor_TopologyType.Value",
"InterconTypeReg": "#/Accessor_InterconType.Value",
"PresentDPUCountReg": "#/Accessor_DPUCount.Value",
"NPUBootOptionReg": "#/Accessor_NPUBoot.Value",
"UBMDeployModeReg": "#/Accessor_UBMDeploy.Value",
"DefaultChassisId": 65535,
"DefaultTopologyType": 0,
"DefaultInterconType": 0,
"DefaultPresentDPUCount": 0,
"DefaultNPUBootOption": 0,
"DefaultUBMDeployMode": 0
}
}使用指南
配置步骤
- 设置标签ID:配置Id作为SuperPod标签的唯一标识
- 配置集群标识:设置SuperPodId、ServerIndex、SuperPodSize标识集群信息
- 启用SuperPod:设置SuperPodEnabled启用SuperPod功能
- 配置拓扑信息:设置TopologyType、ChassisId、InterconType等拓扑参数
- 配置UBM模式:设置UBMDeployMode、IsUBFabricMode、IsUBControlNode
- 关联硬件寄存器:配置各种Acc和Reg属性关联硬件寄存器
- 设置默认值:配置各种Default属性作为默认配置
- CRC校验:配置Crc16和CrcCalcParams进行配置校验
SuperPod功能说明
- SuperPodId: SuperPod集群的唯一标识
- ServerIndex: 服务器在集群中的位置索引
- SuperPodSize: SuperPod集群的总规模
- SuperPodEnabled: 是否启用SuperPod功能
- TopologyType: 集群的拓扑类型配置
UBM部署模式说明
- UBMDeployMode: UBM部署模式配置
- IsUBFabricMode: 是否为UB Fabric模式
- IsUBControlNode: 是否为UB控制节点
注意事项
- ID唯一性:确保Id在SuperPod标签中唯一
- 硬件寄存器:确保Acc和Reg属性关联正确的硬件寄存器
- CRC校验:通过Crc16校验配置完整性
- 持久化:大部分属性支持PoweroffPer持久化