xref: /linux/Documentation/hwmon/lx1308.rst (revision 0eaed89c18aeedf0898baf2dbf5ff027c6795152)
1.. SPDX-License-Identifier: GPL-2.0-or-later
2
3Kernel driver lx1308
4====================
5
6Supported chips:
7
8  * Luxshare LX1308
9
10    Prefixes: 'lx1308'
11
12    Addresses scanned: -
13
14    Datasheet: Datasheet is not publicly available.
15
16Author: Brian Chiang <chiang.brian@inventec.com>
17
18
19Description
20-----------
21
22The LX1308 is a high-efficiency, non-isolated, regulated 12V, 860W,
23digital DC/DC power module. The module operates from a 40V to 60V DC
24primary bus and provides a 12V regulated output voltage. It can deliver
25up to 860W continuous and 1300W in transient.
26
27The module has slow OCP and fast OCP. If the module output current is higher
28than slow OCP set point and the lasting time is also longer than the delay,
29the module will shut down and retry 3 time, if the fault still exists then
30module enter latch mode.
31
32If the module output current is higher than fast OCP set point then it shut
33down and enter latch mode.
34
35The driver is a client driver to the core PMBus driver.
36Please see Documentation/hwmon/pmbus.rst for details on PMBus client drivers.
37
38
39Usage Notes
40-----------
41
42This driver does not auto-detect devices. You will have to instantiate the
43devices explicitly. Please see Documentation/i2c/instantiating-devices.rst for
44details.
45
46
47Sysfs entries
48-------------
49
50======================= ======================================================
51curr1_alarm             Input current alarm
52curr1_input             Input current (IIN)
53curr1_label             "iin"
54curr2_crit              Output over current fault threshold (slow OCP, 60ms delay)
55curr2_crit_alarm        Output over current fault alarm
56curr2_input             Output current (IOUT)
57curr2_label             "iout1"
58curr2_max               Output over current warning threshold (slow OCP, 60ms delay)
59curr2_max_alarm         Output over current warning alarm
60in1_crit                Input over voltage fault threshold
61in1_crit_alarm          Input over voltage fault alarm
62in1_input               Input voltage (VIN)
63in1_label               "vin"
64in1_lcrit               Input under voltage fault threshold
65in1_lcrit_alarm         Input under voltage fault alarm
66in1_max                 Input over voltage warning threshold
67in1_max_alarm           Input over voltage warning alarm
68in1_min                 Input under voltage warning threshold
69in1_min_alarm           Input under voltage warning alarm
70in2_crit                Output over voltage fault threshold
71in2_crit_alarm          Output over voltage fault alarm
72in2_input               Output voltage (VOUT)
73in2_label               "vout1"
74in2_lcrit               Output under voltage fault threshold
75in2_lcrit_alarm         Output under voltage fault alarm
76in2_max                 Output over voltage warning threshold
77in2_max_alarm           Output over voltage warning alarm
78in2_min                 Output under voltage warning threshold
79in2_min_alarm           Output under voltage warning alarm
80power1_alarm            Input power alarm
81power1_input            Input power (PIN)
82power1_label            "pin"
83power2_input            Output power (POUT)
84power2_label            "pout1"
85temp1_crit              Over temperature fault threshold
86temp1_crit_alarm        Over temperature fault alarm
87temp1_input             Module hot spot temperature
88temp1_max               Over temperature warning threshold
89temp1_max_alarm         Over temperature warning alarm
90======================= ======================================================
91