From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S932634Ab2IRIfq (ORCPT ); Tue, 18 Sep 2012 04:35:46 -0400 Received: from moutng.kundenserver.de ([212.227.17.10]:58123 "EHLO moutng.kundenserver.de" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S932304Ab2IRIfj (ORCPT ); Tue, 18 Sep 2012 04:35:39 -0400 From: Thierry Reding To: Linus Walleij Cc: Grant Likely , Rob Herring , devicetree-discuss@lists.ozlabs.org, linux-kernel@vger.kernel.org Subject: [PATCH] gpio: Describe interrupt-controller binding Date: Tue, 18 Sep 2012 10:35:33 +0200 Message-Id: <1347957333-16431-1-git-send-email-thierry.reding@avionic-design.de> X-Mailer: git-send-email 1.7.12 X-Provags-ID: V02:K0:xFUnsi+XSbEvEG+uyqMtQAgS4ph0ilNT4UNXMxO8wX/ Eq0561UjmqtXvTYap1CvsOjhh0EA2A7cHGizv4t7LZQdn5Dt8O gQEhK8JSN0eGgU2uSirqqnvPuG6JHFbY0cZVdp9814QfgLwFMu NBrhpnade4VuyEDWu8mvmBiKELZmNYpjxUravYDDenb9/G6JYr oxV5gnljQ8JQm7Bou9g3L+aQWbtLoq+DtlFEVkYSLKIsVahe/J OH9rrf0n16JOCkecnDnqzukba/vGCMazju6qv4c/d3u6+1WlBG npPsxjTfdzcEhu0qDZkhYysrWyu4R1d9trensC3f/HRQ+JtMvH RT7dukSGeQGTLznVqP8oBLOqT7mRUxNZ4Ftf5y1LXVh+FwK9FN E0FOmkaqGP42TZrxVErb3hJOnNfkhuzE8C3K+8VDfu/hz683fL w3YJf Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org In order to use GPIO controllers as interrupt controllers, they need to be marked with the DT interrupt-controller property. This commit adds some documentation about this to the general GPIO binding document. Cc: Linus Walleij Cc: Grant Likely Cc: Rob Herring Cc: devicetree-discuss@lists.ozlabs.org Cc: linux-kernel@vger.kernel.org Signed-off-by: Thierry Reding --- Documentation/devicetree/bindings/gpio/gpio.txt | 33 +++++++++++++++++++++++++ 1 file changed, 33 insertions(+) diff --git a/Documentation/devicetree/bindings/gpio/gpio.txt b/Documentation/devicetree/bindings/gpio/gpio.txt index 4e16ba4..8d125b0 100644 --- a/Documentation/devicetree/bindings/gpio/gpio.txt +++ b/Documentation/devicetree/bindings/gpio/gpio.txt @@ -75,4 +75,37 @@ Example of two SOC GPIO banks defined as gpio-controller nodes: gpio-controller; }; +If the GPIO controller supports the generation of interrupts, it should +also contain an empty "interrupt-controller" property as well as an +"#interrupt-cells" property. This is required in order for other nodes +to use the GPIO controller as their interrupt parent. +If #interrupt-cells is 1, the single cell is used to specify the number +of the GPIO that is to be used as an interrupt. + +If #interrupt-cells is 2, the first cell is used to specify the number +of the GPIO that is to be used as an interrupt, whereas the second cell +is used to specify any of the following flags: + - bits[3:0] trigger type and level flags + 1 = low-to-high edge triggered + 2 = high-to-low edge triggered + 4 = active high level-sensitive + 8 = active low level-sensitive + +Example: + + gpioext: gpio-controller@41 { + compatible = "ad,gpio-adnp"; + reg = <0x41>; + + interrupt-parent = <&gpio>; + interrupts = <160 1>; + + gpio-controller; + #gpio-cells = <2>; + + interrupt-controller; + #interrupt-cells = <2>; + + nr-gpios = <64>; + }; -- 1.7.12