From patchwork Mon Oct 29 09:43:05 2018 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Viresh Kumar X-Patchwork-Id: 10658989 Return-Path: Received: from mail.wl.linuxfoundation.org (pdx-wl-mail.web.codeaurora.org [172.30.200.125]) by pdx-korg-patchwork-2.web.codeaurora.org (Postfix) with ESMTP id D3AD213A9 for ; Mon, 29 Oct 2018 09:46:36 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id C2A8C296EF for ; Mon, 29 Oct 2018 09:46:36 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id B4AF929870; Mon, 29 Oct 2018 09:46:36 +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,RCVD_IN_DNSWL_NONE autolearn=ham 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 2D777296EF for ; Mon, 29 Oct 2018 09:46: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:Cc:List-Subscribe:List-Help:List-Post: List-Archive:List-Unsubscribe:List-Id:MIME-Version: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:In-Reply-To:References: List-Owner; bh=Tm/bFq7YZEgO/9/YbdAg+f30WypmspelN5lWybJ52Uk=; b=CMqXUS8G/yEX8z TKYDdpOHBj/zaXTrH2xgljuW3l+E9Yvv+ZL4KfMJKkatYnnE9gviHZGoZWDDH2VqG8XiX18/1EAtx TgP9rH0a3KwGXmNRQ4ydEj/X7YWXG47UBn+c5r11Mm/4Guc9clCC5n1j20RyM/pDM51wniQlE7WFW c+D5dwTNgqtbzOv6V9c/9903fM+U/nm/jkb2uFT4sImZyXiv7UBQkfE8/eH7iz5bKp21OKUYMkBFI XZnKZ/INAwIWy+glQ1sg8oVL22w6/pHJ/Ch/y2Ltwege/lrR1Y6bEwqPxUT7ckqqx+j8zEUASNgcV l4WkIGAUBA54K9nBuh/Q==; 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 1gH47y-00011J-9P; Mon, 29 Oct 2018 09:46:30 +0000 Received: from mail-pg1-x542.google.com ([2607:f8b0:4864:20::542]) by bombadil.infradead.org with esmtps (Exim 4.90_1 #2 (Red Hat Linux)) id 1gH452-0006rG-0F for linux-arm-kernel@lists.infradead.org; Mon, 29 Oct 2018 09:43:49 +0000 Received: by mail-pg1-x542.google.com with SMTP id m9-v6so903411pgl.13 for ; Mon, 29 Oct 2018 02:43:17 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=linaro.org; s=google; h=from:to:cc:subject:date:message-id:mime-version :content-transfer-encoding; bh=5RZ9FHApH+90jKzx3eFzIgtrpa6PgcJbkx7WWuT0bFI=; b=h4QcNkmAY1KJlxXLbVpKirKOIircySyjrVBhw99VhliOHE5iMiIXYAPV+wJVjNoizm erZeGDdSwmccg65uQ5rwAISY/O5KolymTm4b0U2th7L0u7x/F33EJ0qGSKK07iaJVR9m Vrcmpijg9OzG8gL4mPTeZyTIVXBTrOA3zCQnc= X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:date:message-id:mime-version :content-transfer-encoding; bh=5RZ9FHApH+90jKzx3eFzIgtrpa6PgcJbkx7WWuT0bFI=; b=Wk9fEKOLaBH3tYc+KnnqyJSa6qM2qyJ4Gwd33htXP7I3HdnxuGcFWP6onW7Nl0BqVa HbcipWjXxkwDydagOxxL/VeL1Sma6UNvRbpXzxdVQI6gAjrlenPZVe97z1yZuKRoo7cV JRBSCRVxmK4oSNfTmM5SnG2f+kWdzcTUbYGWESRoTVYkeg8iUkZAsOanJoQvXXVNYMyg FjxAlg9Rg3Qh7duIMHlFqcCPgo7cxVu+vHoEbGolUzT6pZJKICnxUJQhSPbfGqRg4Q4G 01AwgE3pLb2ClzisHS0j9yzugioYaCZI8+jqwRO+emw81TX1IIzlGZwk0JnJOR0Yl0G6 jJNw== X-Gm-Message-State: AGRZ1gIYqaiJRh2sdlwHevh/wb9fjLJhi82I4SH3DIKO8winoqJjGKdG MtG/fiOYiwcoZLpO7utcbbc4yg== X-Google-Smtp-Source: AJdET5cApD6yK8qe+qCer3t7aPJHFl46Z0z1V8X3x/sCRLJCfcOI+ETy7UK/9iP36S8xqW5lkQ4kBQ== X-Received: by 2002:a63:5308:: with SMTP id h8-v6mr12856854pgb.358.1540806196626; Mon, 29 Oct 2018 02:43:16 -0700 (PDT) Received: from localhost ([122.172.56.94]) by smtp.gmail.com with ESMTPSA id 124-v6sm13449129pfb.132.2018.10.29.02.43.15 (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Mon, 29 Oct 2018 02:43:15 -0700 (PDT) From: Viresh Kumar To: catalin.marinas@arm.com, Rob Herring , Mark Rutland Subject: [PATCH V2] dt-bindings: arm: Explain capacities-dmips-mhz calculations in example Date: Mon, 29 Oct 2018 15:13:05 +0530 Message-Id: <1cd2594fff3fb54948dcd2af65ae1867dd1c541a.1540806119.git.viresh.kumar@linaro.org> X-Mailer: git-send-email 2.19.1.568.g152ad8e3369a MIME-Version: 1.0 X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20181029_024328_082387_78782D38 X-CRM114-Status: GOOD ( 11.85 ) 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: devicetree@vger.kernel.org, Vincent Guittot , Viresh Kumar , Daniel Lezcano , linux-kernel@vger.kernel.org, linux-arm-kernel@lists.infradead.org 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 The example contains two values for the capacity currently, 446 in text and 578 in code. The numbers are all correct but can confuse some of the readers. This patch tries to explain how the numbers are calculated to avoid same confusion going forward. Acked-by: Daniel Lezcano Signed-off-by: Viresh Kumar --- V1->V2: - The numbers weren't incorrect in the example, just that it needs a bit more explanation for some people. Documentation/devicetree/bindings/arm/cpu-capacity.txt | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-) diff --git a/Documentation/devicetree/bindings/arm/cpu-capacity.txt b/Documentation/devicetree/bindings/arm/cpu-capacity.txt index 9b5685a1d15d..84262cdb8d29 100644 --- a/Documentation/devicetree/bindings/arm/cpu-capacity.txt +++ b/Documentation/devicetree/bindings/arm/cpu-capacity.txt @@ -59,9 +59,11 @@ mhz values (normalized w.r.t. the highest value found while parsing the DT). =========================================== Example 1 (ARM 64-bit, 6-cpu system, two clusters): -capacities-dmips-mhz are scaled w.r.t. 1024 (cpu@0 and cpu@1) -supposing cluster0@max-freq=1100 and custer1@max-freq=850, -final capacities are 1024 for cluster0 and 446 for cluster1 +The capacities-dmips-mhz or DMIPS/MHz values (scaled to 1024) +are 1024 and 578 for cluster0 and cluster1. Further normalization +is done by the operating system based on cluster0@max-freq=1100 and +custer1@max-freq=850, final capacities are 1024 for cluster0 and +446 for cluster1 (576*850/1100). cpus { #address-cells = <2>;