[PATCH v4 00/31] Introduce SCMI Telemetry FS support

[Randy Dunlap]

On 6/12/26 3:37 PM, Cristian Marussi wrote:
> Hi all,
> 
> --------------------------------------------------------------------------------
> [TLDR Summary]
> This series introduces a new SCMI driver which uses a new Telemetry FS to expose
> and configure SCMI Telemetry Data Events retrieved from the platform SCMI FW
> at runtime. The patches carrying the new STLMFS Filesystem support are tagged
> with 'stlmfs'.
> --------------------------------------------------------------------------------

> ---
>  - moved from SysFS/chardev to a full fledged FS
>  - added support for SCMI Telemetry BLK timestamps
> 

'make htmldocs' with all documentation patches applied says:

WARNING: linext-2026-0610/Documentation/ABI/testing/stlmfs:5: tag 'contact' is invalid
		Rationale:	This filesystem provides access to SCMI telemetry data and

WARNING: linext-2026-0610/Documentation/ABI/testing/stlmfs:21: tag 'contact' is invalid
		Concurrency:	The telemetry configuration exposed through this filesystem is

Documentation/ABI/testing/stlmfs:55: ERROR: Unexpected indentation. [docutils]
Documentation/ABI/testing/stlmfs:69: ERROR: Unexpected indentation. [docutils]
Documentation/ABI/testing/stlmfs:282: ERROR: Unexpected indentation. [docutils]

WARNING: linext-2026-0610/Documentation/ABI/testing/stlmfs:39: abi_sys_fs_arm_telemetry_tlm_n doesn't have a description
linext-2026-0610/Documentation/filesystems/stlmfs.rst:255: WARNING: Title underline too short.

by-components/
----------- [docutils]

linext-2026-0610/Documentation/filesystems/stlmfs.rst: WARNING: document isn't included in any toctree [toc.not_included]


Please correct these and run 'make htmldocs' to verify that they are fixed.

> 
> Thanks,
> Cristian
> 
> [0]: https://developer.arm.com/documentation/den0056/f/?lang=en
> [1]: https://lore.kernel.org/arm-scmi/20250620192813.2463367-1-cristian.marussi@arm.com/
> [2]: https://git.kernel.org/pub/scm/linux/kernel/git/cris/linux.git/log/?h=scmi_telemetry_unified_fs_V4
> 
> Cristian Marussi (31):
>   firmware: arm_scmi: Add new SCMIv4.0 error codes definitions
>   firmware: arm_scmi: Reduce the scope of protocols mutex
>   firmware: arm_scmi: Allow registration of unknown-size events/reports
>   firmware: arm_scmi: Allow protocols to register for notifications
>   uapi: Add ARM SCMI definitions
>   dt-bindings: firmware: arm,scmi: Add support for telemetry protocol
>   include: trace: Add Telemetry trace events
>   firmware: arm_scmi: Add basic Telemetry support
>   firmware: arm_scmi: Add support to parse SHMTIs areas
>   firmware: arm_scmi: Add Telemetry configuration operations
>   firmware: arm_scmi: Add Telemetry DataEvent read capabilities
>   firmware: arm_scmi: Add support for Telemetry reset
>   firmware: arm_scmi: Add Telemetry notification support
>   firmware: arm_scmi: Add support for boot-on Telemetry
>   firmware: arm_scmi: Add Telemetry generation counter
>   firmware: arm_scmi: Add common per-protocol debugfs support
>   firmware: arm_scmi: Add Telemetry debugfs SHMTI dump support
>   firmware: arm_scmi: Add Telemetry debugfs ABI documentation
>   firmware: arm_scmi: stlmfs: Add System Telemetry filesystem driver
>   fs/stlmfs: Document ARM SCMI Telemetry filesystem
>   firmware: arm_scmi: stlmfs: Add basic mount options
>   fs/stlmfs: Document ARM SCMI Telemetry FS mount options
>   firmware: arm_scmi: stlmfs: Add ioctls support
>   fs/stlmfs: Document alternative ioctl based binary interface
>   firmware: arm_scmi: stlmfs: Add by-components view
>   fs/stlmfs: Document alternative topological view
>   firmware: arm_scmi: stlmfs: Add generation file
>   [RFC] docs: stlmfs: Document ARM SCMI Telemetry FS ABI
>   firmware: arm_scmi: stlmfs: Add lazy population support
>   fs/stlmfs: Document lazy mode and related mount option
>   [RFC] tools/scmi: Add SCMI Telemetry testing tool
> 
>  Documentation/ABI/testing/debugfs-scmi        |   22 +
>  Documentation/ABI/testing/stlmfs              |  348 ++
>  .../bindings/firmware/arm,scmi.yaml           |    8 +
>  Documentation/filesystems/stlmfs.rst          |  342 ++
>  MAINTAINERS                                   |    1 +
>  drivers/firmware/arm_scmi/Kconfig             |   24 +
>  drivers/firmware/arm_scmi/Makefile            |    3 +-
>  drivers/firmware/arm_scmi/common.h            |   10 +
>  drivers/firmware/arm_scmi/driver.c            |   93 +-
>  drivers/firmware/arm_scmi/notify.c            |   30 +-
>  drivers/firmware/arm_scmi/notify.h            |    8 +-
>  drivers/firmware/arm_scmi/protocols.h         |   13 +
>  .../firmware/arm_scmi/scmi_system_telemetry.c | 3146 ++++++++++++++++
>  drivers/firmware/arm_scmi/telemetry.c         | 3300 +++++++++++++++++
>  include/linux/scmi_protocol.h                 |  203 +-
>  include/trace/events/scmi.h                   |   48 +-
>  include/uapi/linux/scmi.h                     |  289 ++
>  tools/testing/scmi/Makefile                   |   25 +
>  tools/testing/scmi/stlm.c                     |  434 +++
>  19 files changed, 8307 insertions(+), 40 deletions(-)
>  create mode 100644 Documentation/ABI/testing/stlmfs
>  create mode 100644 Documentation/filesystems/stlmfs.rst
>  create mode 100644 drivers/firmware/arm_scmi/scmi_system_telemetry.c
>  create mode 100644 drivers/firmware/arm_scmi/telemetry.c
>  create mode 100644 include/uapi/linux/scmi.h
>  create mode 100644 tools/testing/scmi/Makefile
>  create mode 100644 tools/testing/scmi/stlm.c
> 

-- 
~Randy