Received: by 2002:a05:6a10:9afc:0:0:0:0 with SMTP id t28csp253085pxm; Wed, 2 Mar 2022 14:39:23 -0800 (PST) X-Google-Smtp-Source: ABdhPJwv5tgLtQP/5IK0jMy8uvW5h/8H93HhB+GJS5MXDHt2PgtU5+7eDRM3McBewiGD+CkzyaxN X-Received: by 2002:a17:902:b597:b0:14f:3396:a7a5 with SMTP id a23-20020a170902b59700b0014f3396a7a5mr33563664pls.29.1646260763082; Wed, 02 Mar 2022 14:39:23 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1646260763; cv=none; d=google.com; s=arc-20160816; b=m5/i4Qoa9ax7UsUJfTzrxl82t00WqcxRIZ6u7yE+mNv3NTIcy8Fdk4YO9I4jM08bXB wXBv7cTUitgmzdEYZAut6deqWdawAmSz+mcffnPqGxoBNhj6369VU78WkwIKuIn6dVrK qZJRed8MNh712ctYOxDZK9i1BX2yUamMVrqrJvpttuBs5cZwkudeG1M3eWt/E0d5DTPB pTt+daj5YHwMJo1eDAybGyNr50WSR/+n7OhQtycVz+pdrPEgTFe01rseKqKsBGSOHpQE wvhc9TQX75sCi5SCknWc1Y1JQf7CgVhatW9TgS2KripUIi4XJodMsHLXuqtN2jME3mII 8rIw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:references:in-reply-to:message-id:date:subject :cc:to:from; bh=Zt+cEO1/NLH4S5gppCtmhxfIFRnCjzeLHf10TfMkBG4=; b=eFUJc4G0nPs51tGT2L0yW7NBwwAHmQr+OKWKtQyEdFFuveS5KuV/w8ZGxmyfXWb7AZ +HDoIg7oJ9NpAl+x6onz2QI6SoTV4XhH7Nqf8U67uACyDUFQtIAMvobOBYTlnfTy5NO1 YRWbLPTvyg8yP8pAb9LZ2woqJtFEUsxCzjyVzjelKsA94dy2YcfUt3Rsj5seP9697czo ONy29YRqgCOFc/OLqaP2Y/gjpoRfAlxMbO1rVsdx8iaaPp5NxfwDpLd4DbquZneNRk7M VvcfPZeKy4gR5ccql548VCN/oEWSYTmH5jAKs4LwvAFRIu7KRFl4QwjtZisT88m5dk4O rqFg== ARC-Authentication-Results: i=1; mx.google.com; spf=softfail (google.com: domain of transitioning linux-kernel-owner@vger.kernel.org does not designate 23.128.96.19 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=arm.com Return-Path: Received: from lindbergh.monkeyblade.net (lindbergh.monkeyblade.net. [23.128.96.19]) by mx.google.com with ESMTPS id bm27-20020a656e9b000000b0035e558049e1si328697pgb.403.2022.03.02.14.39.22 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 02 Mar 2022 14:39:23 -0800 (PST) Received-SPF: softfail (google.com: domain of transitioning linux-kernel-owner@vger.kernel.org does not designate 23.128.96.19 as permitted sender) client-ip=23.128.96.19; Authentication-Results: mx.google.com; spf=softfail (google.com: domain of transitioning linux-kernel-owner@vger.kernel.org does not designate 23.128.96.19 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=arm.com Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by lindbergh.monkeyblade.net (Postfix) with ESMTP id 11FF2F5402; Wed, 2 Mar 2022 14:35:22 -0800 (PST) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S241527AbiCBLag (ORCPT + 99 others); Wed, 2 Mar 2022 06:30:36 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:36644 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S241448AbiCBLaX (ORCPT ); Wed, 2 Mar 2022 06:30:23 -0500 Received: from foss.arm.com (foss.arm.com [217.140.110.172]) by lindbergh.monkeyblade.net (Postfix) with ESMTP id 76F9675E40; Wed, 2 Mar 2022 03:29:40 -0800 (PST) Received: from usa-sjc-imap-foss1.foss.arm.com (unknown [10.121.207.14]) by usa-sjc-mx-foss1.foss.arm.com (Postfix) with ESMTP id 3EBD013D5; Wed, 2 Mar 2022 03:29:40 -0800 (PST) Received: from e123648.arm.com (unknown [10.57.21.27]) by usa-sjc-imap-foss1.foss.arm.com (Postfix) with ESMTPA id 076C53F70D; Wed, 2 Mar 2022 03:29:37 -0800 (PST) From: Lukasz Luba To: linux-kernel@vger.kernel.org Cc: lukasz.luba@arm.com, dietmar.eggemann@arm.com, viresh.kumar@linaro.org, rafael@kernel.org, daniel.lezcano@linaro.org, nm@ti.com, sboyd@kernel.org, mka@chromium.org, dianders@chromium.org, robh+dt@kernel.org, devicetree@vger.kernel.org, linux-pm@vger.kernel.org Subject: [PATCH v5 5/5] Documentation: EM: Describe new registration method using DT Date: Wed, 2 Mar 2022 11:29:17 +0000 Message-Id: <20220302112917.27270-6-lukasz.luba@arm.com> X-Mailer: git-send-email 2.17.1 In-Reply-To: <20220302112917.27270-1-lukasz.luba@arm.com> References: <20220302112917.27270-1-lukasz.luba@arm.com> X-Spam-Status: No, score=-1.9 required=5.0 tests=BAYES_00, HEADER_FROM_DIFFERENT_DOMAINS,MAILING_LIST_MULTI,RDNS_NONE, SPF_HELO_NONE,T_SCC_BODY_TEXT_LINE autolearn=no autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on lindbergh.monkeyblade.net Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org The new registration method allows to get power values from the DT OPP definition. The new OPP entry property "opp-microwatt" contains total power expressed in micro-Watts. Align the EM documentation with this new possible registration method of EM. Signed-off-by: Lukasz Luba --- Documentation/power/energy-model.rst | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/Documentation/power/energy-model.rst b/Documentation/power/energy-model.rst index 5ac62a7b4b7c..49549aab41b4 100644 --- a/Documentation/power/energy-model.rst +++ b/Documentation/power/energy-model.rst @@ -113,6 +113,16 @@ to: return warning/error, stop working or panic. See Section 3. for an example of driver implementing this callback, or Section 2.4 for further documentation on this API +Registration of EM using DT +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +The EM can also be registered using OPP framework and information in DT +"operating-points-v2". Each OPP entry in DT can be extended with a property +"opp-microwatt" containing micro-Watts power value. This OPP DT property +allows a platform to register EM power values which are reflecting total power +(static + dynamic). These power values might be coming directly from +experiments and measurements. + Registration of 'simple' EM ~~~~~~~~~~~~~~~~~~~~~~~~~~~ -- 2.17.1