projects / mirror_ubuntu-jammy-kernel.git / blame
| Commit | Line | Data |
|---|---|---|
| 6f4a0dae GR |
1 | Kernel driver tps53679 |
| 2 | ====================== | |
| 3 | ||
| 4 | Supported chips: | |
| 5 | ||
| 6 | * Texas Instruments TPS53647 | |
| 7 | ||
| 8 | Prefix: 'tps53647' | |
| 9 | ||
| 10 | Addresses scanned: - | |
| 11 | ||
| ad736c1a | 12 | Datasheet: https://www.ti.com/lit/gpn/tps53647 |
| 6f4a0dae GR |
13 | |
| 14 | * Texas Instruments TPS53667 | |
| 15 | ||
| 16 | Prefix: 'tps53667' | |
| 17 | ||
| 18 | Addresses scanned: - | |
| 19 | ||
| ad736c1a | 20 | Datasheet: https://www.ti.com/lit/gpn/TPS53667 |
| 6f4a0dae GR |
21 | |
| 22 | * Texas Instruments TPS53679 | |
| 23 | ||
| 24 | Prefix: 'tps53679' | |
| 25 | ||
| 26 | Addresses scanned: - | |
| 27 | ||
| ad736c1a | 28 | Datasheet: https://www.ti.com/lit/gpn/TPS53679 (short version) |
| 6f4a0dae GR |
29 | |
| 30 | * Texas Instruments TPS53681 | |
| 31 | ||
| 32 | Prefix: 'tps53681' | |
| 33 | ||
| 34 | Addresses scanned: - | |
| 35 | ||
| ad736c1a | 36 | Datasheet: https://www.ti.com/lit/gpn/TPS53681 |
| 6f4a0dae GR |
37 | |
| 38 | * Texas Instruments TPS53688 | |
| 39 | ||
| 40 | Prefix: 'tps53688' | |
| 41 | ||
| 42 | Addresses scanned: - | |
| 43 | ||
| 44 | Datasheet: Available under NDA | |
| 45 | ||
| 46 | ||
| 47 | Authors: | |
| 48 | Vadim Pasternak <vadimp@mellanox.com> | |
| 49 | Guenter Roeck <linux@roeck-us.net> | |
| 50 | ||
| 51 | ||
| 52 | Description | |
| 53 | ----------- | |
| 54 | ||
| 55 | Chips in this series are multi-phase step-down converters with one or two | |
| 56 | output channels and up to 8 phases per channel. | |
| 57 | ||
| 58 | ||
| 59 | Usage Notes | |
| 60 | ----------- | |
| 61 | ||
| 62 | This driver does not probe for PMBus devices. You will have to instantiate | |
| 63 | devices explicitly. | |
| 64 | ||
| 65 | Example: the following commands will load the driver for an TPS53681 at address | |
| 66 | 0x60 on I2C bus #1:: | |
| 67 | ||
| 68 | # modprobe tps53679 | |
| 69 | # echo tps53681 0x60 > /sys/bus/i2c/devices/i2c-1/new_device | |
| 70 | ||
| 71 | ||
| 72 | Sysfs attributes | |
| 73 | ---------------- | |
| 74 | ||
| 75 | ======================= ======================================================== | |
| 76 | in1_label "vin" | |
| 77 | ||
| 78 | in1_input Measured input voltage. | |
| 79 | ||
| 80 | in1_lcrit Critical minimum input voltage | |
| 81 | ||
| 82 | TPS53679, TPS53681, TPS53688 only. | |
| 83 | ||
| 84 | in1_lcrit_alarm Input voltage critical low alarm. | |
| 85 | ||
| 86 | TPS53679, TPS53681, TPS53688 only. | |
| 87 | ||
| 88 | in1_crit Critical maximum input voltage. | |
| 89 | ||
| 90 | in1_crit_alarm Input voltage critical high alarm. | |
| 91 | ||
| 92 | in[N]_label "vout[1-2]" | |
| 93 | ||
| 94 | - TPS53647, TPS53667: N=2 | |
| 95 | - TPS53679, TPS53588: N=2,3 | |
| 96 | ||
| 97 | in[N]_input Measured output voltage. | |
| 98 | ||
| 99 | in[N]_lcrit Critical minimum input voltage. | |
| 100 | ||
| 101 | TPS53679, TPS53681, TPS53688 only. | |
| 102 | ||
| 103 | in[N]_lcrit_alarm Critical minimum voltage alarm. | |
| 104 | ||
| 105 | TPS53679, TPS53681, TPS53688 only. | |
| 106 | ||
| 107 | in[N]_alarm Output voltage alarm. | |
| 108 | ||
| 109 | TPS53647, TPS53667 only. | |
| 110 | ||
| 111 | in[N]_crit Critical maximum output voltage. | |
| 112 | ||
| 113 | TPS53679, TPS53681, TPS53688 only. | |
| 114 | ||
| 115 | in[N]_crit_alarm Output voltage critical high alarm. | |
| 116 | ||
| 117 | TPS53679, TPS53681, TPS53688 only. | |
| 118 | ||
| 119 | temp[N]_input Measured temperature. | |
| 120 | ||
| 121 | - TPS53647, TPS53667: N=1 | |
| 122 | - TPS53679, TPS53681, TPS53588: N=1,2 | |
| 123 | ||
| 124 | temp[N]_max Maximum temperature. | |
| 125 | ||
| 126 | temp[N]_crit Critical high temperature. | |
| 127 | ||
| 128 | temp[N]_max_alarm Temperature high alarm. | |
| 129 | ||
| 130 | temp[N]_crit_alarm Temperature critical high alarm. | |
| 131 | ||
| 132 | power1_label "pin". | |
| 133 | ||
| 134 | power1_input Measured input power. | |
| 135 | ||
| 136 | power[N]_label "pout[1-2]". | |
| 137 | ||
| 138 | - TPS53647, TPS53667: N=2 | |
| 139 | - TPS53679, TPS53681, TPS53588: N=2,3 | |
| 140 | ||
| 141 | power[N]_input Measured output power. | |
| 142 | ||
| 143 | curr1_label "iin". | |
| 144 | ||
| 145 | curr1_input Measured input current. | |
| 146 | ||
| 147 | curr1_max Maximum input current. | |
| 148 | ||
| 149 | curr1_max_alarm Input current high alarm. | |
| 150 | ||
| 151 | curr1_crit Critical input current. | |
| 152 | ||
| 153 | curr1_crit_alarm Input current critical alarm. | |
| 154 | ||
| 155 | curr[N]_label "iout[1-2]" or "iout1.[0-5]". | |
| 156 | ||
| 157 | The first digit is the output channel, the second | |
| 158 | digit is the phase within the channel. Per-phase | |
| 159 | telemetry supported on TPS53681 only. | |
| 160 | ||
| 161 | - TPS53647, TPS53667: N=2 | |
| 162 | - TPS53679, TPS53588: N=2,3 | |
| 163 | - TPS53681: N=2-9 | |
| 164 | ||
| 165 | curr[N]_input Measured output current. | |
| 166 | ||
| 167 | curr[N]_max Maximum output current. | |
| 168 | ||
| 169 | curr[N]_crit Critical high output current. | |
| 170 | ||
| 171 | curr[N]_max_alarm Output current high alarm. | |
| 172 | ||
| 173 | curr[N]_crit_alarm Output current critical high alarm. | |
| 174 | ||
| 175 | Limit and alarm attributes are only available for | |
| 176 | non-phase telemetry (iout1, iout2). | |
| 177 | ||
| 178 | ======================= ======================================================== |