[PATCH v7 17/23] firmware: arm_scmi: Add Telemetry debugfs ABI documentation
Cristian Marussi <[email protected]> Sun, 2 Aug 2026 15:56:12 +0100
| Newsgroups | org.kernel.vger.arm-scmi,org.infradead.lists.linux-arm-kernel,org.kernel.vger.linux-doc,org.kernel.vger.linux-kernel |
|---|---|
| Message-ID | <[email protected]> |
Add description of the debugfs SCMI Telemetry protocol ABI. Signed-off-by: Cristian Marussi <[email protected]> --- 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 <n> on the RX channels. Users: Debugging, any userspace test suite + +What: /sys/kernel/debug/scmi/<n>/protocols/0x<m>/ +Date: Nov 2026 +KernelVersion: 7.3 +Contact: [email protected] +Description: A subdirectory grouping debug entries related to protocol <m> + for instance <n>. Each protocol owns and defines the subtree + of entries rooted under this directory. +Users: Debugging, any userspace test suite + +What: /sys/kernel/debug/scmi/<n>/protocols/0x1B/shmtis/<m> +Date: Nov 2026 +KernelVersion: 7.3 +Contact: [email protected] +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 <n>. +Users: Debugging, any userspace test suite -- 2.54.0