From patchwork Tue Mar 27 18:52:01 2018 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Rishabh Bhatnagar X-Patchwork-Id: 10311497 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 E9B8F60386 for ; Tue, 27 Mar 2018 18:54:20 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id D92BC29B89 for ; Tue, 27 Mar 2018 18:54:20 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id CBE0829B8D; Tue, 27 Mar 2018 18:54:20 +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 5841229B89 for ; Tue, 27 Mar 2018 18:54:19 +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=W7BtLGxa1wJjaAtPZCaPNEJLc940PiS9PGI0Cx9Kseo=; b=qcRY9KNjYAJUh0wZF9ooNT7OsW OQsP8lhDo44PBc4MUYrdlwT4syJF5I2BxCpJCY4yF9tQ5Ksa8DGSLT1qvDhvOtH32cKEZ1yhNO615 w9E8HCGzL9bCCJ3/o/F66JQxGQ3uB5V9yrTBYaYdsvyx+WEM3aEJWXets2uvqjAWf8hBw1RC8ppYS TNOt3YELYdnRbyfSJJbLLlTHF/OvavjCObmnKvohC39Dm281lIugRs4rYdN20NNE9zG6drzFGAIOO v8BzgsU8u/J9jUgrFGukFN7KKbKZAZc+w3c7ecrWbubC2Y3DiD/QmJZyUM+KTt3o0cz6ARAyRAfWm hpH9QCLA==; 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 1f0tjb-0006J1-0m; Tue, 27 Mar 2018 18:54:15 +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 1f0tjE-00062P-IM; Tue, 27 Mar 2018 18:53:54 +0000 Received: by smtp.codeaurora.org (Postfix, from userid 1000) id D21E460C54; Tue, 27 Mar 2018 18:53:40 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=codeaurora.org; s=default; t=1522176820; bh=kie/+NtkRMbn15PkNxKP/suE8nh1rOUXbWAdS4Fq72U=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=Vf1TAp4aUIhYrQzV/k0btknqN1ecMVdViir+Maxo88JQdzMPlSxaI6tGyvT91HKJZ OAl/0Xblyu94gx5wnwUl2fFBR+lHn8+jSYQTiFeEQGysA4uFBTgJXHey2mR3hWkWXf DdCYr1IsVNDRG+XCUuKe57zVRl/HdMvwhugLTmZs= 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 20AC6602FC; Tue, 27 Mar 2018 18:53:40 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=codeaurora.org; s=default; t=1522176820; bh=kie/+NtkRMbn15PkNxKP/suE8nh1rOUXbWAdS4Fq72U=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=Vf1TAp4aUIhYrQzV/k0btknqN1ecMVdViir+Maxo88JQdzMPlSxaI6tGyvT91HKJZ OAl/0Xblyu94gx5wnwUl2fFBR+lHn8+jSYQTiFeEQGysA4uFBTgJXHey2mR3hWkWXf DdCYr1IsVNDRG+XCUuKe57zVRl/HdMvwhugLTmZs= DMARC-Filter: OpenDMARC Filter v1.3.2 smtp.codeaurora.org 20AC6602FC 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 v3 1/2] Documentation: Documentation for qcom, llcc Date: Tue, 27 Mar 2018 11:52:01 -0700 Message-Id: <1522176722-12691-2-git-send-email-rishabhb@codeaurora.org> X-Mailer: git-send-email 1.9.1 In-Reply-To: <1522176722-12691-1-git-send-email-rishabhb@codeaurora.org> References: <1522176722-12691-1-git-send-email-rishabhb@codeaurora.org> X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20180327_115352_643891_852AA9E1 X-CRM114-Status: GOOD ( 14.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. 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 -- 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..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>; + };