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