Book a Demo!
CoCalc Logo Icon
StoreFeaturesDocsShareSupportNewsAboutPoliciesSign UpSign In
freebsd
GitHub Repository: freebsd/freebsd-src
Path: blob/main/sys/dts/bindings-gpio.txt
39475 views
1
2
GPIO configuration.
3
===================
4
5
1. Properties for GPIO Controllers
6
7
1.1 #gpio-cells
8
9
Property: #gpio-cells
10
11
Value type: <u32>
12
13
Description: The #gpio-cells property defines the number of cells required
14
to encode a gpio specifier.
15
16
17
1.2 gpio-controller
18
19
Property: gpio-controller
20
21
Value type: <empty>
22
23
Description: The presence of a gpio-controller property defines a node as a
24
GPIO controller node.
25
26
27
1.3 pin-count
28
29
Property: pin-count
30
31
Value type: <u32>
32
33
Description: The pin-count property defines the number of GPIO pins.
34
35
36
1.4 Example
37
38
GPIO: gpio@10100 {
39
#gpio-cells = <3>;
40
compatible = "mrvl,gpio";
41
reg = <0x10100 0x20>;
42
gpio-controller;
43
interrupts = <6 7 8 9>;
44
interrupt-parent = <&PIC>;
45
pin-count = <50>
46
};
47
48
2. Properties for GPIO consumer nodes.
49
50
2.1 gpios
51
52
Property: gpios
53
54
Value type: <prop-encoded-array> encoded as arbitrary number of GPIO
55
specifiers.
56
57
Description: The gpios property of a device node defines the GPIO or GPIOs
58
that are used by the device. The value of the gpios property
59
consists of an arbitrary number of GPIO specifiers.
60
61
The first cell of the GPIO specifier is phandle of the node's
62
parent GPIO controller and remaining cells are defined by the
63
binding describing the GPIO parent, typically include
64
information like pin number, direction and various flags.
65
66
Example:
67
gpios = <&GPIO 0 1 /* GPIO[0]: FLAGS */
68
&GPIO 1 2>; /* GPIO[1]: FLAGS */
69
70
71
3. GPIO controller specifier
72
73
<phandle pin dir flags>
74
75
76
pin: 0-MAX GPIO pin number.
77
78
flags:
79
Available flags are listed in sys/conf.h. Following combination
80
can be supported by the controller. For details please refer
81
to controller's GPIO reference manual.
82
83
GPIO_PIN_INPUT 0x0001 Input direction
84
GPIO_PIN_OUTPUT 0x0002 Output direction
85
GPIO_PIN_OPENDRAIN 0x0004 Open-drain output
86
GPIO_PIN_OPENSOURCE 0x0008 Open-source output
87
GPIO_PIN_PUSHPULL 0x0010 Push-pull output
88
GPIO_PIN_TRISTATE 0x0020 Output disabled
89
GPIO_PIN_PULLUP 0x0040 Internal pull-up enabled
90
GPIO_PIN_PULLDOWN 0x0080 Internal pull-down enabled
91
GPIO_PIN_INVIN 0x0100 Invert input
92
GPIO_PIN_INVOUT 0x0200 Invert output
93
GPIO_PIN_PULSATE 0x0400 Pulsate in hardware
94
GPIO_PIN_IRQ_POL_EDG 0x0800 IRQ active single edge
95
GPIO_PIN_IRQ_POL_DBL 0x1000 IRQ active double edge
96
GPIO_PIN_IRQ_POL_LVL 0x2000 IRQ active level
97
GPIO_PIN_IRQ_DEBOUNCE 0x4000 Debounce on IRQ pin
98
99
Example:
100
gpios = <&GPIO 0 0x00000001 /* GPIO[0]: IN */
101
&GPIO 1 0x00000002 /* GPIO[1]: OUT */
102
&GPIO 2 0x00000801 /* GPIO[2]: IN, IRQ (edge) */
103
&GPIO 3 0x00004001 /* GPIO[3]: IN, IRQ (level) */
104
...
105
&GPIO 10 0x00000401>; /* GPIO[10]: OUT, blink */
106
107