ARK-OS/arkos/kernel/Documentation/hwmon/ltc2978.rst

.. SPDX-License-Identifier: GPL-2.0

Kernel driver ltc2978
=====================

Supported chips:

  * Analog Devices LT7170

    Prefix: 'lt7170'

    Addresses scanned: -

    Datasheet: https://www.analog.com/en/products/lt7170.html

  * Analog Devices LT7171

    Prefix: 'lt7171'

    Addresses scanned: -

    Datasheet: https://www.analog.com/en/products/lt7171.html

  * Linear Technology LTC2972

    Prefix: 'ltc2972'

    Addresses scanned: -

    Datasheet: https://www.analog.com/en/products/ltc2972.html

  * Linear Technology LTC2974

    Prefix: 'ltc2974'

    Addresses scanned: -

    Datasheet: https://www.analog.com/en/products/ltc2974

  * Linear Technology LTC2975

    Prefix: 'ltc2975'

    Addresses scanned: -

    Datasheet: https://www.analog.com/en/products/ltc2975

  * Linear Technology LTC2977

    Prefix: 'ltc2977'

    Addresses scanned: -

    Datasheet: https://www.analog.com/en/products/ltc2977

  * Linear Technology LTC2978, LTC2978A

    Prefix: 'ltc2978'

    Addresses scanned: -

    Datasheet: https://www.analog.com/en/products/ltc2978

	       https://www.analog.com/en/products/ltc2978a

  * Linear Technology LTC2979

    Prefix: 'ltc2979'

    Addresses scanned: -

    Datasheet: https://www.analog.com/en/products/ltc2979

  * Linear Technology LTC2980

    Prefix: 'ltc2980'

    Addresses scanned: -

    Datasheet: https://www.analog.com/en/products/ltc2980

  * Linear Technology LTC3880

    Prefix: 'ltc3880'

    Addresses scanned: -

    Datasheet: https://www.analog.com/en/products/ltc3880

  * Linear Technology LTC3882

    Prefix: 'ltc3882'

    Addresses scanned: -

    Datasheet: https://www.analog.com/en/products/ltc3882

  * Linear Technology LTC3883

    Prefix: 'ltc3883'

    Addresses scanned: -

    Datasheet: https://www.analog.com/en/products/ltc3883

  * Linear Technology LTC3884

    Prefix: 'ltc3884'

    Addresses scanned: -

    Datasheet: https://www.analog.com/en/products/ltc3884

  * Linear Technology LTC3886

    Prefix: 'ltc3886'

    Addresses scanned: -

    Datasheet: https://www.analog.com/en/products/ltc3886

  * Linear Technology LTC3887

    Prefix: 'ltc3887'

    Addresses scanned: -

    Datasheet: https://www.analog.com/en/products/ltc3887

  * Linear Technology LTC3889

    Prefix: 'ltc3889'

    Addresses scanned: -

    Datasheet: https://www.analog.com/en/products/ltc3889

  * Linear Technology LTC7841

    Prefix: 'ltc7841'

    Addresses scanned: -

    Datasheet: https://www.analog.com/en/products/ltc7841

  * Linear Technology LTC7880

    Prefix: 'ltc7880'

    Addresses scanned: -

    Datasheet: https://www.analog.com/en/products/ltc7880

  * Linear Technology LTM2987

    Prefix: 'ltm2987'

    Addresses scanned: -

    Datasheet: https://www.analog.com/en/products/ltm2987

  * Linear Technology LTM4644

    Prefix: 'ltm4644'

    Addresses scanned: -

    Datasheet: https://www.analog.com/en/products/ltm4644

   * Linear Technology LTM4673

    Prefix: 'ltm4673'

    Addresses scanned: -

    Datasheet: https://www.analog.com/en/products/ltm4673

   * Linear Technology LTM4675

    Prefix: 'ltm4675'

    Addresses scanned: -

    Datasheet: https://www.analog.com/en/products/ltm4675

  * Linear Technology LTM4676

    Prefix: 'ltm4676'

    Addresses scanned: -

    Datasheet: https://www.analog.com/en/products/ltm4676

  * Linear Technology LTM4677

    Prefix: 'ltm4677'

    Addresses scanned: -

    Datasheet: https://www.analog.com/en/products/ltm4677

  * Linear Technology LTM4678

    Prefix: 'ltm4678'

    Addresses scanned: -

    Datasheet: https://www.analog.com/en/products/ltm4678

  * Analog Devices LTM4680

    Prefix: 'ltm4680'

    Addresses scanned: -

    Datasheet: https://www.analog.com/ltm4680

  * Analog Devices LTM4686

    Prefix: 'ltm4686'

    Addresses scanned: -

    Datasheet: https://www.analog.com/ltm4686

  * Analog Devices LTM4700

    Prefix: 'ltm4700'

    Addresses scanned: -

    Datasheet: https://www.analog.com/ltm4700



Author: Guenter Roeck <linux@roeck-us.net>


Description
-----------

- LT7170 and LT7171 are 20 A, 16 V, single- or dual-phase Silent Switcher
- step-down regulators with Digital Power System Management.
- LTC2974 and LTC2975 are quad digital power supply managers.
- LTC2978 is an octal power supply monitor.
- LTC2977 is a pin compatible replacement for LTC2978.
- LTC2980 is a 16-channel Power System Manager, consisting of two LTC2977
- in a single die. The chip is instantiated and reported as two separate chips
- on two different I2C bus addresses.
- LTC3880, LTC3882, LTC3886, and LTC3887 are dual output poly-phase step-down
- DC/DC controllers.
- LTC3883 is a single phase step-down DC/DC controller.
- LTM2987 is a 16-channel Power System Manager with two LTC2977 plus
- additional components on a single die. The chip is instantiated and reported
- as two separate chips on two different I2C bus addresses.
- LTM4675 is a dual 9A or single 18A μModule regulator
- LTM4676 is a dual 13A or single 26A uModule regulator.
- LTM4686 is a dual 10A or single 20A uModule regulator.


Usage Notes
-----------

This driver does not probe for PMBus devices. You will have to instantiate
devices explicitly.

Example: the following commands will load the driver for an LTC2978 at address
0x60 on I2C bus #1::

	# modprobe ltc2978
	# echo ltc2978 0x60 > /sys/bus/i2c/devices/i2c-1/new_device


Sysfs attributes
----------------

======================= ========================================================
in1_label		"vin"

in1_input		Measured input voltage.

in1_min			Minimum input voltage.

in1_max			Maximum input voltage.

			LTC2974, LTC2975, LTC2977, LTC2980, LTC2978,
			LTC2979 and LTM2987 only.

in1_lcrit		Critical minimum input voltage.

			LTC2972, LTC2974, LTC2975, LTC2977, LTC2980, LTC2978,
			LTC2979 and LTM2987 only.

in1_crit		Critical maximum input voltage.

in1_min_alarm		Input voltage low alarm.

in1_max_alarm		Input voltage high alarm.

			LTC2972, LTC2974, LTC2975, LTC2977, LTC2980, LTC2978,
			LTC2979 and LTM2987 only.

in1_lcrit_alarm		Input voltage critical low alarm.

			LTC2972, LTC2974, LTC2975, LTC2977, LTC2980, LTC2978,
			LTC2979 and LTM2987 only.

in1_crit_alarm		Input voltage critical high alarm.

in1_lowest		Lowest input voltage.

			LTC2972, LTC2974, LTC2975, LTC2977, LTC2980, LTC2978,
			and LTM2987 only.

in1_highest		Highest input voltage.

in1_reset_history	Reset input voltage history.

in[N]_label		"vout[1-8]".

			- LT7170, LT7171: N=2
			- LTC2972: N=2-3
			- LTC2974, LTC2975: N=2-5
			- LTC2977, LTC2979, LTC2980, LTM2987: N=2-9
			- LTC2978: N=2-9
			- LTC3880, LTC3882, LTC3884, LTC23886 LTC3887, LTC3889,
			  LTC7880, LTM4644, LTM4675, LTM4676, LTM4677, LTM4678,
			  LTM4680, LTM4700: N=2-3
			- LTC3883: N=2
			- LTC7841: N=2

in[N]_input		Measured output voltage.

in[N]_min		Minimum output voltage.

in[N]_max		Maximum output voltage.

in[N]_lcrit		Critical minimum output voltage.

in[N]_crit		Critical maximum output voltage.

in[N]_min_alarm		Output voltage low alarm.

in[N]_max_alarm		Output voltage high alarm.

in[N]_lcrit_alarm	Output voltage critical low alarm.

in[N]_crit_alarm	Output voltage critical high alarm.

in[N]_lowest		Lowest output voltage.

			LTC2972, LTC2974, LTC2975,and LTC2978 only.

in[N]_highest		Highest output voltage.

in[N]_reset_history	Reset output voltage history.

temp[N]_input		Measured temperature.

			- On LT7170 and LT7171, temp1 reports the chip
			  temperature.
			- On LTC2972, temp[1-2] report external temperatures,
			  and temp 3 reports the chip temperature.
			- On LTC2974 and LTC2975, temp[1-4] report external
			  temperatures, and temp5 reports the chip temperature.
			- On LTC2977, LTC2979, LTC2980, LTC2978, and LTM2987,
			  only one temperature measurement is supported and
			  reports the chip temperature.
			- On LTC3880, LTC3882, LTC3886, LTC3887, LTC3889,
			  LTM4664, LTM4675, LTM4676, LTM4677, LTM4678, LTM4680,
			  and LTM4700, temp1 and temp2 report external
			  temperatures, and temp3 reports the chip temperature.
			- On LTC3883, temp1 reports an external temperature,
			  and temp2 reports the chip temperature.

temp[N]_min		Minimum temperature.

			LTC2972, LTC2974, LCT2977, LTM2980, LTC2978,
			LTC2979, and LTM2987 only.

temp[N]_max		Maximum temperature.

temp[N]_lcrit		Critical low temperature.

temp[N]_crit		Critical high temperature.

temp[N]_min_alarm	Temperature low alarm.

			LTC2972, LTC2974, LTC2975, LTC2977, LTM2980, LTC2978,
			LTC2979, and LTM2987 only.

temp[N]_max_alarm	Temperature high alarm.


temp[N]_lcrit_alarm	Temperature critical low alarm.

temp[N]_crit_alarm	Temperature critical high alarm.

temp[N]_lowest		Lowest measured temperature.

			- LTC2972, LTC2974, LTC2975, LTC2977, LTM2980, LTC2978,
			  LTC2979, and LTM2987 only.
			- Not supported for chip temperature sensor on LTC2974
			  and LTC2975.

temp[N]_highest		Highest measured temperature.

			Not supported for chip temperature sensor on
			LTC2974 and LTC2975.

temp[N]_reset_history	Reset temperature history.

			Not supported for chip temperature sensor on
			LTC2974 and LTC2975.

power1_label		"pin". LTC3883 and LTC3886 only.

power1_input		Measured input power.

power[N]_label		"pout[1-4]".

			- LTC2972: N=1-2
			- LTC2974, LTC2975: N=1-4
			- LTC2977, LTC2979, LTC2980, LTM2987: Not supported
			- LTC2978: Not supported
			- LTC3880, LTC3882, LTC3884, LTC3886, LTC3887, LTC3889,
			  LTM4664, LTM4675, LTM4676, LTM4677, LTM4678, LTM4680,
			  LTM4700: N=1-2
			- LTC3883: N=2

power[N]_input		Measured output power.

curr1_label		"iin".

			LT7170, LT7171, LTC3880, LTC3883, LTC3884, LTC3886,
			LTC3887, LTC3889, LTM4644, LTM4675, LTM4676, LTM4677,
			LTM4678, LTM4680, and LTM4700 only.

curr1_input		Measured input current.

curr1_max		Maximum input current.

curr1_max_alarm		Input current high alarm.

curr1_highest		Highest input current.

			LTC3883 and LTC3886 only.

curr1_reset_history	Reset input current history.

			LTC3883 and LTC3886 only.

curr[N]_label		"iout[1-4]".

			- LT7170, LT7171: N=1
			- LTC2972: N-1-2
			- LTC2974, LTC2975: N=1-4
			- LTC2977, LTC2979, LTC2980, LTM2987: not supported
			- LTC2978: not supported
			- LTC3880, LTC3882, LTC3884, LTC3886, LTC3887, LTC3889,
			  LTM4664, LTM4675, LTM4676, LTM4677, LTM4678, LTM4680,
			  LTM4700: N=2-3
			- LTC3883: N=2
			- LTC7841: N=2

curr[N]_input		Measured output current.

curr[N]_max		Maximum output current.

curr[N]_crit		Critical high output current.

curr[N]_lcrit		Critical low output current.

			LTC2972, LTC2974 and LTC2975 only.

curr[N]_max_alarm	Output current high alarm.

curr[N]_crit_alarm	Output current critical high alarm.

curr[N]_lcrit_alarm	Output current critical low alarm.

			LTC2972, LTC2974 and LTC2975 only.

curr[N]_lowest		Lowest output current.

			LTC2972, LTC2974 and LTC2975 only.

curr[N]_highest		Highest output current.

curr[N]_reset_history	Reset output current history.
======================= ========================================================