[mirror_ubuntu-bionic-kernel.git] / Documentation / hwmon / ltc2978

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

Supported chips:
  * Linear Technology LTC2978
    Prefix: 'ltc2978'
    Addresses scanned: -
    Datasheet: http://cds.linear.com/docs/Datasheet/2978fa.pdf

Author: Guenter Roeck <guenter.roeck@ericsson.com>


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

The LTC2978 is an octal power supply monitor, supervisor, sequencer and
margin controller.


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.
in1_lcrit		Critical minimum input voltage.
in1_crit		Critical maximum input voltage.
in1_min_alarm		Input voltage low alarm.
in1_max_alarm		Input voltage high alarm.
in1_lcrit_alarm		Input voltage critical low alarm.
in1_crit_alarm		Input voltage critical high alarm.
in1_lowest		Lowest input voltage.
in1_highest		Highest input voltage.
in1_reset_history	Reset history. Writing into this attribute will reset
			history for all attributes.

in[2-9]_label		"vout[1-8]".
in[2-9]_input		Measured output voltage.
in[2-9]_min		Minimum output voltage.
in[2-9]_max		Maximum output voltage.
in[2-9]_lcrit		Critical minimum output voltage.
in[2-9]_crit		Critical maximum output voltage.
in[2-9]_min_alarm	Output voltage low alarm.
in[2-9]_max_alarm	Output voltage high alarm.
in[2-9]_lcrit_alarm	Output voltage critical low alarm.
in[2-9]_crit_alarm	Output voltage critical high alarm.
in[2-9]_lowest		Lowest output voltage.
in[2-9]_highest		Lowest output voltage.
in[2-9]_reset_history	Reset history. Writing into this attribute will reset
			history for all attributes.

temp1_input		Measured temperature.
temp1_min		Mimimum temperature.
temp1_max		Maximum temperature.
temp1_lcrit		Critical low temperature.
temp1_crit		Critical high temperature.
temp1_min_alarm		Chip temperature low alarm.
temp1_max_alarm		Chip temperature high alarm.
temp1_lcrit_alarm	Chip temperature critical low alarm.
temp1_crit_alarm	Chip temperature critical high alarm.
temp1_lowest		Lowest measured temperature.
temp1_highest		Highest measured temperature.
temp1_reset_history	Reset history. Writing into this attribute will reset
			history for all attributes.
Commit	Line	Data
c3ff9a67 GR	1	Kernel driver ltc2978
	2	=====================
	3
	4	Supported chips:
	5	* Linear Technology LTC2978
	6	Prefix: 'ltc2978'
	7	Addresses scanned: -
	8	Datasheet: http://cds.linear.com/docs/Datasheet/2978fa.pdf
	9
	10	Author: Guenter Roeck <guenter.roeck@ericsson.com>
	11
	12
	13	Description
	14	-----------
	15
	16	The LTC2978 is an octal power supply monitor, supervisor, sequencer and
	17	margin controller.
	18
	19
	20	Usage Notes
	21	-----------
	22
	23	This driver does not probe for PMBus devices. You will have to instantiate
	24	devices explicitly.
	25
	26	Example: the following commands will load the driver for an LTC2978 at address
	27	0x60 on I2C bus #1:
	28
	29	# modprobe ltc2978
	30	# echo ltc2978 0x60 > /sys/bus/i2c/devices/i2c-1/new_device
	31
	32
	33	Sysfs attributes
	34	----------------
	35
	36	in1_label "vin"
	37	in1_input Measured input voltage.
	38	in1_min Minimum input voltage.
	39	in1_max Maximum input voltage.
	40	in1_lcrit Critical minimum input voltage.
	41	in1_crit Critical maximum input voltage.
	42	in1_min_alarm Input voltage low alarm.
	43	in1_max_alarm Input voltage high alarm.
	44	in1_lcrit_alarm Input voltage critical low alarm.
	45	in1_crit_alarm Input voltage critical high alarm.
	46	in1_lowest Lowest input voltage.
	47	in1_highest Highest input voltage.
	48	in1_reset_history Reset history. Writing into this attribute will reset
	49	history for all attributes.
	50
	51	in[2-9]_label "vout[1-8]".
	52	in[2-9]_input Measured output voltage.
	53	in[2-9]_min Minimum output voltage.
	54	in[2-9]_max Maximum output voltage.
	55	in[2-9]_lcrit Critical minimum output voltage.
	56	in[2-9]_crit Critical maximum output voltage.
	57	in[2-9]_min_alarm Output voltage low alarm.
	58	in[2-9]_max_alarm Output voltage high alarm.
	59	in[2-9]_lcrit_alarm Output voltage critical low alarm.
	60	in[2-9]_crit_alarm Output voltage critical high alarm.
	61	in[2-9]_lowest Lowest output voltage.
	62	in[2-9]_highest Lowest output voltage.
	63	in[2-9]_reset_history Reset history. Writing into this attribute will reset
	64	history for all attributes.
65
66	temp1_input Measured temperature.
67	temp1_min Mimimum temperature.
68	temp1_max Maximum temperature.
69	temp1_lcrit Critical low temperature.
70	temp1_crit Critical high temperature.
71	temp1_min_alarm Chip temperature low alarm.
72	temp1_max_alarm Chip temperature high alarm.
73	temp1_lcrit_alarm Chip temperature critical low alarm.
74	temp1_crit_alarm Chip temperature critical high alarm.
75	temp1_lowest Lowest measured temperature.
76	temp1_highest Highest measured temperature.
77	temp1_reset_history Reset history. Writing into this attribute will reset
78	history for all attributes.