share/man/man4/acpi_thermal.4

   1 .\" Copyright (c) 2003 Takanori Watanabe.
   2 .\" All rights reserved.
   3 .\"
   4 .\" Redistribution and use in source and binary forms, with or without
   5 .\" modification, are permitted provided that the following conditions
   6 .\" are met:
   7 .\" 1. Redistributions of source code must retain the above copyright
   8 .\"    notice, this list of conditions and the following disclaimer.
   9 .\" 2. Redistributions in binary form must reproduce the above copyright
  10 .\"    notice, this list of conditions and the following disclaimer in the
  11 .\"    documentation and/or other materials provided with the distribution.
  12 .\"
  13 .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
  14 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  15 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  16 .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
  17 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  18 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  19 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  20 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  21 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  22 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  23 .\" SUCH DAMAGE.
  24 .\"
  25 .\" $FreeBSD: src/share/man/man4/acpi_thermal.4,v 1.6 2004/02/03 04:18:55 njl Exp $
  26 .\" $DragonFly: src/share/man/man4/acpi_thermal.4,v 1.2 2006/07/23 07:47:12 swildner Exp $
  27 .\"
  28 .Dd December 27, 2003
  29 .Dt ACPI_THERMAL 4
  30 .Os
  31 .Sh NAME
  32 .Nm acpi_thermal
  33 .Nd ACPI thermal management subsystem
  34 .Sh SYNOPSIS
  35 .Cd "device acpi"
  36 .Sh DESCRIPTION
  37 The
  38 .Nm
  39 driver provides the thermal management features of the ACPI module.
  40 This driver has a
  41 .Xr sysctl 8
  42 interface.
  43 The sysctls export properties of each ACPI thermal zone object.
  44 .Pp
  45 There can be multiple thermal zones in a system.
  46 For example, each CPU and the enclosure could all be separate thermal
  47 zones, each with its own setpoints and cooling devices.
  48 Thermal zones are numbered sequentially in the order they appear in
  49 the AML.
  50 .Pp
  51 The
  52 .Nm
  53 driver also activates the active cooling system according to
  54 each thermal zone's setpoints.
  55 .Sh SYSCTLS
  56 .Bl -tag -width indent
  57 .It Va hw.acpi.thermal.tz%d.active
  58 Current active cooling system state.
  59 If this is non-negative, the appropriate _AC%d object is running.
  60 Set this value to the desired active cooling level to force
  61 the corresponding fan object to the appropriate level.
  62 .It Va hw.acpi.thermal.tz%d.thermal_flags
  63 Current thermal zone status.
  64 These are bit-masked values.
  65 .It Va hw.acpi.thermal.tz%d.temperature
  66 Current temperature for this zone.
  67 .It Va hw.acpi.thermal.tz%d._PSV
  68 Temperature to start passive cooling by throttling down CPU, etc.
  69 .It Va hw.acpi.thermal.tz%d._HOT
  70 Temperature to start critical suspend to disk (S4).
  71 .It Va hw.acpi.thermal.tz%d._CRT
  72 Temperature to start critical shutdown (S5).
  73 .It Va hw.acpi.thermal.tz%d._ACx
  74 Temperatures at which to switch to the corresponding active cooling
  75 level.
  76 For instance, values of
  77 .Qq Li "3200 3100"
  78 mean to switch on _AC0 at 320.0K
  79 and _AC1 at 310.0K.
  80 The lower the _ACx value, the higher the cooling power.
  81 .El
  82 .Pp
  83 All temperatures are represented in tenths of a Kelvin.
  84 For example, 300.0K is represented by the integer 3000.
  85 To convert to units of Centigrade,
  86 the formula is
  87 .Li "(x - 2731.5) / 10" .
  88 .Sh SEE ALSO
  89 .Xr acpi 4 ,
  90 .Xr acpidump 8
  91 .Sh AUTHORS
  92 .An -nosplit
  93 .An Michael Smith
  94 .Pp
  95 This manual page was written by
  96 .An Takanori Watanabe .