文档中心
CSR配置字典之TemperatureInfo类
更新时间： 2025/07/22
在Gitcode上查看源码

📋 文档信息 ​

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

📋 变更历史记录 ​

文档变更记录 ​

版本发布日期变更类型变更内容影响范围维护人员
v1.02025-01-27初始版本创建TemperatureInfo类配置字典全新文档系统管理员
v1.12026-05-12补丁版本修改类概览描述信息和注意事项类概览描述信息和注意事项汪航

🎯 类概览 ​

TemperatureInfo 类 ​

属性值
类名称TemperatureInfo
功能描述温度海洋对象，提供温度海洋界面对应温度点的信息和配置
所属SIG组hardware
所属组件cooling
责任人能效管理组
最后更新2026-05-12
状态🟢 正常运行

📊 属性定义详表 ​

必选属性 ​

属性名类型默认值取值范围动态关联描述使用场景举例来源分类
CoordinateXU80U8-温度点横坐标
温度海洋界面默认朝向为：面朝硬盘方向，俯视后以左下角为坐标轴原点，横坐标最大值为16，纵坐标最大值为27		温度海洋界面对应温度点的横坐标，当前以服务器2U的俯视图进行适配的值，为固定值，仅根据槽位有区别，当前不支持灵活配置7硬件硬件
CoordinateYU80U8-温度点纵坐标温度海洋界面对应温度点的横坐标，当前以服务器2U的俯视图进行适配的值，为固定值，仅根据槽位有区别，当前不支持灵活配置6硬件硬件
HealthString""String"<=/ThresholdSensor_FanBoardTemp.Health"告警状态温度海洋界面对应温度点的健康状态"<=/ThresholdSensor_FanBoardTemp.Health"硬件硬件
LowerThresholdU8[][]U8[]-告警阈值下限，低于该阈值会触发告警温度海洋界面对应温度点的告警阈值
数组值分别表示轻微阈值，严重阈值，致命阈值，其中255为默认值，表示对应程度无告警阈值		[255, 255, 255]CSR配置软件
NameString""String-温度点名称，用于温度海洋界面对应温度点的传感器名称显示温度海洋界面对应温度点的传感器名称"CLU${Slot} Temp"CSR配置软件
ReadingValueDouble0Double"<=/Scanner_FanBrdTemp.Value"温度值温度海洋界面对应温度点的温度值"<=/Scanner_FanBrdTemp.Value"传感器读数硬件
StatusU8[][]U8[]"<=/Scanner_FanBrdTemp.Status"传感器状态温度海洋界面对应温度点的传感器状态"<=/Scanner_FanBrdTemp.Status"传感器读数硬件
UpperThresholdU8[][]U8[]-告警阈值上限，高于该阈值会触发告警温度海洋界面对应温度点的告警阈值
数组值分别表示轻微阈值，严重阈值，致命阈值，其中255为默认值，表示对应程度无告警阈值		[255, 255, 255]CSR配置软件

可选属性 ​

无可选属性

🔗 动态关联机制 ​

语法规范 ​

使用基础语法以及 <=/xxx 和表达式语法实现动态关联：

yaml
# 坐标配置
CoordinateX: 7          # 温度点横坐标
CoordinateY: 10         # 温度点纵坐标
Name: "CLU${Slot} Temp" # 温度点名称

# 传感器状态动态关联
Health: "<=/ThresholdSensor_FanBoardTemp.Health"
Status: "<=/Scanner_FanBrdTemp.Status"
ReadingValue: "<=/Scanner_FanBrdTemp.Value"

# 传感器告警门限
LowerThreshold: [255, 255, 255]
UpperThreshold: [255, 100, 105]

关联说明 ​

  • Scanner关联: 通过Scanner获取温度点传感器状态值和传感器读值
  • 传感器关联: 通过ThresholdSensor获取传感器告警状态

📂 分类标准 ​

硬件属性 ​

  • 定义：与温度传感器硬件直接相关的参数
  • 特点：可观测传感器位置，传感器健康状态等
  • 示例：CoordinateX，CoordinateY，Health，ReadingValue，Status

软件属性 ​

  • 定义：由软件管理和维护的温度点告警阈值
  • 特点：可观测传感器告警状态
  • 示例：Name，LowerThreshold，UpperThreshold

📝 配置示例 ​

基础温度海洋配置 ​

json
{
  "TemperatureInfo_CLU1": {
    "CoordinateX": 7,
    "CoordinateY": 6,
    "Health": "<=/ThresholdSensor_FanBoardTemp.Health",
    "LowerThreshold": [255, 255, 255],
    "Name": "CLU1 Temp",
    "ReadingValue": "<=/Scanner_FanBrdTemp.Value",
    "Status": "<=/Scanner_FanBrdTemp.Status",
    "UpperThreshold": [255, 255, 255]
  }
}

多温度点配置 ​

json
{
  "TemperatureInfo_CPU": {
    "CoordinateX": 8,
    "CoordinateY": 12,
    "Health": "<=/ThresholdSensor_CPUTemp.Health",
    "LowerThreshold": [0, 0, 0],
    "Name": "CPU Temp",
    "ReadingValue": "<=/Scanner_CPUTemp.Value",
    "Status": "<=/Scanner_CPUTemp.Status",
    "UpperThreshold": [70, 85, 95]
  },
  "TemperatureInfo_Memory": {
    "CoordinateX": 10,
    "CoordinateY": 8,
    "Health": "<=/ThresholdSensor_MemoryTemp.Health",
    "LowerThreshold": [0, 0, 0],
    "Name": "Memory Temp",
    "ReadingValue": "<=/Scanner_MemoryTemp.Value",
    "Status": "<=/Scanner_MemoryTemp.Status",
    "UpperThreshold": [65, 80, 90]
  }
}

🔧 使用指南 ​

配置步骤 ​

  1. 坐标规划: 根据物理布局规划温度点坐标
  2. 传感器关联: 关联对应的温度传感器
  3. 阈值设置: 设置合适的告警阈值
  4. 界面验证: 验证温度海洋界面显示

坐标系说明 ​

  • 原点: 左下角为坐标轴原点
  • 朝向: 面朝硬盘方向，俯视角度
  • 范围: 横坐标最大值16，纵坐标最大值27
  • 适配: 当前以2U俯视图适配
  • 横纵坐标配置: 若存在同一个位置有多个器件，器件进行横纵坐标上下偏移1进行配置；若同一器件存在多个位置，则根据器件槽位号进行配置偏移，例如NIC卡横坐标可根据槽位号偏移，${Slot} | expr($1 == 1 ? 13 : 7)

阈值配置说明 ​

  • 数组格式: [轻微阈值, 严重阈值, 致命阈值]
  • 上限阈值: 温度高于该值触发告警
  • 下限阈值: 温度低于该值触发告警
  • 255值: 表示不设置该级别阈值

使用场景 ​

  • 温度监控: 实时监控系统温度分布
  • 可视化: 温度海洋界面可视化展示
  • 告警管理: 温度异常告警处理

注意事项 ​

  • 坐标固定: 当前坐标值为固定值，不支持灵活配置
  • 传感器关联: 确保传感器对象正确配置
  • 阈值合理: 设置合理的温度告警阈值，并且告警阈值需与对应传感器的告警阈值保持一致
  • 温度值关联: 温度值可直接引用传感器的读值
  • 告警状态关联: 告警状态可直接引用传感器的健康状态

📚 相关文档 ​

上一篇Temperature
下一篇Lm75