summaryrefslogtreecommitdiff
path: root/Documentation/hwmon/lm25066
blob: b34c3de5c1bcfccf76f64b3442cf3433bc6ff472 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
Kernel driver lm25066
=====================

Supported chips:
  * TI LM25056
    Prefix: 'lm25056'
    Addresses scanned: -
    Datasheets:
	http://www.ti.com/lit/gpn/lm25056
	http://www.ti.com/lit/gpn/lm25056a
  * TI LM25063
    Prefix: 'lm25063'
    Addresses scanned: -
    Datasheet:
	To be announced
  * National Semiconductor LM25066
    Prefix: 'lm25066'
    Addresses scanned: -
    Datasheets:
	http://www.national.com/pf/LM/LM25066.html
	http://www.national.com/pf/LM/LM25066A.html
  * National Semiconductor LM5064
    Prefix: 'lm5064'
    Addresses scanned: -
    Datasheet:
	http://www.national.com/pf/LM/LM5064.html
  * National Semiconductor LM5066
    Prefix: 'lm5066'
    Addresses scanned: -
    Datasheet:
	http://www.national.com/pf/LM/LM5066.html

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


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

This driver supports hardware montoring for National Semiconductor / TI LM25056,
LM25063, LM25066, LM5064, and LM5066 Power Management, Monitoring, Control, and
Protection ICs.

The driver is a client driver to the core PMBus driver. Please see
Documentation/hwmon/pmbus for details on PMBus client drivers.


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

This driver does not auto-detect devices. You will have to instantiate the
devices explicitly. Please see Documentation/i2c/instantiating-devices for
details.


Platform data support
---------------------

The driver supports standard PMBus driver platform data.


Sysfs entries
-------------

The following attributes are supported. Limits are read-write; all other
attributes are read-only.

in1_label		"vin"
in1_input		Measured input voltage.
in1_average		Average measured input voltage.
in1_min			Minimum input voltage.
in1_max			Maximum input voltage.
in1_crit		Critical high input voltage (LM25063 only).
in1_lcrit		Critical low input voltage (LM25063 only).
in1_min_alarm		Input voltage low alarm.
in1_max_alarm		Input voltage high alarm.
in1_lcrit_alarm		Input voltage critical low alarm (LM25063 only).
in1_crit_alarm		Input voltage critical high alarm. (LM25063 only).

in2_label		"vmon"
in2_input		Measured voltage on VAUX pin
in2_min			Minimum VAUX voltage (LM25056 only).
in2_max			Maximum VAUX voltage (LM25056 only).
in2_min_alarm		VAUX voltage low alarm (LM25056 only).
in2_max_alarm		VAUX voltage high alarm (LM25056 only).

in3_label		"vout1"
			Not supported on LM25056.
in3_input		Measured output voltage.
in3_average		Average measured output voltage.
in3_min			Minimum output voltage.
in3_min_alarm		Output voltage low alarm.
in3_highest		Historical minimum output voltage (LM25063 only).
in3_lowest		Historical maximum output voltage (LM25063 only).

curr1_label		"iin"
curr1_input		Measured input current.
curr1_average		Average measured input current.
curr1_max		Maximum input current.
curr1_crit		Critical input current (LM25063 only).
curr1_max_alarm		Input current high alarm.
curr1_crit_alarm	Input current critical high alarm (LM25063 only).

power1_label		"pin"
power1_input		Measured input power.
power1_average		Average measured input power.
power1_max		Maximum input power limit.
power1_alarm		Input power alarm
power1_input_highest	Historical maximum power.
power1_reset_history	Write any value to reset maximum power history.

power2_label		"pout". LM25063 only.
power2_input		Measured output power.
power2_max		Maximum output power limit.
power2_crit		Critical output power limit.

temp1_input		Measured temperature.
temp1_max		Maximum temperature.
temp1_crit		Critical high temperature.
temp1_max_alarm		Chip temperature high alarm.
temp1_crit_alarm	Chip temperature critical high alarm.