Merge tag 'bitmain-soc-5.2' of git://git.kernel.org/pub/scm/linux/kernel/git/mani...
[sfrench/cifs-2.6.git] / Documentation / hwmon / mc13783-adc
1 Kernel driver mc13783-adc
2 =========================
3
4 Supported chips:
5   * Freescale MC13783
6     Prefix: 'mc13783'
7     Datasheet: https://www.nxp.com/docs/en/data-sheet/MC13783.pdf
8   * Freescale MC13892
9     Prefix: 'mc13892'
10     Datasheet: https://www.nxp.com/docs/en/data-sheet/MC13892.pdf
11
12 Authors:
13     Sascha Hauer <s.hauer@pengutronix.de>
14     Luotao Fu <l.fu@pengutronix.de>
15
16 Description
17 -----------
18
19 The Freescale MC13783 and MC13892 are Power Management and Audio Circuits.
20 Among other things they contain a 10-bit A/D converter. The converter has 16
21 (MC13783) resp. 12 (MC13892) channels which can be used in different modes. The
22 A/D converter has a resolution of 2.25mV.
23
24 Some channels can be used as General Purpose inputs or in a dedicated mode with
25 a chip internal scaling applied .
26
27 Currently the driver only supports the Application Supply channel (BP / BPSNS),
28 the General Purpose inputs and touchscreen.
29
30 See the following tables for the meaning of the different channels and their
31 chip internal scaling:
32
33 MC13783:
34 Channel Signal                                          Input Range     Scaling
35 -------------------------------------------------------------------------------
36 0       Battery Voltage (BATT)                          2.50 - 4.65V    -2.40V
37 1       Battery Current (BATT - BATTISNS)               -50 - 50 mV     x20
38 2       Application Supply (BP)                         2.50 - 4.65V    -2.40V
39 3       Charger Voltage (CHRGRAW)                       0 - 10V /       /5
40                                                         0 - 20V         /10
41 4       Charger Current (CHRGISNSP-CHRGISNSN)           -0.25 - 0.25V   x4
42 5       General Purpose ADIN5 / Battery Pack Thermistor 0 - 2.30V       No
43 6       General Purpose ADIN6 / Backup Voltage (LICELL) 0 - 2.30V /     No /
44                                                         1.50 - 3.50V    -1.20V
45 7       General Purpose ADIN7 / UID / Die Temperature   0 - 2.30V /     No /
46                                                         0 - 2.55V /     x0.9 / No
47 8       General Purpose ADIN8                           0 - 2.30V       No
48 9       General Purpose ADIN9                           0 - 2.30V       No
49 10      General Purpose ADIN10                          0 - 2.30V       No
50 11      General Purpose ADIN11                          0 - 2.30V       No
51 12      General Purpose TSX1 / Touchscreen X-plate 1    0 - 2.30V       No
52 13      General Purpose TSX2 / Touchscreen X-plate 2    0 - 2.30V       No
53 14      General Purpose TSY1 / Touchscreen Y-plate 1    0 - 2.30V       No
54 15      General Purpose TSY2 / Touchscreen Y-plate 2    0 - 2.30V       No
55
56 MC13892:
57 Channel Signal                                          Input Range     Scaling
58 -------------------------------------------------------------------------------
59 0       Battery Voltage (BATT)                          0 - 4.8V        /2
60 1       Battery Current (BATT - BATTISNSCC)             -60 - 60 mV     x20
61 2       Application Supply (BPSNS)                      0 - 4.8V        /2
62 3       Charger Voltage (CHRGRAW)                       0 - 12V /       /5
63                                                         0 - 20V         /10
64 4       Charger Current (CHRGISNS-BPSNS) /              -0.3 - 0.3V /   x4 /
65         Touchscreen X-plate 1                           0 - 2.4V        No
66 5       General Purpose ADIN5 / Battery Pack Thermistor 0 - 2.4V        No
67 6       General Purpose ADIN6 / Backup Voltage (LICELL) 0 - 2.4V /      No
68         Backup Voltage (LICELL)                         0 - 3.6V        x2/3
69 7       General Purpose ADIN7 / UID / Die Temperature   0 - 2.4V /      No /
70                                                         0 - 4.8V        /2
71 12      General Purpose TSX1 / Touchscreen X-plate 1    0 - 2.4V        No
72 13      General Purpose TSX2 / Touchscreen X-plate 2    0 - 2.4V        No
73 14      General Purpose TSY1 / Touchscreen Y-plate 1    0 - 2.4V        No
74 15      General Purpose TSY2 / Touchscreen Y-plate 2    0 - 2.4V        No