[PATCH v4 26/31] fs/stlmfs: Document alternative topological view
Cristian Marussi <[email protected]> Fri, 12 Jun 2026 23:37:56 +0100
| Newsgroups | org.kernel.vger.arm-scmi,org.infradead.lists.linux-arm-kernel,org.kernel.vger.linux-doc,org.kernel.vger.linux-fsdevel,org.kernel.vger.linux-kernel |
|---|---|
| Message-ID | <[email protected]> |
The human readable interface presents an alternative view based on the discovered topological relations between the DEs. Signed-off-by: Cristian Marussi <[email protected]> --- v3 --> v4 - renamed to by-components 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 0c7b7c006709..b5b3cd649775 100644 --- a/Documentation/filesystems/stlmfs.rst +++ b/Documentation/filesystems/stlmfs.rst @@ -143,6 +143,7 @@ create the following directory structure:: |-- all_des_enable |-- all_des_tstamp_enable |-- available_update_intervals_ms + |-- by-components/ |-- control |-- current_update_interval_ms |-- de_implementation_version @@ -233,6 +234,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.54.0