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: 100451 Delivered-To: patch@linaro.org Received: by 10.182.142.97 with SMTP id rv1csp482707obb; Wed, 24 May 2017 11:10:35 -0700 (PDT) X-Received: by 10.99.186.78 with SMTP id l14mr40088752pgu.182.1495649435103; Wed, 24 May 2017 11:10:35 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1495649435; cv=none; d=google.com; s=arc-20160816; b=B+2/+vFwiuuTWGDDNk3dlKOgN3VSLhXMkz4pPC/qHbUS3mxkiWq/SyZQd85RZLGcdE J1Eq0A44BSKEWNEmHT90vVISekq/gw9FG074YHjFeqfJt02TNvnzHKWaVY4Ms9cNG0As P7mzqAlcdppoaMf2WL2f5q8Ra3wVUTvQoIm++iM8mp0WD2tAR0P3wMf+AXh6hI1LuBsr AsDhi2bo7/M3J67vKB18exs8qUzUl65JgsLbbEMtvszni+zd8iJiZg0eSNiVCeSBm9/Y EMjLJY+vQHxCX1Lw6mTMcaH5VHr04iFLhaOywZq1fInw6DcK6UJ45WrMJgRkGXYnSq4Y dvkQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:sender:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:dkim-signature :arc-authentication-results; bh=4djrMgbfytMw6MP0r9vZmyOSyS3PpoK5R9IjrcjxBd8=; b=UFa66D9rkDB/kJ7RT0HE63P4Hlk6GAlb5yd8QrE7X4AtP1W5ypr4eL5LG7/6j8b5Mv Aw0xdvgk2ny6ctDyETV4dC0Wto7trH9IXpdl4DXeE5dG4NMMIz68kjNR+zk97k96DCmt xkRbDqWKwVRzFAIJyof1ZKop9WDGUw4d2SJtPwOgX9oMsOs9YZeFj65aTy8AROCvbCqL NkFJuOzpXrS/t6vpChfDQr2UIKODeS74+2v9C6I1ICYw48IJPFf3AwqaY5KmWYdLiU7w RkquTL1ShpxxSsdByPhVRbTyoudlKhy4BEK+rbt6cPa3EEoD8xbYwRdH5V8KafjoTUig bEpw== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@ti.com; spf=pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=QUARANTINE sp=NONE dis=NONE) header.from=ti.com Return-Path: Received: from vger.kernel.org (vger.kernel.org. [209.132.180.67]) by mx.google.com with ESMTP id a5si9942927plh.320.2017.05.24.11.10.34; Wed, 24 May 2017 11:10:35 -0700 (PDT) Received-SPF: pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) client-ip=209.132.180.67; Authentication-Results: mx.google.com; dkim=pass header.i=@ti.com; spf=pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=QUARANTINE sp=NONE dis=NONE) header.from=ti.com Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S933231AbdEXSKP (ORCPT + 25 others); Wed, 24 May 2017 14:10:15 -0400 Received: from fllnx210.ext.ti.com ([198.47.19.17]:15608 "EHLO fllnx210.ext.ti.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S933033AbdEXSKG (ORCPT ); Wed, 24 May 2017 14:10:06 -0400 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 CC: , , , "Andrew F. Davis" , Tero Kristo , Nishanth Menon , Dave Gerlach , Suman Anna 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 Sender: linux-kernel-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org 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 -- 2.12.0 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