Orange Pi5 kernel

Deprecated Linux kernel 5.10.110 for OrangePi 5/5B/5+ boards

3 Commits   0 Branches   0 Tags
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  1) Kernel Driver IBMPOWERNV
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  2) ========================
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  3) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  4) Supported systems:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  5) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  6)   * Any recent IBM P servers based on POWERNV platform
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  7) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  8) Author: Neelesh Gupta
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  9) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 10) Description
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 11) -----------
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 12) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 13) This driver implements reading the platform sensors data like temperature/fan/
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 14) voltage/power for 'POWERNV' platform.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 15) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 16) The driver uses the platform device infrastructure. It probes the device tree
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 17) for sensor devices during the __init phase and registers them with the 'hwmon'.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 18) 'hwmon' populates the 'sysfs' tree having attribute files, each for a given
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 19) sensor type and its attribute data.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 20) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 21) All the nodes in the DT appear under "/ibm,opal/sensors" and each valid node in
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 22) the DT maps to an attribute file in 'sysfs'. The node exports unique 'sensor-id'
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 23) which the driver uses to make an OPAL call to the firmware.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 24) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 25) Usage notes
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 26) -----------
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 27) The driver is built statically with the kernel by enabling the config
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 28) CONFIG_SENSORS_IBMPOWERNV. It can also be built as module 'ibmpowernv'.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 29) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 30) Sysfs attributes
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 31) ----------------
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 32) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 33) ======================= =======================================================
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 34) fanX_input		Measured RPM value.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 35) fanX_min		Threshold RPM for alert generation.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 36) fanX_fault		- 0: No fail condition
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 37) 			- 1: Failing fan
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 38) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 39) tempX_input		Measured ambient temperature.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 40) tempX_max		Threshold ambient temperature for alert generation.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 41) tempX_highest		Historical maximum temperature
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 42) tempX_lowest		Historical minimum temperature
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 43) tempX_enable		Enable/disable all temperature sensors belonging to the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 44) 			sub-group. In POWER9, this attribute corresponds to
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 45) 			each OCC. Using this attribute each OCC can be asked to
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 46) 			disable/enable all of its temperature sensors.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 47) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 48) 			- 1: Enable
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 49) 			- 0: Disable
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 50) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 51) inX_input		Measured power supply voltage (millivolt)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 52) inX_fault		- 0: No fail condition.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 53) 			- 1: Failing power supply.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 54) inX_highest		Historical maximum voltage
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 55) inX_lowest		Historical minimum voltage
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 56) inX_enable		Enable/disable all voltage sensors belonging to the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 57) 			sub-group. In POWER9, this attribute corresponds to
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 58) 			each OCC. Using this attribute each OCC can be asked to
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 59) 			disable/enable all of its voltage sensors.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 60) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 61) 			- 1: Enable
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 62) 			- 0: Disable
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 63) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 64) powerX_input		Power consumption (microWatt)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 65) powerX_input_highest	Historical maximum power
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 66) powerX_input_lowest	Historical minimum power
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 67) powerX_enable		Enable/disable all power sensors belonging to the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 68) 			sub-group. In POWER9, this attribute corresponds to
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 69) 			each OCC. Using this attribute each OCC can be asked to
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 70) 			disable/enable all of its power sensors.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 71) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 72) 			- 1: Enable
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 73) 			- 0: Disable
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 74) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 75) currX_input		Measured current (milliampere)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 76) currX_highest		Historical maximum current
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 77) currX_lowest		Historical minimum current
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 78) currX_enable		Enable/disable all current sensors belonging to the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 79) 			sub-group. In POWER9, this attribute corresponds to
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 80) 			each OCC. Using this attribute each OCC can be asked to
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 81) 			disable/enable all of its current sensors.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 82) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 83) 			- 1: Enable
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 84) 			- 0: Disable
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 85) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 86) energyX_input		Cumulative energy (microJoule)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 87) ======================= =======================================================