bindings/pinctrl/renesas%2Crza1-ports.yaml

1 # SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
3 ---
4 $id: http://devicetree.org/schemas/pinctrl/renesas,rza1-ports.yaml#
5 $schema: http://devicetree.org/meta-schemas/core.yaml#
10   - Jacopo Mondi <jacopo+renesas@jmondi.org>
11   - Geert Uytterhoeven <geert+renesas@glider.be>
14   The Renesas SoCs of the RZ/A1 family feature a combined Pin and GPIO
15   controller, named "Ports" in the hardware reference manual.
16   Pin multiplexing and GPIO configuration is performed on a per-pin basis
17   writing configuration values to per-port register sets.
18   Each "port" features up to 16 pins, each of them configurable for GPIO
25       - const: renesas,r7s72100-ports     # RZ/A1H
26       - items:
27           - const: renesas,r7s72101-ports # RZ/A1M
28           - const: renesas,r7s72100-ports # fallback
29       - const: renesas,r7s72102-ports     # RZ/A1L
35   - $ref: pinctrl.yaml#
38   - compatible
39   - reg
42   "^gpio-[0-9]*$":
47       Each port of the r7s72100 pin controller hardware is itself a GPIO
49       Different SoCs have different numbers of available pins per port, but
50       generally speaking, each of them can be configured in GPIO ("port") mode
52       Describe GPIO controllers using sub-nodes with the following properties.
55       gpio-controller: true
57       '#gpio-cells':
60       gpio-ranges:
64       - gpio-controller
65       - '#gpio-cells'
66       - gpio-ranges
71     - type: object
73         - $ref: pincfg-node.yaml#
74         - $ref: pinmux-node.yaml#
77         A pin multiplexing sub-node describes how to configure a set of (or a
79         A single sub-node may define several pin configurations.
88         to work in bi-directional mode and when the IO direction has to be
89         specified by software. Bi-directional pins must be managed by the pin
101             When multiple pins are required to be configured as part of the
102             same alternate function they shall be specified as members of the
103             same argument list of a single "pinmux" property.
107             <include/dt-bindings/pinctrl/r7s72100-pinctrl.h>
111         input-enable: true
112         output-enable: true
115         - pinmux
119     - type: object
124   - |
125     #include <dt-bindings/pinctrl/r7s72100-pinctrl.h>
127             compatible = "renesas,r7s72100-ports";
134              * 48, thus pins [0 - 15] on this controller map to pins [48 - 63]
137             port3: gpio-3 {
138                     gpio-controller;
139                     #gpio-cells = <2>;
140                     gpio-ranges = <&pinctrl 0 48 16>;
155              * I2c master: both SDA and SCL pins need bi-directional operations
158              * Both need to work in bi-directional mode, the driver must manage
167              * Multi-function timer input and output compare pins.
177                             input-enable;
187                             output-enable;