CSR配置字典之LeakDetector类
更新时间: 2025/07/22
在Gitcode上查看源码📋 文档信息
| 项目 | 内容 |
|---|---|
| 文档标题 | LeakDetector类配置字典 |
| 版本 | v1.0 |
| 创建日期 | 2026-05-12 |
| 最后更新 | 2026-05-12 |
| 维护状态 | ✅ 活跃维护 |
📋 变更历史记录
文档变更记录
| 版本 | 发布日期 | 变更类型 | 变更内容 | 影响范围 | 维护人员 |
|---|---|---|---|---|---|
| v1.0 | 2026-05-12 | 初始版本 | 创建LeakDetector类配置字典 | 全新文档 | 汪航 |
🎯 类概览
LeakDetector 类
| 属性 | 值 |
|---|---|
| 类名称 | LeakDetector |
| 功能描述 | 漏液检测点对象,提供漏液检测点配置,用于检测设备内部是否存在液体泄漏,并提供相关状态信息和配置选项 |
| 所属SIG组 | hardware |
| 所属组件 | cooling |
| 责任人 | 能效管理 |
| 最后更新 | 2026-05-12 |
| 状态 | 🟢 正常运行 |
📊 属性定义详表
必选属性
| 属性名 | 类型 | 默认值 | 取值范围 | 动态关联 | 描述 | 使用场景 | 举例 | 来源 | 分类 |
|---|---|---|---|---|---|---|---|---|---|
Id | U8 | 0 | U8 | - | 漏液检测点Id | 液冷设备中的漏液检测点编号 | 1 | CSR配置 | 软件 |
Name | String | "" | String | - | 漏液检测点名称 | 液冷设备中的漏液检测点名称 | "Chassis Leak Detector" | CSR配置 | 软件 |
Enabled | Boolean | false | true/false | - | 是否使能漏液检测点 false:不使能,true:使能 | 是否使能漏液检测点 | true | CSR配置 | 软件 |
State | U8 | 0 | 0或1或2 | "<=/Scanner_WatCabAbsent.Value;<=/Scanner_LiquidLeakage.Value |> expr(($1 == 0) ? 0 : (($2 != 0) ? 2 : 0))" | 漏液状态 0:无漏液,1:轻微漏液,2:严重漏液 | 液冷设备中的漏液程度情况 | 详见动态关联 | CSR配置 | 硬件 |
Health | U8 | 0 | 0或1 | "<=/Scanner_WatCabAbsent.Value;<=/Scanner_LiquidLeakage.Value |> expr(($1 == 0) ? 0 : (($2 != 0) ? 0 : 1))" | 漏液传感器状态 0:无漏液,1:有漏液 | 液冷设备中的漏液传感器情况 | 详见动态关联 | CSR配置 | 硬件 |
可选属性
| 属性名 | 类型 | 默认值 | 取值范围 | 动态关联 | 描述 | 使用场景 | 举例 | 来源 | 分类 |
|---|---|---|---|---|---|---|---|---|---|
LeakDetectorType | String | "" | "FloatSwitch"或"Moisture"或"" | - | 漏液检测传感器类型 FloatSwitch: 浮子传感器,Moisture: 湿度传感器 | 液冷设备中的漏液检测传感器类型 | "FloatSwitch" | CSR配置 | 软件 |
Manufacturer | String | "" | String | - | 漏液检测器的厂商 | 液冷设备中的漏液检测器的厂商 | "" | CSR配置 | 软件 |
Model | String | "" | String | - | 漏液检测器的型号 | 液冷设备中的漏液检测器的型号 | "" | CSR配置 | 软件 |
PartNumber | String | "" | String | - | 漏液检测器的部件编码 | 液冷设备中的漏液检测器的部件编码 | "" | CSR配置 | 软件 |
PhysicalContext | String | "" | String | - | 漏液检测器适用的区域或设备, 取值包括但不限于: CPU, CPUSubsystem, Chassis, GPU, GPUSubsystem等 | 液冷设备中的漏液检测器适用的区域或设备 | "Chassis" | CSR配置 | 软件 |
SericalNumber | String | "" | String | - | 漏液检测器的序列号 | 液冷设备中的漏液检测器的序列号 | "" | CSR配置 | 软件 |
ServiceLabel | String | "" | String | - | 漏液检测器的位置标签,如丝印名称或印刷标签 | 液冷设备中的漏液检测器的位置标签,如丝印名称或印刷标签 | "" | CSR配置 | 软件 |
LocationReference | String | "" | "Bottom"或"Front"或"Left"或"Middle"或"Rear"或"Right"或"Top"或"" | - | 漏液检测器的位置参考 | 液冷设备中的漏液检测器的位置参考 | "Bottom" | CSR配置 | 软件 |
🔗 动态关联机制
语法规范
使用基础语法以及 <=/xxx 和表达式语法实现动态关联:
yaml
# 漏液检测器配置
Enabled: true # 使能漏液检测点
# 漏液状态动态关联
State: "<=/Scanner_WatCabAbsent.Value;<=/Scanner_LiquidLeakage.Value |> expr(($1 == 0) ? 0 : (($2 != 0) ? 2 : 0))"
# 漏液传感器状态动态关联
Health: "<=/Scanner_WatCabAbsent.Value;<=/Scanner_LiquidLeakage.Value |> expr(($1 == 0) ? 0 : (($2 != 0) ? 0 : 1))"关联说明
- 传感器关联: 通过Scanner_WatCabAbsent和Scanner_LiquidLeakage获取漏液传感器值
- 表达式计算: 使用expr函数计算漏液状态和漏液传感器状态
- 状态映射: 将传感器值映射为漏液状态等级
📂 分类标准
硬件属性
- 定义:与漏液检测器硬件直接相关的参数
- 特点:可观测漏液检测器的漏液状态和传感器状态
- 示例:State,Health
软件属性
- 定义:由软件管理和维护的漏液检测参数
- 特点:名称配置、厂商配置、状态检测等
- 示例:Id,Name,Enabled,LeakDetectorType,Manufacturer,Model,PartNumber,PhysicalContext,SericalNumber,ServiceLabel,LocationReference
📝 配置示例
整机漏液检测配置
json
{
"LeakDetector_Chassis": {
"Id": 1,
"Name": "Chassis Leak Detector",
"Enabled": true,
"State": "<=/Scanner_WatCabAbsent.Value;<=/Scanner_LiquidLeakage.Value |> expr(($1 == 0) ? 0 : (($2 != 0) ? 2 : 0))",
"Health": "<=/Scanner_WatCabAbsent.Value;<=/Scanner_LiquidLeakage.Value |> expr(($1 == 0) ? 0 : (($2 != 0) ? 0 : 1))",
"PhysicalContext": "Chassis"
}
}湿度传感器漏液检测配置
json
{
"LeakDetector_Moisture": {
"Id": 1,
"Name": "Liquid Cooling Door Leak Detector",
"Enabled": true,
"State": "<=/Scanner_WatCabAbsent.Value;<=/Scanner_LiquidLeakage.Value |> expr(($1 == 0) ? 0 : (($2 != 0) ? 2 : 0))",
"Health": "<=/Scanner_WatCabAbsent.Value;<=/Scanner_LiquidLeakage.Value |> expr(($1 == 0) ? 0 : (($2 != 0) ? 0 : 1))",
"LeakDetectorType": "Moisture",
"PhysicalContext": "Chassis",
"LocationReference": "Bottom"
}
}🔧 使用指南
配置步骤
- 硬件确认: 确认系统是否支持漏液检测
- 策略设置: 根据设备要求设置漏液检测器使能状态
- 传感器配置: 配置漏液检测器对应传感器的Scanner对象
- 测试验证: 验证漏液检测功能是否正常
漏液状态说明
- 0: 无漏液,系统正常
- 1: 轻微漏液,需要关注
- 2: 严重漏液,需要立即处理
漏液传感器状态说明
- 0: 无漏液,系统正常
- 1: 有漏液,需要结合漏液状态进行关注
策略配置说明
- Enabled: 漏液检测器开关,控制是否启用漏液检测
使用场景
- 液冷系统: 配备液冷散热的系统
- 安全保护: 需要漏液安全保护的场景
- 自动化: 需要自动处理漏液的场景
注意事项
- 硬件支持: 确保硬件支持漏液检测
- 传感器正常: 确保漏液传感器正常工作
- 策略合理: 根据实际需求设置合理的策略