[PATCH v4 2/3] Documentation: ABI: add sysfs-bus-counter-ecap

From: Julien Panis
Date: Wed Aug 10 2022 - 10:07:53 EST


This commit adds an ABI file for TI ECAP used in capture operating mode.

Signed-off-by: Julien Panis <jpanis@xxxxxxxxxxxx>
---
.../ABI/testing/sysfs-bus-counter-ecap | 64 +++++++++++++++++++
1 file changed, 64 insertions(+)
create mode 100644 Documentation/ABI/testing/sysfs-bus-counter-ecap

diff --git a/Documentation/ABI/testing/sysfs-bus-counter-ecap b/Documentation/ABI/testing/sysfs-bus-counter-ecap
new file mode 100644
index 000000000000..ca530a6806de
--- /dev/null
+++ b/Documentation/ABI/testing/sysfs-bus-counter-ecap
@@ -0,0 +1,64 @@
+What: /sys/bus/counter/devices/counter0/signal0/polarity1
+What: /sys/bus/counter/devices/counter0/signal0/polarity2
+What: /sys/bus/counter/devices/counter0/signal0/polarity3
+What: /sys/bus/counter/devices/counter0/signal0/polarity4
+KernelVersion: 5.19
+Contact: jpanis@xxxxxxxxxxxx
+Description:
+ ECAP module includes 4 timestamp capture registers.
+ For all 4 sequenced timestamp capture events (1->2->3->4->1->...),
+ edge polarity can be selected. Then, each capture register can be
+ tuned to capture event by either:
+
+ - "rising"
+ - "falling"
+
+ Reading returns current trigger polarity.
+
+ Writing value before enabling capture sets trigger polarity.
+
+What: /sys/bus/counter/devices/counter0/signal0/polarity1_available
+What: /sys/bus/counter/devices/counter0/signal0/polarity2_available
+What: /sys/bus/counter/devices/counter0/signal0/polarity3_available
+What: /sys/bus/counter/devices/counter0/signal0/polarity4_available
+KernelVersion: 5.19
+Contact: jpanis@xxxxxxxxxxxx
+Description:
+ Discrete set of available values for the respective polarity X
+ configuration are listed in this file. Values are delimited by
+ newline characters.
+
+What: /sys/bus/counter/devices/counter0/count0/enable
+KernelVersion: 5.19
+Contact: jpanis@xxxxxxxxxxxx
+Description:
+ Whether ECAP is enabled. Valid attribute values are boolean.
+
+ This attribute is intended to serve as a start/stop mechanism
+ for ECAP.
+
+What: /sys/bus/counter/devices/counter0/count0/count
+KernelVersion: 5.19
+Contact: jpanis@xxxxxxxxxxxx
+Description:
+ Read-only attribute that indicates the current base counter value.
+
+What: /sys/bus/counter/devices/counter0/count0/capture1
+What: /sys/bus/counter/devices/counter0/count0/capture2
+What: /sys/bus/counter/devices/counter0/count0/capture3
+What: /sys/bus/counter/devices/counter0/count0/capture4
+KernelVersion: 5.19
+Contact: jpanis@xxxxxxxxxxxx
+Description:
+ Read-only attributes that indicate the last timestamp captured
+ for the respective capture X register.
+
+What: /sys/bus/counter/devices/counter0/count0/capture1_component_id
+What: /sys/bus/counter/devices/counter0/count0/capture2_component_id
+What: /sys/bus/counter/devices/counter0/count0/capture3_component_id
+What: /sys/bus/counter/devices/counter0/count0/capture4_component_id
+KernelVersion: 5.19
+Contact: jpanis@xxxxxxxxxxxx
+Description:
+ Read-only attributes that indicate the component ID of the
+ respective extension or synapse.
--
2.25.1