1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
|
<table class="head">
<tr>
<td class="head-ltitle">ACPI_THERMAL(4)</td>
<td class="head-vol">Device Drivers Manual</td>
<td class="head-rtitle">ACPI_THERMAL(4)</td>
</tr>
</table>
<div class="manual-text">
<section class="Sh">
<h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1>
<p class="Pp"><code class="Nm">acpi_thermal</code> —
<span class="Nd">ACPI thermal management subsystem</span></p>
</section>
<section class="Sh">
<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1>
<p class="Pp"><code class="Cd">device acpi</code></p>
</section>
<section class="Sh">
<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
<p class="Pp">The <code class="Nm">acpi_thermal</code> driver provides the
thermal management features of the ACPI module. This driver has a
<a class="Xr">sysctl(8)</a> interface and a <a class="Xr">devd(8)</a>
notification interface. The sysctls export properties of each ACPI thermal
zone object.</p>
<p class="Pp">There can be multiple thermal zones in a system. For example, each
CPU and the enclosure could all be separate thermal zones, each with its own
setpoints and cooling devices. Thermal zones are numbered sequentially in
the order they appear in the AML.</p>
<p class="Pp">The <code class="Nm">acpi_thermal</code> driver also activates the
active cooling system according to each thermal zone's setpoints.</p>
</section>
<section class="Sh">
<h1 class="Sh" id="SYSCTL_VARIABLES"><a class="permalink" href="#SYSCTL_VARIABLES">SYSCTL
VARIABLES</a></h1>
<dl class="Bl-tag">
<dt id="hw.acpi.thermal.min_runtime"><var class="Va">hw.acpi.thermal.min_runtime</var></dt>
<dd>Number of seconds to continue active cooling once started. A new active
cooling level will not be selected until this interval expires.</dd>
<dt id="hw.acpi.thermal.polling_rate"><var class="Va">hw.acpi.thermal.polling_rate</var></dt>
<dd>Number of seconds between polling the current temperature.</dd>
<dt id="hw.acpi.thermal.user_override"><var class="Va">hw.acpi.thermal.user_override</var></dt>
<dd>If set to 1, allow user override of various setpoints (below). The
original values for these settings are obtained from the BIOS and system
overheating and possible damage could occur if changed. Default is 0 (no
override).</dd>
<dt id="hw.acpi.thermal.tz_d.active"><var class="Va">hw.acpi.thermal.tz%d.active</var></dt>
<dd>Current active cooling system state. If this is non-negative, the
appropriate _AC%d object is running. Set this value to the desired active
cooling level to force the corresponding fan object to the appropriate
level.</dd>
<dt id="hw.acpi.thermal.tz_d.passive_cooling"><var class="Va">hw.acpi.thermal.tz%d.passive_cooling</var></dt>
<dd>If set to 1, passive cooling is enabled. It does cooling without fans
using <a class="Xr">cpufreq(4)</a> as the mechanism for controlling CPU
speed. Default is enabled for tz0 where it is available.</dd>
<dt id="hw.acpi.thermal.tz_d.thermal_flags"><var class="Va">hw.acpi.thermal.tz%d.thermal_flags</var></dt>
<dd>Current thermal zone status. These are bit-masked values.</dd>
<dt id="hw.acpi.thermal.tz_d.temperature"><var class="Va">hw.acpi.thermal.tz%d.temperature</var></dt>
<dd>Current temperature for this zone.</dd>
<dt id="hw.acpi.thermal.tz_d._PSV"><var class="Va">hw.acpi.thermal.tz%d._PSV</var></dt>
<dd>Temperature to start passive cooling by throttling down CPU, etc. This
value can be overridden by the user.</dd>
<dt id="hw.acpi.thermal.tz_d._CR3"><var class="Va">hw.acpi.thermal.tz%d._CR3</var></dt>
<dd>Temperature to start critical suspend to RAM (S3). This value can be
overridden by the user.</dd>
<dt id="hw.acpi.thermal.tz_d._HOT"><var class="Va">hw.acpi.thermal.tz%d._HOT</var></dt>
<dd>Temperature to start critical suspend to disk (S4). This value can be
overridden by the user.</dd>
<dt id="hw.acpi.thermal.tz_d._CRT"><var class="Va">hw.acpi.thermal.tz%d._CRT</var></dt>
<dd>Temperature to start critical shutdown (S5). This value can be overridden
by the user.</dd>
<dt id="hw.acpi.thermal.tz_d._ACx"><var class="Va">hw.acpi.thermal.tz%d._ACx</var></dt>
<dd>Temperatures at which to switch to the corresponding active cooling level.
The lower the _ACx value, the higher the cooling power.</dd>
</dl>
<p class="Pp">All temperatures are printed in Celsius. Values can be set in
Celsius (by providing a trailing "C") or Kelvin (by leaving off
any trailing letter). When setting a value by <a class="Xr">sysctl(8)</a>,
do not specify a trailing decimal (i.e., 90C instead of 90.0C).</p>
</section>
<section class="Sh">
<h1 class="Sh" id="NOTIFIES"><a class="permalink" href="#NOTIFIES">NOTIFIES</a></h1>
<p class="Pp">Notifies are passed to userland via <a class="Xr">devd(8)</a>. See
<span class="Pa">/etc/devd.conf</span> and <a class="Xr">devd.conf(5)</a>
for examples. The <code class="Nm">acpi_thermal</code> driver sends events
with the following attributes:</p>
<p class="Pp"></p>
<dl class="Bl-tag Bl-compact">
<dt id="ACPI">system</dt>
<dd><a class="permalink" href="#ACPI"><code class="Li">ACPI</code></a></dd>
<dt id="Thermal">subsystem</dt>
<dd><a class="permalink" href="#Thermal"><code class="Li">Thermal</code></a></dd>
<dt>type</dt>
<dd>The fully qualified thermal zone object path as in the ASL.</dd>
<dt>notify</dt>
<dd>An integer designating the event:
<p class="Pp"></p>
<dl class="Bl-tag Bl-compact">
<dt id="0x80"><a class="permalink" href="#0x80"><code class="Li">0x80</code></a></dt>
<dd>Current temperature has changed.</dd>
<dt id="0x81"><a class="permalink" href="#0x81"><code class="Li">0x81</code></a></dt>
<dd>One or more trip points (_ACx, _PSV) have changed.</dd>
<dt id="0x82"><a class="permalink" href="#0x82"><code class="Li">0x82</code></a></dt>
<dd>One or more device lists (_ALx, _PSL, _TZD) have changed.</dd>
<dt id="0xcc"><a class="permalink" href="#0xcc"><code class="Li">0xcc</code></a></dt>
<dd>Non-standard notify that the system will shutdown if the temperature
stays above _CRT or _HOT for one more poll cycle.</dd>
</dl>
</dd>
</dl>
</section>
<section class="Sh">
<h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
ALSO</a></h1>
<p class="Pp"><a class="Xr">acpi(4)</a>, <a class="Xr">cpufreq(4)</a>,
<a class="Xr">acpidump(8)</a></p>
</section>
<section class="Sh">
<h1 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h1>
<p class="Pp"><span class="An">Michael Smith</span></p>
<p class="Pp">This manual page was written by <span class="An">Takanori
Watanabe</span>.</p>
</section>
</div>
<table class="foot">
<tr>
<td class="foot-date">November 21, 2022</td>
<td class="foot-os">FreeBSD 15.0</td>
</tr>
</table>
|
