tools/thermal: Introduce tmon, a tool for thermal subsystem

Increasingly, Linux is running on thermally constrained devices. The simple
thermal relationship between processor and fan has become past for modern
computers.

As hardware vendors cope with the thermal constraints on their products,
more sensors are added, new cooling capabilities are introduced. The
complexity of the thermal relationship can grow exponentially among cooling
devices, zones, sensors, and trip points. They can also change dynamically.

To expose such relationship to the userspace, Linux generic thermal layer
introduced sysfs entry at /sys/class/thermal with a matrix of symbolic
links, trip point bindings, and device instances. To traverse such
matrix by hand is not a trivial task. Testing is also difficult in that
thermal conditions are often exception cases that hard to reach in
normal operations.

TMON is conceived as a tool to help visualize, tune, and test the
complex thermal subsystem.

Signed-off-by: Jacob Pan <jacob.jun.pan@linux.intel.com>
Signed-off-by: Zhang Rui <rui.zhang@intel.com>

1 files changed, 13 insertions, 2 deletions

diff --git a/tools/Makefile b/tools/Makefile
index 41067f304215..a9b02008443c 100644
--- a/tools/Makefile
+++ b/tools/Makefile
@@ -15,6 +15,7 @@ help:
         @echo '  net        - misc networking tools'
         @echo '  vm         - misc vm tools'
         @echo '  x86_energy_perf_policy - Intel energy policy tool'
+        @echo '  tmon       - thermal monitoring and tuning tool'
         @echo ''
         @echo 'You can do:'
         @echo ' $$ make -C tools/ <tool>_install'
@@ -50,6 +51,9 @@ selftests: FORCE
 turbostat x86_energy_perf_policy: FORCE
         $(call descend,power/x86/$@)
 
+tmon: FORCE
+        $(call descend,thermal/$@)
+
 cpupower_install:
         $(call descend,power/$(@:_install=),install)
 
@@ -62,9 +66,13 @@ selftests_install:
 turbostat_install x86_energy_perf_policy_install:
         $(call descend,power/x86/$(@:_install=),install)
 
+tmon_install:
+        $(call descend,thermal/$(@:_install=),install)
+
 install: cgroup_install cpupower_install firewire_install lguest_install \
                 perf_install selftests_install turbostat_install usb_install \
-                virtio_install vm_install net_install x86_energy_perf_policy_install
+                virtio_install vm_install net_install x86_energy_perf_policy_install \
+        tmon
 
 cpupower_clean:
         $(call descend,power/cpupower,clean)
@@ -84,8 +92,11 @@ selftests_clean:
 turbostat_clean x86_energy_perf_policy_clean:
         $(call descend,power/x86/$(@:_clean=),clean)
 
+tmon_clean:
+        $(call descend,thermal/tmon,clean)
+
 clean: cgroup_clean cpupower_clean firewire_clean lguest_clean perf_clean \
                 selftests_clean turbostat_clean usb_clean virtio_clean \
-                vm_clean net_clean x86_energy_perf_policy_clean
+                vm_clean net_clean x86_energy_perf_policy_clean tmon_clean
 
 .PHONY: FORCE