Re: [PATCH v6 1/2] dt-binding: pinctrl: Add NPCM7xx pinctrl and GPIO documentation

2018-08-29 Thread Linus Walleij
On Wed, Aug 8, 2018 at 11:25 AM Tomer Maimon  wrote:

> Added device tree binding documentation for Nuvoton BMC
> NPCM750/730/715/705 pinmux and GPIO controller.
>
> Signed-off-by: Tomer Maimon 
> Reviewed-by: Rob Herring 

Patch applied, bindings are clearly finished!

Yours,
Linus Walleij


Re: [PATCH v6 1/2] dt-binding: pinctrl: Add NPCM7xx pinctrl and GPIO documentation

2018-08-29 Thread Linus Walleij
On Wed, Aug 8, 2018 at 11:25 AM Tomer Maimon  wrote:

> Added device tree binding documentation for Nuvoton BMC
> NPCM750/730/715/705 pinmux and GPIO controller.
>
> Signed-off-by: Tomer Maimon 
> Reviewed-by: Rob Herring 

Patch applied, bindings are clearly finished!

Yours,
Linus Walleij


[PATCH v6 1/2] dt-binding: pinctrl: Add NPCM7xx pinctrl and GPIO documentation

2018-08-08 Thread Tomer Maimon
Added device tree binding documentation for Nuvoton BMC
NPCM750/730/715/705 pinmux and GPIO controller.

Signed-off-by: Tomer Maimon 
Reviewed-by: Rob Herring 
---
 .../bindings/pinctrl/nuvoton,npcm7xx-pinctrl.txt   | 216 +
 1 file changed, 216 insertions(+)
 create mode 100644 
Documentation/devicetree/bindings/pinctrl/nuvoton,npcm7xx-pinctrl.txt

diff --git 
a/Documentation/devicetree/bindings/pinctrl/nuvoton,npcm7xx-pinctrl.txt 
b/Documentation/devicetree/bindings/pinctrl/nuvoton,npcm7xx-pinctrl.txt
new file mode 100644
index ..83f4bbac94bb
--- /dev/null
+++ b/Documentation/devicetree/bindings/pinctrl/nuvoton,npcm7xx-pinctrl.txt
@@ -0,0 +1,216 @@
+Nuvoton NPCM7XX Pin Controllers
+
+The Nuvoton BMC NPCM7XX Pin Controller multi-function routed through
+the multiplexing block, Each pin supports GPIO functionality (GPIOx)
+and multiple functions that directly connect the pin to different
+hardware blocks.
+
+Required properties:
+- #address-cells : should be 1.
+- #size-cells   : should be 1.
+- compatible: "nuvoton,npcm750-pinctrl" for Poleg NPCM7XX.
+- ranges: defines mapping ranges between pin controller node (parent)
+   to GPIO bank node (children).
+
+=== GPIO Bank Subnode ===
+
+The NPCM7XX has 8 GPIO Banks each GPIO bank supports 32 GPIO.
+
+Required GPIO Bank subnode-properties:
+- reg  : specifies physical base address and size of the GPIO
+   bank registers.
+- gpio-controller  : Marks the device node as a GPIO controller.
+- #gpio-cells  : Must be <2>. The first cell is the gpio pin number
+   and the second cell is used for optional 
parameters.
+- interrupts   : contain the GPIO bank interrupt with flags for 
falling edge.
+- gpio-ranges  : defines the range of pins managed by the GPIO bank 
controller.
+
+For example, GPIO bank subnodes like the following:
+   gpio0: gpio@f001 {
+   gpio-controller;
+   #gpio-cells = <2>;
+   reg = <0x0 0x80>;
+   interrupts = ;
+   gpio-ranges = < 0 0 32>;
+   };
+
+=== Pin Mux Subnode ===
+
+- pin: A string containing the name of the pin
+   An array of strings, each string containing the name of a pin.
+   These pin are used for selecting pin configuration.
+
+The following are the list of pins available:
+   "GPIO0/IOX1DI", "GPIO1/IOX1LD", "GPIO2/IOX1CK", "GPIO3/IOX1D0",
+   "GPIO4/IOX2DI/SMB1DSDA", "GPIO5/IOX2LD/SMB1DSCL", 
"GPIO6/IOX2CK/SMB2DSDA",
+   "GPIO7/IOX2D0/SMB2DSCL", "GPIO8/LKGPO1", "GPIO9/LKGPO2", 
"GPIO10/IOXHLD",
+   "GPIO11/IOXHCK", "GPIO12/GSPICK/SMB5BSCL", "GPIO13/GSPIDO/SMB5BSDA",
+   "GPIO14/GSPIDI/SMB5CSCL", "GPIO15/GSPICS/SMB5CSDA", "GPIO16/LKGPO0",
+   "GPIO17/PSPI2DI/SMB4DEN","GPIO18/PSPI2D0/SMB4BSDA", 
"GPIO19/PSPI2CK/SMB4BSCL",
+   "GPIO20/SMB4CSDA/SMB15SDA", "GPIO21/SMB4CSCL/SMB15SCL", 
"GPIO22/SMB4DSDA/SMB14SDA",
+   "GPIO23/SMB4DSCL/SMB14SCL", "GPIO24/IOXHDO", "GPIO25/IOXHDI", 
"GPIO26/SMB5SDA",
+   "GPIO27/SMB5SCL", "GPIO28/SMB4SDA", "GPIO29/SMB4SCL", "GPIO30/SMB3SDA",
+   "GPIO31/SMB3SCL", "GPIO32/nSPI0CS1","SPI0D2", "SPI0D3", 
"GPIO37/SMB3CSDA",
+   "GPIO38/SMB3CSCL", "GPIO39/SMB3BSDA", "GPIO40/SMB3BSCL", 
"GPIO41/BSPRXD",
+   "GPO42/BSPTXD/STRAP11", "GPIO43/RXD1/JTMS2/BU1RXD", 
"GPIO44/nCTS1/JTDI2/BU1CTS",
+   "GPIO45/nDCD1/JTDO2", "GPIO46/nDSR1/JTCK2", "GPIO47/nRI1/JCP_RDY2",
+   "GPIO48/TXD2/BSPTXD", "GPIO49/RXD2/BSPRXD", "GPIO50/nCTS2", 
"GPO51/nRTS2/STRAP2",
+   "GPIO52/nDCD2", "GPO53/nDTR2_BOUT2/STRAP1", "GPIO54/nDSR2", 
"GPIO55/nRI2",
+   "GPIO56/R1RXERR", "GPIO57/R1MDC", "GPIO58/R1MDIO", "GPIO59/SMB3DSDA",
+   "GPIO60/SMB3DSCL", "GPO61/nDTR1_BOUT1/STRAP6", "GPO62/nRTST1/STRAP5",
+   "GPO63/TXD1/STRAP4", "GPIO64/FANIN0", "GPIO65/FANIN1", "GPIO66/FANIN2",
+   "GPIO67/FANIN3", "GPIO68/FANIN4", "GPIO69/FANIN5", "GPIO70/FANIN6", 
"GPIO71/FANIN7",
+   "GPIO72/FANIN8", "GPIO73/FANIN9", "GPIO74/FANIN10", "GPIO75/FANIN11",
+   "GPIO76/FANIN12", "GPIO77/FANIN13","GPIO78/FANIN14", "GPIO79/FANIN15",
+   "GPIO80/PWM0", "GPIO81/PWM1", "GPIO82/PWM2", "GPIO83/PWM3", 
"GPIO84/R2TXD0",
+   "GPIO85/R2TXD1", "GPIO86/R2TXEN", "GPIO87/R2RXD0", "GPIO88/R2RXD1", 
"GPIO89/R2CRSDV",
+   "GPIO90/R2RXERR", "GPIO91/R2MDC", "GPIO92/R2MDIO", 
"GPIO93/GA20/SMB5DSCL",
+   "GPIO94/nKBRST/SMB5DSDA", "GPIO95/nLRESET/nESPIRST", "GPIO96/RG1TXD0",
+   "GPIO97/RG1TXD1", "GPIO98/RG1TXD2", "GPIO99/RG1TXD3","GPIO100/RG1TXC",
+   "GPIO101/RG1TXCTL", "GPIO102/RG1RXD0", "GPIO103/RG1RXD1", 
"GPIO104/RG1RXD2",
+   "GPIO105/RG1RXD3", "GPIO106/RG1RXC", "GPIO107/RG1RXCTL", 
"GPIO108/RG1MDC",
+   "GPIO109/RG1MDIO", "GPIO110/RG2TXD0/DDRV0", "GPIO111/RG2TXD1/DDRV1",
+   "GPIO112/RG2TXD2/DDRV2", "GPIO113/RG2TXD3/DDRV3", "GPIO114/SMB0SCL",
+   "GPIO115/SMB0SDA", "GPIO116/SMB1SCL", "GPIO117/SMB1SDA", 

[PATCH v6 1/2] dt-binding: pinctrl: Add NPCM7xx pinctrl and GPIO documentation

2018-08-08 Thread Tomer Maimon
Added device tree binding documentation for Nuvoton BMC
NPCM750/730/715/705 pinmux and GPIO controller.

Signed-off-by: Tomer Maimon 
Reviewed-by: Rob Herring 
---
 .../bindings/pinctrl/nuvoton,npcm7xx-pinctrl.txt   | 216 +
 1 file changed, 216 insertions(+)
 create mode 100644 
Documentation/devicetree/bindings/pinctrl/nuvoton,npcm7xx-pinctrl.txt

diff --git 
a/Documentation/devicetree/bindings/pinctrl/nuvoton,npcm7xx-pinctrl.txt 
b/Documentation/devicetree/bindings/pinctrl/nuvoton,npcm7xx-pinctrl.txt
new file mode 100644
index ..83f4bbac94bb
--- /dev/null
+++ b/Documentation/devicetree/bindings/pinctrl/nuvoton,npcm7xx-pinctrl.txt
@@ -0,0 +1,216 @@
+Nuvoton NPCM7XX Pin Controllers
+
+The Nuvoton BMC NPCM7XX Pin Controller multi-function routed through
+the multiplexing block, Each pin supports GPIO functionality (GPIOx)
+and multiple functions that directly connect the pin to different
+hardware blocks.
+
+Required properties:
+- #address-cells : should be 1.
+- #size-cells   : should be 1.
+- compatible: "nuvoton,npcm750-pinctrl" for Poleg NPCM7XX.
+- ranges: defines mapping ranges between pin controller node (parent)
+   to GPIO bank node (children).
+
+=== GPIO Bank Subnode ===
+
+The NPCM7XX has 8 GPIO Banks each GPIO bank supports 32 GPIO.
+
+Required GPIO Bank subnode-properties:
+- reg  : specifies physical base address and size of the GPIO
+   bank registers.
+- gpio-controller  : Marks the device node as a GPIO controller.
+- #gpio-cells  : Must be <2>. The first cell is the gpio pin number
+   and the second cell is used for optional 
parameters.
+- interrupts   : contain the GPIO bank interrupt with flags for 
falling edge.
+- gpio-ranges  : defines the range of pins managed by the GPIO bank 
controller.
+
+For example, GPIO bank subnodes like the following:
+   gpio0: gpio@f001 {
+   gpio-controller;
+   #gpio-cells = <2>;
+   reg = <0x0 0x80>;
+   interrupts = ;
+   gpio-ranges = < 0 0 32>;
+   };
+
+=== Pin Mux Subnode ===
+
+- pin: A string containing the name of the pin
+   An array of strings, each string containing the name of a pin.
+   These pin are used for selecting pin configuration.
+
+The following are the list of pins available:
+   "GPIO0/IOX1DI", "GPIO1/IOX1LD", "GPIO2/IOX1CK", "GPIO3/IOX1D0",
+   "GPIO4/IOX2DI/SMB1DSDA", "GPIO5/IOX2LD/SMB1DSCL", 
"GPIO6/IOX2CK/SMB2DSDA",
+   "GPIO7/IOX2D0/SMB2DSCL", "GPIO8/LKGPO1", "GPIO9/LKGPO2", 
"GPIO10/IOXHLD",
+   "GPIO11/IOXHCK", "GPIO12/GSPICK/SMB5BSCL", "GPIO13/GSPIDO/SMB5BSDA",
+   "GPIO14/GSPIDI/SMB5CSCL", "GPIO15/GSPICS/SMB5CSDA", "GPIO16/LKGPO0",
+   "GPIO17/PSPI2DI/SMB4DEN","GPIO18/PSPI2D0/SMB4BSDA", 
"GPIO19/PSPI2CK/SMB4BSCL",
+   "GPIO20/SMB4CSDA/SMB15SDA", "GPIO21/SMB4CSCL/SMB15SCL", 
"GPIO22/SMB4DSDA/SMB14SDA",
+   "GPIO23/SMB4DSCL/SMB14SCL", "GPIO24/IOXHDO", "GPIO25/IOXHDI", 
"GPIO26/SMB5SDA",
+   "GPIO27/SMB5SCL", "GPIO28/SMB4SDA", "GPIO29/SMB4SCL", "GPIO30/SMB3SDA",
+   "GPIO31/SMB3SCL", "GPIO32/nSPI0CS1","SPI0D2", "SPI0D3", 
"GPIO37/SMB3CSDA",
+   "GPIO38/SMB3CSCL", "GPIO39/SMB3BSDA", "GPIO40/SMB3BSCL", 
"GPIO41/BSPRXD",
+   "GPO42/BSPTXD/STRAP11", "GPIO43/RXD1/JTMS2/BU1RXD", 
"GPIO44/nCTS1/JTDI2/BU1CTS",
+   "GPIO45/nDCD1/JTDO2", "GPIO46/nDSR1/JTCK2", "GPIO47/nRI1/JCP_RDY2",
+   "GPIO48/TXD2/BSPTXD", "GPIO49/RXD2/BSPRXD", "GPIO50/nCTS2", 
"GPO51/nRTS2/STRAP2",
+   "GPIO52/nDCD2", "GPO53/nDTR2_BOUT2/STRAP1", "GPIO54/nDSR2", 
"GPIO55/nRI2",
+   "GPIO56/R1RXERR", "GPIO57/R1MDC", "GPIO58/R1MDIO", "GPIO59/SMB3DSDA",
+   "GPIO60/SMB3DSCL", "GPO61/nDTR1_BOUT1/STRAP6", "GPO62/nRTST1/STRAP5",
+   "GPO63/TXD1/STRAP4", "GPIO64/FANIN0", "GPIO65/FANIN1", "GPIO66/FANIN2",
+   "GPIO67/FANIN3", "GPIO68/FANIN4", "GPIO69/FANIN5", "GPIO70/FANIN6", 
"GPIO71/FANIN7",
+   "GPIO72/FANIN8", "GPIO73/FANIN9", "GPIO74/FANIN10", "GPIO75/FANIN11",
+   "GPIO76/FANIN12", "GPIO77/FANIN13","GPIO78/FANIN14", "GPIO79/FANIN15",
+   "GPIO80/PWM0", "GPIO81/PWM1", "GPIO82/PWM2", "GPIO83/PWM3", 
"GPIO84/R2TXD0",
+   "GPIO85/R2TXD1", "GPIO86/R2TXEN", "GPIO87/R2RXD0", "GPIO88/R2RXD1", 
"GPIO89/R2CRSDV",
+   "GPIO90/R2RXERR", "GPIO91/R2MDC", "GPIO92/R2MDIO", 
"GPIO93/GA20/SMB5DSCL",
+   "GPIO94/nKBRST/SMB5DSDA", "GPIO95/nLRESET/nESPIRST", "GPIO96/RG1TXD0",
+   "GPIO97/RG1TXD1", "GPIO98/RG1TXD2", "GPIO99/RG1TXD3","GPIO100/RG1TXC",
+   "GPIO101/RG1TXCTL", "GPIO102/RG1RXD0", "GPIO103/RG1RXD1", 
"GPIO104/RG1RXD2",
+   "GPIO105/RG1RXD3", "GPIO106/RG1RXC", "GPIO107/RG1RXCTL", 
"GPIO108/RG1MDC",
+   "GPIO109/RG1MDIO", "GPIO110/RG2TXD0/DDRV0", "GPIO111/RG2TXD1/DDRV1",
+   "GPIO112/RG2TXD2/DDRV2", "GPIO113/RG2TXD3/DDRV3", "GPIO114/SMB0SCL",
+   "GPIO115/SMB0SDA", "GPIO116/SMB1SCL", "GPIO117/SMB1SDA",