0d77597c3f922b6e4047fffe38e1dbdc7bfc2e67
[platform/kernel/linux-rpi.git] / Documentation / devicetree / bindings / gpio / gpio-axp209.txt
1 AXP209 GPIO & pinctrl controller
2
3 This driver follows the usual GPIO bindings found in
4 Documentation/devicetree/bindings/gpio/gpio.txt
5
6 This driver follows the usual pinctrl bindings found in
7 Documentation/devicetree/bindings/pinctrl/pinctrl-bindings.txt
8
9 This driver employs the per-pin muxing pattern.
10
11 Required properties:
12 - compatible: Should be "x-powers,axp209-gpio"
13 - #gpio-cells: Should be two. The first cell is the pin number and the
14   second is the GPIO flags.
15 - gpio-controller: Marks the device node as a GPIO controller.
16
17 This node must be a subnode of the axp20x PMIC, documented in
18 Documentation/devicetree/bindings/mfd/axp20x.txt
19
20 Example:
21
22 axp209: pmic@34 {
23         compatible = "x-powers,axp209";
24         reg = <0x34>;
25         interrupt-parent = <&nmi_intc>;
26         interrupts = <0 IRQ_TYPE_LEVEL_LOW>;
27         interrupt-controller;
28         #interrupt-cells = <1>;
29
30         axp_gpio: gpio {
31                 compatible = "x-powers,axp209-gpio";
32                 gpio-controller;
33                 #gpio-cells = <2>;
34         };
35 };
36
37 The GPIOs can be muxed to other functions and therefore, must be a subnode of
38 axp_gpio.
39
40 Example:
41
42 &axp_gpio {
43         gpio0_adc: gpio0-adc {
44                 pins = "GPIO0";
45                 function = "adc";
46         };
47 };
48
49 &example_node {
50         pinctrl-names = "default";
51         pinctrl-0 = <&gpio0_adc>;
52 };
53
54 GPIOs and their functions
55 -------------------------
56
57 Each GPIO is independent from the other (i.e. GPIO0 in gpio_in function does
58 not force GPIO1 and GPIO2 to be in gpio_in function as well).
59
60 GPIO    |       Functions
61 ------------------------
62 GPIO0   |       gpio_in, gpio_out, ldo, adc
63 GPIO1   |       gpio_in, gpio_out, ldo, adc
64 GPIO2   |       gpio_in, gpio_out