From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from foss.arm.com (foss.arm.com [217.140.110.172]) by smtp.subspace.kernel.org (Postfix) with ESMTP id E6E2D3F1640; Sun, 20 Sep 2026 09:21:23 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=217.140.110.172 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1789896086; cv=none; b=Sf+wwsVOCG7EC48+MHddQfVTDjmbJ8SliqwSHzoSeX4D0Jhdee5ZNmEHHKVhYYEuiOKCfXY/wpEKcHHuP+AsWkiEtmixOVDRKJHzdtnxW6GQRM8kWa5V9VKRMWfV7coR552D6whkd20WTkPHIO5i71oa3v6yG7UbOpGKA76dkmg= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1789896086; c=relaxed/simple; bh=w7L8DbnoCEuyvO8JUAes+aM9b0PjMj4j60HnlNcmEQg=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=bbOzCPnQXVEUm6536mlNpRZA4bIxBgJ9s/lW8u6m8bj9XIPDJ6KvDnXCmHQFJ7lYQ1bfBMa+P3UunFPdCJDSGjzf7PqSZ4dRST1uAkB+ZGdUePjMJi1f6coZU2AT3Yte4mCWn9zJxHEpw1IfgDhvHI47ZmSa34Wa9GnoaQCX9Ks= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=arm.com; spf=pass smtp.mailfrom=arm.com; dkim=pass (1024-bit key) header.d=arm.com header.i=@arm.com header.b=Edb9sFg1; arc=none smtp.client-ip=217.140.110.172 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=arm.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=arm.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (1024-bit key) header.d=arm.com header.i=@arm.com header.b="Edb9sFg1" 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 695881650; Sun, 20 Sep 2026 02:21:19 -0700 (PDT) Received: from pluto.fritz.box (usa-sjc-mx-foss1.foss.arm.com [172.31.20.19]) by usa-sjc-imap-foss1.foss.arm.com (Postfix) with ESMTPSA id 087FE3F59E; Sun, 20 Sep 2026 02:21:18 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=simple/simple; d=arm.com; s=foss; t=1789896082; bh=w7L8DbnoCEuyvO8JUAes+aM9b0PjMj4j60HnlNcmEQg=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=Edb9sFg1euS2DnDbeahHVBjeguj1hf22L0sqgheDLp/UvgSAvzTh4ETmwIX2srYrR B+Ymw+J4YXNokzIvfQGscclTX8O5b2rmt2kKmr5UTLUlsnsIjcJYWIaVeQqzKseCzr bTljuYb0f+IuhhQfNoEC0qVpkR45zWBxVhldpmKQ= From: Cristian Marussi To: linux-kernel@vger.kernel.org, linux-arm-kernel@lists.infradead.org, arm-scmi@vger.kernel.org, linux-doc@vger.kernel.org Cc: sudeep.holla@kernel.org, james.quinlan@broadcom.com, f.fainelli@gmail.com, vincent.guittot@linaro.org, etienne.carriere@st.com, peng.fan@oss.nxp.com, michal.simek@amd.com, d-gole@ti.com, jic23@kernel.org, elif.topuz@arm.com, lukasz.luba@arm.com, philip.radford@arm.com, david@kernel.org, souvik.chakravarty@arm.com, leitao@kernel.org, kas@kernel.org, puranjay@kernel.org, usama.arif@linux.dev, kernel-team@meta.com, Cristian Marussi Subject: [PATCH v12 17/25] firmware: arm_scmi: Add Telemetry debugfs ABI documentation Date: Sun, 20 Sep 2026 10:19:20 +0100 Message-ID: <20260920091928.2014972-18-cristian.marussi@arm.com> X-Mailer: git-send-email 2.54.0 In-Reply-To: <20260920091928.2014972-1-cristian.marussi@arm.com> References: <20260920091928.2014972-1-cristian.marussi@arm.com> Precedence: bulk X-Mailing-List: linux-doc@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Add description of the debugfs SCMI Telemetry protocol ABI. Signed-off-by: Cristian Marussi --- v5 --> v6 - fixed typos --- Documentation/ABI/testing/debugfs-scmi | 22 ++++++++++++++++++++++ 1 file changed, 22 insertions(+) diff --git a/Documentation/ABI/testing/debugfs-scmi b/Documentation/ABI/testing/debugfs-scmi index ee7179ab2edf..edbbe360321d 100644 --- a/Documentation/ABI/testing/debugfs-scmi +++ b/Documentation/ABI/testing/debugfs-scmi @@ -68,3 +68,25 @@ Description: Max number of concurrently allowed in-flight SCMI messages for the currently configured SCMI transport for instance on the RX channels. Users: Debugging, any userspace test suite + +What: /sys/kernel/debug/scmi//protocols/0x/ +Date: Nov 2026 +KernelVersion: 7.3 +Contact: cristian.marussi@arm.com +Description: A subdirectory grouping debug entries related to protocol + for instance . Each protocol owns and defines the subtree + of entries rooted under this directory. +Users: Debugging, any userspace test suite + +What: /sys/kernel/debug/scmi//protocols/0x1B/shmtis/ +Date: Nov 2026 +KernelVersion: 7.3 +Contact: cristian.marussi@arm.com +Description: A set of RO files exposed by the Telemetry protocol (0x1B) in + order to dump the latest snapshot of each SHMTI memory area in + binary format: each file is named by its SHMTI id. + File is seekable and a seek to position zero on an open file + causes the SHMTI snapshot to be refreshed; file timestamps are + updated after each snapshot. + This directory reports SHMTIs for instance . +Users: Debugging, any userspace test suite -- 2.54.0