thermal/tmon/tmon.8

2 # SPDX-License-Identifier: GPL-2.0
4 \fBtmon\fP - A monitoring and testing tool for Linux kernel thermal subsystem
12 \fBtmon \fP can be used to visualize thermal relationship and
13 real-time thermal data; tune
14 and test cooling devices and sensors; collect thermal data for offline
21 1. Thermal relationships:
22 - show thermal zone information
23 - show cooling device information
24 - show trip point binding within each thermal zone
25 - show trip point and cooling device instance bindings
28 - show temperature of all thermal zones w.r.t. its trip points and types
29 - show states of all cooling devices
31 3. Thermal relationship learning and device tuning
32 - with a built-in Proportional Integral Derivative (\fBPID\fP)
33 controller, user can pair a cooling device to a thermal sensor for
34 testing the effectiveness and learn about the thermal distance between the two
35 - allow manual control of cooling device states and target temperature
38 - contains thermal configuration data, i.e. cooling device, thermal
41 - log real-time thermal data into space separated format that can be
46 The \fB-c --control\fP option sets a cooling device type to control temperature
47 of a thermal zone
49 The \fB-d --daemon\fP option runs \fBtmon \fP as daemon without user interface
51 The \fB-g --debug\fP option allow debug messages to be stored in syslog
53 The \fB-h --help\fP option shows help message
55 The \fB-l --log\fP option write data to /var/tmp/tmon.log
57 The \fB-t --time-interval\fP option sets the polling interval in seconds
59 The \fB-T --target-temp\fP option sets the initial target temperature
61 The \fB-v --version\fP option shows the version of \fBtmon \fP
63 The \fB-z --zone\fP option sets the target therma zone instance to be controlled
88 \fBCtrl-C, q/Q\fP stops \fBtmon\fP
99 2. Use Processor cooling device to control thermal zone 0 at default 65C.
100 $ sudo ./tmon -c Processor -z 0
102 3. Use intel_powerclamp(idle injection) cooling device to control thermal zone 1
103 $ sudo ./tmon -c intel_powerclamp -z 1
106 $ sudo ./tmon -g -l
109 for all cooling devices with "Processor" type such that thermal zone 0
112 #---------- THERMAL DATA LOG STARTED -----------
134 Data can be read directly into an array by an example R-script below:
137 tdata <- read.table("/var/tmp/tmon.log", header=T, comment.char="#")
141 g_range <- range(0, intel_powerclamp15, TargetTemp, acpitz0)