内核驱动 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 定义。