Re: [PATCH v15 26/35] firmware: arm_scmi: Add Telemetry debugfs ABI documentation

[Jonathan Cameron]

On Mon,  9 Nov 2026 09:12:12 +0000
Cristian Marussi <cristian.marussi@xxxxxxx> wrote:

> Add description of the debugfs SCMI Telemetry protocol ABI.
> 
> Signed-off-by: Cristian Marussi <cristian.marussi@xxxxxxx>
> ---
> 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

Overly optimistic use of time travel.

> +Contact:	cristian.marussi@xxxxxxx
> +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:	cristian.marussi@xxxxxxx
> +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