16ec3fcf5SKun Yi.. SPDX-License-Identifier: GPL-2.0-or-later
26ec3fcf5SKun Yi
36ec3fcf5SKun YiKernel driver sbtsi_temp
4*e042f151SRandy Dunlap========================
56ec3fcf5SKun Yi
66ec3fcf5SKun YiSupported hardware:
76ec3fcf5SKun Yi
86ec3fcf5SKun Yi  * Sideband interface (SBI) Temperature Sensor Interface (SB-TSI)
96ec3fcf5SKun Yi    compliant AMD SoC temperature device.
106ec3fcf5SKun Yi
116ec3fcf5SKun Yi    Prefix: 'sbtsi_temp'
126ec3fcf5SKun Yi
136ec3fcf5SKun Yi    Addresses scanned: This driver doesn't support address scanning.
146ec3fcf5SKun Yi
156ec3fcf5SKun Yi    To instantiate this driver on an AMD CPU with SB-TSI
166ec3fcf5SKun Yi    support, the i2c bus number would be the bus connected from the board
176ec3fcf5SKun Yi    management controller (BMC) to the CPU. The i2c address is specified in
186ec3fcf5SKun Yi    Section 6.3.1 of the SoC register reference: The SB-TSI address is normally
196ec3fcf5SKun Yi    98h for socket 0 and 90h for socket 1, but it could vary based on hardware
206ec3fcf5SKun Yi    address select pins.
216ec3fcf5SKun Yi
226ec3fcf5SKun Yi    Datasheet: The SB-TSI interface and protocol is available as part of
236ec3fcf5SKun Yi               the open source SoC register reference at:
246ec3fcf5SKun Yi
256ec3fcf5SKun Yi	       https://www.amd.com/system/files/TechDocs/56255_OSRR.pdf
266ec3fcf5SKun Yi
276ec3fcf5SKun Yi               The Advanced Platform Management Link (APML) Specification is
286ec3fcf5SKun Yi               available at:
296ec3fcf5SKun Yi
306ec3fcf5SKun Yi	       http://developer.amd.com/wordpress/media/2012/10/41918.pdf
316ec3fcf5SKun Yi
326ec3fcf5SKun YiAuthor: Kun Yi <kunyi@google.com>
336ec3fcf5SKun Yi
346ec3fcf5SKun YiDescription
356ec3fcf5SKun Yi-----------
366ec3fcf5SKun Yi
376ec3fcf5SKun YiThe SBI temperature sensor interface (SB-TSI) is an emulation of the software
386ec3fcf5SKun Yiand physical interface of a typical 8-pin remote temperature sensor (RTS) on
396ec3fcf5SKun YiAMD SoCs. It implements one temperature sensor with readings and limit
406ec3fcf5SKun Yiregisters encode the temperature in increments of 0.125 from 0 to 255.875.
416ec3fcf5SKun YiLimits can be set through the writable thresholds, and if reached will trigger
426ec3fcf5SKun Yicorresponding alert signals.
43