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 Received: from kanga.kvack.org (kanga.kvack.org [205.233.56.17]) (using TLSv1 with cipher DHE-RSA-AES256-SHA (256/256 bits)) (No client certificate requested) by smtp.lore.kernel.org (Postfix) with ESMTPS id 00E95C44500 for ; Sat, 4 Jul 2026 22:08:26 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id C6D456B00A4; Sat, 4 Jul 2026 18:08:25 -0400 (EDT) Received: by kanga.kvack.org (Postfix, from userid 40) id C44D76B00A5; Sat, 4 Jul 2026 18:08:25 -0400 (EDT) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id B38C66B00A6; Sat, 4 Jul 2026 18:08:25 -0400 (EDT) X-Delivered-To: linux-mm@kvack.org Received: from relay.hostedemail.com (smtprelay0016.hostedemail.com [216.40.44.16]) by kanga.kvack.org (Postfix) with ESMTP id 6C3446B00A4 for ; Sat, 4 Jul 2026 18:08:25 -0400 (EDT) Received: from smtpin11.hostedemail.com (lb01a-stub [10.200.18.249]) by unirelay08.hostedemail.com (Postfix) with ESMTP id D5733140588 for ; Sat, 4 Jul 2026 22:08:24 +0000 (UTC) X-FDA: 84952483728.11.092D82F Received: from mail-wr1-f48.google.com (mail-wr1-f48.google.com [209.85.221.48]) by imf04.hostedemail.com (Postfix) with ESMTP id 111EC40002 for ; Sat, 4 Jul 2026 22:08:22 +0000 (UTC) Authentication-Results: imf04.hostedemail.com; dkim=pass header.d=gmail.com header.s=20251104 header.b=Kw+dcUd+; spf=pass (imf04.hostedemail.com: domain of shijujose2008@gmail.com designates 209.85.221.48 as permitted sender) smtp.mailfrom=shijujose2008@gmail.com; dmarc=pass (policy=none) header.from=gmail.com ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=hostedemail.com; s=arc-20220608; t=1783202903; h=from:from:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:cc:mime-version:mime-version: content-type:content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references:dkim-signature; bh=Gk+GUURV1zwMtcnJFQqFv5rWx0yVOJwKIlcrySZRbZM=; b=O3CBL0EWU+q7DDxIUAU12Cu7UlSEcru4wRyCcr+dkA4+KnqrNsCFfAPBvH/PW0+BSKPZmR j7fZWElKVEYxcI6zKxg+Yae/xYyC634EiTmFCVBY10vH82A1yX7vSN2yueEkZhjnrGzSxe gFg1SydSLxgf5UE53t84JZ4kyWg3198= ARC-Authentication-Results: i=1; imf04.hostedemail.com; dkim=pass header.d=gmail.com header.s=20251104 header.b=Kw+dcUd+; spf=pass (imf04.hostedemail.com: domain of shijujose2008@gmail.com designates 209.85.221.48 as permitted sender) smtp.mailfrom=shijujose2008@gmail.com; dmarc=pass (policy=none) header.from=gmail.com ARC-Seal: i=1; a=rsa-sha256; d=hostedemail.com; s=arc-20220608; cv=none; t=1783202903; b=6oRymEZ9SutQC2JAqpz3WeyvuKrkiJMEESo12LnZlcjSGDgDe4q8ES69XsjU4vBb8/d33O HB3uDXUo9mnruPx+fe8BJWvnufSJCtRxnf4ym+cG2KqJ0PHgBYpljaW5pkKQaVJ4OocOKn Uo8fjjqdoXgZYzB716TD5eOeUQqErcs= Received: by mail-wr1-f48.google.com with SMTP id ffacd0b85a97d-4759b4f0897so708246f8f.1 for ; Sat, 04 Jul 2026 15:08:22 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20251104; t=1783202902; x=1783807702; darn=kvack.org; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:from:to:cc:subject:date :message-id:reply-to; bh=Gk+GUURV1zwMtcnJFQqFv5rWx0yVOJwKIlcrySZRbZM=; b=Kw+dcUd+i9mLiERrlNp9Uy2+4JVrlL/GVWMwuTtF5QTX6UoUCeM34efGLJm0lmyXmo STRlHCPoiPZ9ZgSL/l8ktcDZNgz6/wczfGQNS/bH2TAYcgo+qWljDcVNJGeESF9yMzh5 ochPEMaER+tezhFrGej98EcRFBLuYGq7Hs/EBTC83E2FVJgGbjWwI3/Fx1fKeTSjLJ8L 5z6UsCF6mu4cWhW6mRUs+F4g8UXl2B3pxP8mzGafCG9vgoAQrhq2JSJYnzwTPe85bhfi QIxNx3bWxR/5jJdjto65zWTQdTmaxyc7VlZcWVk9JhpOmX15fsHOvvAcpqYO87KK5nRt UzUQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20251104; t=1783202902; x=1783807702; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-gg:x-gm-message-state:from :to:cc:subject:date:message-id:reply-to; bh=Gk+GUURV1zwMtcnJFQqFv5rWx0yVOJwKIlcrySZRbZM=; b=W58L9GCPkVjEnym+SG7YjEhMy3VopAlnBlP2sjynX5ZzpAi0KolFtKELKV2RrnXXHp plZoa5Us7dHX23sDUZyHpHHlIKCpXyP6xfG0eHJhTj3+2ZtOY8yaLz21tsKNb+MB4DMC 2/eHawgSCW+IffS9B4Jp43P0UnILXaquZyXX6BZiuWITwKIIODp49469em4B95rZfdy8 yiVm4NnCSSXXva7MwqK7gOwi9pTSHKaFP/Y1JSAlzfFOv9dLYua9tnflvzx2HUm8VZ9p 5lkNDPrbHw/x1Z+IYjLbAr6KlpypHYInlTnVxw/zy4r+aXn8azDY0t0cUIi50ZWK1lby Gq0g== X-Forwarded-Encrypted: i=1; AHgh+RqE//AztJ4i08lBIaYr3APf7VDtZZh9ynmGngXkWmMPJGCmebZpNzt6jgPLFmYre/AKL7PIqff/ug==@kvack.org X-Gm-Message-State: AOJu0YydgiCjBZScVrU1T04rmKidJTt/AgSIcQV3FeLHq05OjnIsxq6w s44lPPURPoMFowwLguYLyo+wHraw0H3gq1T7ObLKkD4GcjKV9+gPNfad X-Gm-Gg: AfdE7cmyw89eKa4QFspYojiSIf3aTpX4gPx+um/1sjZNjbntoLBz2oxtOKsQLQjB/O0 vysxI29+XbUlTzpWp9/SYVx/ssdq6ozexCwIZkfbF5o/Zt8v8X/Ckdd4ZaOoYPAbXCw10YJmEkf 2UeP33TTTlp1IGdd4+ryPx9aKiz2SMMG6n05cExIKTV3v8mNFnJiQkTouhqyYsy0YNMh+Z50Olh MCQBzyDzZv7zkmOeHT4LoVEhnqLKNssKvtbzC1rGsYJew4vjvzWzGf8BQztu72Qxi1evqe0zLjL Ewt88UdPgaJRCBKsdEhTZSitYMU6oCxs2+biKI3VfiJ1FjrSvAUMqKuxSi9plj8mnvTaBoDp0qW Y6bdtYG436Lnt2b7y53mTM4rLRyDc68jhe8WpEilgth6CXlgrj6wUcDQUl2jzbgqehyN67JhXTW 52QQKJ6qA7Sm3qe9OAYiYg9jbf5MmIh0u6eSa1SRLbrkuS7N+6heQZO6DBBxy2aFX9Vt0ex9KfF XzamxYVJoNvTiNxszNAHw== X-Received: by 2002:a5d:5f86:0:b0:47b:69a5:7264 with SMTP id ffacd0b85a97d-47b69a573bcmr3080843f8f.5.1783202901557; Sat, 04 Jul 2026 15:08:21 -0700 (PDT) Received: from localhost.localdomain (stev-08-b2-v4wan-169520-cust2225.vm32.cable.virginm.net. [81.98.232.178]) by smtp.gmail.com with ESMTPSA id ffacd0b85a97d-47aa0960816sm10478477f8f.29.2026.07.04.15.08.19 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sat, 04 Jul 2026 15:08:20 -0700 (PDT) From: shijujose2008@gmail.com To: rafael@kernel.org, bp@alien8.de, akpm@linux-foundation.org, rppt@kernel.org, dferguson@amperecomputing.com, linux-edac@vger.kernel.org, linux-acpi@vger.kernel.org, linux-mm@kvack.org, linux-doc@vger.kernel.org, tony.luck@intel.com, lenb@kernel.org, leo.duran@amd.com, Yazen.Ghannam@amd.com, mchehab@kernel.org Cc: jic23@kernel.org, linuxarm@huawei.com, rientjes@google.com, jiaqiyan@google.com, Jon.Grimm@amd.com, dave.hansen@linux.intel.com, naoya.horiguchi@nec.com, james.morse@arm.com, jthoughton@google.com, somasundaram.a@hpe.com, erdemaktas@google.com, pgonda@google.com, duenwen@google.com, gthelen@google.com, wschwartz@amperecomputing.com, wbs@os.amperecomputing.com, nifan.cxl@gmail.com, tanxiaofei@huawei.com, prime.zeng@hisilicon.com, roberto.sassu@huawei.com, kangkang.shen@futurewei.com, wanghuiqiang@huawei.com, shijujose2008@gmail.com Subject: [PATCH v20 1/2] ACPI:RAS2: Add driver for the ACPI RAS2 feature table Date: Sat, 4 Jul 2026 23:07:44 +0100 Message-Id: <20260704220745.110773-2-shijujose2008@gmail.com> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20260704220745.110773-1-shijujose2008@gmail.com> References: <20260704220745.110773-1-shijujose2008@gmail.com> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Rspam-User: X-Rspamd-Server: rspam08 X-Rspamd-Queue-Id: 111EC40002 X-Stat-Signature: 11rwp3awr9sgqa7dikn6ezapa5k7johq X-HE-Tag: 1783202902-270131 X-HE-Meta: U2FsdGVkX19rDfcli95GJgDf756QJ6h7rP44UOgiJyjLbhLTZLMjaLdkU36YVuUmZWEhmtewphJyrr1WN4aQwEvto2NQ0B3uMpYl2mFoHWOjDicx1WN/BThkVYPeoGiK8TsWZ7xEYM1T1/rT91q+OQfsan3g64NJtOp1VHxd8VwIZieI1NkQTUS3gwUF2MzouAbrG83s3DkPBK4QXVgLnXVHelaf+v0omqAgPan81C8ec88TUbrYLMR5Vdpos1iWc//Q2h6WAodXjbz/yluhymlLqok4cgtH8OKKQ2bGa9eHmJO66/AxzlrJxdzDzX+KL7fdeMq+1nImIitJwFS7EZi0AR586JX5e3UUhQeNrDs0It5dV5WYvWwHgM1dJpC7BbtI3E6FZ3HOnKzBYDC1j7V5K0b86+rYxJI2gOVPSH/rhmg/gPLRQRBMpZXCSzaj3DBi36CsCLwq1HsrjHXYz4hIbEHDsJsJBwGih7lY4IsFppDnH/Kn3Nx1HfiVcKCDasDw0uo7o9jeARUHECPKCyrx5aSGSGc5J2KFmUi+tqI1FiO1IX+gXfaUVM8avnTgwJJsSAa8iKINU+FuUGP2ewltZBYDhtLbomxDm62hteV8geroJqFdt/Rmo631O/mEXZ6EEzN4yZxaK6zvzOA6kQlFRFm4dkL3XSIaZtbZKKORDiNMFiKD9MYi3M+MmTZiDinCWREdXSRk9UJexM/74984MgwDfZhrVw+Zxj5rHN3GHFblHk9e0Hts4Z1vMo50KbRs6ravEOa+Gc62MEwv/hkoLm74+kJjAVR+BGZtMrc9sz9XpZ6wOd3/sMZPBfkTaFtrLoraIcGpun9uy/2+wpxShR+kIBJrk5XO4MQzeNEg1q5KefHG37F85gKD5+twW4KubcyI26WCvqogEh4dtNdDXistLD8SIVJ+EaqTw+S7X6Uzdina0K1Ffq7fri8tojt8BLpXpFzUJYEm0wB uAHF+lmk kWFtVSgepmfQUtjHtPcsKi85dLqcpgk2dnK78dMJOPBCalrdSsjO/O0LndAsMdxpGwje2O9du663iKaPTiqvoaE2UCuF7Y3PN3UI3MFyLnUcTos9xeZlAL+zof1wXyITlkPMaa6I9AqR++eKA5N9Ce6zJpHMWLv2Yhrs0GYMja+hEdDXh66EFptvK8E5y+6rWbk4pgknWVN+iCxiIFKbs2nL2KDtkKr2r5dGfHy9EclFprThMN0yLgrmZCBLrNe7QJlycx0VrphA04ih8cXZ8iqj0K8ZNX8AhpZ96Yd+jF3khWPxvl+cEVZK6TlTW+PtELGpVp29G9O5hZD1YmCrIABGcmI3JpNqESYiQSpzEgtaHe4f22Rm03f2Lx4ktzSTotFYff2t2F8sC4p1uMXjaOhPZI4eoHLaLwmiQzJTsjDwxHRnRYoKTNNE0I7t0nq2OarJqqgbZ6peZ61tfWKXhF/OecTxYR3BHGn/l4WsQvSWiyqYQtzDFUfQdFzdFcsxMVwFI2SKbHVOOKJrOGPcuy2YYneI6teADRmdlVLO3w7mmSTPiRRtevAES5jZeUumDSijcLdvc5NdlfBNfrjrXVexRlg== Sender: owner-linux-mm@kvack.org Precedence: bulk X-Loop: owner-majordomo@kvack.org List-ID: List-Subscribe: List-Unsubscribe: From: Shiju Jose ACPI 6.5 Specification, section 5.2.21, defined RAS2 feature table (RAS2). Driver adds support for RAS2 feature table, which provides interfaces for platform RAS features, e.g., for HW-based memory scrubbing, and logical to PA translation service. RAS2 uses PCC channel subspace for communicating with the ACPI compliant HW platform. Co-developed-by: A Somasundaram Signed-off-by: A Somasundaram Co-developed-by: Jonathan Cameron Signed-off-by: Jonathan Cameron Tested-by: Daniel Ferguson Signed-off-by: Shiju Jose --- drivers/acpi/Kconfig | 11 + drivers/acpi/Makefile | 1 + drivers/acpi/bus.c | 3 + drivers/acpi/ras2.c | 509 ++++++++++++++++++++++++++++++++++++++++++ include/acpi/ras2.h | 57 +++++ 5 files changed, 581 insertions(+) create mode 100644 drivers/acpi/ras2.c create mode 100644 include/acpi/ras2.h diff --git a/drivers/acpi/Kconfig b/drivers/acpi/Kconfig index f165d14cf61a..539ff143ccc5 100644 --- a/drivers/acpi/Kconfig +++ b/drivers/acpi/Kconfig @@ -294,6 +294,17 @@ config ACPI_CPPC_LIB If your platform does not support CPPC in firmware, leave this option disabled. +config ACPI_RAS2 + bool "ACPI RAS2 driver" + select AUXILIARY_BUS + depends on MAILBOX + depends on PCC + help + Add support for the RAS2 feature table and provide interfaces for + platform RAS features, such as hardware-based memory scrubbing. + + If unsure, select N. + config ACPI_PROCESSOR tristate "Processor" depends on X86 || ARM64 || LOONGARCH || RISCV diff --git a/drivers/acpi/Makefile b/drivers/acpi/Makefile index d1b0affb844f..abfec6745724 100644 --- a/drivers/acpi/Makefile +++ b/drivers/acpi/Makefile @@ -105,6 +105,7 @@ obj-$(CONFIG_ACPI_EC_DEBUGFS) += ec_sys.o obj-$(CONFIG_ACPI_BGRT) += bgrt.o obj-$(CONFIG_ACPI_CPPC_LIB) += cppc_acpi.o obj-$(CONFIG_ACPI_SPCR_TABLE) += spcr.o +obj-$(CONFIG_ACPI_RAS2) += ras2.o obj-$(CONFIG_ACPI_DEBUGGER_USER) += acpi_dbg.o obj-$(CONFIG_ACPI_PPTT) += pptt.o obj-$(CONFIG_ACPI_PFRUT) += pfr_update.o pfr_telemetry.o diff --git a/drivers/acpi/bus.c b/drivers/acpi/bus.c index a30a904f6535..8d6a0b773bc5 100644 --- a/drivers/acpi/bus.c +++ b/drivers/acpi/bus.c @@ -31,6 +31,7 @@ #include #include #include +#include #include "internal.h" @@ -1610,6 +1611,8 @@ static int __init acpi_init(void) acpi_debugger_init(); acpi_setup_sb_notify_handler(); acpi_viot_init(); + acpi_ras2_init(); + return 0; } diff --git a/drivers/acpi/ras2.c b/drivers/acpi/ras2.c new file mode 100644 index 000000000000..31ddf5c9688c --- /dev/null +++ b/drivers/acpi/ras2.c @@ -0,0 +1,509 @@ +// SPDX-License-Identifier: GPL-2.0-only +/* + * ACPI RAS2 feature table driver. + * + * Copyright (c) 2024-2026 HiSilicon Limited. + * + * Support for RAS2 table - ACPI 6.5 Specification, section 5.2.21, which + * provides interfaces for platform RAS features, e.g., for HW-based memory + * scrubbing, and logical to physical address translation service. RAS2 uses + * PCC channel subspace for communicating with the ACPI compliant HW platform. + */ + +#undef pr_fmt +#define pr_fmt(fmt) "ACPI RAS2: " fmt + +#include +#include +#include +#include +#include +#include + +/** + * struct ras2_sspcc - Data structure for PCC communication + * @mbox_client: struct mbox_client object + * @pcc_chan: Pointer to struct pcc_mbox_chan + * @comm_addr: Pointer to RAS2 PCC shared memory region + * @elem: List for registered RAS2 PCC channel subspaces + * @pcc_lock: PCC lock to provide mutually exclusive access + * to PCC channel subspace + * @deadline_us: Poll PCC status register timeout in microsecs + * for PCC command completion + * @pcc_mpar: Maximum Periodic Access Rate (MPAR) for PCC channel + * @pcc_mrtt: Minimum Request Turnaround Time (MRTT) in microsecs + * OS must wait after completion of a PCC command before + * issuing next command + * @last_cmd_cmpl_time: Completion time of last PCC command + * @last_mpar_reset: Time of last MPAR count reset + * @mpar_count: MPAR count + * @pcc_id: Identifier of the RAS2 platform communication channel + * @last_cmd: Last PCC command + * @kref: kref object + */ +struct ras2_sspcc { + struct mbox_client mbox_client; + struct pcc_mbox_chan *pcc_chan; + struct acpi_ras2_shmem __iomem *comm_addr; + struct list_head elem; + struct mutex pcc_lock; + u64 deadline_us; + unsigned int pcc_mpar; + unsigned int pcc_mrtt; + ktime_t last_cmd_cmpl_time; + ktime_t last_mpar_reset; + int mpar_count; + int pcc_id; + u16 last_cmd; + struct kref kref; +}; + +/* + * Arbitrary retries for PCC commands because the remote processor could be + * much slower to reply. Keep it high enough to cover emulators where the + * processors run painfully slow. + */ +#define PCC_NUM_RETRIES 600ULL +#define PCC_CHNL_DEFAULT_LATENCY 1000 +#define PCC_MIN_POLL_USECS 3 + +#define RAS2_MAX_NUM_PCC_DESCS 100 +#define RAS2_FEAT_TYPE_MEMORY 0x00 + +/* Static variables for the RAS2 PCC subspaces */ +static DEFINE_MUTEX(ras2_pcc_list_lock); +static LIST_HEAD(ras2_sspcc); + +static int check_pcc_chan(struct ras2_sspcc *sspcc) +{ + struct acpi_ras2_shmem __iomem *gen_comm_base = sspcc->comm_addr; + u32 cap_status; + u16 status; + int rc; + + /* + * As per ACPI spec, the PCC space will be initialized by the + * platform and should have set the command completion bit when + * PCC can be used by OSPM. + * + * Poll PCC status register every PCC_MIN_POLL_USECS for maximum of + * PCC_NUM_RETRIES * PCC channel latency until PCC command complete + * bit is set. + */ + rc = readw_relaxed_poll_timeout(&gen_comm_base->status, status, + status & PCC_STATUS_CMD_COMPLETE, + PCC_MIN_POLL_USECS, sspcc->deadline_us); + if (rc) { + pr_warn("PCC ID: 0x%x: PCC check channel timeout for last command: 0x%x rc=%d\n", + sspcc->pcc_id, sspcc->last_cmd, rc); + + return rc; + } + + if (status & PCC_STATUS_ERROR) { + pr_warn("PCC ID: 0x%x: Error in executing last command: 0x%x\n", + sspcc->pcc_id, sspcc->last_cmd); + status &= ~PCC_STATUS_ERROR; + iowrite16(status, &gen_comm_base->status); + iowrite32(0x0, &gen_comm_base->set_caps_status); + return -EIO; + } + + /* Ensure get updated PCC status */ + rmb(); + cap_status = ioread32(&gen_comm_base->set_caps_status); + switch (cap_status) { + case ACPI_RAS2_NOT_VALID: + case ACPI_RAS2_NOT_SUPPORTED: + rc = -EPERM; + break; + case ACPI_RAS2_BUSY: + rc = -EBUSY; + break; + case ACPI_RAS2_FAILED: + case ACPI_RAS2_ABORTED: + case ACPI_RAS2_INVALID_DATA: + rc = -EINVAL; + break; + default: + rc = 0; + } + + iowrite32(0x0, &gen_comm_base->set_caps_status); + + return rc; +} + +/** + * ras2_send_pcc_cmd() - Send RAS2 command via PCC channel + * @ras2_ctx: pointer to the RAS2 context structure + * @cmd: RAS2 command to send + * + * Returns: 0 on success, an error otherwise + */ +int ras2_send_pcc_cmd(struct ras2_mem_ctx *ras2_ctx, u16 cmd) +{ + struct acpi_ras2_shmem __iomem *gen_comm_base; + struct mbox_chan *pcc_channel; + struct ras2_sspcc *sspcc; + s64 time_delta; + u16 val; + int rc; + + if (!ras2_ctx) + return -EINVAL; + + lockdep_assert_held(ras2_ctx->pcc_lock); + sspcc = ras2_ctx->sspcc; + gen_comm_base = sspcc->comm_addr; + + rc = check_pcc_chan(sspcc); + if (rc < 0) + return rc; + + pcc_channel = sspcc->pcc_chan->mchan; + + /* + * Handle the Minimum Request Turnaround Time (MRTT): the minimum + * amount of time that OSPM must wait after the completion of + * a command before issuing the next command, in microseconds. + */ + if (sspcc->pcc_mrtt) { + time_delta = ktime_us_delta(ktime_get(), sspcc->last_cmd_cmpl_time); + if (sspcc->pcc_mrtt > time_delta) + fsleep(sspcc->pcc_mrtt - time_delta); + } + + /* + * Handle the non-zero Maximum Periodic Access Rate (MPAR): the + * maximum number of periodic requests that the subspace channel can + * support, reported in commands per minute. 0 indicates no + * limitation. + * + * This parameter should be ideally zero or large enough so that it + * can handle maximum number of requests that all the cores in the + * system can collectively generate. If it is not, follow the spec and + * just not send the request to the platform after hitting the MPAR + * limit in any 60s window. + */ + if (sspcc->pcc_mpar) { + if (!sspcc->mpar_count) { + time_delta = ktime_ms_delta(ktime_get(), sspcc->last_mpar_reset); + if ((time_delta < 60 * MSEC_PER_SEC) && sspcc->last_mpar_reset) { + dev_dbg(ras2_ctx->dev, + "PCC command 0x%x not sent due to MPAR limit", cmd); + return -EIO; + } + sspcc->last_mpar_reset = ktime_get(); + sspcc->mpar_count = sspcc->pcc_mpar; + } + sspcc->mpar_count--; + } + + /* Write to the shared comm region */ + iowrite16(cmd, &gen_comm_base->command); + + /* Flip CMD COMPLETE bit */ + iowrite16(0, &gen_comm_base->status); + + /* Ring doorbell */ + rc = mbox_send_message(pcc_channel, &cmd); + /* + * mbox_send_message() returns a non-negative integer for successful submission + * and a negative value on failure. + */ + if (rc < 0) { + dev_warn(ras2_ctx->dev, + "Error sending PCC mbox message command: 0x%x, rc:%d\n", cmd, rc); + /* Restore CMD COMPLETE bit on error */ + val = ioread16(&gen_comm_base->status); + val |= PCC_STATUS_CMD_COMPLETE; + iowrite16(val, &gen_comm_base->status); + return rc; + } else { + rc = 0; + } + + sspcc->last_cmd = cmd; + + /* + * If Minimum Request Turnaround Time is non-zero, need to record the + * completion time of both READ and WRITE commands for proper handling + * of MRTT, so need to check for pcc_mrtt in addition to PCC_CMD_EXEC_RAS2. + */ + if (cmd == PCC_CMD_EXEC_RAS2 || sspcc->pcc_mrtt) { + rc = check_pcc_chan(sspcc); + if (sspcc->pcc_mrtt) + sspcc->last_cmd_cmpl_time = ktime_get(); + } + + if (!pcc_channel->mbox->txdone_irq) + mbox_client_txdone(pcc_channel, rc); + + return rc; +} +EXPORT_SYMBOL_FOR_MODULES(ras2_send_pcc_cmd, "acpi_ras2"); + +static void ras2_list_pcc_release(struct kref *kref) +{ + struct ras2_sspcc *sspcc = + container_of(kref, struct ras2_sspcc, kref); + + guard(mutex)(&ras2_pcc_list_lock); + list_del(&sspcc->elem); + pcc_mbox_free_channel(sspcc->pcc_chan); + kfree(sspcc); +} + +static void ras2_sspcc_get(struct ras2_sspcc *sspcc) +{ + kref_get(&sspcc->kref); +} + +static void ras2_sspcc_put(struct ras2_sspcc *sspcc) +{ + kref_put(&sspcc->kref, &ras2_list_pcc_release); +} + +static struct ras2_sspcc *ras2_get_sspcc(int pcc_id) +{ + struct ras2_sspcc *sspcc; + + guard(mutex)(&ras2_pcc_list_lock); + list_for_each_entry(sspcc, &ras2_sspcc, elem) { + if (sspcc->pcc_id != pcc_id) + continue; + ras2_sspcc_get(sspcc); + return sspcc; + } + + return NULL; +} + +static int register_pcc_channel(struct ras2_mem_ctx *ras2_ctx, int pcc_id) +{ + struct pcc_mbox_chan *pcc_chan; + struct ras2_sspcc *sspcc; + + if (pcc_id < 0) + return -EINVAL; + + sspcc = ras2_get_sspcc(pcc_id); + if (sspcc) { + ras2_ctx->sspcc = sspcc; + ras2_ctx->comm_addr = sspcc->comm_addr; + ras2_ctx->dev = + sspcc->pcc_chan->mchan->mbox->dev; + ras2_ctx->pcc_lock = &sspcc->pcc_lock; + return 0; + } + + sspcc = kzalloc(sizeof(*sspcc), GFP_KERNEL); + if (!sspcc) + return -ENOMEM; + + pcc_chan = pcc_mbox_request_channel(&sspcc->mbox_client, pcc_id); + if (IS_ERR(pcc_chan)) { + kfree(sspcc); + return PTR_ERR(pcc_chan); + } + + if (!pcc_chan->shmem) { + pcc_mbox_free_channel(sspcc->pcc_chan); + kfree(sspcc); + return -EINVAL; + } + + sspcc->pcc_id = pcc_id; + sspcc->pcc_chan = pcc_chan; + sspcc->comm_addr = pcc_chan->shmem; + if (pcc_chan->latency) + sspcc->deadline_us = PCC_NUM_RETRIES * pcc_chan->latency; + else + sspcc->deadline_us = PCC_NUM_RETRIES * PCC_CHNL_DEFAULT_LATENCY; + sspcc->pcc_mrtt = pcc_chan->min_turnaround_time; + sspcc->pcc_mpar = pcc_chan->max_access_rate; + sspcc->mbox_client.knows_txdone = true; + + kref_init(&sspcc->kref); + + mutex_lock(&ras2_pcc_list_lock); + list_add(&sspcc->elem, &ras2_sspcc); + ras2_sspcc_get(sspcc); + mutex_unlock(&ras2_pcc_list_lock); + + ras2_ctx->sspcc = sspcc; + ras2_ctx->comm_addr = sspcc->comm_addr; + ras2_ctx->dev = pcc_chan->mchan->mbox->dev; + + mutex_init(&sspcc->pcc_lock); + ras2_ctx->pcc_lock = &sspcc->pcc_lock; + + return 0; +} + +static DEFINE_IDA(ras2_ida); +static void ras2_release(struct device *device) +{ + struct auxiliary_device *auxdev = to_auxiliary_dev(device); + struct ras2_mem_ctx *ras2_ctx = container_of(auxdev, struct ras2_mem_ctx, adev); + + ida_free(&ras2_ida, auxdev->id); + ras2_sspcc_put(ras2_ctx->sspcc); + kfree(ras2_ctx); +} + +static struct ras2_mem_ctx *add_aux_device(char *name, int channel, u32 pxm_inst) +{ + struct ras2_mem_ctx *ras2_ctx; + struct ras2_sspcc *sspcc; + u32 comp_nid; + int id, rc; + + comp_nid = pxm_to_node(pxm_inst); + if (comp_nid == NUMA_NO_NODE) { + pr_debug("Invalid NUMA node, channel=%d pxm_inst=%d\n", channel, pxm_inst); + return ERR_PTR(-ENXIO); + } + + ras2_ctx = kzalloc(sizeof(*ras2_ctx), GFP_KERNEL); + if (!ras2_ctx) + return ERR_PTR(-ENOMEM); + + ras2_ctx->sys_comp_nid = comp_nid; + + rc = register_pcc_channel(ras2_ctx, channel); + if (rc < 0) { + pr_debug("Failed to register PCC channel=%d pxm_inst=%d rc=%d\n", channel, + pxm_inst, rc); + goto ctx_free; + } + + id = ida_alloc(&ras2_ida, GFP_KERNEL); + if (id < 0) { + rc = id; + goto pcc_free; + } + + ras2_ctx->adev.id = id; + ras2_ctx->adev.name = name; + ras2_ctx->adev.dev.release = ras2_release; + ras2_ctx->adev.dev.parent = ras2_ctx->dev; + + rc = auxiliary_device_init(&ras2_ctx->adev); + if (rc) + goto ida_free; + + rc = auxiliary_device_add(&ras2_ctx->adev); + if (rc) { + auxiliary_device_uninit(&ras2_ctx->adev); + return ERR_PTR(rc); + } + + return ras2_ctx; + +ida_free: + ida_free(&ras2_ida, id); +pcc_free: + sspcc = ras2_ctx->sspcc; + pcc_mbox_free_channel(sspcc->pcc_chan); + kfree(sspcc); +ctx_free: + kfree(ras2_ctx); + + return ERR_PTR(rc); +} + +static void remove_aux_device(struct ras2_mem_ctx *ras2_ctx) +{ + if (!ras2_ctx) + return; + + auxiliary_device_delete(&ras2_ctx->adev); + auxiliary_device_uninit(&ras2_ctx->adev); +} + +static int parse_ras2_table(struct acpi_table_ras2 *ras2_tab) +{ + struct acpi_ras2_pcc_desc *pcc_desc_list; + struct ras2_mem_ctx **pctx_list; + struct ras2_mem_ctx *ras2_ctx; + u16 tot_tbl_len; + u16 i; + + if (ras2_tab->header.length < sizeof(*ras2_tab)) { + pr_warn(FW_WARN "ACPI RAS2 table present but broken (too short, size=%u)\n", + ras2_tab->header.length); + return -EINVAL; + } + + if (!ras2_tab->num_pcc_descs || ras2_tab->num_pcc_descs > RAS2_MAX_NUM_PCC_DESCS) { + pr_warn(FW_WARN "No/Invalid number of PCC descs(%d) in ACPI RAS2 table\n", + ras2_tab->num_pcc_descs); + return -EINVAL; + } + + tot_tbl_len = sizeof(*ras2_tab) + ras2_tab->num_pcc_descs * sizeof(*pcc_desc_list); + if (ras2_tab->header.length < tot_tbl_len) { + pr_warn(FW_WARN "RAS2 table is not large enough to contain PCC descs=%d size=%u)\n", + ras2_tab->num_pcc_descs, ras2_tab->header.length); + return -EINVAL; + } + + pctx_list = kcalloc(ras2_tab->num_pcc_descs, sizeof(*pctx_list), GFP_KERNEL); + if (!pctx_list) + return -ENOMEM; + + pcc_desc_list = (struct acpi_ras2_pcc_desc *)(ras2_tab + 1); + for (i = 0; i < ras2_tab->num_pcc_descs; i++, pcc_desc_list++) { + if (pcc_desc_list->feature_type != RAS2_FEAT_TYPE_MEMORY) + continue; + + ras2_ctx = add_aux_device(RAS2_MEM_DEV_ID_NAME, pcc_desc_list->channel_id, + pcc_desc_list->instance); + /* Invalid NUMA node, continue parsing next node */ + if (PTR_ERR(ras2_ctx) == -ENXIO) + continue; + + if (IS_ERR(ras2_ctx)) { + pr_warn("Failed to add RAS2 auxiliary device rc=%ld\n", PTR_ERR(ras2_ctx)); + for (; i > 0; i--) { + if (pctx_list[i - 1]) + remove_aux_device(pctx_list[i - 1]); + } + kfree(pctx_list); + return PTR_ERR(ras2_ctx); + } + pctx_list[i] = ras2_ctx; + } + kfree(pctx_list); + + return 0; +} + +/** + * acpi_ras2_init - RAS2 driver initialization function. + * + * Extracts the ACPI RAS2 table and retrieves ID for the PCC channel subspace + * for communicating with the ACPI compliant HW platform. Driver adds an + * auxiliary device, which binds to the memory ACPI RAS2 driver, for each RAS2 + * memory feature. + * + * Returns: none. + */ +void __init acpi_ras2_init(void) +{ + struct acpi_table_ras2 *ras2_tab; + acpi_status status; + + status = acpi_get_table(ACPI_SIG_RAS2, 0, (struct acpi_table_header **)&ras2_tab); + if (ACPI_FAILURE(status)) { + pr_debug("Failed to get table, %s\n", acpi_format_exception(status)); + return; + } + + if (parse_ras2_table(ras2_tab)) + pr_debug("Failed to parse RAS2 table\n"); + + acpi_put_table((struct acpi_table_header *)ras2_tab); +} diff --git a/include/acpi/ras2.h b/include/acpi/ras2.h new file mode 100644 index 000000000000..f4574e8e0a12 --- /dev/null +++ b/include/acpi/ras2.h @@ -0,0 +1,57 @@ +/* SPDX-License-Identifier: GPL-2.0-only */ +/* + * ACPI RAS2 (RAS Feature Table) methods. + * + * Copyright (c) 2024-2026 HiSilicon Limited + */ + +#ifndef _ACPI_RAS2_H +#define _ACPI_RAS2_H + +#include +#include +#include +#include +#include + +struct device; + +/* + * ACPI spec 6.5 Table 5.82: PCC command codes used by + * RAS2 platform communication channel. + */ +#define PCC_CMD_EXEC_RAS2 0x01 + +#define RAS2_AUX_DEV_NAME "ras2" +#define RAS2_MEM_DEV_ID_NAME "acpi_ras2_mem" + +/** + * struct ras2_mem_ctx - Context for RAS2 memory features + * @adev: Auxiliary device object + * @comm_addr: Pointer to RAS2 PCC shared memory region + * @dev: Pointer to device backing struct mbox_controller for PCC + * @sspcc: Pointer to local data structure for PCC communication + * @pcc_lock: Pointer to PCC lock to provide mutually exclusive access + * to PCC channel subspace + * @sys_comp_nid: Node ID of the system component that the RAS feature + * is associated with. See ACPI spec 6.5 Table 5.80: RAS2 + * Platform Communication Channel Descriptor format, + * Field: Instance + */ +struct ras2_mem_ctx { + struct auxiliary_device adev; + struct acpi_ras2_shmem __iomem *comm_addr; + struct device *dev; + void *sspcc; + struct mutex *pcc_lock; + u32 sys_comp_nid; +}; + +#ifdef CONFIG_ACPI_RAS2 +void __init acpi_ras2_init(void); +int ras2_send_pcc_cmd(struct ras2_mem_ctx *ras2_ctx, u16 cmd); +#else +static inline void acpi_ras2_init(void) { } +#endif + +#endif /* _ACPI_RAS2_H */ -- 2.25.1