Kernel Driver IBMPOWERNV

POWERNV 플랫폼 센서 등록

`IBMPOWERNV` 드라이버는 POWERNV 플랫폼 기반의 최신 IBM P 서버를 지원하며 작성자는 Neelesh Gupta입니다. 온도, 팬, 전압, 전력 같은 플랫폼 센서 데이터를 읽는 기능을 구현합니다.

드라이버는 플랫폼 장치 기반 구조를 사용합니다. `__init` 단계에서 장치 트리의 센서 장치를 조사해 `hwmon`에 등록하고, hwmon 코어는 센서 형식과 속성 데이터별 파일로 이루어진 `sysfs` 트리를 만듭니다.

모든 장치 트리 노드는 `/ibm,opal/sensors` 아래에 있으며 유효한 노드 하나가 sysfs 속성 파일 하나에 대응합니다. 각 노드는 고유한 `sensor-id`를 내보내고, 드라이버는 이 ID로 펌웨어에 OPAL 호출을 보냅니다.

`CONFIG_SENSORS_IBMPOWERNV`를 활성화하면 커널에 정적으로 포함할 수 있고, `ibmpowernv` 모듈로도 빌드할 수 있습니다.

Kernel Driver IBMPOWERNV
========================

Supported systems:

  * Any recent IBM P servers based on POWERNV platform

Author: Neelesh Gupta

Description
-----------

This driver implements reading the platform sensors data like temperature/fan/
voltage/power for 'POWERNV' platform.

The driver uses the platform device infrastructure. It probes the device tree
for sensor devices during the __init phase and registers them with the 'hwmon'.
'hwmon' populates the 'sysfs' tree having attribute files, each for a given
sensor type and its attribute data.

All the nodes in the DT appear under "/ibm,opal/sensors" and each valid node in
the DT maps to an attribute file in 'sysfs'. The node exports unique 'sensor-id'
which the driver uses to make an OPAL call to the firmware.

Usage notes
-----------
The driver is built statically with the kernel by enabling the config
CONFIG_SENSORS_IBMPOWERNV. It can also be built as module 'ibmpowernv'.

팬과 온도 센서 속성

팬 채널은 RPM 측정값 `fanX_input`, 경보 발생 임계 RPM `fanX_min`, 고장 상태 `fanX_fault`를 제공합니다. `fanX_fault`가 0이면 고장 조건이 없고 1이면 팬이 고장 중입니다.

온도 채널은 주변 온도 측정값 `tempX_input`, 경보 임계 온도 `tempX_max`, 과거 최고·최저 온도 `tempX_highest`와 `tempX_lowest`를 제공합니다.

`tempX_enable`은 같은 하위 그룹에 속한 모든 온도 센서를 활성화하거나 비활성화합니다. POWER9에서는 이 속성이 각 OCC에 대응하므로 OCC별로 소속 온도 센서 전체를 끄거나 켤 수 있습니다. 값 1은 활성화, 0은 비활성화입니다.

Sysfs attributes
----------------

======================= =======================================================
fanX_input                Measured RPM value.
fanX_min                Threshold RPM for alert generation.
fanX_fault                - 0: No fail condition
                        - 1: Failing fan

tempX_input                Measured ambient temperature.
tempX_max                Threshold ambient temperature for alert generation.
tempX_highest                Historical maximum temperature
tempX_lowest                Historical minimum temperature
tempX_enable                Enable/disable all temperature sensors belonging to the
                        sub-group. In POWER9, this attribute corresponds to
                        each OCC. Using this attribute each OCC can be asked to
                        disable/enable all of its temperature sensors.

                        - 1: Enable
                        - 0: Disable

전압과 전력 센서 속성

전압 채널은 millivolt 단위 측정값 `inX_input`, 고장 상태 `inX_fault`, 과거 최고·최저 전압 `inX_highest`와 `inX_lowest`를 제공합니다. `inX_fault`는 0이면 고장 없음, 1이면 전원 공급 장치 고장을 뜻합니다.

`inX_enable`은 같은 하위 그룹의 전압 센서 전체를 활성화하거나 비활성화합니다. POWER9에서는 각 OCC에 대응하며, 1은 활성화, 0은 비활성화입니다.

전력 채널은 microWatt 단위 소비 전력 `powerX_input`, 과거 최고·최저 전력 `powerX_input_highest`와 `powerX_input_lowest`, 하위 그룹 전체를 제어하는 `powerX_enable`을 제공합니다. POWER9의 `powerX_enable`도 OCC 단위로 작동하며 1은 활성화, 0은 비활성화입니다.

inX_input                Measured power supply voltage (millivolt)
inX_fault                - 0: No fail condition.
                        - 1: Failing power supply.
inX_highest                Historical maximum voltage
inX_lowest                Historical minimum voltage
inX_enable                Enable/disable all voltage sensors belonging to the
                        sub-group. In POWER9, this attribute corresponds to
                        each OCC. Using this attribute each OCC can be asked to
                        disable/enable all of its voltage sensors.

                        - 1: Enable
                        - 0: Disable

powerX_input                Power consumption (microWatt)
powerX_input_highest        Historical maximum power
powerX_input_lowest        Historical minimum power
powerX_enable                Enable/disable all power sensors belonging to the
                        sub-group. In POWER9, this attribute corresponds to
                        each OCC. Using this attribute each OCC can be asked to
                        disable/enable all of its power sensors.

                        - 1: Enable
                        - 0: Disable

전류와 누적 에너지 속성

전류 채널은 milliampere 단위 측정값 `currX_input`, 과거 최고·최저 전류 `currX_highest`와 `currX_lowest`, 하위 그룹 전체를 제어하는 `currX_enable`을 제공합니다. POWER9에서 이 활성화 속성은 OCC별 전류 센서 전체에 적용되며 1은 활성화, 0은 비활성화입니다.

`energyX_input`은 microJoule 단위의 누적 에너지를 제공합니다. 순간값인 전류·전력과 달리 시간에 따라 누적되는 값이므로 소비량 분석에서는 측정 시점 간 차이를 사용할 수 있습니다.

currX_input                Measured current (milliampere)
currX_highest                Historical maximum current
currX_lowest                Historical minimum current
currX_enable                Enable/disable all current sensors belonging to the
                        sub-group. In POWER9, this attribute corresponds to
                        each OCC. Using this attribute each OCC can be asked to
                        disable/enable all of its current sensors.

                        - 1: Enable
                        - 0: Disable

energyX_input                Cumulative energy (microJoule)
======================= =======================================================