📋 文档信息

项目	内容
文档标题	FruCtrl类配置字典
版本	v1.3
创建日期	2025-01-27
最后更新	2026-11-07
维护状态	✅ 活跃维护

📋 变更历史记录

文档变更记录

版本	发布日期	变更类型	变更内容	影响范围	维护人员
v1.0	2025-01-27	初始版本	创建FruCtrl类配置字典	全新文档	系统管理员
v1.1	2026-05-15	修订	对齐model.json，新增DelayedPowerOnPolicy、GracefulShutdownDefault/Max/MinTimeoutSeconds等属性	FruCtrl所有CSR属性	基础服务组
v1.2	2026-11-03	优化	修正FruType、HotswapState类型为String并补充枚举取值	FruType/HotswapState字段	基础服务组
v1.3	2026-11-07	修订	与模型同步，补充 CSR 属性：CurrentRestartCause、CurrentRestartCauseId、DefaultDelayStrategy、Mode、PowerOffLocked、PowerOffLockedReasons、PowerOnConditionSatisfied、PowerOnStrategy、PowerOnStrategyExceptions、PowerSt…	FruCtrl	待补充

🎯 类概览

FruCtrl 类

属性	值
类名称	`FruCtrl`
功能描述	FRU电源控制，支持上电策略、优雅关机、热插拔状态、延迟上电等完整电源管理功能
所属SIG组	hardware
所属组件	fructrl
责任人	基础服务组
最后更新	2026-11-07
状态	🟢 正常运行

📊 属性定义详表

模型来源：fructrl/mds/model.json。字段是否可由 CSR 配置以模型的 usage 为准；接口属性的类型和描述补查 mdb_interface/json/intf 中同名接口，模型显式定义优先。

FruCtrl 类 - 必选属性

属性名	类型	默认值	取值范围	动态关联	描述	使用场景	举例	来源	分类
`Id`	U8	-	U8	-	FRU控制对象标识，主键	唯一标识FRU控制对象	`1`	CSR	软件
`SysResetDetected`	U8	-	U8	-	系统复位检测标记	检测系统复位事件	`0`	CSR	软件
`FruType`	String	-	上下电的Fru类型信息："host"（主机）、"NPU"（NP加速卡）、"Mesh"（交换mesh卡）；当前代码实现中取值为"OS"	-	FRU类型标识，上下电的Fru类型信息：host、NP加速卡、交换mesh卡	配置FRU类型	`"OS"`	CSR	软件
`HotswapState`	String	-	热插拔状态机取值："M0"~"M7"（M0初始状态，M7最终状态）	-	热插拔状态，状态机M0~M7	配置热插拔状态	`"M0"`	CSR	软件
`RestartCount`	U32	-	U32	-	重启次数计数	记录FRU重启次数	`0`	CSR	软件

FruCtrl 类 - 可选属性

属性名	类型	默认值	取值范围	动态关联	描述	使用场景	举例	来源	分类
`FruID`	U8	0	U8	-	FRU标识	配置FRU标识	`0`	CSR	软件
`GracefulShutdownTimeoutEnabled`	U8	0	0-1	-	优雅关机超时使能，0：禁用，1：启用	配置优雅关机	`0`	CSR	软件
`GracefulShutdownTimeoutSeconds`	U32	600	U32	-	优雅关机超时时间（秒），范围：GracefulShutdownMinTimeoutSeconds - GracefulShutdownMaxTimeoutSeconds	配置关机超时	`600`	CSR	软件
`GracefulShutdownDefaultTimeoutSeconds`	U32	600	U32	-	优雅关机默认超时时间（秒）	配置默认超时	`600`	CSR	软件
`GracefulShutdownMaxTimeoutSeconds`	U32	6000	U32	-	优雅关机最大超时时间（秒）	配置最大超时	`6000`	CSR	软件
`GracefulShutdownMinTimeoutSeconds`	U32	10	U32	-	优雅关机最小超时时间（秒）	配置最小超时	`10`	CSR	软件
`IsValid`	Boolean	true	true/false	-	对象是否生效，多Host场景下判断对象是否有效	配置有效性	`true`	CSR	软件
`PowerOnTimeoutSeconds`	U32	10	U32	-	上电超时时间（秒）	配置上电超时	`10`	CSR	软件
`CurrentRestartCause`	String	无	-	-	用于记录业务系统本次复位原因	CSR 配置	`"..."`	CSR配置	软件
`CurrentRestartCauseId`	U8	无	-	-	与CurrentRestartCause对应id	CSR 配置	`0`	CSR配置	软件
`DefaultDelayStrategy`	String	Random	-	-	默认延迟策略，Random：0~2秒随机延迟，BySlot：按照槽位延迟	CSR 配置	`Random`	CSR配置	软件
`Mode`	String	DefaultDelay	-	-	延迟上电策略	CSR 配置	`DefaultDelay`	CSR配置	软件
`PowerOffLocked`	Boolean	无	-	-	是否下电锁定:true:锁定 false:解锁	CSR 配置	`false`	CSR配置	硬件
`PowerOffLockedReasons`	String[]	无	-	-	不允许下电的原因，KVM呈现，记录所有原因	CSR 配置	`0`	CSR配置	硬件
`PowerOnConditionSatisfied`	Boolean	true	-	-	上电条件是否满足，true:条件满足，false:条件不满足，默认值为true	CSR 配置	`true`	CSR配置	硬件
`PowerOnStrategy`	String	AlwaysPowerOn	-	-	通电开机策略	CSR 配置	`AlwaysPowerOn`	CSR配置	硬件
`PowerOnStrategyExceptions`	U32	0	-	-	殊通电开机策略，1为不执行此次通电开机策略，0为清除策略	CSR 配置	`0`	CSR配置	硬件
`PowerState`	String	无	-	-	反映实时电源状态	CSR 配置	`"..."`	CSR配置	硬件
`PwrOnLocked`	Boolean	无	-	-	是否满足上电条件	CSR 配置	`false`	CSR配置	软件
`Reasons`	String[]	无	-	-	不允许上电的原因，KVM呈现，记录所有原因	CSR 配置	`0`	CSR配置	软件
`RestartCauseRecords`	String[]	无	-	-	用于记录业务系统历史复位原因，最多纪录10次	CSR 配置	`[]`	CSR配置	软件
`Seconds`	Double	0.0	-	-	延迟上电时间	CSR 配置	`0.0`	CSR配置	软件

📝 配置示例

FRU电源控制配置

json

{
  "FruCtrl": {
    "Id": 1,
    "FruID": 0,
    "PowerOnTimeoutSeconds": 10,
    "IsValid": true,
    "PowerOnStrategy": "AlwaysPowerOn",
    "GracefulShutdownTimeoutEnabled": 0,
    "GracefulShutdownTimeoutSeconds": 600,
    "GracefulShutdownDefaultTimeoutSeconds": 600,
    "GracefulShutdownMaxTimeoutSeconds": 6000,
    "GracefulShutdownMinTimeoutSeconds": 10
  }
}

延迟上电配置

json

{
  "FruCtrl": {
    "Id": 2,
    "FruID": 1,
    "PowerOnTimeoutSeconds": 30,
    "IsValid": true,
    "Mode": "CustomDelay",
    "Seconds": 30.0,
    "PowerOnStrategy": "AlwaysPowerOn"
  }
}

🔧 使用指南

配置步骤

配置FRU标识：设置Id和FruID唯一标识FRU对象
配置上电策略：设置PowerOnStrategy控制上电行为
配置超时时间：根据需要设置GracefulShutdownTimeoutSeconds和PowerOnTimeoutSeconds
配置延迟上电：通过DelayedPowerOnPolicy设置延迟模式和时间

注意事项

GracefulShutdownTimeoutSeconds：必须在Min和Max范围内（10-6000秒）
PowerOnStrategy：可选值根据系统支持的上电策略确定
DelayedPowerOnPolicy：用于控制上电前的延迟等待

故障排查

上电超时：检查PowerOnTimeoutSeconds配置是否合理
优雅关机失败：检查GracefulShutdownTimeoutSeconds是否在有效范围
策略不生效：检查PowerOnStrategy配置是否正确

📋 文档信息 ​

📋 变更历史记录 ​

文档变更记录 ​

🎯 类概览 ​

FruCtrl 类 ​

📊 属性定义详表 ​

FruCtrl 类 - 必选属性 ​

FruCtrl 类 - 可选属性 ​

📝 配置示例 ​

FRU电源控制配置 ​

延迟上电配置 ​

🔧 使用指南 ​

配置步骤 ​

注意事项 ​

故障排查 ​

📋 文档信息

📋 变更历史记录

文档变更记录

🎯 类概览

FruCtrl 类

📊 属性定义详表

FruCtrl 类 - 必选属性

FruCtrl 类 - 可选属性

📝 配置示例

FRU电源控制配置

延迟上电配置

🔧 使用指南

配置步骤

注意事项

故障排查