xref: /linux/Documentation/hwmon/stef48h28.rst (revision c17ee635fd3a482b2ad2bf5e269755c2eae5f25e)
164824861SCharles Hsu.. SPDX-License-Identifier: GPL-2.0
264824861SCharles Hsu
364824861SCharles HsuKernel driver stef48h28
464824861SCharles Hsu=======================
564824861SCharles Hsu
664824861SCharles HsuSupported chips:
764824861SCharles Hsu
864824861SCharles Hsu  * Analog Devices STEF48H28
964824861SCharles Hsu
1064824861SCharles Hsu    Prefix: 'stef48h28'
1164824861SCharles Hsu
1264824861SCharles Hsu    Addresses scanned: -
1364824861SCharles Hsu
1464824861SCharles Hsu    Datasheet: https://www.st.com/resource/en/data_brief/stef48h28.pdf
1564824861SCharles Hsu
1664824861SCharles HsuAuthor:
1764824861SCharles Hsu
1864824861SCharles Hsu  - Charles Hsu <hsu.yungteng@gmail.com>
1964824861SCharles Hsu
2064824861SCharles Hsu
2164824861SCharles HsuDescription
2264824861SCharles Hsu-----------
2364824861SCharles Hsu
2464824861SCharles HsuThe STEF48H28 is a 30 A integrated e-fuse for 9-80 V DC power rails.
2564824861SCharles HsuIt provides inrush control, undervoltage/overvoltage lockout and
2664824861SCharles Hsuovercurrent protection using an adaptive (I x t) scheme that permits
2764824861SCharles Hsushort high-current pulses typical of CPU/GPU loads.
2864824861SCharles Hsu
2964824861SCharles HsuThe device offers an analog current-monitor output and an on-chip
3064824861SCharles Hsutemperature-monitor signal for system supervision. Startup behavior is
3164824861SCharles Hsuprogrammable through insertion-delay and soft-start settings.
3264824861SCharles Hsu
3364824861SCharles HsuAdditional features include power-good indication, self-diagnostics,
3464824861SCharles Hsuthermal shutdown and a PMBus interface for telemetry and status
3564824861SCharles Hsureporting.
3664824861SCharles Hsu
3764824861SCharles HsuPlatform data support
3864824861SCharles Hsu---------------------
3964824861SCharles Hsu
4064824861SCharles HsuThe driver supports standard PMBus driver platform data.
4164824861SCharles Hsu
4264824861SCharles HsuSysfs entries
4364824861SCharles Hsu-------------
4464824861SCharles Hsu
45*eaeb29ceSRandy Dunlap======================  ========================================================
4664824861SCharles Hsuin1_label		"vin".
4764824861SCharles Hsuin1_input		Measured voltage. From READ_VIN register.
4864824861SCharles Hsuin1_min			Minimum Voltage. From VIN_UV_WARN_LIMIT register.
4964824861SCharles Hsuin1_max			Maximum voltage. From VIN_OV_WARN_LIMIT register.
5064824861SCharles Hsu
5164824861SCharles Hsuin2_label		"vout1".
5264824861SCharles Hsuin2_input		Measured voltage. From READ_VOUT register.
5364824861SCharles Hsuin2_min			Minimum Voltage. From VOUT_UV_WARN_LIMIT register.
5464824861SCharles Hsuin2_max			Maximum voltage. From VOUT_OV_WARN_LIMIT register.
5564824861SCharles Hsu
56*eaeb29ceSRandy Dunlapcurr1_label "iin".      curr1_input Measured current. From READ_IIN register.
5764824861SCharles Hsu
58*eaeb29ceSRandy Dunlapcurr2_label "iout1".    curr2_input Measured current. From READ_IOUT register.
5964824861SCharles Hsu
6064824861SCharles Hsupower1_label		"pin"
6164824861SCharles Hsupower1_input		Measured input power. From READ_PIN register.
6264824861SCharles Hsu
6364824861SCharles Hsupower2_label		"pout1"
6464824861SCharles Hsupower2_input		Measured output power. From READ_POUT register.
6564824861SCharles Hsu
6664824861SCharles Hsutemp1_input		Measured temperature. From READ_TEMPERATURE_1 register.
6764824861SCharles Hsutemp1_max		Maximum temperature. From OT_WARN_LIMIT register.
6864824861SCharles Hsutemp1_crit		Critical high temperature. From OT_FAULT_LIMIT register.
6964824861SCharles Hsu
7064824861SCharles Hsutemp2_input		Measured temperature. From READ_TEMPERATURE_2 register.
71*eaeb29ceSRandy Dunlap======================  ========================================================
72