📋 文档信息

项目	内容
文档标题	SOC类配置字典
版本	v1.0
创建日期	2026/05/11
最后更新	2026/05/11
维护状态	✅ 活跃维护

📋 变更历史记录

文档变更记录

版本	发布日期	变更类型	变更内容	影响范围	维护人员
v1.0	2026/05/11	初始版本	创建SOC类配置字典	全新文档	bmc_soc组件组

🎯 类概览

SOC 类

属性	值
类名称	`SOC`
功能描述	SOC芯片管理配置，支持黑盒功能、PCIE控制器、温度监控、开核/关核配置、DDR自检等功能
所属SIG组	hardware
所属组件	bmc_soc
责任人	基础服务组
最后更新	2026/05/11
状态	🟢 正常运行

📊 属性定义详表

SOC 类 - 必选属性

属性名	类型	默认值	取值范围	动态关联	描述	使用场景	举例	来源	分类
`Name`	String	-	String	-	SOC芯片名称	配置SOC名称	`"SocNameExample"`	CSR	硬件
`Version`	String	-	String	SOC芯片版本	配置SOC版本	`V100`	CSR	硬件
`Designator`	String	-	String	芯片位置	配置芯片位置	`"U82"`	CSR	硬件
`DIEID`	String	-	String	-	DIE(裸片)ID(标识)	配置DIE标识	-	CSR	硬件
`ResetType`	U8	-	U8	-	BMC复位原因 0 AC复位，2 软复位	BMC复位原因	-	CSR	软件
`Temperature`	U16	-	U16	-	BMC核心温度	监控BMC核心温度	`42`	CSR	硬件
`TemperatureThreshold`	U16	-	U16	-	BMC核心温度告警阈值	配置BMC核心温度告警阈值	`105`	CSR	硬件
`StartupDuration`	U16	-	U16	-	BMC启动时间规格	配置启动超时	-	CSR	软件
`BlackBoxEnabled`	Boolean	-	Boolean	-	设置黑匣子使能开关状态，false（关闭）/true（打开）	配置黑匣子使能开关状态	`true`	CSR	软件
`PCIeControllerEnabled`	Boolean	-	Boolean	-	设置PCIe接口使能开关状态，false（关闭）/true（打开）	配置PCIE开关	`true`	CSR	软件
`DDRSelfTestResult`	U8	-	U8	-	DDR自检结果，BMC启动检查一次 1 自检成功 0 自检失败	查询自检结果	`1`	CSR	软件
`BootStatus`	U8	0	0/1	-	加载状态，1:表示BMC已启动；0为默认值，表示未完成启动	监控启动状态	`0`	CSR	软件

SOC 类 - 可选属性

属性名	类型	默认值	取值范围	动态关联	描述	使用场景	举例	来源	分类
`CoreEnableTemp`	U8[]	-	U8	-	开核的温度，有3个值，分别代表开第一个，第二个，第三个从核开核的芯片温度	配置开核温度阈值	`[80, 80, 80]`	CSR	硬件
`CoreDisableTemp`	U8	-	U8	-	高温关核温度	配置关核温度阈值	`90`	CSR	硬件
`CoreDisablePowerOffTime`	U8	-	U8	-	下电关核的超时时间，为0表示下电不关核	配置关核超时	`30`	CSR	软件
`DCAEnable`	U8	-	U8	-	动态开关核功能使能 1使能 0关闭	配置动态开关核	`0`	CSR	软件

📝 配置示例

SOC芯片管理配置

json

{
  "SOC": {
    "Name": "SOC_Chip",
    "Version": "v1.0",
    "Designator": "SOC_001",
    "DIEID": "0x12345678",
    "ResetType": 0,
    "Temperature": 65,
    "TemperatureThreshold": 85,
    "StartupDuration": 60,
    "BlackBoxEnabled": true,
    "PCIeControllerEnabled": true,
    "DDRSelfTestResult": 0,
    "BootStatus": 1,
    "CoreEnableTemp": [80, 80, 80],
    "CoreDisableTemp": 90,
    "CoreDisablePowerOffTime": 30,
    "DCAEnable": 0
  }
}

🔧 使用指南

配置步骤

配置SOC基本信息：设置 Name、Version、Designator、DIEID
配置温度监控：设置 TemperatureThreshold 控制温度告警门限
配置功能开关：设置 BlackBoxEnabled、PCIeControllerEnabled、DCAEnable
配置开核/关核：设置 CoreEnableTemp、CoreDisableTemp、CoreDisablePowerOffTime
监控启动状态：通过 BootStatus 监控SOC启动完成情况

注意事项

DCAEnable=1 时启用动态开关核功能
CoreDisablePowerOffTime=0 表示下电时不关核
BootStatus=1 表示BMC启动完成，BootStatus=0 表示未完成
温度阈值需要根据实际芯片规格设置

故障排查

SOC启动异常：检查 BootStatus 和 StartupDuration 配置
温度告警频繁：检查 TemperatureThreshold 设置是否合理
DDR自检失败：检查 DDRSelfTestResult 值，必要时重新执行自检

📋 文档信息 ​

📋 变更历史记录 ​

文档变更记录 ​

🎯 类概览 ​

SOC 类 ​

📊 属性定义详表 ​

SOC 类 - 必选属性 ​

SOC 类 - 可选属性 ​

📝 配置示例 ​

SOC芯片管理配置 ​

🔧 使用指南 ​

配置步骤 ​

注意事项 ​

故障排查 ​

📋 文档信息

📋 变更历史记录

文档变更记录

🎯 类概览

SOC 类

📊 属性定义详表

SOC 类 - 必选属性

SOC 类 - 可选属性

📝 配置示例

SOC芯片管理配置

🔧 使用指南

配置步骤

注意事项

故障排查