From patchwork Wed May 24 18:09:29 2017 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Suman Anna X-Patchwork-Id: 9746721 Return-Path: Received: from mail.wl.linuxfoundation.org (pdx-wl-mail.web.codeaurora.org [172.30.200.125]) by pdx-korg-patchwork.web.codeaurora.org (Postfix) with ESMTP id 5AECA601C2 for ; Wed, 24 May 2017 18:10:16 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id 5280328990 for ; Wed, 24 May 2017 18:10:16 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id 472B3289C7; Wed, 24 May 2017 18:10:16 +0000 (UTC) X-Spam-Checker-Version: SpamAssassin 3.3.1 (2010-03-16) on pdx-wl-mail.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-1.9 required=2.0 tests=BAYES_00,DKIM_SIGNED, DKIM_VALID autolearn=ham version=3.3.1 Received: from bombadil.infradead.org (bombadil.infradead.org [65.50.211.133]) (using TLSv1.2 with cipher AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mail.wl.linuxfoundation.org (Postfix) with ESMTPS id 83D7C28990 for ; Wed, 24 May 2017 18:10:15 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=lists.infradead.org; s=bombadil.20170209; h=Sender: Content-Transfer-Encoding:Content-Type:Cc:List-Subscribe:List-Help:List-Post: List-Archive:List-Unsubscribe:List-Id:MIME-Version:References:In-Reply-To: Message-ID:Date:Subject:To:From:Reply-To:Content-ID:Content-Description: Resent-Date:Resent-From:Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID: List-Owner; bh=up3OCH2V1wsAnS2bL9WR2I64uBrmANgpR2fZUvTtQEE=; b=duaidIa2bKREcO e60pWlbldyCkj9z1yrYY48+VNFBp2ulpBQM7YVgX5DCD4JyeCWzo+7sMAOvwtYEwT1jJmLEslluRq LNOrgkJRbKVhI4ccc53BTVoGq0YuQ6+5njbFxqmhVFCxLixx4O7GiujpfITduNVSo6dnYS3oggBXC HEBR5bwNr7FAYFcA7wONYI9RUTJ1Zc65pGKCMSusjPJPaCSIq6iUIwrbJVcMOmaz3iDx9oF4WoP/v sYYMUspctuGaIBaN10iGrsU3pPMhsTiYMfmhJ5WoUHpK/Tk55IbF/bdAfiNuTOHdlNvbbKpI4sqyc IxjEVrSYcjYV34M/NVXg==; Received: from localhost ([127.0.0.1] helo=bombadil.infradead.org) by bombadil.infradead.org with esmtp (Exim 4.87 #1 (Red Hat Linux)) id 1dDaje-0005iJ-BI; Wed, 24 May 2017 18:10:14 +0000 Received: from fllnx210.ext.ti.com ([198.47.19.17]) by bombadil.infradead.org with esmtps (Exim 4.87 #1 (Red Hat Linux)) id 1dDajL-0004FR-BE for linux-arm-kernel@lists.infradead.org; Wed, 24 May 2017 18:09:57 +0000 Received: from dlelxv90.itg.ti.com ([172.17.2.17]) by fllnx210.ext.ti.com (8.15.1/8.15.1) with ESMTP id v4OI9WJ3008911; Wed, 24 May 2017 13:09:32 -0500 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=ti.com; s=ti-com-17Q1; t=1495649372; bh=q/wdLzJ52RqHoMqUzc5GCdsRbSyGfkbOwjp8Wpc1r/A=; h=From:To:CC:Subject:Date:In-Reply-To:References; b=LyQjMc4GbRpu0spjvPR11+gDJiNHWoF6thgInwo7E032xuzs/3cMqq2V/8SGtryJr ZuHThl+VbtNzd+NmgMWlk2bcXYeNqjsoIbAJwmI+WHCRlDF7rsUTysPxW8/uWCq+ya ng9gsUaC+8VpdY+xoR5i4ofRi/oGuU6hZoHax3As= Received: from DLEE70.ent.ti.com (dlee70.ent.ti.com [157.170.170.113]) by dlelxv90.itg.ti.com (8.14.3/8.13.8) with ESMTP id v4OI9WT2023497; Wed, 24 May 2017 13:09:32 -0500 Received: from dflp32.itg.ti.com (10.64.6.15) by DLEE70.ent.ti.com (157.170.170.113) with Microsoft SMTP Server id 14.3.294.0; Wed, 24 May 2017 13:09:31 -0500 Received: from legion.dal.design.ti.com (legion.dal.design.ti.com [128.247.22.53]) by dflp32.itg.ti.com (8.14.3/8.13.8) with ESMTP id v4OI9V8X000710; Wed, 24 May 2017 13:09:31 -0500 Received: from localhost (irmo.dhcp.ti.com [128.247.58.167]) by legion.dal.design.ti.com (8.11.7p1+Sun/8.11.7) with ESMTP id v4OI9V317792; Wed, 24 May 2017 13:09:31 -0500 (CDT) From: Suman Anna To: Philipp Zabel , Rob Herring , Santosh Shilimkar Subject: [PATCH v5 1/2] Documentation: dt: reset: Add TI SCI reset binding Date: Wed, 24 May 2017 13:09:29 -0500 Message-ID: <20170524180930.9290-2-s-anna@ti.com> X-Mailer: git-send-email 2.12.0 In-Reply-To: <20170524180930.9290-1-s-anna@ti.com> References: <20170524180930.9290-1-s-anna@ti.com> MIME-Version: 1.0 X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20170524_110955_565507_FE463B1F X-CRM114-Status: GOOD ( 13.99 ) X-BeenThere: linux-arm-kernel@lists.infradead.org X-Mailman-Version: 2.1.21 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: Nishanth Menon , devicetree@vger.kernel.org, Dave Gerlach , linux-kernel@vger.kernel.org, "Andrew F. Davis" , Tero Kristo , linux-arm-kernel@lists.infradead.org Sender: "linux-arm-kernel" Errors-To: linux-arm-kernel-bounces+patchwork-linux-arm=patchwork.kernel.org@lists.infradead.org X-Virus-Scanned: ClamAV using ClamSMTP From: "Andrew F. Davis" Add TI SCI reset controller binding. This describes the DT binding details for a reset controller node providing reset management services to hardware blocks (reset consumers) using the Texas Instrument's System Control Interface (TI SCI) protocol to communicate to a system controller block present on the SoC. Signed-off-by: Andrew F. Davis [s-anna@ti.com: revise the binding format] Signed-off-by: Suman Anna Signed-off-by: Nishanth Menon Acked-by: Santosh Shilimkar Acked-by: Rob Herring --- Changes in v5: - Dropped the include/dt-bindings/reset/k2g.h file and its references - Updated description for the resets property in the TI-SCI Reset Consumer Nodes section - Updated the example as well to not use the macros from before .../devicetree/bindings/reset/ti,sci-reset.txt | 62 ++++++++++++++++++++++ MAINTAINERS | 1 + 2 files changed, 63 insertions(+) create mode 100644 Documentation/devicetree/bindings/reset/ti,sci-reset.txt diff --git a/Documentation/devicetree/bindings/reset/ti,sci-reset.txt b/Documentation/devicetree/bindings/reset/ti,sci-reset.txt new file mode 100644 index 000000000000..8b1cf022f18a --- /dev/null +++ b/Documentation/devicetree/bindings/reset/ti,sci-reset.txt @@ -0,0 +1,62 @@ +Texas Instruments System Control Interface (TI-SCI) Reset Controller +===================================================================== + +Some TI SoCs contain a system controller (like the Power Management Micro +Controller (PMMC) on Keystone 66AK2G SoC) that are responsible for controlling +the state of the various hardware modules present on the SoC. Communication +between the host processor running an OS and the system controller happens +through a protocol called TI System Control Interface (TI-SCI protocol). +For TI SCI details, please refer to the document, +Documentation/devicetree/bindings/arm/keystone/ti,sci.txt + +TI-SCI Reset Controller Node +============================ +This reset controller node uses the TI SCI protocol to perform the reset +management of various hardware modules present on the SoC. Must be a child +node of the associated TI-SCI system controller node. + +Required properties: +-------------------- + - compatible : Should be "ti,sci-reset" + - #reset-cells : Should be 2. Please see the reset consumer node below for + usage details. + +TI-SCI Reset Consumer Nodes +=========================== +Each of the reset consumer nodes should have the following properties, +in addition to their own properties. + +Required properties: +-------------------- + - resets : A phandle and reset specifier pair, one pair for each reset + signal that affects the device, or that the device manages. + The phandle should point to the TI-SCI reset controller node, + and the reset specifier should have 2 cell-values. The first + cell should contain the device ID. The second cell should + contain the reset mask value used by system controller. + Please refer to the protocol documentation for these values + to be used for different devices, + http://processors.wiki.ti.com/index.php/TISCI#66AK2G02_Data + +Please also refer to Documentation/devicetree/bindings/reset/reset.txt for +common reset controller usage by consumers. + +Example: +-------- +The following example demonstrates both a TI-SCI reset controller node and a +consumer (a DSP device) on the 66AK2G SoC. + +pmmc: pmmc { + compatible = "ti,k2g-sci"; + + k2g_reset: reset-controller { + compatible = "ti,sci-reset"; + #reset-cells = <2>; + }; +}; + +dsp0: dsp@10800000 { + ... + resets = <&k2g_reset 0x0046 0x1>; + ... +}; diff --git a/MAINTAINERS b/MAINTAINERS index f7d568b8f133..a4c48ec23a11 100644 --- a/MAINTAINERS +++ b/MAINTAINERS @@ -12630,6 +12630,7 @@ F: include/linux/soc/ti/ti_sci_protocol.h F: Documentation/devicetree/bindings/soc/ti/sci-pm-domain.txt F: include/dt-bindings/genpd/k2g.h F: drivers/soc/ti/ti_sci_pm_domains.c +F: Documentation/devicetree/bindings/reset/ti,sci-reset.txt THANKO'S RAREMONO AM/FM/SW RADIO RECEIVER USB DRIVER M: Hans Verkuil