From patchwork Thu Oct 27 21:49:39 2016 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Andrew Davis X-Patchwork-Id: 687969 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 3t4gXp2Cmtz9syB for ; Fri, 28 Oct 2016 08:50:02 +1100 (AEDT) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S964808AbcJ0VuB (ORCPT ); Thu, 27 Oct 2016 17:50:01 -0400 Received: from devils.ext.ti.com ([198.47.26.153]:44014 "EHLO devils.ext.ti.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S938562AbcJ0Vt5 (ORCPT ); Thu, 27 Oct 2016 17:49:57 -0400 Received: from dlelxv90.itg.ti.com ([172.17.2.17]) by devils.ext.ti.com (8.13.7/8.13.7) with ESMTP id u9RLng61007683; Thu, 27 Oct 2016 16:49:42 -0500 Received: from DFLE73.ent.ti.com (dfle73.ent.ti.com [128.247.5.110]) by dlelxv90.itg.ti.com (8.14.3/8.13.8) with ESMTP id u9RLngAt025677; Thu, 27 Oct 2016 16:49:42 -0500 Received: from dflp33.itg.ti.com (10.64.6.16) by DFLE73.ent.ti.com (128.247.5.110) with Microsoft SMTP Server id 14.3.294.0; Thu, 27 Oct 2016 16:49:41 -0500 Received: from legion.dal.design.ti.com (legion.dal.design.ti.com [128.247.22.53]) by dflp33.itg.ti.com (8.14.3/8.13.8) with ESMTP id u9RLnfjd024625; Thu, 27 Oct 2016 16:49:41 -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 u9RLnf317421; Thu, 27 Oct 2016 16:49:41 -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 v2 1/3] Documentation: dt: reset: Add TI SCI reset binding Date: Thu, 27 Oct 2016 16:49:39 -0500 Message-ID: <20161027214941.24641-2-afd@ti.com> X-Mailer: git-send-email 2.10.1 In-Reply-To: <20161027214941.24641-1-afd@ti.com> References: <20161027214941.24641-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 | 65 ++++++++++++++++++++++ MAINTAINERS | 1 + 2 files changed, 66 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..cb00679 --- /dev/null +++ b/Documentation/devicetree/bindings/reset/ti,sci-reset.txt @@ -0,0 +1,65 @@ +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" + - #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 + +pmmc: pmmc { + compatible = "ti,k2g-sci"; + + k2g_reset: k2g_reset { + compatible = "ti,sci-reset"; + #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