CSR配置字典之FruCtrl类
更新时间： 2026/05/15
在Gitcode上查看源码📋 文档信息
| 项目 | 内容 |
|---|---|
| 文档标题 | FruCtrl类配置字典 |
| 版本 | v1.1 |
| 创建日期 | 2025-01-27 |
| 最后更新 | 2026-05-15 |
| 维护状态 | ✅ 活跃维护 |
📋 变更历史记录
文档变更记录
| 版本 | 发布日期 | 变更类型 | 变更内容 | 影响范围 | 维护人员 |
|---|---|---|---|---|---|
| v1.0 | 2025-01-27 | 初始版本 | 创建FruCtrl类配置字典 | 全新文档 | 系统管理员 |
| v1.1 | 2026-05-15 | 修订 | 对齐model.json，新增DelayedPowerOnPolicy、GracefulShutdownDefault/Max/MinTimeoutSeconds等属性 | FruCtrl所有CSR属性 | 基础服务组 |
🎯 类概览
FruCtrl 类
| 属性 | 值 |
|---|---|
| 类名称 | FruCtrl |
| 功能描述 | FRU电源控制，支持上电策略、优雅关机、热插拔状态、延迟上电等完整电源管理功能 |
| 所属SIG组 | hardware |
| 所属组件 | fructrl |
| 责任人 | 基础服务组 |
| 最后更新 | 2026-05-15 |
| 状态 | 🟢 正常运行 |
📊 属性定义详表
FruCtrl 类 - 必选属性
| 属性名 | 类型 | 默认值 | 取值范围 | 动态关联 | 描述 | 使用场景 | 举例 | 来源 | 分类 |
|---|---|---|---|---|---|---|---|---|---|
Id | U8 | - | U8 | - | FRU控制对象标识，主键 | 唯一标识FRU控制对象 | 1 | CSR | 软件 |
SysResetDetected | U8 | - | U8 | - | 系统复位检测标记 | 检测系统复位事件 | 0 | CSR | 软件 |
FruType | U8 | - | U8 | - | FRU类型标识 | 配置FRU类型 | 1 | CSR | 软件 |
HotswapState | U8 | - | U8 | - | 热插拔状态 | 配置热插拔状态 | 0 | 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 | 软件 |
📝 配置示例
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配置是否正确