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