xref: /openbmc/linux/Documentation/hwmon/drivetemp.rst (revision 5b46903d8bf372e563bf2150d46b87fff197a109)
1*5b46903dSGuenter Roeck.. SPDX-License-Identifier: GPL-2.0
2*5b46903dSGuenter Roeck
3*5b46903dSGuenter RoeckKernel driver drivetemp
4*5b46903dSGuenter Roeck=======================
5*5b46903dSGuenter Roeck
6*5b46903dSGuenter Roeck
7*5b46903dSGuenter RoeckReferences
8*5b46903dSGuenter Roeck----------
9*5b46903dSGuenter Roeck
10*5b46903dSGuenter RoeckANS T13/1699-D
11*5b46903dSGuenter RoeckInformation technology - AT Attachment 8 - ATA/ATAPI Command Set (ATA8-ACS)
12*5b46903dSGuenter Roeck
13*5b46903dSGuenter RoeckANS Project T10/BSR INCITS 513
14*5b46903dSGuenter RoeckInformation technology - SCSI Primary Commands - 4 (SPC-4)
15*5b46903dSGuenter Roeck
16*5b46903dSGuenter RoeckANS Project INCITS 557
17*5b46903dSGuenter RoeckInformation technology - SCSI / ATA Translation - 5 (SAT-5)
18*5b46903dSGuenter Roeck
19*5b46903dSGuenter Roeck
20*5b46903dSGuenter RoeckDescription
21*5b46903dSGuenter Roeck-----------
22*5b46903dSGuenter Roeck
23*5b46903dSGuenter RoeckThis driver supports reporting the temperature of disk and solid state
24*5b46903dSGuenter Roeckdrives with temperature sensors.
25*5b46903dSGuenter Roeck
26*5b46903dSGuenter RoeckIf supported, it uses the ATA SCT Command Transport feature to read
27*5b46903dSGuenter Roeckthe current drive temperature and, if available, temperature limits
28*5b46903dSGuenter Roeckas well as historic minimum and maximum temperatures. If SCT Command
29*5b46903dSGuenter RoeckTransport is not supported, the driver uses SMART attributes to read
30*5b46903dSGuenter Roeckthe drive temperature.
31*5b46903dSGuenter Roeck
32*5b46903dSGuenter Roeck
33*5b46903dSGuenter RoeckSysfs entries
34*5b46903dSGuenter Roeck-------------
35*5b46903dSGuenter Roeck
36*5b46903dSGuenter RoeckOnly the temp1_input attribute is always available. Other attributes are
37*5b46903dSGuenter Roeckavailable only if reported by the drive. All temperatures are reported in
38*5b46903dSGuenter Roeckmilli-degrees Celsius.
39*5b46903dSGuenter Roeck
40*5b46903dSGuenter Roeck=======================	=====================================================
41*5b46903dSGuenter Roecktemp1_input		Current drive temperature
42*5b46903dSGuenter Roecktemp1_lcrit		Minimum temperature limit. Operating the device below
43*5b46903dSGuenter Roeck			this temperature may cause physical damage to the
44*5b46903dSGuenter Roeck			device.
45*5b46903dSGuenter Roecktemp1_min		Minimum recommended continuous operating limit
46*5b46903dSGuenter Roecktemp1_max		Maximum recommended continuous operating temperature
47*5b46903dSGuenter Roecktemp1_crit		Maximum temperature limit. Operating the device above
48*5b46903dSGuenter Roeck			this temperature may cause physical damage to the
49*5b46903dSGuenter Roeck			device.
50*5b46903dSGuenter Roecktemp1_lowest		Minimum temperature seen this power cycle
51*5b46903dSGuenter Roecktemp1_highest		Maximum temperature seen this power cycle
52*5b46903dSGuenter Roeck=======================	=====================================================
53