From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1762578AbbA2Kd4 (ORCPT ); Thu, 29 Jan 2015 05:33:56 -0500 Received: from down.free-electrons.com ([37.187.137.238]:59786 "EHLO mail.free-electrons.com" rhost-flags-OK-OK-OK-FAIL) by vger.kernel.org with ESMTP id S1762464AbbA2Kdr (ORCPT ); Thu, 29 Jan 2015 05:33:47 -0500 From: Boris Brezillon To: Thomas Gleixner , Jason Cooper , Nicolas Ferre , Jean-Christophe Plagniol-Villard , Alexandre Belloni , Rob Herring Cc: Pawel Moll , Mark Rutland , Ian Campbell , Kumar Gala , devicetree@vger.kernel.org, "Rafael J. Wysocki" , linux-arm-kernel@lists.infradead.org, linux-kernel@vger.kernel.org, Boris Brezillon Subject: [PATCH v4 3/5] irqchip: Add DT binding doc for the virtual irq demuxer chip Date: Thu, 29 Jan 2015 11:33:38 +0100 Message-Id: <1422527620-8308-4-git-send-email-boris.brezillon@free-electrons.com> X-Mailer: git-send-email 1.9.1 In-Reply-To: <1422527620-8308-1-git-send-email-boris.brezillon@free-electrons.com> References: <1422527620-8308-1-git-send-email-boris.brezillon@free-electrons.com> Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Add documentation for the virtual irq demuxer. Signed-off-by: Boris Brezillon Acked-by: Nicolas Ferre --- .../bindings/interrupt-controller/dumb-demux.txt | 41 ++++++++++++++++++++++ 1 file changed, 41 insertions(+) create mode 100644 Documentation/devicetree/bindings/interrupt-controller/dumb-demux.txt diff --git a/Documentation/devicetree/bindings/interrupt-controller/dumb-demux.txt b/Documentation/devicetree/bindings/interrupt-controller/dumb-demux.txt new file mode 100644 index 0000000..b9a7830 --- /dev/null +++ b/Documentation/devicetree/bindings/interrupt-controller/dumb-demux.txt @@ -0,0 +1,41 @@ +* Virtual Interrupt Demultiplexer + +This virtual demultiplexer simply forward all incoming interrupts to its +enabled/unmasked children. +It is only intended to be used by hardware that do not provide a proper way +to demultiplex a source interrupt, and thus have to wake all their children +up so that they can possibly handle the interrupt (if needed). +This can be seen as an alternative to shared interrupts when at least one +of the interrupt children is a timer (and require the irq to stay enabled +on suspend) while others are not. This will prevent calling irq handlers of +non timer devices while they are suspended. + +Required properties: +- compatible: Should be "virtual,irq-demux". +- interrupt-controller: Identifies the node as an interrupt controller. +- interrupts-extended or interrupt-parent and interrupts: Reference the source + interrupt connected to this dumb demuxer. +- #interrupt-cells: The number of cells to define the interrupts (should be 1). + The only cell is the IRQ number. +- irqs: u32 bitfield specifying the interrupts provided by the demuxer. + +Examples: + /* + * virtual demuxer controller + */ + virt_irq1_demux: virt-irq-demux@1 { + compatible = "virtual,irq-demux"; + interrupt-controller; + #interrupt-cells = <1>; + interrupts-extended = <&aic 1 IRQ_TYPE_LEVEL_HIGH 7>; + irqs = <0x3f>; + }; + + /* + * Device connected on this dumb demuxer + */ + dma: dma-controller@ffffec00 { + compatible = "atmel,at91sam9g45-dma"; + reg = <0xffffec00 0x200>; + interrupts-extended = <&virt_irq1_demux 0>; + }; -- 1.9.1