From patchwork Wed Jan 4 18:05:13 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: Conor Dooley X-Patchwork-Id: 13088828 X-Patchwork-Delegate: palmer@dabbelt.com Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from bombadil.infradead.org (bombadil.infradead.org [198.137.202.133]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.lore.kernel.org (Postfix) with ESMTPS id 7E2F0C4332F for ; Wed, 4 Jan 2023 18:06:06 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=lists.infradead.org; s=bombadil.20210309; h=Sender: Content-Transfer-Encoding:Content-Type:List-Subscribe:List-Help:List-Post: List-Archive:List-Unsubscribe:List-Id:MIME-Version:References:In-Reply-To: Message-Id:Date:Subject:Cc:To:From:Reply-To:Content-ID:Content-Description: Resent-Date:Resent-From:Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID: List-Owner; bh=/r2E9veJxvu9CivCBZNThgRTYsWHwOJTQ6qaZYNm9L8=; b=Z88y97DsiQyG1y i6IcrZl9Kwnqs1laCWJV8VTniZwsXHR3YT7izpNNoIt+6SZ6NkPecRfw6S7lQfU4sjIsuWyiwV3A1 kZpMcZwEW+31RZVUmR4Lrf5vQ99DMep//gmOTq6gwFyW0EYwwA/xWQuBAoz+qjN+3Uaaxms8EhAWk gK0Fd+yj/zhEJ09fEAnQz4B2K5onuiRKYGn4SwoiE26NIpGZXL8gxAmklKauU9rSrUl8+7ZcD+80t BNXlV0vN/U3rxNbTAuOSZP0wkzqHXaJszGJvHB04K4Di2OElZwYOM5KMUljGB1W+fYWp8RBdFLpgV Xivzy5nbUplTO5Fkj1jA==; Received: from localhost ([::1] helo=bombadil.infradead.org) by bombadil.infradead.org with esmtp (Exim 4.94.2 #2 (Red Hat Linux)) id 1pD89H-00AqLz-9M; Wed, 04 Jan 2023 18:05:59 +0000 Received: from ams.source.kernel.org ([2604:1380:4601:e00::1]) by bombadil.infradead.org with esmtps (Exim 4.94.2 #2 (Red Hat Linux)) id 1pD89A-00AqIc-QI for linux-riscv@lists.infradead.org; Wed, 04 Jan 2023 18:05:54 +0000 Received: from smtp.kernel.org (relay.kernel.org [52.25.139.140]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ams.source.kernel.org (Postfix) with ESMTPS id F2E58B81892; Wed, 4 Jan 2023 18:05:49 +0000 (UTC) Received: by smtp.kernel.org (Postfix) with ESMTPSA id CF8A6C43396; Wed, 4 Jan 2023 18:05:45 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1672855548; bh=SpxUfboVfaSWtvMSqW0B+NZAeloH/U4lZdg9RHU4N3c=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=MZyaK10kBqxH/xTpI6ZGaW6VYehCAWKr4pIlLC7OEE5Psip32Y1FhtVa0esLwfIWY Ucp6yTs8EtQAPPX4mLo3Z0ezzgA37F2YHznb+fLhEx2N2Vsiozsi1dpb98R05e6Ji3 4lWe9XtR83YxVnriLYZOjZoD2Sp03q5B3sQZFdiYvC0KSoh0qTalDm+0MMI1dNhr8z Mu2JoS+NnX8D5IS6VbhLD60LXXuhyR3tndeHWHxA+zpNdiLGT55SteqzINdxY19xN0 huKDkhxNkaJr+cINkBg+nXZEYk/SkmnOnyfa/Aav1Ilklsd5dRp5MyPBymK33013/p t9ImPPAILndaA== From: Conor Dooley To: palmer@dabbelt.com Cc: conor@kernel.org, Conor Dooley , Ley Foon Tan , Sudeep Holla , Rob Herring , Krzysztof Kozlowski , Jonathan Corbet , Alex Shi , Yanteng Si , Lorenzo Pieralisi , devicetree@vger.kernel.org, linux-kernel@vger.kernel.org, linux-riscv@lists.infradead.org, linux-doc@vger.kernel.org Subject: [PATCH v1 1/2] dt-bindings: arm: move cpu-capacity to a shared loation Date: Wed, 4 Jan 2023 18:05:13 +0000 Message-Id: <20230104180513.1379453-2-conor@kernel.org> X-Mailer: git-send-email 2.39.0 In-Reply-To: <20230104180513.1379453-1-conor@kernel.org> References: <20230104180513.1379453-1-conor@kernel.org> MIME-Version: 1.0 X-Developer-Signature: v=1; a=openpgp-sha256; l=4078; i=conor.dooley@microchip.com; h=from:subject; bh=EHhLKTpL8b24ylcqPJCu6roLTdkZjz8WegHWiaxDAkY=; b=owGbwMvMwCFWscWwfUFT0iXG02pJDMlb91+c0cf+KyCreJNWx16FJ+++CThmLNT2+X5p868tcjfN H29431HKwiDGwSArpsiSeLuvRWr9H5cdzj1vYeawMoEMYeDiFICJ/O5n+O/29NHEsKfOfOqBdjd+b/ /64NeTzX2i7xX/C1jdWFCg47COkWGp9LYpxfppoocYSyYqhum2eh2Y86/V/sqUG2sjGEKfsDMCAA== X-Developer-Key: i=conor.dooley@microchip.com; a=openpgp; fpr=F9ECA03CF54F12CD01F1655722E2C55B37CF380C X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20230104_100553_197542_307D2EFA X-CRM114-Status: GOOD ( 15.34 ) X-BeenThere: linux-riscv@lists.infradead.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: "linux-riscv" Errors-To: linux-riscv-bounces+linux-riscv=archiver.kernel.org@lists.infradead.org From: Conor Dooley RISC-V uses the same generic topology code as arm64 & while there currently exists no binding for cpu-capacity on RISC-V, the code paths can be hit if the property is present. Move the documentation of cpu-capacity to a shared location, ahead of defining a binding for capacity-dmips-mhz on RISC-V. Update some references to this document in the process. Signed-off-by: Conor Dooley Reviewed-by: Ley Foon Tan Acked-by: Rob Herring Reviewed-by: Yanteng Si --- I wasn't sure what to do with reference [1], but since the property will be the same on RISC-V, I left it as is. --- Documentation/devicetree/bindings/arm/cpus.yaml | 2 +- .../devicetree/bindings/{arm => cpu}/cpu-capacity.txt | 4 ++-- Documentation/scheduler/sched-capacity.rst | 2 +- Documentation/translations/zh_CN/scheduler/sched-capacity.rst | 2 +- 4 files changed, 5 insertions(+), 5 deletions(-) rename Documentation/devicetree/bindings/{arm => cpu}/cpu-capacity.txt (98%) diff --git a/Documentation/devicetree/bindings/arm/cpus.yaml b/Documentation/devicetree/bindings/arm/cpus.yaml index 01b5a9c689a2..a7586295a6f5 100644 --- a/Documentation/devicetree/bindings/arm/cpus.yaml +++ b/Documentation/devicetree/bindings/arm/cpus.yaml @@ -257,7 +257,7 @@ properties: capacity-dmips-mhz: description: - u32 value representing CPU capacity (see ./cpu-capacity.txt) in + u32 value representing CPU capacity (see ../cpu/cpu-capacity.txt) in DMIPS/MHz, relative to highest capacity-dmips-mhz in the system. diff --git a/Documentation/devicetree/bindings/arm/cpu-capacity.txt b/Documentation/devicetree/bindings/cpu/cpu-capacity.txt similarity index 98% rename from Documentation/devicetree/bindings/arm/cpu-capacity.txt rename to Documentation/devicetree/bindings/cpu/cpu-capacity.txt index cc5e190390b7..f28e1adad428 100644 --- a/Documentation/devicetree/bindings/arm/cpu-capacity.txt +++ b/Documentation/devicetree/bindings/cpu/cpu-capacity.txt @@ -1,12 +1,12 @@ ========================================== -ARM CPUs capacity bindings +CPU capacity bindings ========================================== ========================================== 1 - Introduction ========================================== -ARM systems may be configured to have cpus with different power/performance +Some systems may be configured to have cpus with different power/performance characteristics within the same chip. In this case, additional information has to be made available to the kernel for it to be aware of such differences and take decisions accordingly. diff --git a/Documentation/scheduler/sched-capacity.rst b/Documentation/scheduler/sched-capacity.rst index 805f85f330b5..8e2b8538bc2b 100644 --- a/Documentation/scheduler/sched-capacity.rst +++ b/Documentation/scheduler/sched-capacity.rst @@ -260,7 +260,7 @@ for that purpose. The arm and arm64 architectures directly map this to the arch_topology driver CPU scaling data, which is derived from the capacity-dmips-mhz CPU binding; see -Documentation/devicetree/bindings/arm/cpu-capacity.txt. +Documentation/devicetree/bindings/cpu/cpu-capacity.txt. 3.2 Frequency invariance ------------------------ diff --git a/Documentation/translations/zh_CN/scheduler/sched-capacity.rst b/Documentation/translations/zh_CN/scheduler/sched-capacity.rst index 3a52053c29dc..e07ffdd391d3 100644 --- a/Documentation/translations/zh_CN/scheduler/sched-capacity.rst +++ b/Documentation/translations/zh_CN/scheduler/sched-capacity.rst @@ -233,7 +233,7 @@ CFS调度类基于实体负载跟踪机制（Per-Entity Load Tracking, PELT） arm和arm64架构直接把这个信息映射到arch_topology驱动的CPU scaling数据中（译注：参考 arch_topology.h的percpu变量cpu_scale），它是从capacity-dmips-mhz CPU binding中衍生计算 -出来的。参见Documentation/devicetree/bindings/arm/cpu-capacity.txt。 +出来的。参见Documentation/devicetree/bindings/cpu/cpu-capacity.txt。 3.2 频率不变性 --------------