1Abilis Systems TB10x pin controller 2=================================== 3 4Required properties 5------------------- 6 7- compatible: should be "abilis,tb10x-iomux"; 8- reg: should contain the physical address and size of the pin controller's 9 register range. 10 11 12Function definitions 13-------------------- 14 15Functions are defined (and referenced) by sub-nodes of the pin controller. 16Every sub-node defines exactly one function (implying a set of pins). 17Every function is associated to one named pin group inside the pin controller 18driver and these names are used to associate pin group predefinitions to pin 19controller sub-nodes. 20 21Required function definition subnode properties: 22 - abilis,function: should be set to the name of the function's pin group. 23 24The following pin groups are available: 25 - GPIO ports: gpioa, gpiob, gpioc, gpiod, gpioe, gpiof, gpiog, 26 gpioh, gpioi, gpioj, gpiok, gpiol, gpiom, gpion 27 - Serial TS input ports: mis0, mis1, mis2, mis3, mis4, mis5, mis6, mis7 28 - Parallel TS input ports: mip1, mip3, mip5, mip7 29 - Serial TS output ports: mos0, mos1, mos2, mos3 30 - Parallel TS output port: mop 31 - CI+ port: ciplus 32 - CableCard (Mcard) port: mcard 33 - Smart card ports: stc0, stc1 34 - UART ports: uart0, uart1 35 - SPI ports: spi1, spi3 36 - JTAG: jtag 37 38All other ports of the chip are not multiplexed and thus not managed by this 39driver. 40 41 42GPIO ranges definition 43---------------------- 44 45The named pin groups of GPIO ports can be used to define GPIO ranges as 46explained in Documentation/devicetree/bindings/gpio/gpio.txt. 47 48 49Example 50------- 51 52iomux: iomux@FF10601c { 53 compatible = "abilis,tb10x-iomux"; 54 reg = <0xFF10601c 0x4>; 55 pctl_gpio_a: pctl-gpio-a { 56 abilis,function = "gpioa"; 57 }; 58 pctl_uart0: pctl-uart0 { 59 abilis,function = "uart0"; 60 }; 61}; 62uart@FF100000 { 63 compatible = "snps,dw-apb-uart"; 64 reg = <0xFF100000 0x100>; 65 clock-frequency = <166666666>; 66 interrupts = <25 1>; 67 reg-shift = <2>; 68 reg-io-width = <4>; 69 pinctrl-names = "default"; 70 pinctrl-0 = <&pctl_uart0>; 71}; 72gpioa: gpio@FF140000 { 73 compatible = "abilis,tb10x-gpio"; 74 reg = <0xFF140000 0x1000>; 75 gpio-controller; 76 #gpio-cells = <2>; 77 ngpio = <3>; 78 gpio-ranges = <&iomux 0 0>; 79 gpio-ranges-group-names = "gpioa"; 80}; 81