bindings/pinctrl/samsung,pinctrl.yaml

   1 # SPDX-License-Identifier: GPL-2.0-only
   2 %YAML 1.2
   3 ---
   4 $id: http://devicetree.org/schemas/pinctrl/samsung,pinctrl.yaml#
   5 $schema: http://devicetree.org/meta-schemas/core.yaml#
   6
   7 title: Samsung S3C/S5P/Exynos SoC pin controller
   8
   9 maintainers:
  10   - Krzysztof Kozlowski <krzk@kernel.org>
  11   - Sylwester Nawrocki <s.nawrocki@samsung.com>
  12   - Tomasz Figa <tomasz.figa@gmail.com>
  13
  14 description: |
  15   This is a part of device tree bindings for Samsung S3C/S5P/Exynos SoC pin
  16   controller.
  17
  18   All the pin controller nodes should be represented in the aliases node using
  19   the following format 'pinctrl{n}' where n is a unique number for the alias.
  20
  21   The controller supports three types of interrupts::
  22    - External GPIO interrupts (see interrupts property in pin controller node);
  23
  24    - External wake-up interrupts - multiplexed (capable of waking up the system
  25      see interrupts property in external wake-up interrupt controller node -
  26      samsung,pinctrl-wakeup-interrupt.yaml);
  27
  28    - External wake-up interrupts - direct (capable of waking up the system, see
  29      interrupts property in every bank of pin controller with external wake-up
  30      interrupt controller - samsung,pinctrl-gpio-bank.yaml).
  31
  32 properties:
  33   $nodename:
  34     pattern: "^pinctrl(@.*)?"
  35
  36   compatible:
  37     enum:
  38       - google,gs101-pinctrl
  39       - samsung,s3c2412-pinctrl
  40       - samsung,s3c2416-pinctrl
  41       - samsung,s3c2440-pinctrl
  42       - samsung,s3c2450-pinctrl
  43       - samsung,s3c64xx-pinctrl
  44       - samsung,s5pv210-pinctrl
  45       - samsung,exynos3250-pinctrl
  46       - samsung,exynos4210-pinctrl
  47       - samsung,exynos4x12-pinctrl
  48       - samsung,exynos5250-pinctrl
  49       - samsung,exynos5260-pinctrl
  50       - samsung,exynos5410-pinctrl
  51       - samsung,exynos5420-pinctrl
  52       - samsung,exynos5433-pinctrl
  53       - samsung,exynos7-pinctrl
  54       - samsung,exynos7885-pinctrl
  55       - samsung,exynos850-pinctrl
  56       - samsung,exynosautov9-pinctrl
  57       - samsung,exynosautov920-pinctrl
  58       - tesla,fsd-pinctrl
  59
  60   interrupts:
  61     description:
  62       Required for GPIO banks supporting external GPIO interrupts.
  63     maxItems: 1
  64
  65   power-domains:
  66     maxItems: 1
  67
  68   reg:
  69     description:
  70       Second base address of the pin controller if the specific registers of
  71       the pin controller are separated into the different base address.
  72       Only certain banks of certain pin controller might need it.
  73     minItems: 1
  74     maxItems: 2
  75
  76   wakeup-interrupt-controller:
  77     $ref: samsung,pinctrl-wakeup-interrupt.yaml
  78
  79 patternProperties:
  80   "^[a-z]+[0-9]*-gpio-bank$":
  81     description:
  82       Pin banks of the controller are represented by child nodes of the
  83       controller node. Bank name is taken from name of the node.
  84     $ref: samsung,pinctrl-gpio-bank.yaml
  85
  86   "^[a-z0-9-]+-pins$":
  87     oneOf:
  88       - $ref: samsung,pinctrl-pins-cfg.yaml
  89         required:
  90           - samsung,pins
  91       - type: object
  92         patternProperties:
  93           "^[a-z0-9-]+-pins$":
  94             $ref: samsung,pinctrl-pins-cfg.yaml
  95
  96         additionalProperties: false
  97
  98   "^(initial|sleep)-state$":
  99     type: object
 100     additionalProperties: false
 101
 102     patternProperties:
 103       "^(pin-[a-z0-9-]+|[a-z0-9-]+-pin)$":
 104         $ref: samsung,pinctrl-pins-cfg.yaml
 105
 106         properties:
 107           samsung,pins:
 108             description: See samsung,pinctrl-pins-cfg.yaml
 109             $ref: /schemas/types.yaml#/definitions/string-array
 110             maxItems: 1
 111
 112         required:
 113           - samsung,pins
 114
 115         unevaluatedProperties: false
 116
 117 required:
 118   - compatible
 119   - reg
 120
 121 allOf:
 122   - $ref: pinctrl.yaml#
 123   - if:
 124       properties:
 125         compatible:
 126           contains:
 127             const: samsung,exynos5433-pinctrl
 128     then:
 129       properties:
 130         reg:
 131           minItems: 1
 132           maxItems: 2
 133     else:
 134       properties:
 135         reg:
 136           minItems: 1
 137           maxItems: 1
 138
 139 additionalProperties: false
 140
 141 examples:
 142   - |
 143     pinctrl@7f008000 {
 144         compatible = "samsung,s3c64xx-pinctrl";
 145         reg = <0x7f008000 0x1000>;
 146         interrupt-parent = <&vic1>;
 147         interrupts = <21>;
 148
 149         wakeup-interrupt-controller {
 150             compatible = "samsung,s3c64xx-wakeup-eint";
 151             interrupts-extended = <&vic0 0>,
 152                                   <&vic0 1>,
 153                                   <&vic1 0>,
 154                                   <&vic1 1>;
 155         };
 156
 157         /* Pin bank with external GPIO or muxed external wake-up interrupts */
 158         gpa-gpio-bank {
 159             gpio-controller;
 160             #gpio-cells = <2>;
 161             interrupt-controller;
 162             #interrupt-cells = <2>;
 163         };
 164
 165         // ...
 166
 167         uart0-data-pins {
 168             samsung,pins = "gpa-0", "gpa-1";
 169             samsung,pin-function = <2>;
 170             samsung,pin-pud = <0>;
 171         };
 172
 173         // ...
 174     };
 175
 176   - |
 177     #include <dt-bindings/interrupt-controller/arm-gic.h>
 178
 179     pinctrl@11400000 {
 180         compatible = "samsung,exynos4210-pinctrl";
 181         reg = <0x11400000 0x1000>;
 182         interrupts = <GIC_SPI 47 IRQ_TYPE_LEVEL_HIGH>;
 183
 184         pinctrl-names = "default";
 185         pinctrl-0 = <&sleep0>;
 186
 187         /* Pin bank with external GPIO or muxed external wake-up interrupts */
 188         gpa0-gpio-bank {
 189             gpio-controller;
 190             #gpio-cells = <2>;
 191             interrupt-controller;
 192             #interrupt-cells = <2>;
 193         };
 194
 195         // ...
 196
 197         uart0-data-pins {
 198             samsung,pins = "gpa0-0", "gpa0-1";
 199             samsung,pin-function = <2>;
 200             samsung,pin-pud = <0>;
 201             samsung,pin-drv = <0>;
 202         };
 203
 204         // ...
 205
 206         sleep0: sleep-state {
 207             gpa0-0-pin {
 208                 samsung,pins = "gpa0-0";
 209                 samsung,pin-con-pdn = <2>;
 210                 samsung,pin-pud-pdn = <0>;
 211             };
 212
 213             gpa0-1-pin {
 214                 samsung,pins = "gpa0-1";
 215                 samsung,pin-con-pdn = <0>;
 216                 samsung,pin-pud-pdn = <0>;
 217             };
 218
 219             // ...
 220         };
 221     };
 222
 223   - |
 224     #include <dt-bindings/interrupt-controller/arm-gic.h>
 225
 226     pinctrl@11000000 {
 227         compatible = "samsung,exynos4210-pinctrl";
 228         reg = <0x11000000 0x1000>;
 229         interrupts = <GIC_SPI 46 IRQ_TYPE_LEVEL_HIGH>;
 230
 231         wakeup-interrupt-controller {
 232             compatible = "samsung,exynos4210-wakeup-eint";
 233             interrupt-parent = <&gic>;
 234             interrupts = <GIC_SPI 32 IRQ_TYPE_LEVEL_HIGH>;
 235         };
 236
 237         /* Pin bank with external GPIO or muxed external wake-up interrupts */
 238         gpj0-gpio-bank {
 239             gpio-controller;
 240             #gpio-cells = <2>;
 241             interrupt-controller;
 242             #interrupt-cells = <2>;
 243         };
 244
 245         /* Pin bank without external interrupts */
 246         gpy0-gpio-bank {
 247             gpio-controller;
 248             #gpio-cells = <2>;
 249         };
 250
 251         /* Pin bank with external direct wake-up interrupts */
 252         gpx0-gpio-bank {
 253             gpio-controller;
 254             #gpio-cells = <2>;
 255
 256             interrupt-controller;
 257             interrupt-parent = <&gic>;
 258             interrupts = <GIC_SPI 16 IRQ_TYPE_LEVEL_HIGH>,
 259                          <GIC_SPI 17 IRQ_TYPE_LEVEL_HIGH>,
 260                          <GIC_SPI 18 IRQ_TYPE_LEVEL_HIGH>,
 261                          <GIC_SPI 19 IRQ_TYPE_LEVEL_HIGH>,
 262                          <GIC_SPI 20 IRQ_TYPE_LEVEL_HIGH>,
 263                          <GIC_SPI 21 IRQ_TYPE_LEVEL_HIGH>,
 264                          <GIC_SPI 22 IRQ_TYPE_LEVEL_HIGH>,
 265                          <GIC_SPI 23 IRQ_TYPE_LEVEL_HIGH>;
 266             #interrupt-cells = <2>;
 267         };
 268
 269         // ...
 270
 271         sd0-clk-pins {
 272             samsung,pins = "gpk0-0";
 273             samsung,pin-function = <2>;
 274             samsung,pin-pud = <0>;
 275             samsung,pin-drv = <3>;
 276         };
 277
 278         sd4-bus-width8-pins {
 279             part-1-pins {
 280                 samsung,pins = "gpk0-3", "gpk0-4",
 281                                "gpk0-5", "gpk0-6";
 282                 samsung,pin-function = <3>;
 283                 samsung,pin-pud = <3>;
 284                 samsung,pin-drv = <3>;
 285             };
 286
 287             part-2-pins {
 288                 samsung,pins = "gpk1-3", "gpk1-4",
 289                                "gpk1-5", "gpk1-6";
 290                 samsung,pin-function = <4>;
 291                 samsung,pin-pud = <3>;
 292                 samsung,pin-drv = <3>;
 293             };
 294         };
 295
 296         // ...
 297
 298         otg-gp-pins {
 299             samsung,pins = "gpx3-3";
 300             samsung,pin-function = <1>;
 301             samsung,pin-pud = <0>;
 302             samsung,pin-drv = <0>;
 303             samsung,pin-val = <0>;
 304         };
 305     };
 306
 307   - |
 308     #include <dt-bindings/interrupt-controller/arm-gic.h>
 309
 310     pinctrl@10580000 {
 311         compatible = "samsung,exynos5433-pinctrl";
 312         reg = <0x10580000 0x1a20>, <0x11090000 0x100>;
 313
 314         pinctrl-names = "default";
 315         pinctrl-0 = <&initial_alive>;
 316
 317         wakeup-interrupt-controller {
 318             compatible = "samsung,exynos5433-wakeup-eint",
 319                          "samsung,exynos7-wakeup-eint";
 320             interrupts = <GIC_SPI 16 IRQ_TYPE_LEVEL_HIGH>;
 321         };
 322
 323         /* Pin bank with external direct wake-up interrupts */
 324         gpa0-gpio-bank {
 325             gpio-controller;
 326             #gpio-cells = <2>;
 327
 328             interrupt-controller;
 329             interrupt-parent = <&gic>;
 330             interrupts = <GIC_SPI 0 IRQ_TYPE_LEVEL_HIGH>,
 331                          <GIC_SPI 1 IRQ_TYPE_LEVEL_HIGH>,
 332                          <GIC_SPI 2 IRQ_TYPE_LEVEL_HIGH>,
 333                          <GIC_SPI 3 IRQ_TYPE_LEVEL_HIGH>,
 334                          <GIC_SPI 4 IRQ_TYPE_LEVEL_HIGH>,
 335                          <GIC_SPI 5 IRQ_TYPE_LEVEL_HIGH>,
 336                          <GIC_SPI 6 IRQ_TYPE_LEVEL_HIGH>,
 337                          <GIC_SPI 7 IRQ_TYPE_LEVEL_HIGH>;
 338             #interrupt-cells = <2>;
 339         };
 340
 341         // ...
 342
 343         te-irq-pins {
 344             samsung,pins = "gpf1-3";
 345             samsung,pin-function = <0xf>;
 346         };
 347
 348         // ..
 349
 350         initial_alive: initial-state {
 351             gpa0-0-pin {
 352                 samsung,pins = "gpa0-0";
 353                 samsung,pin-function = <0>;
 354                 samsung,pin-pud = <1>;
 355                 samsung,pin-drv = <0>;
 356             };
 357
 358             // ...
 359         };
 360     };
 361
 362   - |
 363     #include <dt-bindings/interrupt-controller/arm-gic.h>
 364
 365     pinctrl@114b0000 {
 366         compatible = "samsung,exynos5433-pinctrl";
 367         reg = <0x114b0000 0x1000>;
 368         interrupts = <GIC_SPI 68 IRQ_TYPE_LEVEL_HIGH>;
 369         power-domains = <&pd_aud>;
 370
 371         /* Pin bank with external GPIO or muxed external wake-up interrupts */
 372         gpz0-gpio-bank {
 373             gpio-controller;
 374             #gpio-cells = <2>;
 375             interrupt-controller;
 376             #interrupt-cells = <2>;
 377         };
 378
 379         // ...
 380
 381         i2s0-bus-pins {
 382             samsung,pins = "gpz0-0", "gpz0-1", "gpz0-2", "gpz0-3",
 383                            "gpz0-4", "gpz0-5", "gpz0-6";
 384             samsung,pin-function = <2>;
 385             samsung,pin-pud = <0>;
 386             samsung,pin-drv = <0>;
 387         };
 388
 389         // ...
 390     };