From patchwork Wed Jan 6 08:30:23 2016 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Leo Yan X-Patchwork-Id: 7965331 Return-Path: X-Original-To: patchwork-linux-pm@patchwork.kernel.org Delivered-To: patchwork-parsemail@patchwork1.web.kernel.org Received: from mail.kernel.org (mail.kernel.org [198.145.29.136]) by patchwork1.web.kernel.org (Postfix) with ESMTP id D861C9F38D for ; Wed, 6 Jan 2016 08:31:11 +0000 (UTC) Received: from mail.kernel.org (localhost [127.0.0.1]) by mail.kernel.org (Postfix) with ESMTP id 077D920172 for ; Wed, 6 Jan 2016 08:31:11 +0000 (UTC) Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by mail.kernel.org (Postfix) with ESMTP id 26B2C2015E for ; Wed, 6 Jan 2016 08:31:10 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1752459AbcAFIaz (ORCPT ); Wed, 6 Jan 2016 03:30:55 -0500 Received: from mail-pa0-f53.google.com ([209.85.220.53]:33009 "EHLO mail-pa0-f53.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1752509AbcAFIav (ORCPT ); Wed, 6 Jan 2016 03:30:51 -0500 Received: by mail-pa0-f53.google.com with SMTP id cy9so229951066pac.0 for ; Wed, 06 Jan 2016 00:30:51 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=linaro.org; s=google; h=from:to:cc:subject:date:message-id:in-reply-to:references; bh=S+L7ukzqAjdfg/0nJNeK17E/q5e9EgESBrN2/33XtA4=; b=UnWvJtX7boEVI8JRJwvilcfW5yE59FDeVHAgAx8vIiXTMXw5hRFdoOGYg1S2h3vzWf j9nESeGNHobW9hsMm7g6m16vTnQTwnL3xWmmTqw1zo4XLOC0ZQvf1v85bhWGmwVmUeBb 0FZesQGX8ICtWliVuDeHA5NC3uZcaq/qov22g= X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20130820; h=x-gm-message-state:from:to:cc:subject:date:message-id:in-reply-to :references; bh=S+L7ukzqAjdfg/0nJNeK17E/q5e9EgESBrN2/33XtA4=; b=c+4yrzW9zSVgH/E90/XpgK85jOyUowMegoZ4NpXUXkiAL17iWp8VQc9c+9Oq7VpRJS Y+yGXda0xFMWYdM/FQIoiwfy+dhxGhTfYOgrCOJfUKZ513IEcr0PAB3uumzAVSpcJziK pzGY+xROwWmQAYxWK8J4lBCEVXDooP+ObwAueVujfML6WQg0DaJqEZJpd/BXoygAEHYv wkZhCq6RoPhpe6X2BcoiV9ifMToBQshl9s2OFwSitc4LINK6GpyE6Iq2GQXLn30ZoAem p1NUo0+TS4lglYQTiGhfE5UbqU0DO+a4wDD/xE+EP0S173Jab/Nf9NUidlEd7qv4xuXE JYtQ== X-Gm-Message-State: ALoCoQmkkZUWdDFhSH1M0SpCDxVVvlN05NHEDd5dTCH9F+Vp5T/9CbNFrFpwJ5cvyOYLsn7ml4DKj5rJl2hTbDdi76f3jfITbw== X-Received: by 10.66.102.106 with SMTP id fn10mr73628948pab.60.1452069050911; Wed, 06 Jan 2016 00:30:50 -0800 (PST) Received: from localhost.localdomain (v17.blockcn.net. [192.241.236.26]) by smtp.gmail.com with ESMTPSA id f24sm133416478pff.68.2016.01.06.00.30.47 (version=TLS1_2 cipher=ECDHE-RSA-AES128-SHA bits=128/128); Wed, 06 Jan 2016 00:30:49 -0800 (PST) From: Leo Yan To: Jonathan Corbet , Zhang Rui , Eduardo Valentin , Javi Merino , Punit Agrawal , Daniel Kurtz , linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, linux-pm@vger.kernel.org, Daniel Thompson Cc: Leo Yan Subject: [PATCH v2 4/4] thermal: power_allocator: document k_pu_ratio/k_po_ratio Date: Wed, 6 Jan 2016 16:30:23 +0800 Message-Id: <1452069023-32149-5-git-send-email-leo.yan@linaro.org> X-Mailer: git-send-email 1.9.1 In-Reply-To: <1452069023-32149-1-git-send-email-leo.yan@linaro.org> References: <1452069023-32149-1-git-send-email-leo.yan@linaro.org> Sender: linux-pm-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-pm@vger.kernel.org X-Spam-Status: No, score=-6.8 required=5.0 tests=BAYES_00,DKIM_SIGNED, RCVD_IN_DNSWL_HI,RP_MATCHES_RCVD,T_DKIM_INVALID,UNPARSEABLE_RELAY autolearn=ham version=3.3.1 X-Spam-Checker-Version: SpamAssassin 3.3.1 (2010-03-16) on mail.kernel.org X-Virus-Scanned: ClamAV using ClamSMTP Document k_pu_ratio and k_po_ratio's purpose, and refine formula to demonstrate to use ratio to calculate k_pu/k_po. Signed-off-by: Leo Yan --- Documentation/thermal/power_allocator.txt | 15 +++++++++++---- 1 file changed, 11 insertions(+), 4 deletions(-) diff --git a/Documentation/thermal/power_allocator.txt b/Documentation/thermal/power_allocator.txt index a1ce223..8958dab 100644 --- a/Documentation/thermal/power_allocator.txt +++ b/Documentation/thermal/power_allocator.txt @@ -114,13 +114,20 @@ whilst temperature is low, and may lead to temperature overshooting. The default value for `k_pu` is: - 2 * sustainable_power / (desired_temperature - switch_on_temp) + k_pu_ratio * sustainable_power / (desired_temperature - switch_on_temp) This means that at `switch_on_temp` the output of the controller's -proportional term will be 2 * `sustainable_power`. The default value -for `k_po` is: +proportional term will be k_pu_ratio * `sustainable_power`. - sustainable_power / (desired_temperature - switch_on_temp) +The default value for `k_po` is: + + k_po_ratio * sustainable_power / (desired_temperature - switch_on_temp) + +k_pu_ratio's default value is 2 and k_po_ratio's default value is 1. +These two vairants mean the ratio value compared against sustainable power, +so smaller ratio will result in thermal slower ramp. User can set these two +ratio value from sys filesystem nodes, finally k_pu and k_po will be +calculated by updated ratio value. Focusing on the proportional and feed forward values of the PID controller equation we have: