GNU Linux-libre 4.19.264-gnu1
[releases.git] / Documentation / devicetree / bindings / pinctrl / pinctrl-rk805.txt
1 Pincontrol driver for RK805 Power management IC.
2
3 RK805 has 2 pins which can be configured as GPIO output only.
4
5 Please refer file <devicetree/bindings/pinctrl/pinctrl-bindings.txt>
6 for details of the common pinctrl bindings used by client devices,
7 including the meaning of the phrase "pin configuration node".
8
9 Optional Pinmux properties:
10 --------------------------
11 Following properties are required if default setting of pins are required
12 at boot.
13 - pinctrl-names: A pinctrl state named per <pinctrl-bindings.txt>.
14 - pinctrl[0...n]: Properties to contain the phandle for pinctrl states per
15                 <pinctrl-bindings.txt>.
16
17 The pin configurations are defined as child of the pinctrl states node. Each
18 sub-node have following properties:
19
20 Required properties:
21 ------------------
22 - #gpio-cells: Should be two. The first cell is the pin number and the
23   second is the GPIO flags.
24
25 - gpio-controller: Marks the device node as a GPIO controller.
26
27 - pins: List of pins. Valid values of pins properties are: gpio0, gpio1.
28
29 First 2 properties must be added in the RK805 PMIC node, documented in
30 Documentation/devicetree/bindings/mfd/rk808.txt
31
32 Optional properties:
33 -------------------
34 Following are optional properties defined as pinmux DT binding document
35 <pinctrl-bindings.txt>. Absence of properties will leave the configuration
36 on default.
37         function,
38         output-low,
39         output-high.
40
41 Valid values for function properties are: gpio.
42
43 Theres is also not customised properties for any GPIO.
44
45 Example:
46 --------
47 rk805: rk805@18 {
48         compatible = "rockchip,rk805";
49         ...
50         gpio-controller;
51         #gpio-cells = <2>;
52
53         pinctrl-names = "default";
54         pinctrl-0 = <&pmic_int_l>, <&rk805_default>;
55
56         rk805_default: pinmux {
57                 gpio01 {
58                         pins = "gpio0", "gpio1";
59                         function = "gpio";
60                         output-high;
61                 };
62         };
63 };