xref: /linux/Documentation/ABI/testing/sysfs-bus-coresight-devices-tpdm (revision f376caf25f79965ab140b7a297cb4a5bb0c89523)

What:		/sys/bus/coresight/devices/<tpdm-name>/integration_test
Date:		January 2023
KernelVersion	6.2
Contact:	Jinlong Mao (QUIC) <quic_jinlmao@quicinc.com>, Tao Zhang (QUIC) <quic_taozha@quicinc.com>
Description:
		(Write) Run integration test for tpdm. Integration test
		will generate test data for tpdm. It can help to make
		sure that the trace path is enabled and the link configurations
		are fine.

		Accepts only one of the 2 values -  1 or 2.
		1 : Generate 64 bits data
		2 : Generate 32 bits data

What:		/sys/bus/coresight/devices/<tpdm-name>/reset_dataset
Date:		March 2023
KernelVersion	6.7
Contact:	Jinlong Mao (QUIC) <quic_jinlmao@quicinc.com>, Tao Zhang (QUIC) <quic_taozha@quicinc.com>
Description:
		(Write) Reset the dataset of the tpdm.

		Accepts only one value -  1.
		1 : Reset the dataset of the tpdm

What:		/sys/bus/coresight/devices/<tpdm-name>/dsb_trig_type
Date:		March 2023
KernelVersion	6.7
Contact:	Jinlong Mao (QUIC) <quic_jinlmao@quicinc.com>, Tao Zhang (QUIC) <quic_taozha@quicinc.com>
Description:
		(RW) Set/Get the trigger type of the DSB for tpdm.

		Accepts only one of the 2 values -  0 or 1.
		0 : Set the DSB trigger type to false
		1 : Set the DSB trigger type to true

What:		/sys/bus/coresight/devices/<tpdm-name>/dsb_trig_ts
Date:		March 2023
KernelVersion	6.7
Contact:	Jinlong Mao (QUIC) <quic_jinlmao@quicinc.com>, Tao Zhang (QUIC) <quic_taozha@quicinc.com>
Description:
		(RW) Set/Get the trigger timestamp of the DSB for tpdm.

		Accepts only one of the 2 values -  0 or 1.
		0 : Set the DSB trigger type to false
		1 : Set the DSB trigger type to true

What:		/sys/bus/coresight/devices/<tpdm-name>/dsb_mode
Date:		March 2023
KernelVersion	6.7
Contact:	Jinlong Mao (QUIC) <quic_jinlmao@quicinc.com>, Tao Zhang (QUIC) <quic_taozha@quicinc.com>
Description:
		(RW) Set/Get the programming mode of the DSB for tpdm.

		Accepts the value needs to be greater than 0. What data
		bits do is listed below.
		Bit[0:1] : Test mode control bit for choosing the inputs.
		Bit[3] : Set to 0 for low performance mode.
				 Set to 1 for high performance mode.
		Bit[4:8] : Select byte lane for high performance mode.

What:		/sys/bus/coresight/devices/<tpdm-name>/dsb_edge/ctrl_idx
Date:		March 2023
KernelVersion	6.7
Contact:	Jinlong Mao (QUIC) <quic_jinlmao@quicinc.com>, Tao Zhang (QUIC) <quic_taozha@quicinc.com>
Description:
		(RW) Set/Get the index number of the edge detection for the DSB
		subunit TPDM. Since there are at most 256 edge detections, this
		value ranges from 0 to 255.

What:		/sys/bus/coresight/devices/<tpdm-name>/dsb_edge/ctrl_val
Date:		March 2023
KernelVersion	6.7
Contact:	Jinlong Mao (QUIC) <quic_jinlmao@quicinc.com>, Tao Zhang (QUIC) <quic_taozha@quicinc.com>
Description:
		Write a data to control the edge detection corresponding to
		the index number. Before writing data to this sysfs file,
		"ctrl_idx" should be written first to configure the index
		number of the edge detection which needs to be controlled.

		Accepts only one of the following values.
		0 - Rising edge detection
		1 - Falling edge detection
		2 - Rising and falling edge detection (toggle detection)


What:		/sys/bus/coresight/devices/<tpdm-name>/dsb_edge/ctrl_mask
Date:		March 2023
KernelVersion	6.7
Contact:	Jinlong Mao (QUIC) <quic_jinlmao@quicinc.com>, Tao Zhang (QUIC) <quic_taozha@quicinc.com>
Description:
		Write a data to mask the edge detection corresponding to the index
		number. Before writing data to this sysfs file, "ctrl_idx" should
		be written first to configure the index number of the edge detection
		which needs to be masked.

		Accepts only one of the 2 values -  0 or 1.

What:		/sys/bus/coresight/devices/<tpdm-name>/dsb_edge/edcr[0:15]
Date:		March 2023
KernelVersion	6.7
Contact:	Jinlong Mao (QUIC) <quic_jinlmao@quicinc.com>, Tao Zhang (QUIC) <quic_taozha@quicinc.com>
Description:
		Read a set of the edge control value of the DSB in TPDM.

What:		/sys/bus/coresight/devices/<tpdm-name>/dsb_edge/edcmr[0:7]
Date:		March 2023
KernelVersion	6.7
Contact:	Jinlong Mao (QUIC) <quic_jinlmao@quicinc.com>, Tao Zhang (QUIC) <quic_taozha@quicinc.com>
Description:
		Read a set of the edge control mask of the DSB in TPDM.