From patchwork Tue Mar 17 05:49:31 2015 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Jeremy Kerr X-Patchwork-Id: 450876 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 35561140140 for ; Tue, 17 Mar 2015 16:49:43 +1100 (AEDT) Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) by lists.ozlabs.org (Postfix) with ESMTP id F25FF1A0BD3 for ; Tue, 17 Mar 2015 16:49:42 +1100 (AEDT) X-Original-To: skiboot@lists.ozlabs.org Delivered-To: skiboot@lists.ozlabs.org Received: from ozlabs.org (ozlabs.org [103.22.144.67]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by lists.ozlabs.org (Postfix) with ESMTPS id 316841A0BC0 for ; Tue, 17 Mar 2015 16:49:40 +1100 (AEDT) Received: by ozlabs.org (Postfix, from userid 1023) id CE397140140; Tue, 17 Mar 2015 16:49:39 +1100 (AEDT) MIME-Version: 1.0 Message-Id: <1426571371.19807.322353169500.1.gpush@pablo> To: skiboot@lists.ozlabs.org From: Jeremy Kerr Date: Tue, 17 Mar 2015 13:49:31 +0800 Subject: [Skiboot] [PATCH] doc/device-tree: Add descriptions for the ibm, pstate-* properties. X-BeenThere: skiboot@lists.ozlabs.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: Mailing list for skiboot development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: skiboot-bounces+incoming=patchwork.ozlabs.org@lists.ozlabs.org Sender: "Skiboot" Signed-off-by: Jeremy Kerr --- doc/device-tree/ibm,opal/power-mgt.txt | 40 ++++++++++++++++--------- 1 file changed, 26 insertions(+), 14 deletions(-) diff --git a/doc/device-tree/ibm,opal/power-mgt.txt b/doc/device-tree/ibm,opal/power-mgt.txt index d67c1b3..0852650 100644 --- a/doc/device-tree/ibm,opal/power-mgt.txt +++ b/doc/device-tree/ibm,opal/power-mgt.txt @@ -25,18 +25,35 @@ values for optimal power efficiency. ibm,cpu-idle-state-residency-ns = <0x1 0x2 0x3> ibm,cpu-idle-state-latencies-ns = <0x1 0x2 0x3> + +ibm,pstate-ids +-------------- + +This property lists the available pstate identifiers, as signed 32-bit +big-endian values. While the identifiers are somewhat arbitrary, these define +the order of the pstates in other ibm,pstate-* properties. + + +ibm,pstate-frequencies-mhz +-------------------------- + +This property lists the frequency, in MHz, of each of the pstates listed in the +ibm,pstate-ids file. Each frequency is a 32-bit big-endian word. + + +ibm,pstate-max ibm,pstate-min ibm,pstate-nominal +------------------------------------------------ + +These properties give the maximum, minimum and nominal pstate values, as an id +specified in the ibm,pstate-ids file. + + ibm,pstate-vcss ibm,pstate-vdds ------------------------------- -During characterisation, we'd like to allow userspace to see the vdd and -vcs values exposed by the OCC. This change adds two new properties to -expose these: - - ibm,pstate-vdds - ibm,pstate-vcss - -- containing one byte per pstate, representing the Vdd or Vcs value for - that pstate. +These properties list a voltage-identifier of each of the pstates listed in +ibm,pstate-ids for the Vcs and Vdd values used for that pstate. Each VID is a +single byte. FIXME: document these: @@ -44,8 +61,3 @@ ibm,cpu-idle-state-flags ibm,cpu-idle-state-names ibm,cpu-idle-state-pmicr ibm,cpu-idle-state-pmicr-mask -ibm,pstate-frequencies-mhz -ibm,pstate-ids -ibm,pstate-max -ibm,pstate-min -ibm,pstate-nominal