xref: /openbmc/linux/Documentation/hwmon/twl4030-madc-hwmon.rst (revision c39f2d9db0fd81ea20bb5cce9b3f082ca63753e2)
1*7ebd8b66SMauro Carvalho ChehabKernel driver twl4030-madc
2*7ebd8b66SMauro Carvalho Chehab==========================
3*7ebd8b66SMauro Carvalho Chehab
4*7ebd8b66SMauro Carvalho ChehabSupported chips:
5*7ebd8b66SMauro Carvalho Chehab
6*7ebd8b66SMauro Carvalho Chehab	* Texas Instruments TWL4030
7*7ebd8b66SMauro Carvalho Chehab
8*7ebd8b66SMauro Carvalho Chehab	Prefix: 'twl4030-madc'
9*7ebd8b66SMauro Carvalho Chehab
10*7ebd8b66SMauro Carvalho Chehab
11*7ebd8b66SMauro Carvalho ChehabAuthors:
12*7ebd8b66SMauro Carvalho Chehab	J Keerthy <j-keerthy@ti.com>
13*7ebd8b66SMauro Carvalho Chehab
14*7ebd8b66SMauro Carvalho ChehabDescription
15*7ebd8b66SMauro Carvalho Chehab-----------
16*7ebd8b66SMauro Carvalho Chehab
17*7ebd8b66SMauro Carvalho ChehabThe Texas Instruments TWL4030 is a Power Management and Audio Circuit. Among
18*7ebd8b66SMauro Carvalho Chehabother things it contains a 10-bit A/D converter MADC. The converter has 16
19*7ebd8b66SMauro Carvalho Chehabchannels which can be used in different modes.
20*7ebd8b66SMauro Carvalho Chehab
21*7ebd8b66SMauro Carvalho Chehab
22*7ebd8b66SMauro Carvalho ChehabSee this table for the meaning of the different channels
23*7ebd8b66SMauro Carvalho Chehab
24*7ebd8b66SMauro Carvalho Chehab======= ==========================================================
25*7ebd8b66SMauro Carvalho ChehabChannel Signal
26*7ebd8b66SMauro Carvalho Chehab======= ==========================================================
27*7ebd8b66SMauro Carvalho Chehab0	Battery type(BTYPE)
28*7ebd8b66SMauro Carvalho Chehab1	BCI: Battery temperature (BTEMP)
29*7ebd8b66SMauro Carvalho Chehab2	GP analog input
30*7ebd8b66SMauro Carvalho Chehab3	GP analog input
31*7ebd8b66SMauro Carvalho Chehab4	GP analog input
32*7ebd8b66SMauro Carvalho Chehab5	GP analog input
33*7ebd8b66SMauro Carvalho Chehab6	GP analog input
34*7ebd8b66SMauro Carvalho Chehab7	GP analog input
35*7ebd8b66SMauro Carvalho Chehab8	BCI: VBUS voltage(VBUS)
36*7ebd8b66SMauro Carvalho Chehab9	Backup Battery voltage (VBKP)
37*7ebd8b66SMauro Carvalho Chehab10	BCI: Battery charger current (ICHG)
38*7ebd8b66SMauro Carvalho Chehab11	BCI: Battery charger voltage (VCHG)
39*7ebd8b66SMauro Carvalho Chehab12	BCI: Main battery voltage (VBAT)
40*7ebd8b66SMauro Carvalho Chehab13	Reserved
41*7ebd8b66SMauro Carvalho Chehab14	Reserved
42*7ebd8b66SMauro Carvalho Chehab15	VRUSB Supply/Speaker left/Speaker right polarization level
43*7ebd8b66SMauro Carvalho Chehab======= ==========================================================
44*7ebd8b66SMauro Carvalho Chehab
45*7ebd8b66SMauro Carvalho Chehab
46*7ebd8b66SMauro Carvalho ChehabThe Sysfs nodes will represent the voltage in the units of mV,
47*7ebd8b66SMauro Carvalho Chehabthe temperature channel shows the converted temperature in
48*7ebd8b66SMauro Carvalho Chehabdegree Celsius. The Battery charging current channel represents
49*7ebd8b66SMauro Carvalho Chehabbattery charging current in mA.
50