内核驱动 occ-hwmon¶
支持的芯片
POWER8
POWER9
作者:Eddie James <eajames@linux.ibm.com>
描述¶
该驱动程序支持对嵌入在 POWER 处理器上的片上控制器 (OCC) 进行硬件监控。OCC 是一种从处理器和系统中收集并聚合传感器数据的设备。OCC 可以提供原始传感器数据,并对系统执行热管理和电源管理。
该驱动程序的 P8 版本是 I2C 的客户端驱动程序。如果在设备树中相应的 I2C 总线节点下找到兼容“ibm,p8-occ-hwmon”的设备,则可以手动探测。
该驱动程序的 P9 版本是基于 FSI 的 OCC 驱动程序的客户端驱动程序。它将由基于 FSI 的 OCC 驱动程序自动探测。
Sysfs 条目¶
支持以下属性。除非另有说明,所有属性均为只读。
OCC 传感器 ID 是一个整数,表示传感器相对于 OCC 的唯一标识符。例如,系统中第三个 DIMM 插槽的温度传感器可能具有传感器 ID 7。此映射对设备驱动程序不可用,因此驱动程序必须按原样导出传感器 ID。
某些条目仅存在于特定 OCC 传感器版本或系统中的特定 OCC 上。版本号不向用户导出,但可以推断。
- temp[1-n]_label
OCC 传感器 ID。
[适用于温度传感器版本 1]
- temp[1-n]_input
组件的测量温度,单位为毫摄氏度。
[适用于温度传感器版本 >= 2]
- temp[1-n]_type
该传感器测量的组件的 FRU(现场可更换单元)类型(由整数表示)。
- temp[1-n]_fault
温度传感器故障布尔值;1 表示存在故障,0 表示无故障。
[当类型 == 3 时 (FRU 类型为 VRM)]
- temp[1-n]_alarm
VRM 温度报警布尔值;1 表示报警,0 表示无报警。
[否则]
- temp[1-n]_input
组件的测量温度,单位为毫摄氏度。
- freq[1-n]_label
OCC 传感器 ID。
- freq[1-n]_input
组件的测量频率,单位为 MHz。
- power[1-n]_input
组件的最新测量功耗读数,单位为微瓦。
- power[1-n]_average
组件的平均功耗,单位为微瓦。
- power[1-n]_average_interval
计算平均功耗所用的时间,单位为微秒。
[适用于功耗传感器版本 < 2]
- power[1-n]_label
OCC 传感器 ID。
[适用于功耗传感器版本 >= 2]
- power[1-n]_label
OCC 传感器 ID + 功能 ID + 通道,以字符串形式表示,由下划线分隔,例如“0_15_1”。功能 ID 和通道都是整数,用于进一步标识功耗传感器。
[适用于功耗传感器版本 0xa0]
- power[1-n]_label
OCC 传感器 ID + 传感器类型,以字符串形式表示,由下划线分隔,例如“0_system”。传感器类型将是“system”、“proc”、“vdd”或“vdn”之一。对于此传感器版本,所有功耗传感器的 OCC 传感器 ID 都将相同。
[仅存在于“主”OCC 上;表示整个系统功耗;仅存在一个这种类型的功耗传感器]
- power[1-n]_label
“system”
- power[1-n]_input
系统最新输出功耗,单位为微瓦。
- power[1-n]_cap
当前系统功耗上限,单位为微瓦。
- power[1-n]_cap_not_redundant
在没有冗余电源时的系统功耗上限,单位为微瓦。
- power[1-n]_cap_max
OCC 可以施加的最大功耗上限,单位为微瓦。
- power[1-n]_cap_min OCC 可以施加的最小功耗上限,单位为
微瓦。
- power[1-n]_cap_user 用户设置的功耗上限,单位为微瓦。
如果未设置用户功耗上限,此属性将返回 0。此属性是可读写的,但任何低于瓦特的精度写入都将被忽略,例如,请求 500900000 微瓦的功耗上限将导致请求 500 瓦的功耗上限。
[适用于上限传感器版本 > 1]
- power[1-n]_cap_user_source
指示用户功耗上限是如何设置的。这是一个整数,映射到可以设置用户功耗上限的系统或固件组件。
以下“extn”传感器作为 OCC 提供其他地方不适合的数据的方式而导出。这些传感器的含义完全取决于其数据,无法静态定义。
- extn[1-n]_label
ASCII ID 或 OCC 传感器 ID。
- extn[1-n]_flags
这是一个单字节十六进制值。第 7 位指示标签属性的类型;1 表示传感器 ID,0 表示 ASCII ID。其他位保留。
- extn[1-n]_input
6 字节的十六进制数据,其含义由传感器 ID 定义。