From nobody Tue Feb 10 04:17:34 2026 Received: from foss.arm.com (foss.arm.com [217.140.110.172]) by smtp.subspace.kernel.org (Postfix) with ESMTP id 9734239A7F3; Wed, 14 Jan 2026 11:48:15 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=217.140.110.172 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1768391297; cv=none; b=dSY88yxZFlpPPVUpNZlqqQY6RPFJ23qkl9nhrTJbkQKAl87ZvZStgyuBbwU+61N1aqwtTKDwKNJ4QNRkPBPcXp+UtvoaVll+8NRtHkelLxzSINhifjZf159Z9Z2InrSEcwcrSsalWnXTcaRNsb2Azh+l+rO48P/+Yw6i5smxim8= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1768391297; c=relaxed/simple; bh=x4SrwuVDC56sNg8/TeRG66soJYVXmHU/A7KUL6AIB2s=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=qWsrDmZeQE1MDBEfYOsrJGgTIfBm3MLmVNp8SLflWdfX+OJZ2m5VuRxBEcfUd85DJa1mzWzZ7Tpcy0jPrFnj4eARqlT0kvSAjoyE2buHJM9lcgHhRpmTjp6zSpQmbu+LKekUwhkPrjT5wR8dmhtOH0F0psYFWzligqdAOmJj+4c= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=arm.com; spf=pass smtp.mailfrom=arm.com; arc=none smtp.client-ip=217.140.110.172 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=arm.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=arm.com Received: from usa-sjc-imap-foss1.foss.arm.com (unknown [10.121.207.14]) by usa-sjc-mx-foss1.foss.arm.com (Postfix) with ESMTP id 4D6E11424; Wed, 14 Jan 2026 03:48:08 -0800 (PST) Received: from pluto.fritz.box (usa-sjc-mx-foss1.foss.arm.com [172.31.20.19]) by usa-sjc-imap-foss1.foss.arm.com (Postfix) with ESMTPSA id 81F773F59E; Wed, 14 Jan 2026 03:48:11 -0800 (PST) From: Cristian Marussi To: linux-kernel@vger.kernel.org, linux-arm-kernel@lists.infradead.org, arm-scmi@vger.kernel.org, linux-fsdevel@vger.kernel.org Cc: sudeep.holla@arm.com, james.quinlan@broadcom.com, f.fainelli@gmail.com, vincent.guittot@linaro.org, etienne.carriere@st.com, peng.fan@oss.nxp.com, michal.simek@amd.com, dan.carpenter@linaro.org, d-gole@ti.com, jonathan.cameron@huawei.com, elif.topuz@arm.com, lukasz.luba@arm.com, philip.radford@arm.com, souvik.chakravarty@arm.com, Cristian Marussi Subject: [PATCH v2 14/17] [RFC] docs: stlmfs: Document ARM SCMI Telemetry FS ABI Date: Wed, 14 Jan 2026 11:46:18 +0000 Message-ID: <20260114114638.2290765-15-cristian.marussi@arm.com> X-Mailer: git-send-email 2.52.0 In-Reply-To: <20260114114638.2290765-1-cristian.marussi@arm.com> References: <20260114114638.2290765-1-cristian.marussi@arm.com> Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" Add full ABI dcoumentation for stlmfs under testing/ Signed-off-by: Cristian Marussi --- RFC since the documentation is still NOT complete and unsure if place this into stable/ or testing/ --- Documentation/ABI/testing/stlmfs | 153 +++++++++++++++++++++++++++++++ 1 file changed, 153 insertions(+) create mode 100644 Documentation/ABI/testing/stlmfs diff --git a/Documentation/ABI/testing/stlmfs b/Documentation/ABI/testing/s= tlmfs new file mode 100644 index 000000000000..efa001a7d82f --- /dev/null +++ b/Documentation/ABI/testing/stlmfs @@ -0,0 +1,153 @@ +What: /sys/fs/arm_telemetry/tlm_/all_des_enable +Date: January 2026 +KernelVersion: 7.0 +Contact: cristian.marussi@arm.com +Description: A boolean WO entry to enable all the discovered Data Events f= or + SCMI instance . +Users: Any userspace telemetry tool + +What: /sys/fs/arm_telemetry/tlm_/all_tstamp_des_enable +Date: January 2026 +KernelVersion: 7.0 +Contact: cristian.marussi@arm.com +Description: A boolean WO entry to enable timestamps for all the discovered + Data Events for SCMI instance . (when available) +Users: Any userspace telemetry tool + +What: /sys/fs/arm_telemetry/tlm_/available_update_intervals_ms +Date: January 2026 +KernelVersion: 7.0 +Contact: cristian.marussi@arm.com +Description: A RO entry that returns a space separated list of tuples of + values, separated by a coma, each one representing a + configurable update interval for SCMI instance . + Each tuple describes a possible update interval using the + format , where the final represented interval is + calculated as: * 10 ^ + An example of list of tuples that can be read from this entry: + 3,0 4,-1 75,-2 300,-3 1,1 5,3 222,-7 +Users: Any userspace telemetry tool + +What: /sys/fs/arm_telemetry/tlm_/current_update_intervals_ms +Date: January 2026 +KernelVersion: 7.0 +Contact: cristian.marussi@arm.com +Description: An RW entry that can be used to get or set the platform update + interval for SCMI instance . + On read the returned tuple represents the current update + interval using the format , where the final + represented interval is calculated as: * 10 ^ + On write the accepted format is the same as on read , + but, optionally, the second element of the tuple can be omitted + and in that case the assumed value for the exponent will default + to -3 signifying milliseconds. +Users: Any userspace telemetry tool + +What: /sys/fs/arm_telemetry/tlm_/control +Date: January 2026 +KernelVersion: 7.0 +Contact: cristian.marussi@arm.com +Description: An RW entry that can be used to discover, configure and retri= eve + Telemetry data using the alternative binary interface based on + ioctls which is documented in include/uapi/linux/scmi.h +Users: Any userspace telemetry tool + +What: /sys/fs/arm_telemetry/tlm_/de_implementation_version +Date: January 2026 +KernelVersion: 7.0 +Contact: cristian.marussi@arm.com +Description: A RO entry that returns a string representing the 128bit UUID + that uniquely identifies the set of SCMI Telemetry Data Events + and their semantic for SCMI instance . + This is compliant with the DE_IMPLEMENTATION_REVISION described + in SCMI v4.0 Telemetry 3.12.4.3. +Users: Any userspace telemetry tool + +What: /sys/fs/arm_telemetry/tlm_/des_bulk_read +Date: January 2026 +KernelVersion: 7.0 +Contact: cristian.marussi@arm.com +Description: A RO entry that returns a multi-line string containing all the + the DEs enabled for SCMI instance , one-per-line, formmatted + as: . + These DEs readings represent the last value updated by the + platform following the configured update interval: on the + backend they may have been collected in a number of different + ways: on-demand SHMTI lookup, notifications, fastchannels. +Users: Any userspace telemetry tool + +What: /sys/fs/arm_telemetry/tlm_/des_single_sample_read +Date: January 2026 +KernelVersion: 7.0 +Contact: cristian.marussi@arm.com +Description: A RO entry that returns a multi-line string containing all the + the DEs enabled for SCMI instance , one-per-line, formmatted + as: . + These DEs readings are generated by triggering an explicit and + immediate platform update using single sample asynchronous + collect methods. +Users: Any userspace telemetry tool + +What: /sys/fs/arm_telemetry/tlm_/intervals_discrete +Date: January 2026 +KernelVersion: 7.0 +Contact: cristian.marussi@arm.com +Description: A boolean RO entry to specify if the intervals reported for + SCMI instance in available_update_intervals_ms are a list of + discrete intervals or a triplet of values representing + . +Users: Any userspace telemetry tool + +What: /sys/fs/arm_telemetry/tlm_/reset +Date: January 2026 +KernelVersion: 7.0 +Contact: cristian.marussi@arm.com +Description: A boolean WO entry that can be used the full reset of the SCMI + Telemetry subsystem, both of the configurations and of the + collected data, as specified in SCMI v4.0 3.12.4.12 +Users: Any userspace telemetry tool + +What: /sys/fs/arm_telemetry/tlm_/tlm_enable +Date: January 2026 +KernelVersion: 7.0 +Contact: cristian.marussi@arm.com +Description: A boolean RW entry that can be used to get or set the general + enable status of the Telemetry subsystem. Temporarily disabling + Telemetry as a whole does NOT reset the current configuration, + it only stops all the DEs updates platform side. +Users: Any userspace telemetry tool + +What: /sys/fs/arm_telemetry/tlm_/version +Date: January 2026 +KernelVersion: 7.0 +Contact: cristian.marussi@arm.com +Description: A RO entry used to report the SCMI Telemetry protocol version + used in this implementation. +Users: Any userspace telemetry tool + +What: /sys/fs/arm_telemetry/tlm_/des/0x/value +Date: January 2026 +KernelVersion: 7.0 +Contact: cristian.marussi@arm.com +Description: A RO entry used to read the last value reported for Data Event + with id 0x for SCMI instance . +Users: Any userspace telemetry tool + +What: /sys/fs/arm_telemetry/tlm_/des/0x/enable +Date: January 2026 +KernelVersion: 7.0 +Contact: cristian.marussi@arm.com +Description: A RW boolean entry used to enable or disable Data Event + with id 0x for SCMI instance . +Users: Any userspace telemetry tool + +What: /sys/fs/arm_telemetry/tlm_/des/0x/tstamp_enable +Date: January 2026 +KernelVersion: 7.0 +Contact: cristian.marussi@arm.com +Description: A RW boolean entry used to enable or disable timestamping for + Data Event with id 0x for SCMI instance . +Users: Any userspace telemetry tool + + +... To BE CONTINUED ... --=20 2.52.0