1Kernel driver zl6100
2====================
3
4Supported chips:
5  * Intersil / Zilker Labs ZL2004
6    Prefix: 'zl2004'
7    Addresses scanned: -
8    Datasheet: http://www.intersil.com/data/fn/fn6847.pdf
9  * Intersil / Zilker Labs ZL2005
10    Prefix: 'zl2005'
11    Addresses scanned: -
12    Datasheet: http://www.intersil.com/data/fn/fn6848.pdf
13  * Intersil / Zilker Labs ZL2006
14    Prefix: 'zl2006'
15    Addresses scanned: -
16    Datasheet: http://www.intersil.com/data/fn/fn6850.pdf
17  * Intersil / Zilker Labs ZL2008
18    Prefix: 'zl2008'
19    Addresses scanned: -
20    Datasheet: http://www.intersil.com/data/fn/fn6859.pdf
21  * Intersil / Zilker Labs ZL2105
22    Prefix: 'zl2105'
23    Addresses scanned: -
24    Datasheet: http://www.intersil.com/data/fn/fn6851.pdf
25  * Intersil / Zilker Labs ZL2106
26    Prefix: 'zl2106'
27    Addresses scanned: -
28    Datasheet: http://www.intersil.com/data/fn/fn6852.pdf
29  * Intersil / Zilker Labs ZL6100
30    Prefix: 'zl6100'
31    Addresses scanned: -
32    Datasheet: http://www.intersil.com/data/fn/fn6876.pdf
33  * Intersil / Zilker Labs ZL6105
34    Prefix: 'zl6105'
35    Addresses scanned: -
36    Datasheet: http://www.intersil.com/data/fn/fn6906.pdf
37  * Ericsson BMR450, BMR451
38    Prefix: 'bmr450', 'bmr451'
39    Addresses scanned: -
40    Datasheet:
41http://archive.ericsson.net/service/internet/picov/get?DocNo=28701-EN/LZT146401
42  * Ericsson BMR462, BMR463, BMR464
43    Prefixes: 'bmr462', 'bmr463', 'bmr464'
44    Addresses scanned: -
45    Datasheet:
46http://archive.ericsson.net/service/internet/picov/get?DocNo=28701-EN/LZT146256
47
48
49Author: Guenter Roeck <guenter.roeck@ericsson.com>
50
51
52Description
53-----------
54
55This driver supports hardware montoring for Intersil / Zilker Labs ZL6100 and
56compatible digital DC-DC controllers.
57
58The driver is a client driver to the core PMBus driver. Please see
59Documentation/hwmon/pmbus and Documentation.hwmon/pmbus-core for details
60on PMBus client drivers.
61
62
63Usage Notes
64-----------
65
66This driver does not auto-detect devices. You will have to instantiate the
67devices explicitly. Please see Documentation/i2c/instantiating-devices for
68details.
69
70WARNING: Do not access chip registers using the i2cdump command, and do not use
71any of the i2ctools commands on a command register used to save and restore
72configuration data (0x11, 0x12, 0x15, 0x16, and 0xf4). The chips supported by
73this driver interpret any access to those command registers (including read
74commands) as request to execute the command in question. Unless write accesses
75to those registers are protected, this may result in power loss, board resets,
76and/or Flash corruption. Worst case, your board may turn into a brick.
77
78
79Platform data support
80---------------------
81
82The driver supports standard PMBus driver platform data.
83
84
85Module parameters
86-----------------
87
88delay
89-----
90
91Intersil/Zilker Labs DC-DC controllers require a minimum interval between I2C
92bus accesses. According to Intersil, the minimum interval is 2 ms, though 1 ms
93appears to be sufficient and has not caused any problems in testing. The problem
94is known to affect all currently supported chips. For manual override, the
95driver provides a writeable module parameter, 'delay', which can be used to set
96the interval to a value between 0 and 65,535 microseconds.
97
98
99Sysfs entries
100-------------
101
102The following attributes are supported. Limits are read-write; all other
103attributes are read-only.
104
105in1_label		"vin"
106in1_input		Measured input voltage.
107in1_min			Minimum input voltage.
108in1_max			Maximum input voltage.
109in1_lcrit		Critical minumum input voltage.
110in1_crit		Critical maximum input voltage.
111in1_min_alarm		Input voltage low alarm.
112in1_max_alarm		Input voltage high alarm.
113in1_lcrit_alarm		Input voltage critical low alarm.
114in1_crit_alarm		Input voltage critical high alarm.
115
116in2_label		"vout1"
117in2_input		Measured output voltage.
118in2_lcrit		Critical minumum output Voltage.
119in2_crit		Critical maximum output voltage.
120in2_lcrit_alarm		Critical output voltage critical low alarm.
121in2_crit_alarm		Critical output voltage critical high alarm.
122
123curr1_label		"iout1"
124curr1_input		Measured output current.
125curr1_lcrit		Critical minimum output current.
126curr1_crit		Critical maximum output current.
127curr1_lcrit_alarm	Output current critical low alarm.
128curr1_crit_alarm	Output current critical high alarm.
129
130temp[12]_input		Measured temperature.
131temp[12]_min		Minimum temperature.
132temp[12]_max		Maximum temperature.
133temp[12]_lcrit		Critical low temperature.
134temp[12]_crit		Critical high temperature.
135temp[12]_min_alarm	Chip temperature low alarm.
136temp[12]_max_alarm	Chip temperature high alarm.
137temp[12]_lcrit_alarm	Chip temperature critical low alarm.
138temp[12]_crit_alarm	Chip temperature critical high alarm.
139