Skip to contentSkip to conversation

powernv/opal-sensor-groups: Add documentation for the sysfs interfaces

PATCH Applied Gautham R. Shenoy 2 participants 2 messages Nov 26, 2019 – Apr 1, 2020

lore
Share & tools
lore
#0 lore raw

PATCH 1/1 powernv/opal-sensor-groups: Add documentation for the sysfs interfaces

From: Shilpasri G Bhat <[email protected]>

Commit bf9571550f52 ("powerpc/powernv: Add support to clear sensor groups data") added a mechanism to clear sensor-group data via a sysfs interface. However, the ABI for that interface has not been documented.

This patch documents the ABI for the sysfs interface for sensor-groups and clearing the sensor-groups.

This patch was originally sent by Shilpasri G Bhat on the mailing list:
https://lkml.org/lkml/2018/8/1/85

---
 .../ABI/testing/sysfs-firmware-opal-sensor-groups   | 21 +++++++++++++++++++++
 1 file changed, 21 insertions(+)
 create mode 100644 Documentation/ABI/testing/sysfs-firmware-opal-sensor-groups
Documentation/ABI/testing/sysfs-firmware-opal-sensor-groups new file +21 -0
new file mode 100644
index 0000000..3a2dfe5
@@ -0,0 +1,21 @@
+What:		/sys/firmware/opal/sensor_groups
+Date:		August 2017
+Contact:	Linux for PowerPC mailing list <[email protected]>
+Description:	Sensor groups directory for POWER9 powernv servers
+
+		Each folder in this directory contains a sensor group
+		which are classified based on type of the sensor
+		like power, temperature, frequency, current, etc. They
+		can also indicate the group of sensors belonging to
+		different owners like CSM, Profiler, Job-Scheduler
+
+What:		/sys/firmware/opal/sensor_groups/<sensor_group_name>/clear
+Date:		August 2017
+Contact:	Linux for PowerPC mailing list <[email protected]>
+Description:	Sysfs file to clear the min-max of all the sensors
+		belonging to the group.
+
+		Writing 1 to this file will clear the minimum and
+		maximum values of all the sensors in the group.
+		In POWER9, the min-max of a sensor is the historical minimum
+		and maximum value of the sensor cached by OCC.
Signature · 1 line
1.9.4
#1 lore raw
Quoted 7 lines · Gautham R. Shenoy

From: Shilpasri G Bhat <[email protected]>

Commit bf9571550f52 ("powerpc/powernv: Add support to clear sensor groups data") added a mechanism to clear sensor-group data via a sysfs interface. However, the ABI for that interface has not been documented.

Quoted 8 lines

This patch documents the ABI for the sysfs interface for sensor-groups and clearing the sensor-groups.

This patch was originally sent by Shilpasri G Bhat on the mailing list:
https://lkml.org/lkml/2018/8/1/85

Applied to powerpc next, thanks.

https://git.kernel.org/powerpc/c/32377bd2cbb62e23ac0a1aaaf0048957c5fd9f02

cheers