1*6ec3fcf5SKun Yi.. SPDX-License-Identifier: GPL-2.0-or-later
2*6ec3fcf5SKun Yi
3*6ec3fcf5SKun YiKernel driver sbtsi_temp
4*6ec3fcf5SKun Yi==================
5*6ec3fcf5SKun Yi
6*6ec3fcf5SKun YiSupported hardware:
7*6ec3fcf5SKun Yi
8*6ec3fcf5SKun Yi  * Sideband interface (SBI) Temperature Sensor Interface (SB-TSI)
9*6ec3fcf5SKun Yi    compliant AMD SoC temperature device.
10*6ec3fcf5SKun Yi
11*6ec3fcf5SKun Yi    Prefix: 'sbtsi_temp'
12*6ec3fcf5SKun Yi
13*6ec3fcf5SKun Yi    Addresses scanned: This driver doesn't support address scanning.
14*6ec3fcf5SKun Yi
15*6ec3fcf5SKun Yi    To instantiate this driver on an AMD CPU with SB-TSI
16*6ec3fcf5SKun Yi    support, the i2c bus number would be the bus connected from the board
17*6ec3fcf5SKun Yi    management controller (BMC) to the CPU. The i2c address is specified in
18*6ec3fcf5SKun Yi    Section 6.3.1 of the SoC register reference: The SB-TSI address is normally
19*6ec3fcf5SKun Yi    98h for socket 0 and 90h for socket 1, but it could vary based on hardware
20*6ec3fcf5SKun Yi    address select pins.
21*6ec3fcf5SKun Yi
22*6ec3fcf5SKun Yi    Datasheet: The SB-TSI interface and protocol is available as part of
23*6ec3fcf5SKun Yi               the open source SoC register reference at:
24*6ec3fcf5SKun Yi
25*6ec3fcf5SKun Yi	       https://www.amd.com/system/files/TechDocs/56255_OSRR.pdf
26*6ec3fcf5SKun Yi
27*6ec3fcf5SKun Yi               The Advanced Platform Management Link (APML) Specification is
28*6ec3fcf5SKun Yi               available at:
29*6ec3fcf5SKun Yi
30*6ec3fcf5SKun Yi	       http://developer.amd.com/wordpress/media/2012/10/41918.pdf
31*6ec3fcf5SKun Yi
32*6ec3fcf5SKun YiAuthor: Kun Yi <kunyi@google.com>
33*6ec3fcf5SKun Yi
34*6ec3fcf5SKun YiDescription
35*6ec3fcf5SKun Yi-----------
36*6ec3fcf5SKun Yi
37*6ec3fcf5SKun YiThe SBI temperature sensor interface (SB-TSI) is an emulation of the software
38*6ec3fcf5SKun Yiand physical interface of a typical 8-pin remote temperature sensor (RTS) on
39*6ec3fcf5SKun YiAMD SoCs. It implements one temperature sensor with readings and limit
40*6ec3fcf5SKun Yiregisters encode the temperature in increments of 0.125 from 0 to 255.875.
41*6ec3fcf5SKun YiLimits can be set through the writable thresholds, and if reached will trigger
42*6ec3fcf5SKun Yicorresponding alert signals.
43