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>
16   Pin multiplexing and GPIO configuration is performed on a per-pin basis
17   writing configuration values to per-port register sets.
19   function (port mode) or in alternate function mode.
20   Up to 8 different alternate function modes exist for each single pin.
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]*$":
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
78         single) pin in some desired alternate function mode.
79         A single sub-node may define several pin configurations.
80         A few alternate function require special pin configuration flags to be
81         supplied along with the alternate function configuration number.
82         The hardware reference manual specifies when a pin function requires
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
98             When a pin has to be configured in alternate function mode, use
100             its alternate function configuration number along with it.
102             same alternate function they shall be specified as members of the
105             (port where it sits on and pin number) and alternate function
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>;
146              * Pin #0 on port #3 is configured as alternate function #6.
147              * Pin #2 on port #3 is configured as alternate function #4.
155              * I2c master: both SDA and SCL pins need bi-directional operations
156              * Pin #4 on port #1 is configured as alternate function #1.
157              * Pin #5 on port #1 is configured as alternate function #1.
158              * Both need to work in bi-directional mode, the driver must manage
167              * Multi-function timer input and output compare pins.
172                      * Pin #0 on port #4 is configured as alternate function #2
177                             input-enable;
182                      * Pin #1 on port #4 is configured as alternate function #1
187                             output-enable;