CSR配置字典之NpuBoard类
更新时间: 2025/07/22
在Gitcode上查看源码📋 文档信息
| 项目 | 内容 |
|---|---|
| 文档标题 | NpuBoard类配置字典 |
| 版本 | v1.0 |
| 创建日期 | 2025-01-27 |
| 最后更新 | 2026-05-27 |
| 维护状态 | ✅ 活跃维护 |
📋 变更历史记录
文档变更记录
| 版本 | 发布日期 | 变更类型 | 变更内容 | 影响范围 | 维护人员 |
|---|---|---|---|---|---|
| v1.0 | 2025-01-27 | 初始版本 | 创建NpuBoard类配置字典 | 全新文档 | 系统管理员 |
🎯 类概览
NpuBoard 类
| 属性 | 值 |
|---|---|
| 类名称 | NpuBoard |
| 功能描述 | NPU单板管理对象,提供NPU板的基本信息、版本管理、功率管理、状态监控和接口展示功能 |
| 所属SIG组 | hardware |
| 所属组件 | general_hardware |
| 责任人 | 单板管理组 |
| 最后更新 | 2026-05-27 |
| 状态 | 🟢 正常运行 |
📊 属性定义详表
必选属性
| 属性名 | 类型 | 默认值 | 取值范围 | 动态关联 | 描述 | 使用场景 | 举例 | 来源 | 分类 |
|---|---|---|---|---|---|---|---|---|---|
Slot | U8 | - | U8 | - | 槽位号 | BMC接口展示 | 1 | 硬件提供 | 硬件 |
Number | U8 | - | U8 | - | 单板编号 | BMC接口展示 | 1 | CSR配置 | 软件 |
Position | String | - | String | - | 单板位置 | BMC接口展示 | "NPU${Slot}" | CSR配置 | 软件 |
Name | String | - | String | - | 单板名称 | BMC接口展示 | "NPU_BOARD" | CSR配置 | 软件 |
ProductName | String | - | String | - | 产品名称 | BMC接口展示 | "NpuBoard" | CSR配置 | 软件 |
SilkText | String | - | String | - | 丝印文本 | BMC接口展示 | "NPU${Slot}" | CSR配置 | 软件 |
Manufacturer | String | - | String | - | 厂商 | BMC接口展示 | "Huawei" | 硬件提供 | 硬件 |
Description | String | - | String | - | 描述信息 | BMC接口展示 | "NPU Board" | CSR配置 | 硬件 |
BoardID | U16 | - | U16 | - | 单板ID | BMC接口展示 | 65535 | CSR配置 | 软件 |
PartNumber | String | - | String | - | 部件编号 | BMC接口展示 | "0302031825" | 硬件提供 | 硬件 |
PcbVersion | String | - | String | - | PCB版本 | BMC接口展示 | "A" | BMC内部设置 | 软件 |
LogicVersion | String | - | String | - | CPLD版本号 | BMC接口展示 | "1.0" | BMC内部设置 | 软件 |
SRVersion | String | - | String | - | CSR版本 | BMC接口展示 | "${DataVersion}" | CSR配置 | 软件 |
MCUVersion | String | - | String | - | MCU版本信息 | BMC接口展示 | "1.0" | BMC内部设置 | 软件 |
LogicUnit | U32 | - | U32 | - | 逻辑位号 | BMC接口展示 | 17 | 硬件提供 | 硬件 |
PowerWatts | U32 | - | U32 | - | NPU模组功耗值,单位W | BMC接口展示 | 300 | 硬件提供 | 硬件 |
RunningStatus | U8 | - | U8 | - | 运行状态 | 状态监控 | 1 | BMC内部设置 | 软件 |
FruID | U8 | - | U8 | - | FRU ID | BMC接口展示 | 1 | CSR配置 | 软件 |
DeviceName | String | - | String | - | 设备名称 | BMC接口展示 | "NpuBoard${Slot}" | CSR配置 | 软件 |
BoardType | String | - | String | - | 单板类型 | BMC接口展示 | "NpuBoard" | CSR配置 | 软件 |
NodeId | String | - | String | - | 节点ID | BMC接口展示 | "NPU${Slot}NpuBoard${Slot}" | CSR配置 | 软件 |
RefComponent | String | - | String | - | 关联组件 | BMC接口展示 | - | CSR配置 | 软件 |
RefFru | String | - | String | - | 关联FRU | BMC接口展示 | - | CSR配置 | 软件 |
CpldStatus | U8 | - | U8 | - | CPLD状态 | CPLD自检告警使用 | 0 | BMC内部设置 | 软件 |
MultiLogicVersion | Mixed | - | Mixed | - | 多CPLD版本 | BMC接口展示 | - | BMC内部设置 | 硬件 |
MultiLogicUnit | Mixed | - | Mixed | - | 多CPLD位号 | BMC接口展示 | {"CPLD1": 17} | 硬件提供 | 硬件 |
SerialNumber | String | - | String | - | 序列号 | BMC接口展示 | "SN001" | 硬件提供 | 硬件 |
UID | String | - | String | - | 单板UID | BMC接口展示 | "00000001020302031825" | 硬件提供 | 硬件 |
Type | String | - | String | - | 单板类型(Unit) | BMC接口展示 | "NPU" | CSR配置 | 硬件 |
PowerCapWatts | U32 | - | U32 | - | NPU模组功耗封顶值,单位W | BMC接口展示 | 350 | CSR配置 | 硬件 |
MaxPowerCapWatts | U32 | - | U32 | - | NPU模组支持的最大功耗封顶值,单位W | BMC接口展示 | 400 | CSR配置 | 硬件 |
MinPowerCapWatts | U32 | - | U32 | - | NPU模组支持的最小功耗封顶值,单位W | BMC接口展示 | 200 | CSR配置 | 硬件 |
Model | String | - | String | - | NPU模组型号 | BMC接口展示 | "Ascend 910" | 硬件提供 | 硬件 |
ComputeCapability | String | - | String | - | NPU模组的算力 | BMC接口展示 | "7.0" | 硬件提供 | 硬件 |
VRDUpgradeState | U8 | - | U8 | - | vrd升级状态, 0代表未升级,1代表升级中 | BMC接口展示 | 0 | BMC内部设置 | 软件 |
BmcStartFlag | U8 | - | U8 | - | BMC启动标志 | BMC启动 | - | CSR配置 | 软件 |
CollectMCULogFlag | U8 | 0 | U8 | - | MCU日志采集标志 | MCU日志采集 | 0 | CSR配置 | 软件 |
可选属性
| 属性名 | 类型 | 默认值 | 取值范围 | 动态关联 | 描述 | 使用场景 | 举例 | 来源 | 分类 |
|---|---|---|---|---|---|---|---|---|---|
PcbID | U8 | - | U8 | Accessor_PcbID | PCB ID | PcbVersion属性会使用 | "#/Accessor_PcbID.Value" | 硬件提供 | 硬件 |
LogicVersionID | U8 | - | U8 | Accessor_LogicVersionID | CPLD版本ID | BMC获取CPLD版本号 | "#/Accessor_LogicVersionID.Value" | 硬件提供 | 硬件 |
RefMCUChip | U8[] | - | U8[] | Chip_MCU1 | 关联MCU芯片 | 状态监控 | "#/Chip_MCU1" | CSR配置 | 硬件 |
RefSMCChip | U8[] | - | U8[] | Smc_NpuBoardSMC | 关联SMC芯片 | 状态监控 | "#/Smc_NpuBoardSMC" | CSR配置 | 硬件 |
Container | String | - | String | - | 容器信息 | BMC接口展示 | "${Container}" | CSR配置 | 软件 |
CpldTestReg | U32 | - | U32 | Accessor_CpldTest | CPLD自检寄存器 | CPLD自检 | "#/Accessor_CpldTest.Value" | 硬件提供 | 硬件 |
Count | U8 | 0 | U8 | - | 计数 | 组件计数 | 0 | CSR配置 | 软件 |
CpldTestNum | U8 | 1 | U8 | - | CPLD自检次数 | CPLD自检 | 1 | CSR配置 | 软件 |
Reset | U32 | - | U32 | - | 复位控制 | NPU复位 | - | CSR配置 | 硬件 |
BusType | U8 | 0 | U8 | - | 总线类型 | 总线配置 | 0 | CSR配置 | 硬件 |
GlobalReset | U8 | 0 | U8 | - | 全局复位 | 复位控制 | 0 | CSR配置 | 硬件 |
GlobalResetLocked | U8 | 0 | U8 | - | 全局复位锁定 | 复位控制 | 0 | CSR配置 | 硬件 |
ComputingUnitReset | U8 | 0 | U8 | - | 计算单元复位 | 复位控制 | 0 | CSR配置 | 硬件 |
ComputingUnitResetLocked | U8 | 0 | U8 | - | 计算单元复位锁定 | 复位控制 | 0 | CSR配置 | 硬件 |
PowerCapReduce | U16 | - | U16 | - | 功率降低值 | 功率控制 | - | CSR配置 | 硬件 |
ResetEnabled | U8 | 0 | U8 | - | 复位使能 | 复位控制 | 0 | CSR配置 | 硬件 |
🔗 动态关联机制
使用标准配置语法和动态关联:
yaml
# 动态关联配置
PcbID: "#/Accessor_PcbID.Value"
LogicVersionID: "#/Accessor_LogicVersionID.Value"
RefMCUChip: "#/Chip_MCU1"
RefSMCChip: "#/Smc_NpuBoardSMC"
CpldTestReg: "#/Accessor_CpldTest.Value"
# 变量替换
DeviceName: "NpuBoard${Slot}"
Position: "NPU${Slot}"
NodeId: "NPU${Slot}NpuBoard${Slot}"📂 分类标准
硬件属性
- 示例:
Slot,UID,Name,Manufacturer,LogicUnit,PcbID,PowerWatts,CpldTestReg,RefMCUChip,RefSMCChip,PowerCapWatts
软件属性
- 示例:
SRVersion,BoardID,BoardType,DeviceName,Position,NodeId,FruID,LogicVersion,PcbVersion,MCUVersion,Container,CpldTestNum,Count
📝 配置示例
json
{
"NpuBoard": {
"Slot": 1,
"UID": "00000001020302031825",
"Name": "NPU_BOARD",
"Manufacturer": "Huawei",
"BoardType": "NpuBoard",
"DeviceName": "NpuBoard${Slot}",
"Position": "NPU${Slot}",
"NodeId": "NPU${Slot}NpuBoard${Slot}",
"PcbID": "#/Accessor_PcbID.Value",
"LogicVersionID": "#/Accessor_LogicVersionID.Value",
"RefMCUChip": "#/Chip_MCU1",
"RefSMCChip": "#/Smc_NpuBoardSMC",
"PowerWatts": 300,
"PowerCapWatts": 350,
"Model": "Ascend 910"
}
}