xref: /linux/Documentation/hwmon/powr1220.rst (revision c39f2d9db0fd81ea20bb5cce9b3f082ca63753e2)
1*7ebd8b66SMauro Carvalho ChehabKernel driver powr1220
2*7ebd8b66SMauro Carvalho Chehab======================
3*7ebd8b66SMauro Carvalho Chehab
4*7ebd8b66SMauro Carvalho ChehabSupported chips:
5*7ebd8b66SMauro Carvalho Chehab
6*7ebd8b66SMauro Carvalho Chehab  * Lattice POWR1220AT8
7*7ebd8b66SMauro Carvalho Chehab
8*7ebd8b66SMauro Carvalho Chehab    Prefix: 'powr1220'
9*7ebd8b66SMauro Carvalho Chehab
10*7ebd8b66SMauro Carvalho Chehab    Addresses scanned: none
11*7ebd8b66SMauro Carvalho Chehab
12*7ebd8b66SMauro Carvalho Chehab    Datasheet: Publicly available at the Lattice website
13*7ebd8b66SMauro Carvalho Chehab
14*7ebd8b66SMauro Carvalho Chehab	       http://www.latticesemi.com/
15*7ebd8b66SMauro Carvalho Chehab
16*7ebd8b66SMauro Carvalho ChehabAuthor: Scott Kanowitz <scott.kanowitz@gmail.com>
17*7ebd8b66SMauro Carvalho Chehab
18*7ebd8b66SMauro Carvalho ChehabDescription
19*7ebd8b66SMauro Carvalho Chehab-----------
20*7ebd8b66SMauro Carvalho Chehab
21*7ebd8b66SMauro Carvalho ChehabThis driver supports the Lattice POWR1220AT8 chip. The POWR1220
22*7ebd8b66SMauro Carvalho Chehabincludes voltage monitoring for 14 inputs as well as trim settings
23*7ebd8b66SMauro Carvalho Chehabfor output voltages and GPIOs. This driver implements the voltage
24*7ebd8b66SMauro Carvalho Chehabmonitoring portion of the chip.
25*7ebd8b66SMauro Carvalho Chehab
26*7ebd8b66SMauro Carvalho ChehabVoltages are sampled by a 12-bit ADC with a step size of 2 mV.
27*7ebd8b66SMauro Carvalho ChehabAn in-line attenuator allows measurements from 0 to 6 V. The
28*7ebd8b66SMauro Carvalho Chehabattenuator is enabled or disabled depending on the setting of the
29*7ebd8b66SMauro Carvalho Chehabinput's max value. The driver will enable the attenuator for any
30*7ebd8b66SMauro Carvalho Chehabvalue over the low measurement range maximum of 2 V.
31*7ebd8b66SMauro Carvalho Chehab
32*7ebd8b66SMauro Carvalho ChehabThe input naming convention is as follows:
33*7ebd8b66SMauro Carvalho Chehab
34*7ebd8b66SMauro Carvalho Chehab============== ========
35*7ebd8b66SMauro Carvalho Chehabdriver name    pin name
36*7ebd8b66SMauro Carvalho Chehab============== ========
37*7ebd8b66SMauro Carvalho Chehabin0            VMON1
38*7ebd8b66SMauro Carvalho Chehabin1            VMON2
39*7ebd8b66SMauro Carvalho Chehabin2            VMON3
40*7ebd8b66SMauro Carvalho Chehabin2            VMON4
41*7ebd8b66SMauro Carvalho Chehabin4            VMON5
42*7ebd8b66SMauro Carvalho Chehabin5            VMON6
43*7ebd8b66SMauro Carvalho Chehabin6            VMON7
44*7ebd8b66SMauro Carvalho Chehabin7            VMON8
45*7ebd8b66SMauro Carvalho Chehabin8            VMON9
46*7ebd8b66SMauro Carvalho Chehabin9            VMON10
47*7ebd8b66SMauro Carvalho Chehabin10           VMON11
48*7ebd8b66SMauro Carvalho Chehabin11           VMON12
49*7ebd8b66SMauro Carvalho Chehabin12           VCCA
50*7ebd8b66SMauro Carvalho Chehabin13           VCCINP
51*7ebd8b66SMauro Carvalho Chehab============== ========
52*7ebd8b66SMauro Carvalho Chehab
53*7ebd8b66SMauro Carvalho ChehabThe ADC readings are updated on request with a minimum period of 1s.
54