Documentation/devicetree/bindings/pinctrl/marvell,armada-37xx-pinctrl.txt

   1 * Marvell Armada 37xx SoC pin and gpio controller
   2
   3 Each Armada 37xx SoC come with two pin and gpio controller one for the
   4 south bridge and the other for the north bridge.
   5
   6 Inside this set of register the gpio latch allows exposing some
   7 configuration of the SoC and especially the clock frequency of the
   8 xtal. Hence, this node is a represent as syscon allowing sharing the
   9 register between multiple hardware block.
  10
  11 GPIO and pin controller:
  12 ------------------------
  13
  14 Main node:
  15
  16 Refer to pinctrl-bindings.txt in this directory for details of the
  17 common pinctrl bindings used by client devices, including the meaning
  18 of the phrase "pin configuration node".
  19
  20 Required properties for pinctrl driver:
  21
  22 - compatible:   "marvell,armada3710-sb-pinctrl", "syscon, "simple-mfd"
  23                 for the south bridge
  24                 "marvell,armada3710-nb-pinctrl", "syscon, "simple-mfd"
  25                 for the north bridge
  26 - reg: The first set of register are for pinctrl/gpio and the second
  27   set for the interrupt controller
  28 - interrupts: list of the interrupt use by the gpio
  29
  30 Available groups and functions for the North bridge:
  31
  32 group: jtag
  33  - pins 20-24
  34  - functions jtag, gpio
  35
  36 group sdio0
  37  - pins 8-10
  38  - functions sdio, gpio
  39
  40 group emmc_nb
  41  - pins 27-35
  42  - functions emmc, gpio
  43
  44 group pwm0
  45  - pin 11 (GPIO1-11)
  46  - functions pwm, led, gpio
  47
  48 group pwm1
  49  - pin 12
  50  - functions pwm, led, gpio
  51
  52 group pwm2
  53  - pin 13
  54  - functions pwm, led, gpio
  55
  56 group pwm3
  57  - pin 14
  58  - functions pwm, led, gpio
  59
  60 group pmic1
  61  - pin 7
  62  - functions pmic, gpio
  63
  64 group pmic0
  65  - pin 6
  66  - functions pmic, gpio
  67
  68 group i2c2
  69  - pins 2-3
  70  - functions i2c, gpio
  71
  72 group i2c1
  73  - pins 0-1
  74  - functions i2c, gpio
  75
  76 group spi_cs1
  77  - pin 17
  78  - functions spi, gpio
  79
  80 group spi_cs2
  81  - pin 18
  82  - functions spi, gpio
  83
  84 group spi_cs3
  85  - pin 19
  86  - functions spi, gpio
  87
  88 group onewire
  89  - pin 4
  90  - functions onewire, gpio
  91
  92 group uart1
  93  - pins 25-26
  94  - functions uart, gpio
  95
  96 group spi_quad
  97  - pins 15-16
  98  - functions spi, gpio
  99
 100 group uart_2
 101  - pins 9-10
 102  - functions uart, gpio
 103
 104 Available groups and functions for the South bridge:
 105
 106 group usb32_drvvbus0
 107  - pin 36
 108  - functions drvbus, gpio
 109
 110 group usb2_drvvbus1
 111  - pin 37
 112  - functions drvbus, gpio
 113
 114 group sdio_sb
 115  - pins 60-65
 116  - functions sdio, gpio
 117
 118 group rgmii
 119  - pins 42-53
 120  - functions mii, gpio
 121
 122 group pcie1
 123  - pins 39
 124  - functions pcie, gpio
 125
 126 group pcie1_clkreq
 127  - pins 40
 128  - functions pcie, gpio
 129
 130 group smi
 131  - pins 54-55
 132  - functions smi, gpio
 133
 134 group ptp
 135  - pins 56-58
 136  - functions ptp, gpio
 137
 138 group ptp_clk
 139  - pin 57
 140  - functions ptp, mii
 141
 142 group ptp_trig
 143  - pin 58
 144  - functions ptp, mii
 145
 146 group mii_col
 147  - pin 59
 148  - functions mii, mii_err
 149
 150 GPIO subnode:
 151
 152 Please refer to gpio.txt in this directory for details of gpio-ranges property
 153 and the common GPIO bindings used by client devices.
 154
 155 Required properties for gpio driver under the gpio subnode:
 156 - interrupts: List of interrupt specifier for the controllers interrupt.
 157 - gpio-controller: Marks the device node as a gpio controller.
 158 - #gpio-cells: Should be 2. The first cell is the GPIO number and the
 159    second cell specifies GPIO flags, as defined in
 160    <dt-bindings/gpio/gpio.h>. Only the GPIO_ACTIVE_HIGH and
 161    GPIO_ACTIVE_LOW flags are supported.
 162 - gpio-ranges: Range of pins managed by the GPIO controller.
 163
 164 Xtal Clock bindings for Marvell Armada 37xx SoCs
 165 ------------------------------------------------
 166
 167 see Documentation/devicetree/bindings/clock/armada3700-xtal-clock.txt
 168
 169
 170 Example:
 171 pinctrl_sb: pinctrl-sb@18800 {
 172         compatible = "marvell,armada3710-sb-pinctrl", "syscon", "simple-mfd";
 173         reg = <0x18800 0x100>, <0x18C00 0x20>;
 174         gpio {
 175                 #gpio-cells = <2>;
 176                 gpio-ranges = <&pinctrl_sb 0 0 29>;
 177                 gpio-controller;
 178                 interrupts =
 179                 <GIC_SPI 160 IRQ_TYPE_LEVEL_HIGH>,
 180                 <GIC_SPI 159 IRQ_TYPE_LEVEL_HIGH>,
 181                 <GIC_SPI 158 IRQ_TYPE_LEVEL_HIGH>,
 182                 <GIC_SPI 157 IRQ_TYPE_LEVEL_HIGH>,
 183                 <GIC_SPI 156 IRQ_TYPE_LEVEL_HIGH>;
 184         };
 185
 186         rgmii_pins: mii-pins {
 187                 groups = "rgmii";
 188                 function = "mii";
 189         };
 190
 191 };