From patchwork Fri Feb 2 14:21:59 2018 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Lina Iyer X-Patchwork-Id: 868593 Return-Path: X-Original-To: incoming-dt@patchwork.ozlabs.org Delivered-To: patchwork-incoming-dt@bilbo.ozlabs.org Authentication-Results: ozlabs.org; spf=none (mailfrom) smtp.mailfrom=vger.kernel.org (client-ip=209.132.180.67; helo=vger.kernel.org; envelope-from=devicetree-owner@vger.kernel.org; receiver=) Authentication-Results: ozlabs.org; dkim=fail reason="signature verification failed" (1024-bit key; unprotected) header.d=codeaurora.org header.i=@codeaurora.org header.b="JvC+FjQZ"; dkim=fail reason="signature verification failed" (1024-bit key) header.d=codeaurora.org header.i=@codeaurora.org header.b="YXqRXPts"; dkim-atps=neutral Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by ozlabs.org (Postfix) with ESMTP id 3zXzhz1Lgpz9sR8 for ; Sat, 3 Feb 2018 01:22:43 +1100 (AEDT) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1751970AbeBBOWl (ORCPT ); Fri, 2 Feb 2018 09:22:41 -0500 Received: from smtp.codeaurora.org ([198.145.29.96]:59754 "EHLO smtp.codeaurora.org" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1752260AbeBBOWb (ORCPT ); Fri, 2 Feb 2018 09:22:31 -0500 Received: by smtp.codeaurora.org (Postfix, from userid 1000) id E9709610D7; Fri, 2 Feb 2018 14:22:30 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=codeaurora.org; s=default; t=1517581351; bh=zsyqbCZeUA9dcWjKSdie2i3udWfS7xa9sQIX9RdkjA4=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=JvC+FjQZpFnvIq9zLs0Uycs2X/lZ4AYqJo0mUVN1h6xsKkgTnHoL5svOp4y3DAD5L WqMqBXDHNmNX073MCy2k2ZzitYT8BIQEH7MKdT1Kd1wLfnzku5w7ydwlFKmYz93Z8/ y8yiELpdvqmjIeY0oKc6lFNH7/bKvrEsexNTDgOk= X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on pdx-caf-mail.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-2.8 required=2.0 tests=ALL_TRUSTED,BAYES_00, DKIM_SIGNED, T_DKIM_INVALID autolearn=no autolearn_force=no version=3.4.0 Received: from codeaurora.org (i-global254.qualcomm.com [199.106.103.254]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-SHA256 (128/128 bits)) (No client certificate requested) (Authenticated sender: ilina@smtp.codeaurora.org) by smtp.codeaurora.org (Postfix) with ESMTPSA id 2C9776076A; Fri, 2 Feb 2018 14:22:24 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=codeaurora.org; s=default; t=1517581345; bh=zsyqbCZeUA9dcWjKSdie2i3udWfS7xa9sQIX9RdkjA4=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=YXqRXPtsD+61YYz3wpe6oU3VBTel5NDIiIG9G4BOApGlMzSo21dgREjOyVaKLHNx9 EC3egF4HZ8mbbMkAFvZ0n4Y2C6KaryYvLstusoCIHHvjzJLfR0ONdB6bfknHk2DGUp Qpj6uIqWsXilC7pYpKNS6qR/sbqlAs+mm+thwpsc= DMARC-Filter: OpenDMARC Filter v1.3.2 smtp.codeaurora.org 2C9776076A Authentication-Results: pdx-caf-mail.web.codeaurora.org; dmarc=none (p=none dis=none) header.from=codeaurora.org Authentication-Results: pdx-caf-mail.web.codeaurora.org; spf=none smtp.mailfrom=ilina@codeaurora.org From: Lina Iyer To: tglx@linutronix.de, jason@lakedaemon.net, marc.zyngier@arm.com Cc: linux-kernel@vger.kernel.org, linux-arm-msm@vger.kernel.org, sboyd@codeaurora.org, rnayak@codeaurora.org, asathyak@codeaurora.org, Lina Iyer , devicetree@vger.kernel.org Subject: [PATCH RFC v2 2/3] dt-bindings/interrupt-controller: pdc: descibe PDC device binding Date: Fri, 2 Feb 2018 07:21:59 -0700 Message-Id: <20180202142200.6229-3-ilina@codeaurora.org> X-Mailer: git-send-email 2.15.1 In-Reply-To: <20180202142200.6229-1-ilina@codeaurora.org> References: <20180202142200.6229-1-ilina@codeaurora.org> Sender: devicetree-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: devicetree@vger.kernel.org From: Archana Sathyakumar Add device binding documentation for the PDC Interrupt controller on QCOM SoC's like the SDM845. The interrupt-controller can be used to sense edge low interrupts and wakeup interrupts when the GIC is non-operational. Cc: devicetree@vger.kernel.org Signed-off-by: Archana Sathyakumar Signed-off-by: Lina Iyer --- .../bindings/interrupt-controller/qcom,pdc.txt | 78 ++++++++++++++++++++++ 1 file changed, 78 insertions(+) create mode 100644 Documentation/devicetree/bindings/interrupt-controller/qcom,pdc.txt diff --git a/Documentation/devicetree/bindings/interrupt-controller/qcom,pdc.txt b/Documentation/devicetree/bindings/interrupt-controller/qcom,pdc.txt new file mode 100644 index 000000000000..7bf40cb6a4f8 --- /dev/null +++ b/Documentation/devicetree/bindings/interrupt-controller/qcom,pdc.txt @@ -0,0 +1,78 @@ +PDC interrupt controller + +Qualcomm Technologies Inc. SoCs based on the RPM Hardened architecture have a +Power Domain Controller (PDC) that is on always-on domain. In addition to +providing power control for the power domains, the hardware also has an +interrupt controller that can be used to help detect edge low interrupts as +well detect interrupts when the GIC is non-operational. + +GIC is parent interrupt controller at the highest level. Platform interrupt +controller PDC is next in hierarchy, followed by others. Drivers requiring +wakeup capabilities of their device interrupts routed through the PDC, must +specify PDC as their interrupt controller and request the PDC port associated +with the GIC interrupt. See example below. + +Properties: + +- compatible: + Usage: required + Value type: + Definition: Should contain "qcom,-pdc" + - "qcom,sdm845-pdc": For SDM845 + +- reg: + Usage: required + Value type: + Definition: Specifies the base physical address for PDC hardware. + +- interrupt-cells: + Usage: required + Value type: + Definition: Specifies the number of cells needed to encode an interrupt + source. + The value must match that of the parent interrupt + controller defined in the DT. + The encoding of these cells are same as described in [1]. + +- interrupt-parent: + Usage: required + Value type: + Definition: Specifies the interrupt parent necessary for hierarchical + domain to operate. + +- interrupt-controller: + Usage: required + Value type: + Definition: Identifies the node as an interrupt controller. + +- qcom,pdc-range: + Usage: required + Value type: + Definition: Specifies the PDC pin offset and the number of PDC ports. + The tuples indicates the valid mapping of valid PDC ports + and their hwirq mapping. + The first element of the tuple is the staring PDC port num. + The second element is the hwirq number for the PDC port. + The third element is the number of elements in sequence. + +Example: + + pdc: interrupt-controller@b220000 { + compatible = "qcom,sdm845-pdc"; + reg = <0xb220000 0x30000>; + qcom,pdc-ranges = <0 512 94>, <94 641 15>, <115 662 7>; + #interrupt-cells = <3>; + interrupt-parent = <&intc>; + interrupt-controller; + }; + +The DT binding of a device that wants to use the GIC SPI 514 as a wakeup +interrupt, would look like this - + + wake-device { + [...] + interrupt-parent = <&pdc>; + interrupt = <0 2 0>; + }; + +[1]. Documentation/devicetree/bindings/interrupt-controller/arm,gic-v3.txt