On Thu, Mar 31, 2016 at 8:30 AM, Nicolas Ferre <nicolas.ferre@xxxxxxxxx> wrote: > Le 31/03/2016 15:22, Rob Herring a écrit : >> On Thu, Mar 31, 2016 at 4:10 AM, Linus Walleij <linus.walleij@xxxxxxxxxx> wrote: >>> Cc: devicetree@xxxxxxxxxxxxxxx >>> Cc: Neil Armstrong <narmstrong@xxxxxxxxxxxx> >>> Cc: Rob Herring <robh@xxxxxxxxxx> >>> Signed-off-by: Linus Walleij <linus.walleij@xxxxxxxxxx> >> >> We generally avoid indexing blocks in DT. >> >>> --- >>> Documentation/devicetree/bindings/gpio/gpio.txt | 14 ++++++++++++++ >>> 1 file changed, 14 insertions(+) >>> >>> diff --git a/Documentation/devicetree/bindings/gpio/gpio.txt b/Documentation/devicetree/bindings/gpio/gpio.txt >>> index 069cdf6f9dac..f509ecf03ece 100644 >>> --- a/Documentation/devicetree/bindings/gpio/gpio.txt >>> +++ b/Documentation/devicetree/bindings/gpio/gpio.txt >>> @@ -131,6 +131,19 @@ Every GPIO controller node must contain both an empty "gpio-controller" >>> property, and a #gpio-cells integer property, which indicates the number of >>> cells in a gpio-specifier. >>> >>> +Some system-on-chips (SoCs) use the concept of GPIO banks. A GPIO bank is an >>> +instance of a hardware IP core on a silicon die, usually exposed to the >>> +programmer as a coherent range of I/O addresses. Usually each such bank is >>> +exposed in the device tree as an individual gpio-controller node, reflecting >>> +the fact that the hardware was synthesized by reusing the same IP block a >>> +few times over. >>> + >>> +A GPIO controller may specify a bank ID. This is a hardware index that >>> +indicate the logical order of the GPIO controller in the hardware architecture, >>> +usually in the sequence 0, 1, 2 .. n. The hardware index may be different >>> +from the order of register ranges and related to the backplane of how this >>> +one bank is connected to the outside through a pin controller for example. >> >> I still don't understand why do you need to know this? If you need >> some mapping of gpio nodes into pin controller, the pin controller >> should have a mapping using phandles. > > We use aliases for this: > > aliases { > gpio0 = &pioA; > gpio1 = &pioB; > [..] > }; Which is a global number space that might not work in all cases. I don't think gpio should be using aliases either. If you need to describe the connections between nodes, then keep that between nodes. Rob -- To unsubscribe from this list: send the line "unsubscribe devicetree" in the body of a message to majordomo@xxxxxxxxxxxxxxx More majordomo info at http://vger.kernel.org/majordomo-info.html