On Mon, Nov 3, 2014 at 8:05 PM, Soren Brinkmann
[off-list ref] wrote:

Add documentation for the devicetree binding for the Zynq pincontroller.

Signed-off-by: Soren Brinkmann <redacted>

(...)

+Example:
+       pinctrl0: pinctrl at 700 {
+               compatible = "xlnx,pinctrl-zynq";
+               reg = <0x700 0x200>;
+               syscon = <&slcr>;
+
+               pinctrl_uart1_default: pinctrl-uart1-default {
+                       common {
+                               groups = "uart1_10_grp";
+                               function = "uart1";
+                               slew-rate = <0>;
+                               io-standard = <1>;
+                       };

I don't really like that you mix multiplexing and config in the
same node. I would prefer if the generic bindings say we have
muxing nodes and config nodes, and those are disparate.

Can't you just split this:

common-mux {
    groups = "uart1_10_grp";
    function = "uart1";
};

common-config {
    groups = "uart1_10_grp";
    slew-rate = <0>;
    io-standard = <1>;
};

That way we can identify nodes as mux nodes (have "function")
or config nodes (have "groups" or "pins" but not "function") which
I think makes things easier to read.

Yours,
Linus Walleij