From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-9.8 required=3.0 tests=HEADER_FROM_DIFFERENT_DOMAINS, INCLUDES_PATCH,MAILING_LIST_MULTI,SIGNED_OFF_BY,SPF_HELO_NONE,SPF_PASS, URIBL_BLOCKED,USER_AGENT_GIT autolearn=ham autolearn_force=no version=3.4.0 Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id 1B6ECC47257 for ; Mon, 4 May 2020 16:56:18 +0000 (UTC) Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by mail.kernel.org (Postfix) with ESMTP id EACDE206D9 for ; Mon, 4 May 2020 16:56:17 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1729792AbgEDQ4R (ORCPT ); Mon, 4 May 2020 12:56:17 -0400 Received: from foss.arm.com ([217.140.110.172]:49256 "EHLO foss.arm.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1729692AbgEDQ4P (ORCPT ); Mon, 4 May 2020 12:56:15 -0400 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 907011063; Mon, 4 May 2020 09:56:13 -0700 (PDT) Received: from e120937-lin.home (unknown [172.31.20.19]) by usa-sjc-imap-foss1.foss.arm.com (Postfix) with ESMTPSA id 6884C3F68F; Mon, 4 May 2020 09:56:12 -0700 (PDT) From: Cristian Marussi To: linux-kernel@vger.kernel.org, linux-arm-kernel@lists.infradead.org Cc: sudeep.holla@arm.com, lukasz.luba@arm.com, james.quinlan@broadcom.com, Jonathan.Cameron@Huawei.com, cristian.marussi@arm.com Subject: [PATCH v2 2/3] firmware: arm_scmi: Add SCMI System Power Control driver Date: Mon, 4 May 2020 17:55:39 +0100 Message-Id: <20200504165540.37188-3-cristian.marussi@arm.com> X-Mailer: git-send-email 2.17.1 In-Reply-To: <20200504165540.37188-1-cristian.marussi@arm.com> References: <20200504165540.37188-1-cristian.marussi@arm.com> Sender: linux-kernel-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Add an SCMI System Power control driver to handle platform's requests carried by SYSTEM_POWER_STATE_NOTIFIER notifications: such platform requested system power state transitions are handled accordingly, gracefully or forcefully, depending on the notifications' message flags. Graceful requests are by default relayed to userspace using the same Kernel API used to handle ACPI Shutdown bus events: alternatively, instead, a few available module parameters can be used to tunnel instead such requests to userspace via signals addressed to CAD pid. When handling graceful requests, grant userspace processes a maximum (configurable) time to perform their duties and then revert to a forceful transition, so avoiding completely timing out platform's maximum grace time and hitting possible abrupt power-cuts. Signed-off-by: Cristian Marussi ---- V1 --> V2 - use common event enums - introduced optioanl alternative signal based comms 2 userspace --- drivers/firmware/Kconfig | 12 + drivers/firmware/arm_scmi/Makefile | 1 + drivers/firmware/arm_scmi/driver.c | 1 + .../firmware/arm_scmi/scmi_power_control.c | 389 ++++++++++++++++++ 4 files changed, 403 insertions(+) create mode 100644 drivers/firmware/arm_scmi/scmi_power_control.c diff --git a/drivers/firmware/Kconfig b/drivers/firmware/Kconfig index 8007d4aa76dc..c58f1c080a47 100644 --- a/drivers/firmware/Kconfig +++ b/drivers/firmware/Kconfig @@ -40,6 +40,18 @@ config ARM_SCMI_POWER_DOMAIN will be called scmi_pm_domain. Note this may needed early in boot before rootfs may be available. +config ARM_SCMI_POWER_CONTROL + bool "SCMI power control driver" + depends on ARM_SCMI_PROTOCOL || (COMPILE_TEST && OF) + default y + help + This enables System Power control logic which binds system shutdown or + reboot actions to SCMI System Power notifications generated by SCP + firmware. + + Graceful requests' methods and timeout and can be configured using + a few available module parameters. + config ARM_SCPI_PROTOCOL tristate "ARM System Control and Power Interface (SCPI) Message Protocol" depends on ARM || ARM64 || COMPILE_TEST diff --git a/drivers/firmware/arm_scmi/Makefile b/drivers/firmware/arm_scmi/Makefile index e01b67bc74b4..280568632791 100644 --- a/drivers/firmware/arm_scmi/Makefile +++ b/drivers/firmware/arm_scmi/Makefile @@ -7,3 +7,4 @@ scmi-transport-$(CONFIG_MAILBOX) += mailbox.o scmi-transport-$(CONFIG_HAVE_ARM_SMCCC) += smc.o scmi-protocols-y = base.o clock.o perf.o power.o reset.o sensors.o system.o obj-$(CONFIG_ARM_SCMI_POWER_DOMAIN) += scmi_pm_domain.o +obj-$(CONFIG_ARM_SCMI_POWER_CONTROL) += scmi_power_control.o diff --git a/drivers/firmware/arm_scmi/driver.c b/drivers/firmware/arm_scmi/driver.c index 5d89d0e9d650..dd6ac0819c69 100644 --- a/drivers/firmware/arm_scmi/driver.c +++ b/drivers/firmware/arm_scmi/driver.c @@ -733,6 +733,7 @@ struct scmi_prot_devnames { static struct scmi_prot_devnames devnames[] = { { SCMI_PROTOCOL_POWER, { "genpd", "notifytest" },}, + { SCMI_PROTOCOL_SYSTEM, {"syspower" },}, { SCMI_PROTOCOL_PERF, { "cpufreq" },}, { SCMI_PROTOCOL_CLOCK, { "clocks" },}, { SCMI_PROTOCOL_SENSOR, { "hwmon" },}, diff --git a/drivers/firmware/arm_scmi/scmi_power_control.c b/drivers/firmware/arm_scmi/scmi_power_control.c new file mode 100644 index 000000000000..56d01f3ffe91 --- /dev/null +++ b/drivers/firmware/arm_scmi/scmi_power_control.c @@ -0,0 +1,389 @@ +// SPDX-License-Identifier: GPL-2.0 +/* + * SCMI Generic System Power support. + * + * Copyright (C) 2020 ARM Ltd. + */ +/** + * DOC: Theory of operation + * + * In order to handle platform originated SCMI System Power requests (like + * shutdowns or cold/warm resets) we register an SCMI Notification notifier + * block to react when such SCMI System Power events are emitted. + * + * Once such a notification is received we act accordingly to perform the + * required system transition depending on the kind of request. + * + * By default graceful requests are routed to userspace through the same + * API methods (orderly_poweroff/reboot()) used by ACPI when handling ACPI + * Shutdown bus events: alternatively, by properly setting a couple of module + * parameters, it is possible to choose to use signals to CAD pid as a mean + * to communicate such graceful requests. + * + * Forceful requests instead simply cause and immediate emergency_sync() and + * subsequent Kernel-only shutdown/reboot. + * + * The assumption here is that even graceful requests can be upper-bound by a + * maximum final timeout strictly enforced by the platform itself which can + * finally cuts the power off at will: in such a scenario, which we want to + * avoid, we track the graceful requests progress through the means of a + * reboot_notifier and promptly convert a timed-out graceful request to a + * forceful one when userspace is late, in order to at least perform a clean + * sync and shutdown/restart. + * + * Given that such platform hard-timeout, when present, is anyway highly + * platform/event specific and not exposed at run-time, we make it configurable + * via the Kernel module param @scmi_graceful_request_tmo_ms. + */ + +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include + +#define DEFAULT_GRACE_TMO_MS 5000 +static unsigned int scmi_graceful_request_tmo_ms = DEFAULT_GRACE_TMO_MS; +static unsigned int scmi_graceful_poweroff_signum; +static unsigned int scmi_graceful_reboot_signum; + +enum scmi_system_request_status { + SCMI_SYSPOWER_IDLE, + SCMI_SYSPOWER_SERVED, + SCMI_SYSPOWER_INPROGRESS, + SCMI_SYSPOWER_FORCING, +}; + +struct scmi_syspower_config { + struct device *dev; + + atomic_t status; + + u32 required_state; + + void (*request_graceful_transition)(struct scmi_syspower_config *conf); + void (*request_forceful_transition)(struct scmi_syspower_config *conf); + + struct notifier_block userspace_nb; + struct notifier_block reboot_nb; + + struct timer_list request_timer; + struct work_struct forceful_work; +}; + +static void scmi_forceful_work_func(struct work_struct *work) +{ + struct scmi_syspower_config *conf = + container_of(work, struct scmi_syspower_config, forceful_work); + + conf->request_forceful_transition(conf); +} + +/** + * scmi_request_timeout - On timeout trigger a forceful transition + * @t: The timer reference + * + * Actual work is deferred out of the timer IRQ context since shutdown/reboot + * code do not play well when !in_task(). + */ +static void scmi_request_timeout(struct timer_list *t) +{ + struct scmi_syspower_config *conf = from_timer(conf, t, request_timer); + + dev_warn(conf->dev, + "SCMI Graceful System Transition request timed out !\n"); + atomic_set(&conf->status, SCMI_SYSPOWER_FORCING); + /* Ensure atomic values are updated */ + smp_mb__after_atomic(); + schedule_work(&conf->forceful_work); +} + +/** + * scmi_reboot_notifier - A reboot_notifier to catch an ongoing successful + * system transition + * @nb: Reference to the related notifier block + * @reason: The reason for the ongoing reboot + * @__unused: The cmd being executed on a restart request (unused) + * + * When an ongoing system transition is detected, compatible with the requested + * one, cancel the timer work. + * + * Return: NOTIFY_OK in any case + */ +static int scmi_reboot_notifier(struct notifier_block *nb, + unsigned long reason, void *__unused) +{ + struct scmi_syspower_config *conf; + + conf = container_of(nb, struct scmi_syspower_config, reboot_nb); + + /* Ensure atomic values are updated */ + smp_mb__before_atomic(); + if (unlikely(atomic_read(&conf->status) == SCMI_SYSPOWER_FORCING)) + return NOTIFY_OK; + + switch (reason) { + case SYS_HALT: + case SYS_POWER_OFF: + if (conf->required_state == SCMI_SYSTEM_SHUTDOWN) + atomic_set(&conf->status, SCMI_SYSPOWER_INPROGRESS); + break; + case SYS_RESTART: + if (conf->required_state == SCMI_SYSTEM_COLDRESET || + conf->required_state == SCMI_SYSTEM_WARMRESET) + atomic_set(&conf->status, SCMI_SYSPOWER_INPROGRESS); + break; + default: + break; + } + + /* Ensure atomic values are updated */ + smp_mb__after_atomic(); + if (atomic_read(&conf->status) == SCMI_SYSPOWER_INPROGRESS) { + dev_info(conf->dev, + "SCMI System State request in progress...\n"); + del_timer_sync(&conf->request_timer); + } + + return NOTIFY_OK; +} + +static inline void scmi_send_cad_signal(struct device *dev, unsigned int sig) +{ + dev_info(dev, "SCMI Sending signal %d to CAD pid\n", sig); + + kill_cad_pid(sig, 1); +} + +/** + * scmi_request_graceful_transition - Request graceful SystemPower transition + * @conf: The current SystemPower configuration descriptor + * + * Initiates the required SystemPower transition, requesting userspace + * co-operation using the same orderly_ methods used by ACPI Shutdown event + * processing. + * + * This takes care also to register a reboot notifier and a timer callback in + * order to detect if userspace actions are taking too long; in such a case + * the timeout callback will finally perform a forceful transition, ignoring + * lagging userspace: the aim here is to at least perform an emergency_sync() + * and a clean shutdown or reboot transition when userspace is late, avoiding + * the brutal final power-cut from platform. + */ +static void scmi_request_graceful_transition(struct scmi_syspower_config *conf) +{ + int ret; + u32 status; + + if (conf->required_state >= SCMI_SYSTEM_POWERUP) { + dev_warn(conf->dev, + "Received unexpected SYSTEM POWER request: %d\n", + conf->required_state); + return; + } + + status = atomic_cmpxchg(&conf->status, SCMI_SYSPOWER_IDLE, + SCMI_SYSPOWER_SERVED); + if (status != SCMI_SYSPOWER_IDLE) + return; + + ret = devm_register_reboot_notifier(conf->dev, &conf->reboot_nb); + if (ret) + dev_warn(conf->dev, "Cannot register reboot notifier !\n"); + + INIT_WORK(&conf->forceful_work, scmi_forceful_work_func); + conf->request_timer.expires = jiffies + + msecs_to_jiffies(scmi_graceful_request_tmo_ms); + timer_setup(&conf->request_timer, scmi_request_timeout, 0); + add_timer(&conf->request_timer); + + dev_info(conf->dev, + "Serving SCMI Graceful request: %d (timeout_ms:%d)\n", + conf->required_state, scmi_graceful_request_tmo_ms); + + switch (conf->required_state) { + case SCMI_SYSTEM_SHUTDOWN: + /* + * When received early at boot-time the 'orderly' part will + * fail due to the lack of userspace itself, but the force=true + * argument will anyway be able trigger a successful forced + * shutdown. + */ + if (!scmi_graceful_poweroff_signum) + orderly_poweroff(true); + else + scmi_send_cad_signal(conf->dev, + scmi_graceful_poweroff_signum); + break; + case SCMI_SYSTEM_COLDRESET: + case SCMI_SYSTEM_WARMRESET: + if (!scmi_graceful_reboot_signum) + orderly_reboot(); + else + scmi_send_cad_signal(conf->dev, + scmi_graceful_reboot_signum); + break; + default: + break; + } +} + +static void scmi_request_forceful_transition(struct scmi_syspower_config *conf) +{ + /* Ensure atomic values are updated */ + smp_mb__before_atomic(); + if (unlikely(atomic_read(&conf->status) == SCMI_SYSPOWER_INPROGRESS)) + return; + + dev_info(conf->dev, "Serving SCMI FORCEFUL SystemPower request:%d\n", + conf->required_state); + + emergency_sync(); + switch (conf->required_state) { + case SCMI_SYSTEM_SHUTDOWN: + kernel_power_off(); + break; + case SCMI_SYSTEM_COLDRESET: + case SCMI_SYSTEM_WARMRESET: + kernel_restart(NULL); + break; + default: + break; + } +} + +#define SCMI_IS_REQUEST_GRACEFUL(flags) ((flags) & BIT(0)) + +/** + * scmi_userspace_notifier - Notifier callback to act on SystemPower + * Notifications + * @nb: Reference to the related notifier block + * @event: The SystemPower notification event id + * @data: The SystemPower event report + * + * This callback is in charge of decoding the received SystemPower report + * and act accordingly triggering a graceful or forceful system transition. + * + * Return: NOTIFY_OK in any case + */ +static int scmi_userspace_notifier(struct notifier_block *nb, + unsigned long event, void *data) +{ + struct scmi_system_power_state_notifier_report *er = data; + struct scmi_syspower_config *conf; + + if (unlikely(system_state > SYSTEM_RUNNING)) + return NOTIFY_OK; + + conf = container_of(nb, struct scmi_syspower_config, userspace_nb); + conf->required_state = er->system_state; + + if (conf->required_state >= SCMI_SYSTEM_MAX) + return NOTIFY_OK; + + if (SCMI_IS_REQUEST_GRACEFUL(er->flags)) + conf->request_graceful_transition(conf); + else + conf->request_forceful_transition(conf); + + return NOTIFY_OK; +} + +/** + * scmi_syspower_configure - General SystemPower configuration init + * @dev: The associated struct device + * + * Return: SystemPower configuration descriptor on Success, NULL otherwise + */ +static void *scmi_syspower_configure(struct device *dev) +{ + struct scmi_syspower_config *conf; + + conf = devm_kzalloc(dev, sizeof(*conf), GFP_KERNEL); + if (!conf) + return NULL; + + conf->dev = dev; + conf->required_state = SCMI_SYSTEM_MAX; + conf->request_graceful_transition = &scmi_request_graceful_transition; + conf->request_forceful_transition = &scmi_request_forceful_transition; + conf->userspace_nb.notifier_call = &scmi_userspace_notifier; + conf->reboot_nb.notifier_call = &scmi_reboot_notifier; + atomic_set(&conf->status, SCMI_SYSPOWER_IDLE); + /* Ensure atomic values are updated */ + smp_mb__after_atomic(); + + return conf; +} + +static int scmi_syspower_probe(struct scmi_device *sdev) +{ + int ret; + struct scmi_handle *handle = sdev->handle; + struct scmi_syspower_config *syspower_conf; + + if (!handle) + return -ENODEV; + + syspower_conf = scmi_syspower_configure(&sdev->dev); + if (!syspower_conf) + return -ENOMEM; + + dev_set_drvdata(&sdev->dev, syspower_conf); + ret = handle->notify_ops->register_event_notifier(handle, + SCMI_PROTOCOL_SYSTEM, + SCMI_EVENT_SYSTEM_POWER_STATE_NOTIFIER, + NULL, &syspower_conf->userspace_nb); + + return 0; +} + +static void scmi_syspower_remove(struct scmi_device *sdev) +{ + int ret; + const struct scmi_handle *handle = sdev->handle; + struct scmi_syspower_config *syspower_conf; + + syspower_conf = dev_get_drvdata(&sdev->dev); + ret = handle->notify_ops->unregister_event_notifier(handle, + SCMI_PROTOCOL_SYSTEM, + SCMI_EVENT_SYSTEM_POWER_STATE_NOTIFIER, + NULL, &syspower_conf->userspace_nb); +} + +static const struct scmi_device_id scmi_id_table[] = { + { SCMI_PROTOCOL_SYSTEM, "syspower" }, + { }, +}; +MODULE_DEVICE_TABLE(scmi, scmi_id_table); + +static struct scmi_driver scmi_system_power_driver = { + .name = "scmi-system-power", + .probe = scmi_syspower_probe, + .remove = scmi_syspower_remove, + .id_table = scmi_id_table, +}; +module_scmi_driver(scmi_system_power_driver); + +module_param(scmi_graceful_request_tmo_ms, uint, 0644); +MODULE_PARM_DESC(scmi_graceful_request_tmo_ms, + "Maximum time(ms) allowed to userspace for complying to the request."); + +module_param(scmi_graceful_poweroff_signum, uint, 0644); +MODULE_PARM_DESC(scmi_graceful_poweroff_signum, + "Signal to request graceful poweroff to CAD process. Ignored if zero."); + +module_param(scmi_graceful_reboot_signum, uint, 0644); +MODULE_PARM_DESC(scmi_graceful_reboot_signum, + "Signal to request graceful reboot to CAD process. Ignored if zero."); + +MODULE_AUTHOR("Cristian Marussi "); +MODULE_DESCRIPTION("ARM SCMI System Power driver"); +MODULE_LICENSE("GPL v2"); -- 2.17.1 From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-9.8 required=3.0 tests=DKIMWL_WL_HIGH,DKIM_SIGNED, DKIM_VALID,HEADER_FROM_DIFFERENT_DOMAINS,INCLUDES_PATCH,MAILING_LIST_MULTI, SIGNED_OFF_BY,SPF_HELO_NONE,SPF_PASS,URIBL_BLOCKED,USER_AGENT_GIT autolearn=unavailable autolearn_force=no version=3.4.0 Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id 2210BC3A5A9 for ; Mon, 4 May 2020 16:57:04 +0000 (UTC) Received: from bombadil.infradead.org (bombadil.infradead.org [198.137.202.133]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mail.kernel.org (Postfix) with ESMTPS id C25E7206A4 for ; Mon, 4 May 2020 16:57:03 +0000 (UTC) Authentication-Results: mail.kernel.org; dkim=pass (2048-bit key) header.d=lists.infradead.org header.i=@lists.infradead.org header.b="g/x2D+AX" DMARC-Filter: OpenDMARC Filter v1.3.2 mail.kernel.org C25E7206A4 Authentication-Results: mail.kernel.org; dmarc=none (p=none dis=none) header.from=arm.com Authentication-Results: mail.kernel.org; spf=none smtp.mailfrom=linux-arm-kernel-bounces+infradead-linux-arm-kernel=archiver.kernel.org@lists.infradead.org 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:MIME-Version:Cc:List-Subscribe: List-Help:List-Post:List-Archive:List-Unsubscribe:List-Id:References: In-Reply-To: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:List-Owner; bh=fe9u8wjmcqDFTiA+M51qMzxGkY3j+K7E0bBqWY6N/tA=; b=g/x2D+AXfvScRA034z/XRgeGub EEGeg5YE2rLcmEhuTKXa1XV+b1kuKbtxzfNACXiTNilRBwyPg41kt75satqlcG8S0jIZ6/Nl7ElHu q9ASP7JRYMTN2xQc9uSx4rXSKOruOuGZvBKK2vW1C/C27I53FrkcWS/RJ/CnAYsmbRR5QdTKeY3E0 Zw0eJUUgicJs2pQ6YnTZWmm87muk7xmDVM7A552hVvmaFX1ZgnUW5htR/9jZ/8TY+Y63OOBLGeXQM unA//B086Y6mUPZ9Lhg28sPZOHCe6KGPPSkA9aYfcEodzyG4myFjHL60Hm+QhGqy2rwIBlmJYFO8S jDS/PhJA==; Received: from localhost ([127.0.0.1] helo=bombadil.infradead.org) by bombadil.infradead.org with esmtp (Exim 4.92.3 #3 (Red Hat Linux)) id 1jVeOs-00028f-Hv; Mon, 04 May 2020 16:57:02 +0000 Received: from foss.arm.com ([217.140.110.172]) by bombadil.infradead.org with esmtp (Exim 4.92.3 #3 (Red Hat Linux)) id 1jVeO6-0001S9-Kl for linux-arm-kernel@lists.infradead.org; Mon, 04 May 2020 16:56:18 +0000 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 907011063; Mon, 4 May 2020 09:56:13 -0700 (PDT) Received: from e120937-lin.home (unknown [172.31.20.19]) by usa-sjc-imap-foss1.foss.arm.com (Postfix) with ESMTPSA id 6884C3F68F; Mon, 4 May 2020 09:56:12 -0700 (PDT) From: Cristian Marussi To: linux-kernel@vger.kernel.org, linux-arm-kernel@lists.infradead.org Subject: [PATCH v2 2/3] firmware: arm_scmi: Add SCMI System Power Control driver Date: Mon, 4 May 2020 17:55:39 +0100 Message-Id: <20200504165540.37188-3-cristian.marussi@arm.com> X-Mailer: git-send-email 2.17.1 In-Reply-To: <20200504165540.37188-1-cristian.marussi@arm.com> References: <20200504165540.37188-1-cristian.marussi@arm.com> X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20200504_095614_771386_AE90E46D X-CRM114-Status: GOOD ( 22.45 ) X-BeenThere: linux-arm-kernel@lists.infradead.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: Jonathan.Cameron@Huawei.com, cristian.marussi@arm.com, james.quinlan@broadcom.com, lukasz.luba@arm.com, sudeep.holla@arm.com MIME-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit Sender: "linux-arm-kernel" Errors-To: linux-arm-kernel-bounces+infradead-linux-arm-kernel=archiver.kernel.org@lists.infradead.org Add an SCMI System Power control driver to handle platform's requests carried by SYSTEM_POWER_STATE_NOTIFIER notifications: such platform requested system power state transitions are handled accordingly, gracefully or forcefully, depending on the notifications' message flags. Graceful requests are by default relayed to userspace using the same Kernel API used to handle ACPI Shutdown bus events: alternatively, instead, a few available module parameters can be used to tunnel instead such requests to userspace via signals addressed to CAD pid. When handling graceful requests, grant userspace processes a maximum (configurable) time to perform their duties and then revert to a forceful transition, so avoiding completely timing out platform's maximum grace time and hitting possible abrupt power-cuts. Signed-off-by: Cristian Marussi ---- V1 --> V2 - use common event enums - introduced optioanl alternative signal based comms 2 userspace --- drivers/firmware/Kconfig | 12 + drivers/firmware/arm_scmi/Makefile | 1 + drivers/firmware/arm_scmi/driver.c | 1 + .../firmware/arm_scmi/scmi_power_control.c | 389 ++++++++++++++++++ 4 files changed, 403 insertions(+) create mode 100644 drivers/firmware/arm_scmi/scmi_power_control.c diff --git a/drivers/firmware/Kconfig b/drivers/firmware/Kconfig index 8007d4aa76dc..c58f1c080a47 100644 --- a/drivers/firmware/Kconfig +++ b/drivers/firmware/Kconfig @@ -40,6 +40,18 @@ config ARM_SCMI_POWER_DOMAIN will be called scmi_pm_domain. Note this may needed early in boot before rootfs may be available. +config ARM_SCMI_POWER_CONTROL + bool "SCMI power control driver" + depends on ARM_SCMI_PROTOCOL || (COMPILE_TEST && OF) + default y + help + This enables System Power control logic which binds system shutdown or + reboot actions to SCMI System Power notifications generated by SCP + firmware. + + Graceful requests' methods and timeout and can be configured using + a few available module parameters. + config ARM_SCPI_PROTOCOL tristate "ARM System Control and Power Interface (SCPI) Message Protocol" depends on ARM || ARM64 || COMPILE_TEST diff --git a/drivers/firmware/arm_scmi/Makefile b/drivers/firmware/arm_scmi/Makefile index e01b67bc74b4..280568632791 100644 --- a/drivers/firmware/arm_scmi/Makefile +++ b/drivers/firmware/arm_scmi/Makefile @@ -7,3 +7,4 @@ scmi-transport-$(CONFIG_MAILBOX) += mailbox.o scmi-transport-$(CONFIG_HAVE_ARM_SMCCC) += smc.o scmi-protocols-y = base.o clock.o perf.o power.o reset.o sensors.o system.o obj-$(CONFIG_ARM_SCMI_POWER_DOMAIN) += scmi_pm_domain.o +obj-$(CONFIG_ARM_SCMI_POWER_CONTROL) += scmi_power_control.o diff --git a/drivers/firmware/arm_scmi/driver.c b/drivers/firmware/arm_scmi/driver.c index 5d89d0e9d650..dd6ac0819c69 100644 --- a/drivers/firmware/arm_scmi/driver.c +++ b/drivers/firmware/arm_scmi/driver.c @@ -733,6 +733,7 @@ struct scmi_prot_devnames { static struct scmi_prot_devnames devnames[] = { { SCMI_PROTOCOL_POWER, { "genpd", "notifytest" },}, + { SCMI_PROTOCOL_SYSTEM, {"syspower" },}, { SCMI_PROTOCOL_PERF, { "cpufreq" },}, { SCMI_PROTOCOL_CLOCK, { "clocks" },}, { SCMI_PROTOCOL_SENSOR, { "hwmon" },}, diff --git a/drivers/firmware/arm_scmi/scmi_power_control.c b/drivers/firmware/arm_scmi/scmi_power_control.c new file mode 100644 index 000000000000..56d01f3ffe91 --- /dev/null +++ b/drivers/firmware/arm_scmi/scmi_power_control.c @@ -0,0 +1,389 @@ +// SPDX-License-Identifier: GPL-2.0 +/* + * SCMI Generic System Power support. + * + * Copyright (C) 2020 ARM Ltd. + */ +/** + * DOC: Theory of operation + * + * In order to handle platform originated SCMI System Power requests (like + * shutdowns or cold/warm resets) we register an SCMI Notification notifier + * block to react when such SCMI System Power events are emitted. + * + * Once such a notification is received we act accordingly to perform the + * required system transition depending on the kind of request. + * + * By default graceful requests are routed to userspace through the same + * API methods (orderly_poweroff/reboot()) used by ACPI when handling ACPI + * Shutdown bus events: alternatively, by properly setting a couple of module + * parameters, it is possible to choose to use signals to CAD pid as a mean + * to communicate such graceful requests. + * + * Forceful requests instead simply cause and immediate emergency_sync() and + * subsequent Kernel-only shutdown/reboot. + * + * The assumption here is that even graceful requests can be upper-bound by a + * maximum final timeout strictly enforced by the platform itself which can + * finally cuts the power off at will: in such a scenario, which we want to + * avoid, we track the graceful requests progress through the means of a + * reboot_notifier and promptly convert a timed-out graceful request to a + * forceful one when userspace is late, in order to at least perform a clean + * sync and shutdown/restart. + * + * Given that such platform hard-timeout, when present, is anyway highly + * platform/event specific and not exposed at run-time, we make it configurable + * via the Kernel module param @scmi_graceful_request_tmo_ms. + */ + +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include + +#define DEFAULT_GRACE_TMO_MS 5000 +static unsigned int scmi_graceful_request_tmo_ms = DEFAULT_GRACE_TMO_MS; +static unsigned int scmi_graceful_poweroff_signum; +static unsigned int scmi_graceful_reboot_signum; + +enum scmi_system_request_status { + SCMI_SYSPOWER_IDLE, + SCMI_SYSPOWER_SERVED, + SCMI_SYSPOWER_INPROGRESS, + SCMI_SYSPOWER_FORCING, +}; + +struct scmi_syspower_config { + struct device *dev; + + atomic_t status; + + u32 required_state; + + void (*request_graceful_transition)(struct scmi_syspower_config *conf); + void (*request_forceful_transition)(struct scmi_syspower_config *conf); + + struct notifier_block userspace_nb; + struct notifier_block reboot_nb; + + struct timer_list request_timer; + struct work_struct forceful_work; +}; + +static void scmi_forceful_work_func(struct work_struct *work) +{ + struct scmi_syspower_config *conf = + container_of(work, struct scmi_syspower_config, forceful_work); + + conf->request_forceful_transition(conf); +} + +/** + * scmi_request_timeout - On timeout trigger a forceful transition + * @t: The timer reference + * + * Actual work is deferred out of the timer IRQ context since shutdown/reboot + * code do not play well when !in_task(). + */ +static void scmi_request_timeout(struct timer_list *t) +{ + struct scmi_syspower_config *conf = from_timer(conf, t, request_timer); + + dev_warn(conf->dev, + "SCMI Graceful System Transition request timed out !\n"); + atomic_set(&conf->status, SCMI_SYSPOWER_FORCING); + /* Ensure atomic values are updated */ + smp_mb__after_atomic(); + schedule_work(&conf->forceful_work); +} + +/** + * scmi_reboot_notifier - A reboot_notifier to catch an ongoing successful + * system transition + * @nb: Reference to the related notifier block + * @reason: The reason for the ongoing reboot + * @__unused: The cmd being executed on a restart request (unused) + * + * When an ongoing system transition is detected, compatible with the requested + * one, cancel the timer work. + * + * Return: NOTIFY_OK in any case + */ +static int scmi_reboot_notifier(struct notifier_block *nb, + unsigned long reason, void *__unused) +{ + struct scmi_syspower_config *conf; + + conf = container_of(nb, struct scmi_syspower_config, reboot_nb); + + /* Ensure atomic values are updated */ + smp_mb__before_atomic(); + if (unlikely(atomic_read(&conf->status) == SCMI_SYSPOWER_FORCING)) + return NOTIFY_OK; + + switch (reason) { + case SYS_HALT: + case SYS_POWER_OFF: + if (conf->required_state == SCMI_SYSTEM_SHUTDOWN) + atomic_set(&conf->status, SCMI_SYSPOWER_INPROGRESS); + break; + case SYS_RESTART: + if (conf->required_state == SCMI_SYSTEM_COLDRESET || + conf->required_state == SCMI_SYSTEM_WARMRESET) + atomic_set(&conf->status, SCMI_SYSPOWER_INPROGRESS); + break; + default: + break; + } + + /* Ensure atomic values are updated */ + smp_mb__after_atomic(); + if (atomic_read(&conf->status) == SCMI_SYSPOWER_INPROGRESS) { + dev_info(conf->dev, + "SCMI System State request in progress...\n"); + del_timer_sync(&conf->request_timer); + } + + return NOTIFY_OK; +} + +static inline void scmi_send_cad_signal(struct device *dev, unsigned int sig) +{ + dev_info(dev, "SCMI Sending signal %d to CAD pid\n", sig); + + kill_cad_pid(sig, 1); +} + +/** + * scmi_request_graceful_transition - Request graceful SystemPower transition + * @conf: The current SystemPower configuration descriptor + * + * Initiates the required SystemPower transition, requesting userspace + * co-operation using the same orderly_ methods used by ACPI Shutdown event + * processing. + * + * This takes care also to register a reboot notifier and a timer callback in + * order to detect if userspace actions are taking too long; in such a case + * the timeout callback will finally perform a forceful transition, ignoring + * lagging userspace: the aim here is to at least perform an emergency_sync() + * and a clean shutdown or reboot transition when userspace is late, avoiding + * the brutal final power-cut from platform. + */ +static void scmi_request_graceful_transition(struct scmi_syspower_config *conf) +{ + int ret; + u32 status; + + if (conf->required_state >= SCMI_SYSTEM_POWERUP) { + dev_warn(conf->dev, + "Received unexpected SYSTEM POWER request: %d\n", + conf->required_state); + return; + } + + status = atomic_cmpxchg(&conf->status, SCMI_SYSPOWER_IDLE, + SCMI_SYSPOWER_SERVED); + if (status != SCMI_SYSPOWER_IDLE) + return; + + ret = devm_register_reboot_notifier(conf->dev, &conf->reboot_nb); + if (ret) + dev_warn(conf->dev, "Cannot register reboot notifier !\n"); + + INIT_WORK(&conf->forceful_work, scmi_forceful_work_func); + conf->request_timer.expires = jiffies + + msecs_to_jiffies(scmi_graceful_request_tmo_ms); + timer_setup(&conf->request_timer, scmi_request_timeout, 0); + add_timer(&conf->request_timer); + + dev_info(conf->dev, + "Serving SCMI Graceful request: %d (timeout_ms:%d)\n", + conf->required_state, scmi_graceful_request_tmo_ms); + + switch (conf->required_state) { + case SCMI_SYSTEM_SHUTDOWN: + /* + * When received early at boot-time the 'orderly' part will + * fail due to the lack of userspace itself, but the force=true + * argument will anyway be able trigger a successful forced + * shutdown. + */ + if (!scmi_graceful_poweroff_signum) + orderly_poweroff(true); + else + scmi_send_cad_signal(conf->dev, + scmi_graceful_poweroff_signum); + break; + case SCMI_SYSTEM_COLDRESET: + case SCMI_SYSTEM_WARMRESET: + if (!scmi_graceful_reboot_signum) + orderly_reboot(); + else + scmi_send_cad_signal(conf->dev, + scmi_graceful_reboot_signum); + break; + default: + break; + } +} + +static void scmi_request_forceful_transition(struct scmi_syspower_config *conf) +{ + /* Ensure atomic values are updated */ + smp_mb__before_atomic(); + if (unlikely(atomic_read(&conf->status) == SCMI_SYSPOWER_INPROGRESS)) + return; + + dev_info(conf->dev, "Serving SCMI FORCEFUL SystemPower request:%d\n", + conf->required_state); + + emergency_sync(); + switch (conf->required_state) { + case SCMI_SYSTEM_SHUTDOWN: + kernel_power_off(); + break; + case SCMI_SYSTEM_COLDRESET: + case SCMI_SYSTEM_WARMRESET: + kernel_restart(NULL); + break; + default: + break; + } +} + +#define SCMI_IS_REQUEST_GRACEFUL(flags) ((flags) & BIT(0)) + +/** + * scmi_userspace_notifier - Notifier callback to act on SystemPower + * Notifications + * @nb: Reference to the related notifier block + * @event: The SystemPower notification event id + * @data: The SystemPower event report + * + * This callback is in charge of decoding the received SystemPower report + * and act accordingly triggering a graceful or forceful system transition. + * + * Return: NOTIFY_OK in any case + */ +static int scmi_userspace_notifier(struct notifier_block *nb, + unsigned long event, void *data) +{ + struct scmi_system_power_state_notifier_report *er = data; + struct scmi_syspower_config *conf; + + if (unlikely(system_state > SYSTEM_RUNNING)) + return NOTIFY_OK; + + conf = container_of(nb, struct scmi_syspower_config, userspace_nb); + conf->required_state = er->system_state; + + if (conf->required_state >= SCMI_SYSTEM_MAX) + return NOTIFY_OK; + + if (SCMI_IS_REQUEST_GRACEFUL(er->flags)) + conf->request_graceful_transition(conf); + else + conf->request_forceful_transition(conf); + + return NOTIFY_OK; +} + +/** + * scmi_syspower_configure - General SystemPower configuration init + * @dev: The associated struct device + * + * Return: SystemPower configuration descriptor on Success, NULL otherwise + */ +static void *scmi_syspower_configure(struct device *dev) +{ + struct scmi_syspower_config *conf; + + conf = devm_kzalloc(dev, sizeof(*conf), GFP_KERNEL); + if (!conf) + return NULL; + + conf->dev = dev; + conf->required_state = SCMI_SYSTEM_MAX; + conf->request_graceful_transition = &scmi_request_graceful_transition; + conf->request_forceful_transition = &scmi_request_forceful_transition; + conf->userspace_nb.notifier_call = &scmi_userspace_notifier; + conf->reboot_nb.notifier_call = &scmi_reboot_notifier; + atomic_set(&conf->status, SCMI_SYSPOWER_IDLE); + /* Ensure atomic values are updated */ + smp_mb__after_atomic(); + + return conf; +} + +static int scmi_syspower_probe(struct scmi_device *sdev) +{ + int ret; + struct scmi_handle *handle = sdev->handle; + struct scmi_syspower_config *syspower_conf; + + if (!handle) + return -ENODEV; + + syspower_conf = scmi_syspower_configure(&sdev->dev); + if (!syspower_conf) + return -ENOMEM; + + dev_set_drvdata(&sdev->dev, syspower_conf); + ret = handle->notify_ops->register_event_notifier(handle, + SCMI_PROTOCOL_SYSTEM, + SCMI_EVENT_SYSTEM_POWER_STATE_NOTIFIER, + NULL, &syspower_conf->userspace_nb); + + return 0; +} + +static void scmi_syspower_remove(struct scmi_device *sdev) +{ + int ret; + const struct scmi_handle *handle = sdev->handle; + struct scmi_syspower_config *syspower_conf; + + syspower_conf = dev_get_drvdata(&sdev->dev); + ret = handle->notify_ops->unregister_event_notifier(handle, + SCMI_PROTOCOL_SYSTEM, + SCMI_EVENT_SYSTEM_POWER_STATE_NOTIFIER, + NULL, &syspower_conf->userspace_nb); +} + +static const struct scmi_device_id scmi_id_table[] = { + { SCMI_PROTOCOL_SYSTEM, "syspower" }, + { }, +}; +MODULE_DEVICE_TABLE(scmi, scmi_id_table); + +static struct scmi_driver scmi_system_power_driver = { + .name = "scmi-system-power", + .probe = scmi_syspower_probe, + .remove = scmi_syspower_remove, + .id_table = scmi_id_table, +}; +module_scmi_driver(scmi_system_power_driver); + +module_param(scmi_graceful_request_tmo_ms, uint, 0644); +MODULE_PARM_DESC(scmi_graceful_request_tmo_ms, + "Maximum time(ms) allowed to userspace for complying to the request."); + +module_param(scmi_graceful_poweroff_signum, uint, 0644); +MODULE_PARM_DESC(scmi_graceful_poweroff_signum, + "Signal to request graceful poweroff to CAD process. Ignored if zero."); + +module_param(scmi_graceful_reboot_signum, uint, 0644); +MODULE_PARM_DESC(scmi_graceful_reboot_signum, + "Signal to request graceful reboot to CAD process. Ignored if zero."); + +MODULE_AUTHOR("Cristian Marussi "); +MODULE_DESCRIPTION("ARM SCMI System Power driver"); +MODULE_LICENSE("GPL v2"); -- 2.17.1 _______________________________________________ linux-arm-kernel mailing list linux-arm-kernel@lists.infradead.org http://lists.infradead.org/mailman/listinfo/linux-arm-kernel