From patchwork Wed Oct 26 19:39:36 2016 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Andrew Davis X-Patchwork-Id: 687332 Return-Path: X-Original-To: incoming-dt@patchwork.ozlabs.org Delivered-To: patchwork-incoming-dt@bilbo.ozlabs.org Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by ozlabs.org (Postfix) with ESMTP id 3t40kH2HLFz9srZ for ; Thu, 27 Oct 2016 06:40:55 +1100 (AEDT) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1756371AbcJZTk0 (ORCPT ); Wed, 26 Oct 2016 15:40:26 -0400 Received: from arroyo.ext.ti.com ([198.47.19.12]:45900 "EHLO arroyo.ext.ti.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S933616AbcJZTjz (ORCPT ); Wed, 26 Oct 2016 15:39:55 -0400 Received: from dflxv15.itg.ti.com ([128.247.5.124]) by arroyo.ext.ti.com (8.13.7/8.13.7) with ESMTP id u9QJddDJ008010; Wed, 26 Oct 2016 14:39:39 -0500 Received: from DFLE72.ent.ti.com (dfle72.ent.ti.com [128.247.5.109]) by dflxv15.itg.ti.com (8.14.3/8.13.8) with ESMTP id u9QJddBw005378; Wed, 26 Oct 2016 14:39:39 -0500 Received: from dflp32.itg.ti.com (10.64.6.15) by DFLE72.ent.ti.com (128.247.5.109) with Microsoft SMTP Server id 14.3.294.0; Wed, 26 Oct 2016 14:39:39 -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 u9QJdcKF028164; Wed, 26 Oct 2016 14:39:38 -0500 Received: from localhost (uda0226330.am.dhcp.ti.com [128.247.83.166]) by legion.dal.design.ti.com (8.11.7p1+Sun/8.11.7) with ESMTP id u9QJdc314142; Wed, 26 Oct 2016 14:39:38 -0500 (CDT) From: "Andrew F. Davis" To: Nishanth Menon , Tero Kristo , Santosh Shilimkar , Philipp Zabel , Rob Herring , Mark Rutland , Suman Anna CC: , , "Andrew F . Davis" Subject: [PATCH 1/3] Documentation: dt: reset: Add TI SCI reset binding Date: Wed, 26 Oct 2016 14:39:36 -0500 Message-ID: <20161026193938.25093-2-afd@ti.com> X-Mailer: git-send-email 2.10.1 In-Reply-To: <20161026193938.25093-1-afd@ti.com> References: <20161026193938.25093-1-afd@ti.com> MIME-Version: 1.0 Sender: devicetree-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: devicetree@vger.kernel.org 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 --- .../devicetree/bindings/reset/ti,sci-reset.txt | 68 ++++++++++++++++++++++ MAINTAINERS | 1 + 2 files changed, 69 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 0000000..189e284 --- /dev/null +++ b/Documentation/devicetree/bindings/reset/ti,sci-reset.txt @@ -0,0 +1,68 @@ +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 K2G 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. + +Required properties: +-------------------- + - compatible : Should be "ti,sci-reset" + - ti,sci : phandle to the TI SCI device to use for managing resets + - #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 values of which are + specified in the .h> include file. + The second cell should contain the reset mask value used by + system controller, the values of which are specified in the + include file .h>, where is the + name of the SoC involved, for example 'k2g'. + +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 K2G SoC. + +#include +#include + +/ { + soc { + k2g_reset: k2g_reset { + compatible = "ti,sci-reset"; + ti,sci = <&pmmc>; + #reset-cells = <2>; + }; + + dsp0: dsp0 { + ... + resets = <&k2g_reset K2G_DEV_CGEM0 K2G_DEV_CGEM0_DSP0_RESET>; + ... + }; + }; +}; diff --git a/MAINTAINERS b/MAINTAINERS index 6e93976..d8068df 100644 --- a/MAINTAINERS +++ b/MAINTAINERS @@ -11899,6 +11899,7 @@ F: drivers/soc/ti/ti_sci_pm_domains.c F: Documentation/devicetree/bindings/clock/ti,sci-clk.txt F: include/dt-bindings/clock/k2g.h F: drivers/clk/keystone/sci-clk.c +F: Documentation/devicetree/bindings/reset/ti,sci-reset.txt THANKO'S RAREMONO AM/FM/SW RADIO RECEIVER USB DRIVER M: Hans Verkuil