From patchwork Sun Mar 25 01:29:15 2018 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Rishabh Bhatnagar X-Patchwork-Id: 10307011 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 C18ED60212 for ; Sun, 25 Mar 2018 23:24:37 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id B5C5529139 for ; Sun, 25 Mar 2018 23:24:37 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id AA69E29172; Sun, 25 Mar 2018 23:24:37 +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=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 4625D29139 for ; Sun, 25 Mar 2018 23:24:36 +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=kJ+YatPQKiamV3yWZAUO8QwbFkv9iuwu2RwIQn6dRZA=; b=agELjzrjM3RP5tL/nn3ma27gYo 1VtluMy+eDsrVJX9zOm5CdkYs8HHwJitD9+3Av6xx68cfnhRv67In37zLLOXUZDMlsJ7gOHnN4oBj da1UfJwU7TDr7Q+ILgvnYtSM9UAfnEQdVQgmrdBUPoHIZA+tD2ITn1lHAWE94J7GU/+3EON/7ESlk E73vByzTUNhdIz3xq7iYaQaS0+nLmUgvJI6iDllFNWDKnQ/Pws9YbykDBj1Qz7Z3aHohDgceJKdSW btRUbmsYrWZ4z4SigHlQ8C7fmceRi84P8LCPzUIOtmriQ7T58lW2VNVC/E4AhcJpTtJewt9xz2DSM Wv7rSM6Q==; 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 1f0Ezz-0003je-Qk; Sun, 25 Mar 2018 23:24:27 +0000 Received: from merlin.infradead.org ([2001:8b0:10b:1231::1]) by bombadil.infradead.org with esmtps (Exim 4.90_1 #2 (Red Hat Linux)) id 1f0Emu-0006ba-K7; Sun, 25 Mar 2018 23:10:56 +0000 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=infradead.org; s=merlin.20170209; h=References:In-Reply-To:Message-Id:Date: Subject:Cc:To:From:Sender:Reply-To:MIME-Version:Content-Type: Content-Transfer-Encoding:Content-ID:Content-Description:Resent-Date: Resent-From:Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID:List-Id: List-Help:List-Unsubscribe:List-Subscribe:List-Post:List-Owner:List-Archive; bh=F4sqCWW3mARh9CYCwrBgP04cT7uoS60SXuR1vM5RD4s=; b=xYUVnkf0S6MsG5spFJQ6IVKN9 L1xK3s9rUNEL+HYAh4HmG8VwNjRbx06iC2n/Rh6OgonGDW6JO+pi1j5lpWBPxYYeph7+WMgk9H8fp NVCIjIPm5iFSlPGoqFWN92tGV5OPgt35JnBwgfZVNmNf6V/AJnxAWAjIryOpPkQgwejEd6xLeP1bO naeWV86kBTsmR/XrlYRNXwRJVR4T0R9GWH2nKvSJ7/FJ6XZ2jzOl/05hRixyFEiF3jAsj5C26bTek AaXfsvXYifd1W0hO6BP8RhxXKoMfrA3NTLQ5IXmbxboRNRKhQ9w+k3lcmX2wvgptbmlEV1AFnooey up2iTl2GA==; Received: from smtp.codeaurora.org ([198.145.29.96]) by merlin.infradead.org with esmtps (Exim 4.90_1 #2 (Red Hat Linux)) id 1ezuUk-0005da-VM; Sun, 25 Mar 2018 01:30:52 +0000 Received: by smtp.codeaurora.org (Postfix, from userid 1000) id 6354D607B9; Sun, 25 Mar 2018 01:30:04 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=codeaurora.org; s=default; t=1521941404; bh=sKq/RRxvNLwyJLtwj72KrAxapGFnxSI/HS1zLWW/Z4U=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=JROT6HT1YDGK94gIIojTA4lrlUWcjksZXNTieRwTCbhH8ACTukIJ7ptiZ8ru7a/Dj W78uitlXef0kvXmZKZdH5HcqzD8Cj09p7t1ShFHrM1c3ffXuKbhVBDcmqAVcuob4Gw zDKMJ/3Ip6u3fgJetpsoPFJeStaLtOVt24vMCB+M= 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 A9080601D3; Sun, 25 Mar 2018 01:30:03 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=codeaurora.org; s=default; t=1521941404; bh=sKq/RRxvNLwyJLtwj72KrAxapGFnxSI/HS1zLWW/Z4U=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=JROT6HT1YDGK94gIIojTA4lrlUWcjksZXNTieRwTCbhH8ACTukIJ7ptiZ8ru7a/Dj W78uitlXef0kvXmZKZdH5HcqzD8Cj09p7t1ShFHrM1c3ffXuKbhVBDcmqAVcuob4Gw zDKMJ/3Ip6u3fgJetpsoPFJeStaLtOVt24vMCB+M= DMARC-Filter: OpenDMARC Filter v1.3.2 smtp.codeaurora.org A9080601D3 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 Subject: [PATCH v2 1/2] Documentation: Documentation for qcom, llcc Date: Sat, 24 Mar 2018 18:29:15 -0700 Message-Id: <1521941356-12361-2-git-send-email-rishabhb@codeaurora.org> X-Mailer: git-send-email 1.9.1 In-Reply-To: <1521941356-12361-1-git-send-email-rishabhb@codeaurora.org> References: <1521941356-12361-1-git-send-email-rishabhb@codeaurora.org> X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20180324_213051_172223_B686A5A1 X-CRM114-Status: GOOD ( 18.28 ) 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, kyan@codeaurora.org, ckadabi@codeaurora.org, linux-kernel@vger.kernel.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. Change-Id: Ic2d6d6154ab8269cfce6828e9f2250320a0572e8 Signed-off-by: Channagoud Kadabi Signed-off-by: Rishabh Bhatnagar --- .../devicetree/bindings/arm/msm/qcom,llcc.txt | 70 ++++++++++++++++++++++ 1 file changed, 70 insertions(+) create mode 100644 Documentation/devicetree/bindings/arm/msm/qcom,llcc.txt 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..ceb20a4 --- /dev/null +++ b/Documentation/devicetree/bindings/arm/msm/qcom,llcc.txt @@ -0,0 +1,70 @@ +== Introduction== + +LLCC (Last Level Cache Controller) driver is implemented as a platform device. +The driver Programs the SCT (system configuration table). The SCT programming +divides the system cache into slices. Each slice is assigned an ID A.K.A +SCID(Sub-cache ID). +HW modules that are designated to use the system cache are known as clients. +Each client must also be represented as a node in the device tree just like +any other hw module. +One client can have multiple SCID's assigned meaning each client could get +multiple slices in the cache. Client can use the slices for various pre-defined +usecases. Each client defines a set of names for these usecases in its +device tree binding. +Client makes a request to LLCC device to get cache-slices properties for each +of its usecase. Client gets the information like cache slice ID and size of the +cache slice. + +== llcc device == + +Properties: +- compatible: + Usage: required + Value type: + Definition: must be "qcom,sdm855-llcc" + +- reg: + Usage: required + Value Type: + Definition: must be addresses and sizes 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,sdm855-llcc@01100000 { + compatible = "qcom,sdm845-llcc"; + reg = <0x01100000 0x250000>; + #cache-cells = <1>; + max-slices = <32>; + }; + +== Client == + +Required 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 2>, <&llcc 3>; + };