xref: /linux/Documentation/hwmon/lx1308.rst (revision 0eaed89c18aeedf0898baf2dbf5ff027c6795152)
1*d71d17d3SBrian Chiang.. SPDX-License-Identifier: GPL-2.0-or-later
2*d71d17d3SBrian Chiang
3*d71d17d3SBrian ChiangKernel driver lx1308
4*d71d17d3SBrian Chiang====================
5*d71d17d3SBrian Chiang
6*d71d17d3SBrian ChiangSupported chips:
7*d71d17d3SBrian Chiang
8*d71d17d3SBrian Chiang  * Luxshare LX1308
9*d71d17d3SBrian Chiang
10*d71d17d3SBrian Chiang    Prefixes: 'lx1308'
11*d71d17d3SBrian Chiang
12*d71d17d3SBrian Chiang    Addresses scanned: -
13*d71d17d3SBrian Chiang
14*d71d17d3SBrian Chiang    Datasheet: Datasheet is not publicly available.
15*d71d17d3SBrian Chiang
16*d71d17d3SBrian ChiangAuthor: Brian Chiang <chiang.brian@inventec.com>
17*d71d17d3SBrian Chiang
18*d71d17d3SBrian Chiang
19*d71d17d3SBrian ChiangDescription
20*d71d17d3SBrian Chiang-----------
21*d71d17d3SBrian Chiang
22*d71d17d3SBrian ChiangThe LX1308 is a high-efficiency, non-isolated, regulated 12V, 860W,
23*d71d17d3SBrian Chiangdigital DC/DC power module. The module operates from a 40V to 60V DC
24*d71d17d3SBrian Chiangprimary bus and provides a 12V regulated output voltage. It can deliver
25*d71d17d3SBrian Chiangup to 860W continuous and 1300W in transient.
26*d71d17d3SBrian Chiang
27*d71d17d3SBrian ChiangThe module has slow OCP and fast OCP. If the module output current is higher
28*d71d17d3SBrian Chiangthan slow OCP set point and the lasting time is also longer than the delay,
29*d71d17d3SBrian Chiangthe module will shut down and retry 3 time, if the fault still exists then
30*d71d17d3SBrian Chiangmodule enter latch mode.
31*d71d17d3SBrian Chiang
32*d71d17d3SBrian ChiangIf the module output current is higher than fast OCP set point then it shut
33*d71d17d3SBrian Chiangdown and enter latch mode.
34*d71d17d3SBrian Chiang
35*d71d17d3SBrian ChiangThe driver is a client driver to the core PMBus driver.
36*d71d17d3SBrian ChiangPlease see Documentation/hwmon/pmbus.rst for details on PMBus client drivers.
37*d71d17d3SBrian Chiang
38*d71d17d3SBrian Chiang
39*d71d17d3SBrian ChiangUsage Notes
40*d71d17d3SBrian Chiang-----------
41*d71d17d3SBrian Chiang
42*d71d17d3SBrian ChiangThis driver does not auto-detect devices. You will have to instantiate the
43*d71d17d3SBrian Chiangdevices explicitly. Please see Documentation/i2c/instantiating-devices.rst for
44*d71d17d3SBrian Chiangdetails.
45*d71d17d3SBrian Chiang
46*d71d17d3SBrian Chiang
47*d71d17d3SBrian ChiangSysfs entries
48*d71d17d3SBrian Chiang-------------
49*d71d17d3SBrian Chiang
50*d71d17d3SBrian Chiang======================= ======================================================
51*d71d17d3SBrian Chiangcurr1_alarm             Input current alarm
52*d71d17d3SBrian Chiangcurr1_input             Input current (IIN)
53*d71d17d3SBrian Chiangcurr1_label             "iin"
54*d71d17d3SBrian Chiangcurr2_crit              Output over current fault threshold (slow OCP, 60ms delay)
55*d71d17d3SBrian Chiangcurr2_crit_alarm        Output over current fault alarm
56*d71d17d3SBrian Chiangcurr2_input             Output current (IOUT)
57*d71d17d3SBrian Chiangcurr2_label             "iout1"
58*d71d17d3SBrian Chiangcurr2_max               Output over current warning threshold (slow OCP, 60ms delay)
59*d71d17d3SBrian Chiangcurr2_max_alarm         Output over current warning alarm
60*d71d17d3SBrian Chiangin1_crit                Input over voltage fault threshold
61*d71d17d3SBrian Chiangin1_crit_alarm          Input over voltage fault alarm
62*d71d17d3SBrian Chiangin1_input               Input voltage (VIN)
63*d71d17d3SBrian Chiangin1_label               "vin"
64*d71d17d3SBrian Chiangin1_lcrit               Input under voltage fault threshold
65*d71d17d3SBrian Chiangin1_lcrit_alarm         Input under voltage fault alarm
66*d71d17d3SBrian Chiangin1_max                 Input over voltage warning threshold
67*d71d17d3SBrian Chiangin1_max_alarm           Input over voltage warning alarm
68*d71d17d3SBrian Chiangin1_min                 Input under voltage warning threshold
69*d71d17d3SBrian Chiangin1_min_alarm           Input under voltage warning alarm
70*d71d17d3SBrian Chiangin2_crit                Output over voltage fault threshold
71*d71d17d3SBrian Chiangin2_crit_alarm          Output over voltage fault alarm
72*d71d17d3SBrian Chiangin2_input               Output voltage (VOUT)
73*d71d17d3SBrian Chiangin2_label               "vout1"
74*d71d17d3SBrian Chiangin2_lcrit               Output under voltage fault threshold
75*d71d17d3SBrian Chiangin2_lcrit_alarm         Output under voltage fault alarm
76*d71d17d3SBrian Chiangin2_max                 Output over voltage warning threshold
77*d71d17d3SBrian Chiangin2_max_alarm           Output over voltage warning alarm
78*d71d17d3SBrian Chiangin2_min                 Output under voltage warning threshold
79*d71d17d3SBrian Chiangin2_min_alarm           Output under voltage warning alarm
80*d71d17d3SBrian Chiangpower1_alarm            Input power alarm
81*d71d17d3SBrian Chiangpower1_input            Input power (PIN)
82*d71d17d3SBrian Chiangpower1_label            "pin"
83*d71d17d3SBrian Chiangpower2_input            Output power (POUT)
84*d71d17d3SBrian Chiangpower2_label            "pout1"
85*d71d17d3SBrian Chiangtemp1_crit              Over temperature fault threshold
86*d71d17d3SBrian Chiangtemp1_crit_alarm        Over temperature fault alarm
87*d71d17d3SBrian Chiangtemp1_input             Module hot spot temperature
88*d71d17d3SBrian Chiangtemp1_max               Over temperature warning threshold
89*d71d17d3SBrian Chiangtemp1_max_alarm         Over temperature warning alarm
90*d71d17d3SBrian Chiang======================= ======================================================
91