CSR配置字典之SwitchRule类
更新时间： 2026/05/16
在Gitcode上查看源码📋 文档信息
| 项目 | 内容 |
|---|---|
| 文档标题 | SwitchRule类配置字典 |
| 版本 | v1.0 |
| 创建日期 | 2026/05/16 |
| 最后更新 | 2026/05/16 |
| 维护状态 | ✅ 活跃维护 |
📋 变更历史记录
文档变更记录
| 版本 | 发布日期 | 变更类型 | 变更内容 | 影响范围 | 维护人员 |
|---|---|---|---|---|---|
| v1.0 | 2026/05/16 | 初始版本 | 创建SwitchRule类配置字典 | 全新文档 | active_standby_mgmt组件组 |
🎯 类概览
SwitchRule 类
| 属性 | 值 |
|---|---|
| 类名称 | SwitchRule |
| 功能描述 | 主备切换规则配置管理，支持条件类型、门限值、运算符和切换方向 |
| 所属SIG组 | hardware |
| 所属组件 | active_standby_mgmt |
| 责任人 | 基础服务组 |
| 最后更新 | 2026/05/16 |
| 状态 | 🟢 正常运行 |
📊 属性定义详表
SwitchRule 类 - 必选属性
| 属性名 | 类型 | 默认值 | 取值范围 | 动态关联 | 描述 | 使用场景 | 举例 | 来源 | 分类 |
|---|---|---|---|---|---|---|---|---|---|
RuleType | U8 | - | U8 | - | 切换条件类型 0：BMC主动切换的触发条件 1：BMC被动切换的禁止条件 | 配置主备切换触发条件 | 1 | CSR | 软件 |
Threshold | String | - | String | - | 当前主备切换条件的门限值 | 配置切换阈值 | "80" | CSR | 软件 |
Reading | String | - | String | - | 当前主备切换条件的输入值 | 查看当前传感器读数 | "75" | CSR | 软件 |
Enabled | Boolean | - | true/false | - | 是否使能当前主备切换条件 | 启用/禁用切换规则 | true | CSR | 软件 |
Operator | U8 | - | U8 | - | 当前主备切换条件的运算符 1：小于 2：小于等于 3：大于 4： 大于等于 5：等于 6：不等于 | 配置比较运算符 | 1 | CSR | 软件 |
Direction | U8 | - | U8 | - | 切换条件类型配置为0时表示BMC主动切换的主备方向，配置为1时表示被动切换时被禁止的主备方向 0： 降备 1： 升主 | 配置切换目标状态 | 1 | CSR | 软件 |
Description | String | - | String | - | 当前主备切换条件匹配之后的描述信息，表示BMC发生主动切换或者被动切换禁止的原因 | 配置切换规则描述 | "温度过高降备" | CSR | 软件 |
取值说明
Operator（运算符）
| 值 | 含义 |
|---|---|
| 1 | 大于 |
| 2 | 大于等于 |
| 3 | 小于 |
| 4 | 小于等于 |
| 5 | 等于 |
| 6 | 不等于 |
Direction（切换方向）
| 值 | 含义 |
|---|---|
| 0 | 无动作 |
| 1 | 降备 |
| 2 | 升主 |
📝 配置示例
主备切换规则配置
json
{
"SwitchRule": {
"RuleType": 1,
"Threshold": "80",
"Reading": "75",
"Enabled": true,
"Operator": 1,
"Direction": 1,
"Description": "温度超过80摄氏度时降备"
}
}🔧 使用指南
配置步骤
配置条件类型：设置 RuleType 确定触发条件的种类（如温度、电压等）
配置比较运算符：设置 Operator（1:大于 2:大于等于 3:小于 4:小于等于 5:等于 6:不等于）
配置门限值：设置 Threshold 作为比较的阈值
配置切换方向：设置 Direction（0:无动作 1:降备 2:升主）
使能规则：设置 Enabled 为 true 启用切换规则
添加描述：设置 Description 便于维护识别
注意事项
RuleType 需要与实际传感器类型匹配
Operator 和 Threshold 配合使用，Reading 值与 Threshold 按 Operator 比较
Enabled 写入需要 BasicSetting 权限
Reading 为只读属性，自动从传感器获取
故障排查
规则未触发：检查 Enabled 是否为 true，RuleType 是否匹配实际传感器
切换方向错误：确认 Direction 配置是否符合预期（降备/升主）
阈值比较异常：检查 Operator 和 Threshold 配置是否合理