^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1) .. SPDX-License-Identifier: GPL-2.0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 3) Kernel driver drivetemp
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 4) =======================
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 5)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 6)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 7) References
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 8) ----------
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 9)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 10) ANS T13/1699-D
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 11) Information technology - AT Attachment 8 - ATA/ATAPI Command Set (ATA8-ACS)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 12)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 13) ANS Project T10/BSR INCITS 513
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 14) Information technology - SCSI Primary Commands - 4 (SPC-4)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 15)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 16) ANS Project INCITS 557
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 17) Information technology - SCSI / ATA Translation - 5 (SAT-5)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 18)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 19)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 20) Description
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 21) -----------
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 22)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 23) This driver supports reporting the temperature of disk and solid state
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 24) drives with temperature sensors.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 25)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 26) If supported, it uses the ATA SCT Command Transport feature to read
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 27) the current drive temperature and, if available, temperature limits
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 28) as well as historic minimum and maximum temperatures. If SCT Command
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 29) Transport is not supported, the driver uses SMART attributes to read
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 30) the drive temperature.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 31)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 32)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 33) Usage Note
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 34) ----------
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 35)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 36) Reading the drive temperature may reset the spin down timer on some drives.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 37) This has been observed with WD120EFAX drives, but may be seen with other
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 38) drives as well. The same behavior is observed if the 'hdtemp' or 'smartd'
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 39) tools are used to access the drive.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 40) With the WD120EFAX drive, reading the drive temperature using the drivetemp
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 41) driver is still possible _after_ it transitioned to standby mode, and
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 42) reading the drive temperature in this mode will not cause the drive to
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 43) change its mode (meaning the drive will not spin up). It is unknown if other
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 44) drives experience similar behavior.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 45)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 46) A known workaround for WD120EFAX drives is to read the drive temperature at
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 47) intervals larger than twice the spin-down time. Otherwise affected drives
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 48) will never spin down.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 49)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 50)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 51) Sysfs entries
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 52) -------------
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 53)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 54) Only the temp1_input attribute is always available. Other attributes are
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 55) available only if reported by the drive. All temperatures are reported in
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 56) milli-degrees Celsius.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 57)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 58) ======================= =====================================================
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 59) temp1_input Current drive temperature
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 60) temp1_lcrit Minimum temperature limit. Operating the device below
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 61) this temperature may cause physical damage to the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 62) device.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 63) temp1_min Minimum recommended continuous operating limit
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 64) temp1_max Maximum recommended continuous operating temperature
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 65) temp1_crit Maximum temperature limit. Operating the device above
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 66) this temperature may cause physical damage to the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 67) device.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 68) temp1_lowest Minimum temperature seen this power cycle
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 69) temp1_highest Maximum temperature seen this power cycle
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 70) ======================= =====================================================