On Wed, Jun 05, 2019 at 08:03:11PM +0100, Mike Leach wrote:
Add API usage document for sysfs API in CTI driver.
Signed-off-by: Mike Leach mike.leach@linaro.org
.../testing/sysfs-bus-coresight-devices-cti | 225 ++++++++++++++++++ 1 file changed, 225 insertions(+) create mode 100644 Documentation/ABI/testing/sysfs-bus-coresight-devices-cti
diff --git a/Documentation/ABI/testing/sysfs-bus-coresight-devices-cti b/Documentation/ABI/testing/sysfs-bus-coresight-devices-cti new file mode 100644 index 000000000000..4dd3ba94d2b2 --- /dev/null +++ b/Documentation/ABI/testing/sysfs-bus-coresight-devices-cti @@ -0,0 +1,225 @@ +What: /sys/bus/coresight/devices/<cti-name>/enable +Date: Apr 2019 +KernelVersion 5.3
I would like your work to become public during the 5.3 cycle and hopfully queued for 5.4, which will likely show up in September 2019.
+Contact: Mike Leach or Mathieu Poirier +Description: (RW) Enable/Disable the CTI hardware.
+What: /sys/bus/coresight/devices/<cti-name>/ctmid +Date: Apr 2019 +KernelVersion 5.3 +Contact: Mike Leach or Mathieu Poirier +Description: (R) Display the associated CTM ID
+What: /sys/bus/coresight/devices/<cti-name>/connections/nr_cons +Date: Apr 2019 +KernelVersion 5.3 +Contact: Mike Leach or Mathieu Poirier +Description: (R) Number of devices connected to this CTI
+What: /sys/bus/coresight/devices/<cti-name>/connections/<N>_name +Date: Apr 2019 +KernelVersion 5.3 +Contact: Mike Leach or Mathieu Poirier +Description: (R) Name of connected device <N>
+What: /sys/bus/coresight/devices/<cti-name>/connections/<N>_trgin_sig +Date: Apr 2019 +KernelVersion 5.3 +Contact: Mike Leach or Mathieu Poirier +Description: (R) Input trigger signals from connected device <N>
+What: /sys/bus/coresight/devices/<cti-name>/connections/<N>_trgin_type +Date: Apr 2019 +KernelVersion 5.3 +Contact: Mike Leach or Mathieu Poirier +Description: (R) Functional types for the input trigger signals
from connected device <N>+What: /sys/bus/coresight/devices/<cti-name>/connections/<N>_trgout_sig +Date: Apr 2019 +KernelVersion 5.3 +Contact: Mike Leach or Mathieu Poirier +Description: (R) Output trigger signals to connected device <N>
+What: /sys/bus/coresight/devices/<cti-name>/connections/<N>_trgout_type +Date: Apr 2019 +KernelVersion 5.3 +Contact: Mike Leach or Mathieu Poirier +Description: (R) Functional types for the output trigger signals
to connected device <N>+What: /sys/bus/coresight/devices/<cti-name>/regs/inout_sel +Date: Apr 2019 +KernelVersion 5.3 +Contact: Mike Leach or Mathieu Poirier +Description: (RW) Select the index for inen and outen registers.
+What: /sys/bus/coresight/devices/<cti-name>/regs/inen +Date: Apr 2019 +KernelVersion 5.3 +Contact: Mike Leach or Mathieu Poirier +Description: (RW) Read or write the CTIINEN register selected by inout_sel.
+What: /sys/bus/coresight/devices/<cti-name>/regs/outen +Date: Apr 2019 +KernelVersion 5.3 +Contact: Mike Leach or Mathieu Poirier +Description: (RW) Read or write the CTIOUTEN register selected by inout_sel.
+What: /sys/bus/coresight/devices/<cti-name>/regs/gate +Date: Apr 2019 +KernelVersion 5.3 +Contact: Mike Leach or Mathieu Poirier +Description: (RW) Read or write CTIGATE register.
+What: /sys/bus/coresight/devices/<cti-name>/regs/asicctl +Date: Apr 2019 +KernelVersion 5.3 +Contact: Mike Leach or Mathieu Poirier +Description: (RW) Read or write ASICCTL register.
+What: /sys/bus/coresight/devices/<cti-name>/regs/intack +Date: Apr 2019 +KernelVersion 5.3 +Contact: Mike Leach or Mathieu Poirier +Description: (W) Write the INTACK register.
+What: /sys/bus/coresight/devices/<cti-name>/regs/appset +Date: Apr 2019 +KernelVersion 5.3 +Contact: Mike Leach or Mathieu Poirier +Description: (RW) Set CTIAPPSET register to activate channel. Read back to
determine current value of register.+What: /sys/bus/coresight/devices/<cti-name>/regs/appclear +Date: Apr 2019 +KernelVersion 5.3 +Contact: Mike Leach or Mathieu Poirier +Description: (W) Write APPCLEAR register to deactivate channel.
+What: /sys/bus/coresight/devices/<cti-name>/regs/apppulse +Date: Apr 2019 +KernelVersion 5.3 +Contact: Mike Leach or Mathieu Poirier +Description: (W) Write APPPULSE to pulse a channel active for one clock
cycle.+What: /sys/bus/coresight/devices/<cti-name>/regs/chinstatus +Date: Apr 2019 +KernelVersion 5.3 +Contact: Mike Leach or Mathieu Poirier +Description: (R) Read current status of channel inputs.
+What: /sys/bus/coresight/devices/<cti-name>/regs/choutstatus +Date: Apr 2019 +KernelVersion 5.3 +Contact: Mike Leach or Mathieu Poirier +Description: (R) read current status of channel outputs.
s/read/Read
+What: /sys/bus/coresight/devices/<cti-name>/regs/triginstatus +Date: Apr 2019 +KernelVersion 5.3 +Contact: Mike Leach or Mathieu Poirier +Description: (R) read current status of input trigger signals
s/read/Read
+What: /sys/bus/coresight/devices/<cti-name>/regs/trigoutstatus +Date: Apr 2019 +KernelVersion 5.3 +Contact: Mike Leach or Mathieu Poirier +Description: (R) read current status of output trigger signals.
s/read/Read
+What: /sys/bus/coresight/devices/<cti-name>/channels/trigin_attach +Date: Apr 2019 +KernelVersion 5.3 +Contact: Mike Leach or Mathieu Poirier +Description: (W) Attach a CTI input trigger to a CTM channel.
+What: /sys/bus/coresight/devices/<cti-name>/channels/trigin_detach +Date: Apr 2019 +KernelVersion 5.3 +Contact: Mike Leach or Mathieu Poirier +Description: (W) Detach a CTI input trigger from a CTM channel.
+What: /sys/bus/coresight/devices/<cti-name>/channels/trigout_attach +Date: Apr 2019 +KernelVersion 5.3 +Contact: Mike Leach or Mathieu Poirier +Description: (W) Attach a CTI output trigger to a CTM channel.
+What: /sys/bus/coresight/devices/<cti-name>/channels/trigout_detach +Date: Apr 2019 +KernelVersion 5.3 +Contact: Mike Leach or Mathieu Poirier +Description: (W) Detach a CTI output trigger from a CTM channel.
+What: /sys/bus/coresight/devices/<cti-name>/channels/gate_enable +Date: Apr 2019 +KernelVersion 5.3 +Contact: Mike Leach or Mathieu Poirier +Description: (W) Enable CTIGATE for single channel or all channels.
+What: /sys/bus/coresight/devices/<cti-name>/channels/gate_disable +Date: Apr 2019 +KernelVersion 5.3 +Contact: Mike Leach or Mathieu Poirier +Description: (W) Disable CTIGATE for single channel or all channels.
+What: /sys/bus/coresight/devices/<cti-name>/channels/chan_set +Date: Apr 2019 +KernelVersion 5.3 +Contact: Mike Leach or Mathieu Poirier +Description: (W) Activate a single channel.
+What: /sys/bus/coresight/devices/<cti-name>/channels/chan_clear +Date: Apr 2019 +KernelVersion 5.3 +Contact: Mike Leach or Mathieu Poirier +Description: (W) Deactivate a single channel.
+What: /sys/bus/coresight/devices/<cti-name>/channels/chan_pulse +Date: Apr 2019 +KernelVersion 5.3 +Contact: Mike Leach or Mathieu Poirier +Description: (W) Pulse a single channel - activate for a single clock cycle.
+What: /sys/bus/coresight/devices/<cti-name>/channels/trig_filter_enable +Date: Apr 2019 +KernelVersion 5.3 +Contact: Mike Leach or Mathieu Poirier +Description: (RW) Enable or disable trigger output signal filtering.
+What: /sys/bus/coresight/devices/<cti-name>/channels/list_gate_ena +Date: Apr 2019 +KernelVersion 5.3 +Contact: Mike Leach or Mathieu Poirier +Description: (R) Channels enabled through the gate.
+What: /sys/bus/coresight/devices/<cti-name>/channels/list_inuse +Date: Apr 2019 +KernelVersion 5.3 +Contact: Mike Leach or Mathieu Poirier +Description: (R) show channels with at least one attached trigger signal.
s/show/Show
+What: /sys/bus/coresight/devices/<cti-name>/channels/list_free +Date: Apr 2019 +KernelVersion 5.3 +Contact: Mike Leach or Mathieu Poirier +Description: (R) show channels with no attached trigger signals.
s/show/Show
+What: /sys/bus/coresight/devices/<cti-name>/channels/show_chan_sel +Date: Apr 2019 +KernelVersion 5.3 +Contact: Mike Leach or Mathieu Poirier +Description: (RW) Select a channel for the show_chan_xtrigs operation
+What: /sys/bus/coresight/devices/<cti-name>/channels/show_chan_xtrigs +Date: Apr 2019 +KernelVersion 5.3 +Contact: Mike Leach or Mathieu Poirier +Description: (R) Show triggers attached to selected channel on this CTI.
+What: /sys/bus/coresight/devices/<cti-name>/channels/reset_xtrigs +Date: Apr 2019 +KernelVersion 5.3 +Contact: Mike Leach or Mathieu Poirier
+Description: (W) Clear all channel / trigger programming.
2.20.1
CoreSight mailing list CoreSight@lists.linaro.org https://lists.linaro.org/mailman/listinfo/coresight