Documentation/devicetree/bindings/pinctrl/aspeed,ast2500-pinctrl.yaml

   1 # SPDX-License-Identifier: GPL-2.0-or-later
   2 %YAML 1.2
   3 ---
   4 $id: http://devicetree.org/schemas/pinctrl/aspeed,ast2500-pinctrl.yaml#
   5 $schema: http://devicetree.org/meta-schemas/core.yaml#
   6
   7 title: ASPEED AST2500 Pin Controller
   8
   9 maintainers:
  10   - Andrew Jeffery <andrew@aj.id.au>
  11
  12 description: |+
  13   The pin controller node should be the child of a syscon node with the
  14   required property:
  15
  16   - compatible:         Should be one of the following:
  17                         "aspeed,ast2500-scu", "syscon", "simple-mfd"
  18                         "aspeed,g5-scu", "syscon", "simple-mfd"
  19
  20   Refer to the the bindings described in
  21   Documentation/devicetree/bindings/mfd/syscon.txt
  22
  23 properties:
  24   compatible:
  25     enum: [ aspeed,ast2500-pinctrl, aspeed,g5-pinctrl ]
  26   aspeed,external-nodes:
  27     minItems: 2
  28     maxItems: 2
  29     allOf:
  30       - $ref: /schemas/types.yaml#/definitions/phandle-array
  31     description: |
  32       A cell of phandles to external controller nodes:
  33       0: compatible with "aspeed,ast2500-gfx", "syscon"
  34       1: compatible with "aspeed,ast2500-lhc", "syscon"
  35
  36 patternProperties:
  37   '^.*$':
  38     if:
  39       type: object
  40     then:
  41       patternProperties:
  42         "^function|groups$":
  43           allOf:
  44             - $ref: "/schemas/types.yaml#/definitions/string"
  45             - enum: [ "ACPI", "ADC0", "ADC1", "ADC10", "ADC11", "ADC12", "ADC13",
  46               "ADC14", "ADC15", "ADC2", "ADC3", "ADC4", "ADC5", "ADC6", "ADC7",
  47               "ADC8", "ADC9", "BMCINT", "DDCCLK", "DDCDAT", "ESPI", "FWSPICS1",
  48               "FWSPICS2", "GPID0", "GPID2", "GPID4", "GPID6", "GPIE0", "GPIE2",
  49               "GPIE4", "GPIE6", "I2C10", "I2C11", "I2C12", "I2C13", "I2C14",
  50               "I2C3", "I2C4", "I2C5", "I2C6", "I2C7", "I2C8", "I2C9", "LAD0",
  51               "LAD1", "LAD2", "LAD3", "LCLK", "LFRAME", "LPCHC", "LPCPD",
  52               "LPCPLUS", "LPCPME", "LPCRST", "LPCSMI", "LSIRQ", "MAC1LINK",
  53               "MAC2LINK", "MDIO1", "MDIO2", "NCTS1", "NCTS2", "NCTS3", "NCTS4",
  54               "NDCD1", "NDCD2", "NDCD3", "NDCD4", "NDSR1", "NDSR2", "NDSR3",
  55               "NDSR4", "NDTR1", "NDTR2", "NDTR3", "NDTR4", "NRI1", "NRI2",
  56               "NRI3", "NRI4", "NRTS1", "NRTS2", "NRTS3", "NRTS4", "OSCCLK",
  57               "PEWAKE", "PNOR", "PWM0", "PWM1", "PWM2", "PWM3", "PWM4", "PWM5",
  58               "PWM6", "PWM7", "RGMII1", "RGMII2", "RMII1", "RMII2", "RXD1",
  59               "RXD2", "RXD3", "RXD4", "SALT1", "SALT10", "SALT11", "SALT12",
  60               "SALT13", "SALT14", "SALT2", "SALT3", "SALT4", "SALT5", "SALT6",
  61               "SALT7", "SALT8", "SALT9", "SCL1", "SCL2", "SD1", "SD2", "SDA1",
  62               "SDA2", "SGPS1", "SGPS2", "SIOONCTRL", "SIOPBI", "SIOPBO",
  63               "SIOPWREQ", "SIOPWRGD", "SIOS3", "SIOS5", "SIOSCI", "SPI1",
  64               "SPI1CS1", "SPI1DEBUG", "SPI1PASSTHRU", "SPI2CK", "SPI2CS0",
  65               "SPI2CS1", "SPI2MISO", "SPI2MOSI", "TIMER3", "TIMER4", "TIMER5",
  66               "TIMER6", "TIMER7", "TIMER8", "TXD1", "TXD2", "TXD3", "TXD4",
  67               "UART6", "USB11BHID", "USB2AD", "USB2AH", "USB2BD", "USB2BH",
  68               "USBCKI", "VGABIOSROM", "VGAHS", "VGAVS", "VPI24", "VPO",
  69               "WDTRST1", "WDTRST2", ]
  70
  71 required:
  72   - compatible
  73   - aspeed,external-nodes
  74
  75 examples:
  76   - |
  77     compatible = "simple-bus";
  78     ranges;
  79
  80     apb {
  81         compatible = "simple-bus";
  82         #address-cells = <1>;
  83         #size-cells = <1>;
  84         ranges;
  85
  86         syscon: scu@1e6e2000 {
  87             compatible = "aspeed,ast2500-scu", "syscon", "simple-mfd";
  88             reg = <0x1e6e2000 0x1a8>;
  89
  90             pinctrl: pinctrl {
  91                 compatible = "aspeed,g5-pinctrl";
  92                 aspeed,external-nodes = <&gfx &lhc>;
  93
  94                 pinctrl_i2c3_default: i2c3_default {
  95                     function = "I2C3";
  96                     groups = "I2C3";
  97                 };
  98
  99                 pinctrl_gpioh0_unbiased_default: gpioh0 {
 100                     pins = "A18";
 101                     bias-disable;
 102                 };
 103             };
 104         };
 105
 106         gfx: display@1e6e6000 {
 107             compatible = "aspeed,ast2500-gfx", "syscon";
 108             reg = <0x1e6e6000 0x1000>;
 109         };
 110     };
 111
 112     lpc: lpc@1e789000 {
 113         compatible = "aspeed,ast2500-lpc", "simple-mfd";
 114         reg = <0x1e789000 0x1000>;
 115
 116         #address-cells = <1>;
 117         #size-cells = <1>;
 118         ranges = <0x0 0x1e789000 0x1000>;
 119
 120         lpc_host: lpc-host@80 {
 121             compatible = "aspeed,ast2500-lpc-host", "simple-mfd", "syscon";
 122             reg = <0x80 0x1e0>;
 123             reg-io-width = <4>;
 124
 125             #address-cells = <1>;
 126             #size-cells = <1>;
 127             ranges = <0x0 0x80 0x1e0>;
 128
 129             lhc: lhc@20 {
 130                    compatible = "aspeed,ast2500-lhc";
 131                    reg = <0x20 0x24 0x48 0x8>;
 132             };
 133         };
 134     };