1.\" $OpenBSD: kate.4,v 1.1 2008/03/27 01:54:44 cnst Exp $ 2.\" 3.\" Copyright (c) 2008/2010 Constantine A. Murenin <cnst+dfly@bugmail.mojo.ru> 4.\" 5.\" Permission to use, copy, modify, and distribute this software for any 6.\" purpose with or without fee is hereby granted, provided that the above 7.\" copyright notice and this permission notice appear in all copies. 8.\" 9.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES 10.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF 11.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR 12.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES 13.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN 14.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF 15.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. 16.\" 17.Dd August 2, 2020 18.Dt KATE 4 19.Os 20.Sh NAME 21.Nm kate 22.Nd AMD K8 temperature sensor 23.Sh SYNOPSIS 24To compile this driver into the kernel, 25place the following lines in your 26kernel configuration file: 27.Bd -ragged -offset indent 28.Cd "device pci" 29.Cd "device kate" 30.Ed 31.Pp 32Alternatively, to load the driver as a 33module at boot time, place the following line in 34.Xr loader.conf 5 : 35.Bd -literal -offset indent 36kate_load="YES" 37.Ed 38.Sh DESCRIPTION 39The 40.Nm 41driver provides support for the temperature sensors available in the 42AMD K8 family of processors. 43(Subsequent AMD families are supported by 44.Xr km 4 . ) 45.Pp 46These sensors were officially introduced with 47Revision F Family 0Fh processors, 48and provide 1 degC accuracy. 49Precision was improved in Revision G chips, 50which provide two more bits for 0.25 degC steppings. 51Each core may have two temperature sensors, and 52there may be up to two cores per package. 53.Pp 54Multiprocessor systems would have one instance of 55.Nm 56per each chip. 57In each instance, 58.Va temp0 59and 60.Va temp1 61sensors 62correspond to the temperature sensors on the first core, 63whereas 64.Va temp2 65and 66.Va temp3 67correspond to the temperature sensors on the second core. 68As such, single core chips may have two sensors, 69and dual-core dual-processor systems may have as many as 8 70temperature sensors in total. 71.Pp 72Since many prior revisions of the chips appear to have 73valid readings for at least some temperature sensors 74in the same address space as the abovementioned revisions, 75the driver may also attach on such older revisions provided 76that it finds some sensor readings that appear valid. 77However, in such cases 78.Nm 79would not print the core revision information into the dmesg. 80.Pp 81Sensor values are made available through the 82.Dv HW_SENSORS 83.Xr sysctl 3 84interface, 85and can be monitored with the 86.Xr systat 1 87.Ar sensors 88display, 89.Xr sensorsd 8 90and 91.Xr sysctl 8 92.Ar hw.sensors . 93.Sh SEE ALSO 94.Xr systat 1 , 95.Xr sysctl 3 , 96.Xr amdtemp 4 , 97.Xr intro 4 , 98.Xr km 4 , 99.Xr pci 4 , 100.Xr sensorsd 8 , 101.Xr sysctl 8 102.Rs 103.%T "BIOS and Kernel Developer's Guide for AMD NPT Family 0Fh Processors" 104.%D July 2007 105.%R Publication # 32559 106.%P pp. 21--23 and pp. 179--184 107.\" .%U http://www.amd.com/us-en/assets/content_type/white_papers_and_tech_docs/32559.pdf 108.Re 109.Rs 110.%T "Revision Guide for AMD NPT Family 0Fh Processors" 111.%D February 2008 112.%R Publication # 33610 113.\" .%U http://www.amd.com/us-en/assets/content_type/white_papers_and_tech_docs/33610.pdf 114.Re 115.Sh HISTORY 116The 117.Nm 118driver first appeared in 119.Ox 4.4 120and 121.Dx 2.5 . 122.Sh AUTHORS 123The 124.Nm 125driver was written for 126.Ox 127and 128.Dx 129by 130.An Constantine A. Murenin 131whilst at the University of Waterloo. 132