From patchwork Thu Dec 28 14:40:37 2017 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Ulf Hansson X-Patchwork-Id: 122841 Delivered-To: patches@linaro.org Received: by 10.140.22.227 with SMTP id 90csp3531124qgn; Thu, 28 Dec 2017 06:40:55 -0800 (PST) X-Received: by 10.46.93.27 with SMTP id r27mr20700369ljb.96.1514472055257; Thu, 28 Dec 2017 06:40:55 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1514472055; cv=none; d=google.com; s=arc-20160816; b=pSxcK/NEq6UDFKmqYPABtsTtPcArl7MJNlflX8W2BQ8dSQHm/zkxIfm/yT0X0KKugz vP5ei1haE3MfIKXDavqBK8ffpTkNrv6p/BEdoG3PjHXeCcf3QlPcE2+NgIZBX42/+Gvf XX030wGQYNhrBEMszidKKe5vOYqyDGdQT5vCJW1m7vks0R+Cz0qiAXS7QJ/pxJhHu/if GudKEU4bpe2zyT2c8iagV02z5svHl+6Gs64nWEmQWMVaDUXYptH6LavfPMRSRYH0Mjvn dzCLQ3fU7iZzMNaDm68zezSFJAMppU5sWMmhuIHeTMI2w/Y5wueg+qXJ0c7Feu+O2/5r WGtg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=message-id:date:subject:cc:to:from:dkim-signature :arc-authentication-results; bh=0aZTYNHi2keQmBQx1r07kzof4IVMXRZtLqTWpHBqUpg=; b=LGaGigPwASVk7d/V9HlZBeHl9K8ofJ1EenUdMMLVBCNkB0+D85Oo4Kmza/LlTY2wlj b/VWADD3z1AealFUKe08xOUlIoIQpSwcW7EuDzf1DdtxFSGRyULOjfGQmtebW7mWxib3 Bm5EZ9gPRWyL3ABRgbo2k5zZ3zcF2mouAVhfiTNhX9jd6Fi9LHseC2fIb4wPZA+mYryG 0dPWlt1pmcz+rMcdWLXtnggTTdQlBFzSxnCCC176AaTb4I+iQ14+YObPahY+dWNeaaOV sfKHD5cmetaxJ/Aqa6yXj6971imMJt42h7b0/7so30HXvIECX0DIVvvOkOROhWAxpJ8i rz2Q== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=eJxv4kqK; spf=pass (google.com: domain of ulf.hansson@linaro.org designates 209.85.220.65 as permitted sender) smtp.mailfrom=ulf.hansson@linaro.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=linaro.org Return-Path: Received: from mail-sor-f65.google.com (mail-sor-f65.google.com. [209.85.220.65]) by mx.google.com with SMTPS id j13sor3469903lfk.37.2017.12.28.06.40.54 for (Google Transport Security); Thu, 28 Dec 2017 06:40:54 -0800 (PST) Received-SPF: pass (google.com: domain of ulf.hansson@linaro.org designates 209.85.220.65 as permitted sender) client-ip=209.85.220.65; Authentication-Results: mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=eJxv4kqK; spf=pass (google.com: domain of ulf.hansson@linaro.org designates 209.85.220.65 as permitted sender) smtp.mailfrom=ulf.hansson@linaro.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=linaro.org DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=linaro.org; s=google; h=from:to:cc:subject:date:message-id; bh=0aZTYNHi2keQmBQx1r07kzof4IVMXRZtLqTWpHBqUpg=; b=eJxv4kqKGV3RsQ4jmhsxd+7C3Hut5nFpXuBw+GHmb5pgBgN5+JtrKC6ZX/zYfD978Z AfXinMkytLBkVVJFmEe1U7S+pexgNQwPCOwYrhinvLkq8/mBOceuiNEQxnGK4Ym5tB6i rmsJWFuWK5aDIVsZ1YUdIHRXExAtIYX6mL0ac= 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; bh=0aZTYNHi2keQmBQx1r07kzof4IVMXRZtLqTWpHBqUpg=; b=V3QZ4nuNA2f9l2VjYL4ioXhpPvv6jG8j4bePjtMjaDeyaToYZ3p+QNO9Ku/Nbv4H7O gtnXYiV4+vXAX8NXhHZxRnu+nKnMCD3MK27HfhTRpcfQZVoObiaeKKfMtgFEmVQIAI7d 3Kaq74J8QN5Vi39ZkJjUaZL/+gWGTII3D+L3fny2CDKFzIlB6YICcHgpW757HvBqVhmL k9S7BDb2gcGSj48krWK/dwq3gSBewV1xM12ilL+SqYCfQBloG34u5LWxEciYOnKflNwa FtWlixlUMgMiD7d3Syl/lOuhuvN9Kh+wpmlaD84Q7Q4+jinXvRenJrUd/qfLSlsjtV1h 6Oyw== X-Gm-Message-State: AKGB3mI4fU/mv6/QdLyq7YwiDz+8WV9V2pqWToSgZuwFLY/EUpM3TmdN B2toqUmCq2ClUPBZHJUbUY42kEWG X-Google-Smtp-Source: ACJfBovyuMUJgGumPA+xG7wLEKS5OFIyKz8MJMYK00Vhg61S1CLTDIEMtZZad+33ubFCSs+1uX8u5Q== X-Received: by 10.25.215.11 with SMTP id o11mr8088696lfg.33.1514472054230; Thu, 28 Dec 2017 06:40:54 -0800 (PST) Return-Path: Received: from localhost.localdomain (h-158-174-22-67.NA.cust.bahnhof.se. [158.174.22.67]) by smtp.gmail.com with ESMTPSA id c1sm6825104ljb.78.2017.12.28.06.40.52 (version=TLS1_2 cipher=ECDHE-RSA-AES128-SHA bits=128/128); Thu, 28 Dec 2017 06:40:53 -0800 (PST) From: Ulf Hansson To: Rob Herring , Mark Rutland , devicetree@vger.kernel.org Cc: Sudeep Holla , Lorenzo Pieralisi , Brendan Jackman , Lina Iyer , Ulf Hansson , Kevin Hilman , linux-kernel@vger.kernel.org, linux-arm-kernel@lists.infradead.org Subject: [PATCH v2] dt: psci: Update DT bindings to support hierarchical PSCI states Date: Thu, 28 Dec 2017 15:40:37 +0100 Message-Id: <1514472037-25969-1-git-send-email-ulf.hansson@linaro.org> X-Mailer: git-send-email 2.7.4 From: Lina Iyer Update DT bindings to represent hierarchical CPU and CPU domain idle states for PSCI. Also update the PSCI examples to clearly show how flattened and hierarchical idle states can be represented in DT. Signed-off-by: Lina Iyer Signed-off-by: Ulf Hansson --- Changes in v2: - Addressed comments from Rob. - Updated some labels in the examples to get more consistency. For your information, I have picked up the work from Lina Iyer around the so called CPU cluster idling series [1,2] and I working on new versions. However, I decided to post the updates to the PSCI DT bindings first, as they will be needed to be agreed upon before further changes can be done to the PSCI firmware driver. Note, these bindings have been discussed over and over again, at LKML, but especially also at various Linux conferences, like LPC and Linaro Connect. We finally came to a conclusion and the changes we agreed upon, should be reflected in this update. Of course, it's a while ago since the latest discussions, but hopefully people don't have too hard time to remember. Kind regards Uffe [1] https://www.spinics.net/lists/arm-kernel/msg566200.html [2] https://lwn.net/Articles/716300/ --- Documentation/devicetree/bindings/arm/psci.txt | 152 +++++++++++++++++++++++++ 1 file changed, 152 insertions(+) -- 2.7.4 Reviewed-by: Rob Herring diff --git a/Documentation/devicetree/bindings/arm/psci.txt b/Documentation/devicetree/bindings/arm/psci.txt index a2c4f1d..8a09bd2 100644 --- a/Documentation/devicetree/bindings/arm/psci.txt +++ b/Documentation/devicetree/bindings/arm/psci.txt @@ -105,7 +105,159 @@ Case 3: PSCI v0.2 and PSCI v0.1. ... }; +PSCI v1.0 onwards, supports OS-Initiated mode for powering off CPUs and CPU +clusters from the firmware. For such topologies the PSCI firmware driver acts +as pseudo-controller, which may be specified in the psci DT node. The +definitions of the CPU and the CPU cluster topology, must conform to the domain +idle state specification [3]. The domain idle states themselves, must be +compatible with the defined 'domain-idle-state' binding [1], and also need to +specify the arm,psci-suspend-param property for each idle state. + +DT allows representing CPU and CPU cluster idle states in two different ways - + +The flattened model as given in Example 1, lists CPU's idle states followed by +the domain idle state that the CPUs may choose. This is the general practice +followed in PSCI firmwares that support Platform Coordinated mode. Note that +the idle states are all compatible with "arm,idle-state". + +Example 2 represents the hierarchical model of CPU and domain idle states. +CPUs define their domain provider in their DT node. The domain controls the +power to the CPU and possibly other h/w blocks that would be powered off when +the CPU is powered off. The CPU's idle states may therefore be considered as +the domain's idle states and have the compatible "arm,idle-state". Such domains +may be embedded within another domain that represents common h/w blocks between +these CPUs viz. the cluster. The idle states of the cluster would be +represented as the domain's idle states. In order to use OS-Initiated mode of +PSCI in the firmware, the hierarchical representation must be used. + +Example 1: Flattened representation of CPU and domain idle states + cpus { + #address-cells = <1>; + #size-cells = <0>; + + CPU0: cpu@0 { + device_type = "cpu"; + compatible = "arm,cortex-a53", "arm,armv8"; + reg = <0x0>; + enable-method = "psci"; + cpu-idle-states = <&CPU_PWRDN>, <&CLUSTER_RET>, + <&CLUSTER_PWRDN>; + }; + + CPU1: cpu@1 { + device_type = "cpu"; + compatible = "arm,cortex-a57", "arm,armv8"; + reg = <0x100>; + enable-method = "psci"; + cpu-idle-states = <&CPU_PWRDN>, <&CLUSTER_RET>, + <&CLUSTER_PWRDN>; + }; + + idle-states { + CPU_PWRDN: cpu-power-down { + compatible = "arm,idle-state"; + arm,psci-suspend-param = <0x000001>; + entry-latency-us = <10>; + exit-latency-us = <10>; + min-residency-us = <100>; + }; + + CLUSTER_RET: cluster-retention { + compatible = "arm,idle-state"; + arm,psci-suspend-param = <0x1000010>; + entry-latency-us = <500>; + exit-latency-us = <500>; + min-residency-us = <2000>; + }; + + CLUSTER_PWRDN: cluster-power-down { + compatible = "arm,idle-state"; + arm,psci-suspend-param = <0x1000030>; + entry-latency-us = <2000>; + exit-latency-us = <2000>; + min-residency-us = <6000>; + }; + }; + + psci { + compatible = "arm,psci-0.2"; + method = "smc"; + }; + +Example 2: Hierarchical representation of CPU and domain idle states + + cpus { + #address-cells = <1>; + #size-cells = <0>; + + CPU0: cpu@0 { + device_type = "cpu"; + compatible = "arm,cortex-a53", "arm,armv8"; + reg = <0x0>; + enable-method = "psci"; + power-domains = <&CPU_PD0>; + }; + + CPU1: cpu@1 { + device_type = "cpu"; + compatible = "arm,cortex-a57", "arm,armv8"; + reg = <0x100>; + enable-method = "psci"; + power-domains = <&CPU_PD1>; + }; + + idle-states { + CPU_PWRDN: cpu-power-down { + compatible = "arm,idle-state"; + arm,psci-suspend-param = <0x000001>; + entry-latency-us = <10>; + exit-latency-us = <10>; + min-residency-us = <100>; + }; + + CLUSTER_RET: cluster-retention { + compatible = "domain-idle-state"; + arm,psci-suspend-param = <0x1000010>; + entry-latency-us = <500>; + exit-latency-us = <500>; + min-residency-us = <2000>; + }; + + CLUSTER_PWRDN: cluster-power-down { + compatible = "domain-idle-state"; + arm,psci-suspend-param = <0x1000030>; + entry-latency-us = <2000>; + exit-latency-us = <2000>; + min-residency-us = <6000>; + }; + }; + }; + + psci { + compatible = "arm,psci-1.0"; + method = "smc"; + + CPU_PD0: cpu-pd0 { + #power-domain-cells = <0>; + domain-idle-states = <&CPU_PWRDN>; + power-domains = <&CLUSTER_PD>; + }; + + CPU_PD1: cpu-pd1 { + #power-domain-cells = <0>; + domain-idle-states = <&CPU_PWRDN>; + power-domains = <&CLUSTER_PD>; + }; + + CLUSTER_PD: cluster-pd { + #power-domain-cells = <0>; + domain-idle-states = <&CLUSTER_RET>, <&CLUSTER_PWRDN>; + }; + }; + [1] Kernel documentation - ARM idle states bindings Documentation/devicetree/bindings/arm/idle-states.txt [2] Power State Coordination Interface (PSCI) specification http://infocenter.arm.com/help/topic/com.arm.doc.den0022c/DEN0022C_Power_State_Coordination_Interface.pdf +[3]. PM Domains description + Documentation/devicetree/bindings/power/power_domain.txt