aboutsummaryrefslogtreecommitdiffstats
path: root/Documentation/devicetree
diff options
context:
space:
mode:
authorLinus Torvalds <torvalds@linux-foundation.org>2013-07-10 14:10:27 -0400
committerLinus Torvalds <torvalds@linux-foundation.org>2013-07-10 14:10:27 -0400
commit3aa78e0cb5c9b8b4ed2a617bb1e1542bfb508379 (patch)
treea446e1f8a81f63933423ef11ea7d31cc918b30f6 /Documentation/devicetree
parentdc5ef1f56968c67e81ad1c81ab7dce678f480285 (diff)
parent25f311fa58c18c19ae1348336265ccb8368638f0 (diff)
Merge tag 'mfd-3.11-1' of git://git.kernel.org/pub/scm/linux/kernel/git/sameo/mfd-next
Pull MFD update from Samuel Ortiz: "For the 3.11 merge we only have one new MFD driver for the Kontron PLD. But we also have: - Support for the TPS659038 PMIC from the palmas driver. - Intel's Coleto Creek and Avoton SoCs support from the lpc_ich driver. - RTL8411B support from the rtsx driver. - More DT support for the Arizona, max8998, twl4030-power and the ti_am335x_tsadc drivers. - The SSBI driver move under MFD. - A conversion to the devm_* API for most of the MFD drivers. - The twl4030-power got split from twl-core into its own module. - A major ti_am335x_adc cleanup, leading to a proper DT support. - Our regular arizona and wm* updates and cleanups from the Wolfson folks. - A better error handling and initialization, and a regulator subdevice addition for the 88pm80x driver. - A bulk platform_set_drvdata() call removal that's no longer need since commit 0998d0631001 ("device-core: Ensure drvdata = NULL when no driver is bound") * tag 'mfd-3.11-1' of git://git.kernel.org/pub/scm/linux/kernel/git/sameo/mfd-next: (102 commits) mfd: sec: Provide max_register to regmap mfd: wm8994: Remove duplicate check for active JACKDET MAINTAINERS: Add include directory to MFD file patterns mfd: sec: Remove fields not used since regmap conversion watchdog: Kontron PLD watchdog timer driver mfd: max8998: Add support for Device Tree regulator: max8998: Use arrays for specifying voltages in platform data mfd: max8998: Add irq domain support regulator: palmas: Add TPS659038 support mfd: Kontron PLD mfd driver mfd: palmas: Add TPS659038 PMIC support mfd: palmas: Add SMPS10_BOOST feature mfd: palmas: Check if irq is valid mfd: lpc_ich: iTCO_wdt patch for Intel Coleto Creek DeviceIDs mfd: twl-core: Change TWL6025 references to TWL6032 mfd: davinci_voicecodec: Fix build breakage mfd: vexpress: Make the driver optional for arm and arm64 mfd: htc-egpio: Use devm_ioremap_nocache() instead of ioremap_nocache() mfd: davinci_voicecodec: Convert to use devm_* APIs mfd: twl4030-power: Fix relocking on error ...
Diffstat (limited to 'Documentation/devicetree')
-rw-r--r--Documentation/devicetree/bindings/input/touchscreen/ti-tsc-adc.txt44
-rw-r--r--Documentation/devicetree/bindings/mfd/max8998.txt119
-rw-r--r--Documentation/devicetree/bindings/mfd/twl4030-power.txt28
-rw-r--r--Documentation/devicetree/bindings/regulator/twl-regulator.txt26
-rw-r--r--Documentation/devicetree/bindings/usb/twlxxxx-usb.txt2
5 files changed, 205 insertions, 14 deletions
diff --git a/Documentation/devicetree/bindings/input/touchscreen/ti-tsc-adc.txt b/Documentation/devicetree/bindings/input/touchscreen/ti-tsc-adc.txt
new file mode 100644
index 000000000000..491c97b78384
--- /dev/null
+++ b/Documentation/devicetree/bindings/input/touchscreen/ti-tsc-adc.txt
@@ -0,0 +1,44 @@
1* TI - TSC ADC (Touschscreen and analog digital converter)
2~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
3
4Required properties:
5- child "tsc"
6 ti,wires: Wires refer to application modes i.e. 4/5/8 wire touchscreen
7 support on the platform.
8 ti,x-plate-resistance: X plate resistance
9 ti,coordiante-readouts: The sequencer supports a total of 16
10 programmable steps each step is used to
11 read a single coordinate. A single
12 readout is enough but multiple reads can
13 increase the quality.
14 A value of 5 means, 5 reads for X, 5 for
15 Y and 2 for Z (always). This utilises 12
16 of the 16 software steps available. The
17 remaining 4 can be used by the ADC.
18 ti,wire-config: Different boards could have a different order for
19 connecting wires on touchscreen. We need to provide an
20 8 bit number where in the 1st four bits represent the
21 analog lines and the next 4 bits represent positive/
22 negative terminal on that input line. Notations to
23 represent the input lines and terminals resoectively
24 is as follows:
25 AIN0 = 0, AIN1 = 1 and so on till AIN7 = 7.
26 XP = 0, XN = 1, YP = 2, YN = 3.
27- child "adc"
28 ti,adc-channels: List of analog inputs available for ADC.
29 AIN0 = 0, AIN1 = 1 and so on till AIN7 = 7.
30
31Example:
32 tscadc: tscadc@44e0d000 {
33 compatible = "ti,am3359-tscadc";
34 tsc {
35 ti,wires = <4>;
36 ti,x-plate-resistance = <200>;
37 ti,coordiante-readouts = <5>;
38 ti,wire-config = <0x00 0x11 0x22 0x33>;
39 };
40
41 adc {
42 ti,adc-channels = <4 5 6 7>;
43 };
44 }
diff --git a/Documentation/devicetree/bindings/mfd/max8998.txt b/Documentation/devicetree/bindings/mfd/max8998.txt
new file mode 100644
index 000000000000..23a3650ff2a2
--- /dev/null
+++ b/Documentation/devicetree/bindings/mfd/max8998.txt
@@ -0,0 +1,119 @@
1* Maxim MAX8998, National/TI LP3974 multi-function device
2
3The Maxim MAX8998 is a multi-function device which includes voltage/current
4regulators, real time clock, battery charging controller and several
5other sub-blocks. It is interfaced using an I2C interface. Each sub-block
6is addressed by the host system using different i2c slave address.
7
8PMIC sub-block
9--------------
10
11The PMIC sub-block contains a number of voltage and current regulators,
12with controllable parameters and dynamic voltage scaling capability.
13In addition, it includes a real time clock and battery charging controller
14as well. It is accessible at I2C address 0x66.
15
16Required properties:
17- compatible: Should be one of the following:
18 - "maxim,max8998" for Maxim MAX8998
19 - "national,lp3974" or "ti,lp3974" for National/TI LP3974.
20- reg: Specifies the i2c slave address of the pmic block. It should be 0x66.
21
22Optional properties:
23- interrupt-parent: Specifies the phandle of the interrupt controller to which
24 the interrupts from MAX8998 are routed to.
25- interrupts: Interrupt specifiers for two interrupt sources.
26 - First interrupt specifier is for main interrupt.
27 - Second interrupt specifier is for power-on/-off interrupt.
28- max8998,pmic-buck1-dvs-gpios: GPIO specifiers for two host gpios used
29 for buck 1 dvs. The format of the gpio specifier depends on the gpio
30 controller.
31- max8998,pmic-buck2-dvs-gpio: GPIO specifier for host gpio used
32 for buck 2 dvs. The format of the gpio specifier depends on the gpio
33 controller.
34- max8998,pmic-buck1-default-dvs-idx: Default voltage setting selected from
35 the possible 4 options selectable by the dvs gpios. The value of this
36 property should be 0, 1, 2 or 3. If not specified or out of range,
37 a default value of 0 is taken.
38- max8998,pmic-buck2-default-dvs-idx: Default voltage setting selected from
39 the possible 2 options selectable by the dvs gpios. The value of this
40 property should be 0 or 1. If not specified or out of range, a default
41 value of 0 is taken.
42- max8998,pmic-buck-voltage-lock: If present, disallows changing of
43 preprogrammed buck dvfs voltages.
44
45Additional properties required if max8998,pmic-buck1-dvs-gpios is defined:
46- max8998,pmic-buck1-dvs-voltage: An array of 4 voltage values in microvolts
47 for buck1 regulator that can be selected using dvs gpio.
48
49Additional properties required if max8998,pmic-buck2-dvs-gpio is defined:
50- max8998,pmic-buck2-dvs-voltage: An array of 2 voltage values in microvolts
51 for buck2 regulator that can be selected using dvs gpio.
52
53Regulators: All the regulators of MAX8998 to be instantiated shall be
54listed in a child node named 'regulators'. Each regulator is represented
55by a child node of the 'regulators' node.
56
57 regulator-name {
58 /* standard regulator bindings here */
59 };
60
61Following regulators of the MAX8998 PMIC block are supported. Note that
62the 'n' in regulator name, as in LDOn or BUCKn, represents the LDO or BUCK
63number as described in MAX8998 datasheet.
64
65 - LDOn
66 - valid values for n are 2 to 17
67 - Example: LDO2, LDO10, LDO17
68 - BUCKn
69 - valid values for n are 1 to 4.
70 - Example: BUCK1, BUCK2, BUCK3, BUCK4
71
72 - ENVICHG: Battery Charging Current Monitor Output. This is a fixed
73 voltage type regulator
74
75 - ESAFEOUT1: (ldo19)
76 - ESAFEOUT2: (ld020)
77
78Standard regulator bindings are used inside regulator subnodes. Check
79 Documentation/devicetree/bindings/regulator/regulator.txt
80for more details.
81
82Example:
83
84 pmic@66 {
85 compatible = "maxim,max8998-pmic";
86 reg = <0x66>;
87 interrupt-parent = <&wakeup_eint>;
88 interrupts = <4 0>, <3 0>;
89
90 /* Buck 1 DVS settings */
91 max8998,pmic-buck1-default-dvs-idx = <0>;
92 max8998,pmic-buck1-dvs-gpios = <&gpx0 0 1 0 0>, /* SET1 */
93 <&gpx0 1 1 0 0>; /* SET2 */
94 max8998,pmic-buck1-dvs-voltage = <1350000>, <1300000>,
95 <1000000>, <950000>;
96
97 /* Buck 2 DVS settings */
98 max8998,pmic-buck2-default-dvs-idx = <0>;
99 max8998,pmic-buck2-dvs-gpio = <&gpx0 0 3 0 0>; /* SET3 */
100 max8998,pmic-buck2-dvs-voltage = <1350000>, <1300000>;
101
102 /* Regulators to instantiate */
103 regulators {
104 ldo2_reg: LDO2 {
105 regulator-name = "VDD_ALIVE_1.1V";
106 regulator-min-microvolt = <1100000>;
107 regulator-max-microvolt = <1100000>;
108 regulator-always-on;
109 };
110
111 buck1_reg: BUCK1 {
112 regulator-name = "VDD_ARM_1.2V";
113 regulator-min-microvolt = <950000>;
114 regulator-max-microvolt = <1350000>;
115 regulator-always-on;
116 regulator-boot-on;
117 };
118 };
119 };
diff --git a/Documentation/devicetree/bindings/mfd/twl4030-power.txt b/Documentation/devicetree/bindings/mfd/twl4030-power.txt
new file mode 100644
index 000000000000..8e15ec35ac99
--- /dev/null
+++ b/Documentation/devicetree/bindings/mfd/twl4030-power.txt
@@ -0,0 +1,28 @@
1Texas Instruments TWL family (twl4030) reset and power management module
2
3The power management module inside the TWL family provides several facilities
4to control the power resources, including power scripts. For now, the
5binding only supports the complete shutdown of the system after poweroff.
6
7Required properties:
8- compatible : must be "ti,twl4030-power"
9
10Optional properties:
11- ti,use_poweroff: With this flag, the chip will initiates an ACTIVE-to-OFF or
12 SLEEP-to-OFF transition when the system poweroffs.
13
14Example:
15&i2c1 {
16 clock-frequency = <2600000>;
17
18 twl: twl@48 {
19 reg = <0x48>;
20 interrupts = <7>; /* SYS_NIRQ cascaded to intc */
21 interrupt-parent = <&intc>;
22
23 twl_power: power {
24 compatible = "ti,twl4030-power";
25 ti,use_poweroff;
26 };
27 };
28};
diff --git a/Documentation/devicetree/bindings/regulator/twl-regulator.txt b/Documentation/devicetree/bindings/regulator/twl-regulator.txt
index 658749b90b97..75b0c1669504 100644
--- a/Documentation/devicetree/bindings/regulator/twl-regulator.txt
+++ b/Documentation/devicetree/bindings/regulator/twl-regulator.txt
@@ -18,20 +18,20 @@ For twl6030 regulators/LDOs
18 - "ti,twl6030-vdd1" for VDD1 SMPS 18 - "ti,twl6030-vdd1" for VDD1 SMPS
19 - "ti,twl6030-vdd2" for VDD2 SMPS 19 - "ti,twl6030-vdd2" for VDD2 SMPS
20 - "ti,twl6030-vdd3" for VDD3 SMPS 20 - "ti,twl6030-vdd3" for VDD3 SMPS
21For twl6025 regulators/LDOs 21For twl6032 regulators/LDOs
22- compatible: 22- compatible:
23 - "ti,twl6025-ldo1" for LDO1 LDO 23 - "ti,twl6032-ldo1" for LDO1 LDO
24 - "ti,twl6025-ldo2" for LDO2 LDO 24 - "ti,twl6032-ldo2" for LDO2 LDO
25 - "ti,twl6025-ldo3" for LDO3 LDO 25 - "ti,twl6032-ldo3" for LDO3 LDO
26 - "ti,twl6025-ldo4" for LDO4 LDO 26 - "ti,twl6032-ldo4" for LDO4 LDO
27 - "ti,twl6025-ldo5" for LDO5 LDO 27 - "ti,twl6032-ldo5" for LDO5 LDO
28 - "ti,twl6025-ldo6" for LDO6 LDO 28 - "ti,twl6032-ldo6" for LDO6 LDO
29 - "ti,twl6025-ldo7" for LDO7 LDO 29 - "ti,twl6032-ldo7" for LDO7 LDO
30 - "ti,twl6025-ldoln" for LDOLN LDO 30 - "ti,twl6032-ldoln" for LDOLN LDO
31 - "ti,twl6025-ldousb" for LDOUSB LDO 31 - "ti,twl6032-ldousb" for LDOUSB LDO
32 - "ti,twl6025-smps3" for SMPS3 SMPS 32 - "ti,twl6032-smps3" for SMPS3 SMPS
33 - "ti,twl6025-smps4" for SMPS4 SMPS 33 - "ti,twl6032-smps4" for SMPS4 SMPS
34 - "ti,twl6025-vio" for VIO SMPS 34 - "ti,twl6032-vio" for VIO SMPS
35For twl4030 regulators/LDOs 35For twl4030 regulators/LDOs
36- compatible: 36- compatible:
37 - "ti,twl4030-vaux1" for VAUX1 LDO 37 - "ti,twl4030-vaux1" for VAUX1 LDO
diff --git a/Documentation/devicetree/bindings/usb/twlxxxx-usb.txt b/Documentation/devicetree/bindings/usb/twlxxxx-usb.txt
index 36b9aede3f40..0aee0ad3f035 100644
--- a/Documentation/devicetree/bindings/usb/twlxxxx-usb.txt
+++ b/Documentation/devicetree/bindings/usb/twlxxxx-usb.txt
@@ -8,7 +8,7 @@ TWL6030 USB COMPARATOR
8 usb interrupt number that raises VBUS interrupts when the controller has to 8 usb interrupt number that raises VBUS interrupts when the controller has to
9 act as device 9 act as device
10 - usb-supply : phandle to the regulator device tree node. It should be vusb 10 - usb-supply : phandle to the regulator device tree node. It should be vusb
11 if it is twl6030 or ldousb if it is twl6025 subclass. 11 if it is twl6030 or ldousb if it is twl6032 subclass.
12 12
13twl6030-usb { 13twl6030-usb {
14 compatible = "ti,twl6030-usb"; 14 compatible = "ti,twl6030-usb";