From patchwork Tue Jul 8 15:54:28 2014 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stanimir Varbanov X-Patchwork-Id: 4506081 Return-Path: X-Original-To: patchwork-linux-arm@patchwork.kernel.org Delivered-To: patchwork-parsemail@patchwork2.web.kernel.org Received: from mail.kernel.org (mail.kernel.org [198.145.19.201]) by patchwork2.web.kernel.org (Postfix) with ESMTP id A930ABEEAA for ; Tue, 8 Jul 2014 15:58:17 +0000 (UTC) Received: from mail.kernel.org (localhost [127.0.0.1]) by mail.kernel.org (Postfix) with ESMTP id D6121202F8 for ; Tue, 8 Jul 2014 15:58:16 +0000 (UTC) Received: from bombadil.infradead.org (bombadil.infradead.org [198.137.202.9]) (using TLSv1.2 with cipher DHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mail.kernel.org (Postfix) with ESMTPS id 0F0222026D for ; Tue, 8 Jul 2014 15:58:16 +0000 (UTC) Received: from localhost ([127.0.0.1] helo=bombadil.infradead.org) by bombadil.infradead.org with esmtp (Exim 4.80.1 #2 (Red Hat Linux)) id 1X4Xkp-0000NK-GI; Tue, 08 Jul 2014 15:56:27 +0000 Received: from ns.mm-sol.com ([37.157.136.199] helo=extserv.mm-sol.com) by bombadil.infradead.org with esmtps (Exim 4.80.1 #2 (Red Hat Linux)) id 1X4Xki-00005m-Hz for linux-arm-kernel@lists.infradead.org; Tue, 08 Jul 2014 15:56:21 +0000 Received: from localhost.localdomain (unknown [37.157.136.206]) by extserv.mm-sol.com (Postfix) with ESMTPSA id DE90BC7C3; Tue, 8 Jul 2014 18:55:58 +0300 (EEST) From: Stanimir Varbanov To: linux-arm-msm@vger.kernel.org, linux-kernel@vger.kernel.org, linux-arm-kernel@lists.infradead.org, devicetree@vger.kernel.org Subject: [PATCH 2/3] mfd: qpnp-spmi: document DT bindings for Qualcomm QPNP PMICs Date: Tue, 8 Jul 2014 18:54:28 +0300 Message-Id: <1404834869-23049-3-git-send-email-svarbanov@mm-sol.com> X-Mailer: git-send-email 1.7.0.4 In-Reply-To: <1404834869-23049-1-git-send-email-svarbanov@mm-sol.com> References: <1404834869-23049-1-git-send-email-svarbanov@mm-sol.com> X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20140708_085620_816539_378DC8B4 X-CRM114-Status: UNSURE ( 9.11 ) X-CRM114-Notice: Please train this message. X-Spam-Score: -0.7 (/) Cc: Mark Rutland , Courtney Cavin , Samuel Ortiz , Josh Cartwright , Stanimir Varbanov , Rob Herring , "Ivan T. Ivanov" , Kumar Gala , Grant Likely , Lee Jones X-BeenThere: linux-arm-kernel@lists.infradead.org X-Mailman-Version: 2.1.18-1 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , MIME-Version: 1.0 Sender: "linux-arm-kernel" Errors-To: linux-arm-kernel-bounces+patchwork-linux-arm=patchwork.kernel.org@lists.infradead.org X-Spam-Status: No, score=-2.6 required=5.0 tests=BAYES_00,RP_MATCHES_RCVD, UNPARSEABLE_RELAY autolearn=unavailable version=3.3.1 X-Spam-Checker-Version: SpamAssassin 3.3.1 (2010-03-16) on mail.kernel.org X-Virus-Scanned: ClamAV using ClamSMTP From: Ivan T. Ivanov Document DT bindings used to describe the Qualcomm QPNP PMICs. Signed-off-by: Ivan T. Ivanov Signed-off-by: Stanimir Varbanov --- .../devicetree/bindings/qpnp/qcom,qpnp-spmi.txt | 53 ++++++++++++++++++++ 1 files changed, 53 insertions(+), 0 deletions(-) create mode 100644 Documentation/devicetree/bindings/qpnp/qcom,qpnp-spmi.txt diff --git a/Documentation/devicetree/bindings/qpnp/qcom,qpnp-spmi.txt b/Documentation/devicetree/bindings/qpnp/qcom,qpnp-spmi.txt new file mode 100644 index 0000000..24cde34 --- /dev/null +++ b/Documentation/devicetree/bindings/qpnp/qcom,qpnp-spmi.txt @@ -0,0 +1,53 @@ +Qualcomm QPNP partitioned PMIC multi-function device bindings + +QPNP is effectively a partitioning scheme for dividing the SPMI extended +register space up into logical pieces, and set of fixed register +locations/definitions within these regions, with some of these regions +specifically used for interrupt handling. + +The QPNP PMICs are used with the Qualcomm Snapdragon series SoCs, and are +interfaced to the chip via the SPMI (System Power Management Interface) bus. +Support for multiple independent functions are implemented by splitting the +16-bit SPMI slave address space into 256 smaller fixed-size regions, 256 bytes +each. A function can consume one or more of these fixed-size register regions. + +Required properties: +- compatible: Should contain "qcom,qpnp-spmi" +- reg: Specifies the SPMI USID slave address for this device. + For more information see: + Documentation/devicetree/bindings/spmi/spmi.txt +- #address-cells: Defines address cells for peripheral nodes - should be 1 +- #size-cells: Defines size cells for peripheral nodes - should be 0 + +Required properties for peripheral child nodes: +- compatible: Should constain "qcom,qpnp-xxx" +- reg: One or more 16bits peripheral address(es) + +Optional properties for peripheral child nodes: +- reg-names: Shall be a string describing the reg resource. +- interrupts: Interrupts are specified as a 4-tuple. For more information + see: + Documentation/devicetree/bindings/spmi/qcom,spmi-pmic-arb.txt +- interrupt-names: Corresponding interrupt name to the interrupts property + +Each child node represents a function of the QPNP. Each child 'reg' entry +describes a QPNP peripheral address within the USID slave address space where +the region starts. + +Example: + + pm8941@0 { + compatible = "qcom,qpnp-spmi"; + reg = <0x0 SPMI_USID>; + + #address-cells = <1>; + #size-cells = <0>; + + rtc@6000 { + compatible = "qcom,qpnp-rtc"; + reg = <0x6000 0x6100>; + reg-names = "rtc", "alarm"; + interrupts = <0x0 0x61 0x1 IRQ_TYPE_EDGE_RISING>; + }; + }; +