Re: [PATCH v5 14/14] docs: sysfs: coresight: Add sysfs ABI documentation for CTI

Mathieu Poirier
2019-11-27T19:08:57Z

On Tue, Nov 19, 2019 at 11:19:12PM +0000, 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 | 221 ++++++++++++++++++
> 1 file changed, 221 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..d867800f567f
> --- /dev/null
> +++ b/Documentation/ABI/testing/sysfs-bus-coresight-devices-cti
> @@ -0,0 +1,221 @@
> +What: /sys/bus/coresight/devices/<cti-name>/enable
> +Date: Jul 2019
> +KernelVersion 5.4
> +Contact: Mike Leach or Mathieu Poirier
> +Description: (RW) Enable/Disable the CTI hardware.

This will (likely) go in kernel 5.6 that should be released in January 2020.

In your next revision please add yourself as an official reviewer to the
coresight subsystem. This should be done at the end of the set, in a patch on
its own.

Thanks,
Mathieu

> +
> +What: /sys/bus/coresight/devices/<cti-name>/ctmid
> +Date: Jul 2019
> +KernelVersion 5.4
> +Contact: Mike Leach or Mathieu Poirier
> +Description: (R) Display the associated CTM ID
> +
> +What: /sys/bus/coresight/devices/<cti-name>/nr_trigger_cons
> +Date: Jul 2019
> +KernelVersion 5.4
> +Contact: Mike Leach or Mathieu Poirier
> +Description: (R) Number of devices connected to triggers on this CTI
> +
> +What: /sys/bus/coresight/devices/<cti-name>/triggers<N>/name
> +Date: Jul 2019
> +KernelVersion 5.4
> +Contact: Mike Leach or Mathieu Poirier
> +Description: (R) Name of connected device <N>
> +
> +What: /sys/bus/coresight/devices/<cti-name>/triggers<N>/in_signals
> +Date: Jul 2019
> +KernelVersion 5.4
> +Contact: Mike Leach or Mathieu Poirier
> +Description: (R) Input trigger signals from connected device <N>
> +
> +What: /sys/bus/coresight/devices/<cti-name>/triggers<N>/in_types
> +Date: Jul 2019
> +KernelVersion 5.4
> +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>/triggers<N>/out_signals
> +Date: Jul 2019
> +KernelVersion 5.4
> +Contact: Mike Leach or Mathieu Poirier
> +Description: (R) Output trigger signals to connected device <N>
> +
> +What: /sys/bus/coresight/devices/<cti-name>/triggers<N>/out_types
> +Date: Jul 2019
> +KernelVersion 5.4
> +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: Jul 2019
> +KernelVersion 5.4
> +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: Jul 2019
> +KernelVersion 5.4
> +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: Jul 2019
> +KernelVersion 5.4
> +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: Jul 2019
> +KernelVersion 5.4
> +Contact: Mike Leach or Mathieu Poirier
> +Description: (RW) Read or write CTIGATE register.
> +
> +What: /sys/bus/coresight/devices/<cti-name>/regs/asicctl
> +Date: Jul 2019
> +KernelVersion 5.4
> +Contact: Mike Leach or Mathieu Poirier
> +Description: (RW) Read or write ASICCTL register.
> +
> +What: /sys/bus/coresight/devices/<cti-name>/regs/intack
> +Date: Jul 2019
> +KernelVersion 5.4
> +Contact: Mike Leach or Mathieu Poirier
> +Description: (W) Write the INTACK register.
> +
> +What: /sys/bus/coresight/devices/<cti-name>/regs/appset
> +Date: Jul 2019
> +KernelVersion 5.4
> +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: Jul 2019
> +KernelVersion 5.4
> +Contact: Mike Leach or Mathieu Poirier
> +Description: (W) Write APPCLEAR register to deactivate channel.
> +
> +What: /sys/bus/coresight/devices/<cti-name>/regs/apppulse
> +Date: Jul 2019
> +KernelVersion 5.4
> +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: Jul 2019
> +KernelVersion 5.4
> +Contact: Mike Leach or Mathieu Poirier
> +Description: (R) Read current status of channel inputs.
> +
> +What: /sys/bus/coresight/devices/<cti-name>/regs/choutstatus
> +Date: Jul 2019
> +KernelVersion 5.4
> +Contact: Mike Leach or Mathieu Poirier
> +Description: (R) read current status of channel outputs.
> +
> +What: /sys/bus/coresight/devices/<cti-name>/regs/triginstatus
> +Date: Jul 2019
> +KernelVersion 5.4
> +Contact: Mike Leach or Mathieu Poirier
> +Description: (R) read current status of input trigger signals
> +
> +What: /sys/bus/coresight/devices/<cti-name>/regs/trigoutstatus
> +Date: Jul 2019
> +KernelVersion 5.4
> +Contact: Mike Leach or Mathieu Poirier
> +Description: (R) read current status of output trigger signals.
> +
> +What: /sys/bus/coresight/devices/<cti-name>/channels/trigin_attach
> +Date: Jul 2019
> +KernelVersion 5.4
> +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: Jul 2019
> +KernelVersion 5.4
> +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: Jul 2019
> +KernelVersion 5.4
> +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: Jul 2019
> +KernelVersion 5.4
> +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/chan_gate_enable
> +Date: Jul 2019
> +KernelVersion 5.4
> +Contact: Mike Leach or Mathieu Poirier
> +Description: (RW) Enable CTIGATE for single channel (W) or list enabled
> + channels through the gate (R).
> +
> +What: /sys/bus/coresight/devices/<cti-name>/channels/chan_gate_disable
> +Date: Jul 2019
> +KernelVersion 5.4
> +Contact: Mike Leach or Mathieu Poirier
> +Description: (W) Disable CTIGATE for single channel.
> +
> +What: /sys/bus/coresight/devices/<cti-name>/channels/chan_set
> +Date: Jul 2019
> +KernelVersion 5.4
> +Contact: Mike Leach or Mathieu Poirier
> +Description: (W) Activate a single channel.
> +
> +What: /sys/bus/coresight/devices/<cti-name>/channels/chan_clear
> +Date: Jul 2019
> +KernelVersion 5.4
> +Contact: Mike Leach or Mathieu Poirier
> +Description: (W) Deactivate a single channel.
> +
> +What: /sys/bus/coresight/devices/<cti-name>/channels/chan_pulse
> +Date: Jul 2019
> +KernelVersion 5.4
> +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/trigout_filtered
> +Date: Jul 2019
> +KernelVersion 5.4
> +Contact: Mike Leach or Mathieu Poirier
> +Description: (R) List of output triggers filtered across all connections.
> +
> +What: /sys/bus/coresight/devices/<cti-name>/channels/trig_filter_enable
> +Date: Jul 2019
> +KernelVersion 5.4
> +Contact: Mike Leach or Mathieu Poirier
> +Description: (RW) Enable or disable trigger output signal filtering.
> +
> +What: /sys/bus/coresight/devices/<cti-name>/channels/chan_inuse
> +Date: Jul 2019
> +KernelVersion 5.4
> +Contact: Mike Leach or Mathieu Poirier
> +Description: (R) show channels with at least one attached trigger signal.
> +
> +What: /sys/bus/coresight/devices/<cti-name>/channels/chan_free
> +Date: Jul 2019
> +KernelVersion 5.4
> +Contact: Mike Leach or Mathieu Poirier
> +Description: (R) show channels with no attached trigger signals.
> +
> +What: /sys/bus/coresight/devices/<cti-name>/channels/chan_xtrigs_view
> +Date: Jul 2019
> +KernelVersion 5.4
> +Contact: Mike Leach or Mathieu Poirier
> +Description: (RW) Write channel number to select a channel to view, read to
> + see triggers attached to selected channel on this CTI.
> +
> +What: /sys/bus/coresight/devices/<cti-name>/channels/chan_xtrigs_reset
> +Date: Jul 2019
> +KernelVersion 5.4
> +Contact: Mike Leach or Mathieu Poirier
> +Description: (W) Clear all channel / trigger programming.
> --
> 2.17.1