[PATCH v3 20/24] fs/stlmfs: Document alternative topological view
From: Cristian Marussi <cristian.marussi@arm.com>
Date: 2026-03-29 16:35:20
Also in:
arm-scmi, linux-doc, linux-fsdevel, lkml
Subsystem:
documentation, the rest · Maintainers:
Jonathan Corbet, Linus Torvalds
The human readable interface presents an alternative view based on the discovered topological relations between the DEs. Signed-off-by: Cristian Marussi <cristian.marussi@arm.com> --- v2 --> v3 - completed FS tree description - renamed components to by_components --- Documentation/filesystems/stlmfs.rst | 72 ++++++++++++++++++++++++++++ 1 file changed, 72 insertions(+)
diff --git a/Documentation/filesystems/stlmfs.rst b/Documentation/filesystems/stlmfs.rst
index e4f07a4f930d..a775da24f320 100644
--- a/Documentation/filesystems/stlmfs.rst
+++ b/Documentation/filesystems/stlmfs.rst@@ -113,6 +113,7 @@ the following directory structure:: |-- all_des_enable |-- all_des_tstamp_enable |-- available_update_intervals_ms + |-- components/ |-- control |-- current_update_interval_ms |-- de_implementation_version
@@ -203,6 +204,77 @@ values, as in:: |-- intervals_discrete `-- tstamp_enable +by_components/ +----------- + +An alternative topological view of the des/ directory based on the topology +relationship information described in des/ :: + + by_components/ + ├── cpu + │ ├── 0 + │ │ ├── celsius + │ │ │ └── 0 + │ │ │ └── 0x00000001[pe_0] -> ../../../../../des/0x00000001 + │ │ └── cycles + │ │ ├── 0 + │ │ │ └── 0x00001010[] -> ../../../../../des/0x00001010 + │ │ └── 1 + │ │ └── 0x00002020[] -> ../../../../../des/0x00002020 + │ ├── 1 + │ │ └── celsius + │ │ └── 0 + │ │ └── 0x00000002[pe_1] -> ../../../../../des/0x00000002 + │ └── 2 + │ └── celsius + │ └── 0 + │ └── 0x00000003[pe_2] -> ../../../../../des/0x00000003 + ├── interconnnect + │ └── 0 + │ └── hertz + │ └── 0 + │ ├── 0x0000A008[A008_de] -> ../../../../../des/0x0000A008 + │ └── 0x0000A00B[] -> ../../../../../des/0x0000A00B + ├── mem_cntrl + │ └── 0 + │ ├── bps + │ │ └── 0 + │ │ └── 0x0000A00A[] -> ../../../../../des/0x0000A00A + │ ├── celsius + │ │ └── 0 + │ │ └── 0x0000A007[DRAM_temp] -> ../../../../../des/0x0000A007 + │ └── joules + │ └── 0 + │ └── 0x0000A002[DRAM_energy] -> ../../../../../des/0x0000A002 + ├── periph + │ ├── 0 + │ │ └── messages + │ │ └── 0 + │ │ └── 0x00000016[device_16] -> ../../../../../des/0x00000016 + │ ├── 1 + │ │ └── messages + │ │ └── 0 + │ │ └── 0x00000017[device_17] -> ../../../../../des/0x00000017 + │ └── 2 + │ └── messages + │ └── 0 + │ └── 0x00000018[device_18] -> ../../../../../des/0x00000018 + └── unspec + └── 0 + ├── celsius + │ └── 0 + │ └── 0x0000A005[] -> ../../../../../des/0x0000A005 + ├── counts + │ └── 0 + │ └── 0x0000A00C[] -> ../../../../../des/0x0000A00C + ├── joules + │ └── 0 + │ ├── 0x0000A000[SOC_Energy] -> ../../../../../des/0x0000A000 + │ └── 0x0000A001[] -> ../../../../../des/0x0000A001 + └── state + └── 0 + └── 0x0000A010[] -> ../../../../../des/0x0000A010 + Alternative Binary Interfaces - Special files =============================================
--
2.53.0