1 Broadcom BCM2835 GPIO (and pinmux) controller 1 Broadcom BCM2835 GPIO (and pinmux) controller
2 2
3 The BCM2835 GPIO module is a combined GPIO con 3 The BCM2835 GPIO module is a combined GPIO controller, (GPIO) interrupt
4 controller, and pinmux/control device. 4 controller, and pinmux/control device.
5 5
6 Required properties: 6 Required properties:
7 - compatible: "brcm,bcm2835-gpio" 7 - compatible: "brcm,bcm2835-gpio"
8 - compatible: should be one of: 8 - compatible: should be one of:
9 "brcm,bcm2835-gpio" - BCM2835 compatible pin 9 "brcm,bcm2835-gpio" - BCM2835 compatible pinctrl
10 "brcm,bcm7211-gpio" - BCM7211 compatible pin 10 "brcm,bcm7211-gpio" - BCM7211 compatible pinctrl
11 "brcm,bcm2711-gpio" - BCM2711 compatible pin 11 "brcm,bcm2711-gpio" - BCM2711 compatible pinctrl
12 "brcm,bcm7211-gpio" - BCM7211 compatible pin 12 "brcm,bcm7211-gpio" - BCM7211 compatible pinctrl
13 - reg: Should contain the physical address of 13 - reg: Should contain the physical address of the GPIO module's registers.
14 - gpio-controller: Marks the device node as a 14 - gpio-controller: Marks the device node as a GPIO controller.
15 - #gpio-cells : Should be two. The first cell 15 - #gpio-cells : Should be two. The first cell is the pin number and the
16 second cell is used to specify optional para 16 second cell is used to specify optional parameters:
17 - bit 0 specifies polarity (0 for normal, 1 17 - bit 0 specifies polarity (0 for normal, 1 for inverted)
18 - interrupts : The interrupt outputs from the 18 - interrupts : The interrupt outputs from the controller. One interrupt per
19 individual bank followed by the "all banks" 19 individual bank followed by the "all banks" interrupt. For BCM7211, an
20 additional set of per-bank interrupt line an 20 additional set of per-bank interrupt line and an "all banks" wake-up
21 interrupt may be specified. 21 interrupt may be specified.
22 - interrupt-controller: Marks the device node 22 - interrupt-controller: Marks the device node as an interrupt controller.
23 - #interrupt-cells : Should be 2. 23 - #interrupt-cells : Should be 2.
24 The first cell is the GPIO number. 24 The first cell is the GPIO number.
25 The second cell is used to specify flags: 25 The second cell is used to specify flags:
26 bits[3:0] trigger type and level flags: 26 bits[3:0] trigger type and level flags:
27 1 = low-to-high edge triggered. 27 1 = low-to-high edge triggered.
28 2 = high-to-low edge triggered. 28 2 = high-to-low edge triggered.
29 4 = active high level-sensitive. 29 4 = active high level-sensitive.
30 8 = active low level-sensitive. 30 8 = active low level-sensitive.
31 Valid combinations are 1, 2, 3, 4, 8. 31 Valid combinations are 1, 2, 3, 4, 8.
32 32
33 Please refer to ../gpio/gpio.txt for a general 33 Please refer to ../gpio/gpio.txt for a general description of GPIO bindings.
34 34
35 Please refer to pinctrl-bindings.txt in this d 35 Please refer to pinctrl-bindings.txt in this directory for details of the
36 common pinctrl bindings used by client devices 36 common pinctrl bindings used by client devices, including the meaning of the
37 phrase "pin configuration node". 37 phrase "pin configuration node".
38 38
39 Each pin configuration node lists the pin(s) t 39 Each pin configuration node lists the pin(s) to which it applies, and one or
40 more of the mux function to select on those pi 40 more of the mux function to select on those pin(s), and pull-up/down
41 configuration. Each subnode only affects those 41 configuration. Each subnode only affects those parameters that are explicitly
42 listed. In other words, a subnode that lists o 42 listed. In other words, a subnode that lists only a mux function implies no
43 information about any pull configuration. Simi 43 information about any pull configuration. Similarly, a subnode that lists only
44 a pul parameter implies no information about t 44 a pul parameter implies no information about the mux function.
45 45
46 The BCM2835 pin configuration and multiplexing 46 The BCM2835 pin configuration and multiplexing supports the generic bindings.
47 For details on each properties, you can refer 47 For details on each properties, you can refer to ./pinctrl-bindings.txt.
48 48
49 Required sub-node properties: 49 Required sub-node properties:
50 - pins 50 - pins
51 - function 51 - function
52 52
53 Optional sub-node properties: 53 Optional sub-node properties:
54 - bias-disable 54 - bias-disable
55 - bias-pull-up 55 - bias-pull-up
56 - bias-pull-down 56 - bias-pull-down
57 - output-high 57 - output-high
58 - output-low 58 - output-low
59 59
60 Legacy pin configuration and multiplexing bind 60 Legacy pin configuration and multiplexing binding:
61 *** (Its use is deprecated, use generic multip 61 *** (Its use is deprecated, use generic multiplexing and configuration
62 bindings instead) 62 bindings instead)
63 63
64 Required subnode-properties: 64 Required subnode-properties:
65 - brcm,pins: An array of cells. Each cell cont 65 - brcm,pins: An array of cells. Each cell contains the ID of a pin. Valid IDs
66 are the integer GPIO IDs; 0==GPIO0, 1==GPIO1 66 are the integer GPIO IDs; 0==GPIO0, 1==GPIO1, ... 53==GPIO53.
67 67
68 Optional subnode-properties: 68 Optional subnode-properties:
69 - brcm,function: Integer, containing the funct 69 - brcm,function: Integer, containing the function to mux to the pin(s):
70 0: GPIO in 70 0: GPIO in
71 1: GPIO out 71 1: GPIO out
72 2: alt5 72 2: alt5
73 3: alt4 73 3: alt4
74 4: alt0 74 4: alt0
75 5: alt1 75 5: alt1
76 6: alt2 76 6: alt2
77 7: alt3 77 7: alt3
78 - brcm,pull: Integer, representing the pull-do 78 - brcm,pull: Integer, representing the pull-down/up to apply to the pin(s):
79 0: none 79 0: none
80 1: down 80 1: down
81 2: up 81 2: up
82 82
83 Each of brcm,function and brcm,pull may contai 83 Each of brcm,function and brcm,pull may contain either a single value which
84 will be applied to all pins in brcm,pins, or 1 84 will be applied to all pins in brcm,pins, or 1 value for each entry in
85 brcm,pins. 85 brcm,pins.
86 86
87 Example: 87 Example:
88 88
89 gpio: gpio { 89 gpio: gpio {
90 compatible = "brcm,bcm2835-gpi 90 compatible = "brcm,bcm2835-gpio";
91 reg = <0x2200000 0xb4>; 91 reg = <0x2200000 0xb4>;
92 interrupts = <2 17>, <2 19>, < 92 interrupts = <2 17>, <2 19>, <2 18>, <2 20>;
93 93
94 gpio-controller; 94 gpio-controller;
95 #gpio-cells = <2>; 95 #gpio-cells = <2>;
96 96
97 interrupt-controller; 97 interrupt-controller;
98 #interrupt-cells = <2>; 98 #interrupt-cells = <2>;
99 }; 99 };
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.