summaryrefslogtreecommitdiffstats
path: root/Documentation/devicetree/bindings/pinctrl/microchip,mpfs-pinctrl-mssio.yaml
blob: fe05196160f45c227ec7882609143eab19b6c073 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
# SPDX-License-Identifier: GPL-2.0-only OR BSD-2-Clause
%YAML 1.2
---
$id: http://devicetree.org/schemas/pinctrl/microchip,mpfs-pinctrl-mssio.yaml#
$schema: http://devicetree.org/meta-schemas/core.yaml#

title: Microchip Polarfire SoC MSSIO pinctrl

maintainers:
  - Conor Dooley <conor.dooley@microchip.com>

properties:
  compatible:
    oneOf:
      - const: microchip,mpfs-pinctrl-mssio
      - items:
          - const: microchip,pic64gx-pinctrl-mssio
          - const: microchip,mpfs-pinctrl-mssio

  reg:
    maxItems: 1

  pinctrl-use-default: true

patternProperties:
  '-cfg$':
    type: object
    additionalProperties: false

    patternProperties:
      '-pins$':
        type: object
        additionalProperties: false

        allOf:
          - $ref: pincfg-node.yaml#
          - $ref: pinmux-node.yaml#

        properties:
          pins:
            description:
              The list of IOs that properties in the pincfg node apply to.

          function:
            description:
              A string containing the name of the function to mux for these
              pins. The "reserved" function tristates a pin.
            enum: [ sd, emmc, qspi, spi, usb, uart, i2c, can, mdio, misc
                    reserved, gpio, fabric-test, tied-low, tied-high, tristate ]

          bias-bus-hold: true
          bias-disable: true
          bias-pull-down: true
          bias-pull-up: true
          input-schmitt-enable: true
          low-power-enable: true

          drive-strength:
            enum: [ 2, 4, 6, 8, 10, 12, 16, 20 ]

          power-source:
            description:
              Which bank voltage to use. This cannot differ for pins in a
              given bank, the whole bank uses the same voltage.
            enum: [ 1200000, 1500000, 1800000, 2500000, 3300000 ]

          microchip,clamp-diode:
            $ref: /schemas/types.yaml#/definitions/flag
            description:
              Reflects the "Clamp Diode" setting in the MSS Configurator for
              this pin. This setting controls whether or not input voltage
              clamping should be enabled.

          microchip,ibufmd:
            $ref: /schemas/types.yaml#/definitions/uint32
            default: 0
            description:
              Reflects the "IBUFMD" bits in the MSS Configurator output files
              for this pin.

        required:
          - pins
          - function
          - power-source

required:
  - compatible
  - reg

additionalProperties: false

examples:
  - |
    pinctrl@204 {
      compatible = "microchip,mpfs-pinctrl-mssio";
      reg = <0x204 0x7c>;

      ikrd-spi1-cfg {
        spi1-pins {
          pins = <30>, <31>, <32>, <33>;
          function = "spi";
          bias-pull-up;
          drive-strength = <8>;
          power-source = <3300000>;
          microchip,ibufmd = <0x1>;
        };
      };
    };
...