From patchwork Mon Apr 23 23:09:31 2018 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Rishabh Bhatnagar X-Patchwork-Id: 10358237 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 3E3986019D for ; Mon, 23 Apr 2018 23:12:06 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id 3419D28C87 for ; Mon, 23 Apr 2018 23:12:06 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id 2847428C8E; Mon, 23 Apr 2018 23:12:06 +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=-2.9 required=2.0 tests=BAYES_00,DKIM_SIGNED, DKIM_VALID,MAILING_LIST_MULTI autolearn=unavailable version=3.3.1 Received: from bombadil.infradead.org (bombadil.infradead.org [198.137.202.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 9167728C87 for ; Mon, 23 Apr 2018 23:12:05 +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:MIME-Version:Cc:List-Subscribe: List-Help:List-Post:List-Archive:List-Unsubscribe:List-Id: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=Mycc0eWy8/ZYUXXiLrg35XzvFLRPLtjno23zHQugP2c=; b=R16d8sVR6yYcGkhbMOBUG4biY8 zGeWaGo3avf3cVTeF6LbaanT+IKNaY3pZZx5RzrMYoADan2HAXSwR+b1e8dEnS8ibsMasT5vTK/c3 Pez+7Ma6jpbcAhj+YEef3w8v8xlFv1hxxU3V2af4PK6C+Gr8ow1VWkXjjU0QMLBqxqTd3LWiAMGPm F1dBvjR2/adHNXQ1sNG1XBxhHFUi8vbOQr8SYjgh4IK6pyYUl499CHx9X1mt+fBfeAl+yunkSw5Si GLcH2daxW6UyOZhqQPRp7vJPWIsfIvos1w075yOxIDc5vv4HNoabXdMdnxK/Bfkx4VyIkiRF7ldMP k9L91/hQ==; Received: from localhost ([127.0.0.1] helo=bombadil.infradead.org) by bombadil.infradead.org with esmtp (Exim 4.90_1 #2 (Red Hat Linux)) id 1fAkcm-0001Sx-5n; Mon, 23 Apr 2018 23:11:56 +0000 Received: from smtp.codeaurora.org ([198.145.29.96]) by bombadil.infradead.org with esmtps (Exim 4.90_1 #2 (Red Hat Linux)) id 1fAkc8-000171-7D; Mon, 23 Apr 2018 23:11:18 +0000 Received: by smtp.codeaurora.org (Postfix, from userid 1000) id A621A60C65; Mon, 23 Apr 2018 23:11:01 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=codeaurora.org; s=default; t=1524525061; bh=gayl6C+0/mWoYzFAVSQ6zl6G9Js3YvbOPNj8m5/fI/s=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=l+NVCv0LUY8sJpaSJPPinlDdZVzUwXlwsTSgBfFOVlPj42WK1IFCSftxmVpGj9I1v ZBH5+3dYzr6ZdBqDDxTowmXnLkMT27Ckd7F9n/UB6oEUReOblsHb2YeBNeMH9bnVC+ 2hssA5tchXwMZCYO2CFYlxhO2big9GjDQ2kUWyHU= Received: from rishabhb-linux.qualcomm.com (i-global254.qualcomm.com [199.106.103.254]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-SHA256 (128/128 bits)) (No client certificate requested) (Authenticated sender: rishabhb@smtp.codeaurora.org) by smtp.codeaurora.org (Postfix) with ESMTPSA id DD6866072E; Mon, 23 Apr 2018 23:11:00 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=codeaurora.org; s=default; t=1524525061; bh=gayl6C+0/mWoYzFAVSQ6zl6G9Js3YvbOPNj8m5/fI/s=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=l+NVCv0LUY8sJpaSJPPinlDdZVzUwXlwsTSgBfFOVlPj42WK1IFCSftxmVpGj9I1v ZBH5+3dYzr6ZdBqDDxTowmXnLkMT27Ckd7F9n/UB6oEUReOblsHb2YeBNeMH9bnVC+ 2hssA5tchXwMZCYO2CFYlxhO2big9GjDQ2kUWyHU= DMARC-Filter: OpenDMARC Filter v1.3.2 smtp.codeaurora.org DD6866072E Authentication-Results: pdx-caf-mail.web.codeaurora.org; dmarc=none (p=none dis=none) header.from=codeaurora.org Authentication-Results: pdx-caf-mail.web.codeaurora.org; spf=none smtp.mailfrom=rishabhb@codeaurora.org From: Rishabh Bhatnagar To: linux-arm-kernel@lists.infradead.org, linux-arm-msm@vger.kernel.org, devicetree@vger.kernel.org Subject: [PATCH v5 1/2] dt-bindings: Documentation for qcom, llcc Date: Mon, 23 Apr 2018 16:09:31 -0700 Message-Id: <1524524972-12014-2-git-send-email-rishabhb@codeaurora.org> X-Mailer: git-send-email 1.9.1 In-Reply-To: <1524524972-12014-1-git-send-email-rishabhb@codeaurora.org> References: <1524524972-12014-1-git-send-email-rishabhb@codeaurora.org> X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20180423_161116_296707_665A6970 X-CRM114-Status: GOOD ( 11.73 ) 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: tsoni@codeaurora.org, robh@kernel.org, kyan@codeaurora.org, ckadabi@codeaurora.org, linux-kernel@vger.kernel.org, evgreen@chromium.org, Rishabh Bhatnagar , linux-arm@lists.infradead.org MIME-Version: 1.0 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 Documentation for last level cache controller device tree bindings, client bindings usage examples. Signed-off-by: Channagoud Kadabi Signed-off-by: Rishabh Bhatnagar --- .../devicetree/bindings/arm/msm/qcom,llcc.txt | 60 ++++++++++++++++++++++ 1 file changed, 60 insertions(+) create mode 100644 Documentation/devicetree/bindings/arm/msm/qcom,llcc.txt -- The Qualcomm Innovation Center, Inc. is a member of the Code Aurora Forum, a Linux Foundation Collaborative Project diff --git a/Documentation/devicetree/bindings/arm/msm/qcom,llcc.txt b/Documentation/devicetree/bindings/arm/msm/qcom,llcc.txt new file mode 100644 index 0000000..c30d433 --- /dev/null +++ b/Documentation/devicetree/bindings/arm/msm/qcom,llcc.txt @@ -0,0 +1,60 @@ +== Introduction== + +LLCC (Last Level Cache Controller) provides last level of cache memory in SOC, +that can be shared by multiple clients. Clients here are different cores in the +SOC, the idea is to minimize the local caches at the clients and migrate to +common pool of memory. Cache memory is divided into partitions called slices +which are assigned to clients. Clients can query the slice details, activate +and deactivate them. + +Properties: +- compatible: + Usage: required + Value type: + Definition: must be "qcom,sdm845-llcc" + +- reg: + Usage: required + Value Type: + Definition: Start address and the range of the LLCC registers. + +- #cache-cells: + Usage: required + Value Type: + Definition: Number of cache cells, must be 1 + +- max-slices: + usage: required + Value Type: + Definition: Number of cache slices supported by hardware + +Example: + + llcc: qcom,llcc@1100000 { + compatible = "qcom,sdm845-llcc"; + reg = <0x1100000 0x250000>; + #cache-cells = <1>; + max-slices = <32>; + }; + +== Client == + +Properties: +- cache-slice-names: +Usage: required + Value type: + Definition: A set of names that identify the usecase names of a + client that uses cache slice. These strings are + used to look up the cache slice entries by name. + +- cache-slices: + Usage: required + Value type: + Definition: The tuple has phandle to llcc device as the first + argument and the second argument is the usecase + id of the client. +For Example: + venus { + cache-slice-names = "vidsc0", "vidsc1"; + cache-slices = <&llcc VIDSC0_ID>, <&llcc VIDSC1_ID>; + };