xref: /linux/Documentation/ABI/testing/debugfs-pcie-ptm (revision 3719a04a80caf660f899a462cd8f3973bcfa676e)
1What:		/sys/kernel/debug/pcie_ptm_*/local_clock
2Date:		May 2025
3Contact:	Manivannan Sadhasivam <manivannan.sadhasivam@linaro.org>
4Description:
5		(RO) PTM local clock in nanoseconds. Applicable for both Root
6		Complex and Endpoint controllers.
7
8What:		/sys/kernel/debug/pcie_ptm_*/master_clock
9Date:		May 2025
10Contact:	Manivannan Sadhasivam <manivannan.sadhasivam@linaro.org>
11Description:
12		(RO) PTM master clock in nanoseconds. Applicable only for
13		Endpoint controllers.
14
15What:		/sys/kernel/debug/pcie_ptm_*/t1
16Date:		May 2025
17Contact:	Manivannan Sadhasivam <manivannan.sadhasivam@linaro.org>
18Description:
19		(RO) PTM T1 timestamp in nanoseconds. Applicable only for
20		Endpoint controllers.
21
22What:		/sys/kernel/debug/pcie_ptm_*/t2
23Date:		May 2025
24Contact:	Manivannan Sadhasivam <manivannan.sadhasivam@linaro.org>
25Description:
26		(RO) PTM T2 timestamp in nanoseconds. Applicable only for
27		Root Complex controllers.
28
29What:		/sys/kernel/debug/pcie_ptm_*/t3
30Date:		May 2025
31Contact:	Manivannan Sadhasivam <manivannan.sadhasivam@linaro.org>
32Description:
33		(RO) PTM T3 timestamp in nanoseconds. Applicable only for
34		Root Complex controllers.
35
36What:		/sys/kernel/debug/pcie_ptm_*/t4
37Date:		May 2025
38Contact:	Manivannan Sadhasivam <manivannan.sadhasivam@linaro.org>
39Description:
40		(RO) PTM T4 timestamp in nanoseconds. Applicable only for
41		Endpoint controllers.
42
43What:		/sys/kernel/debug/pcie_ptm_*/context_update
44Date:		May 2025
45Contact:	Manivannan Sadhasivam <manivannan.sadhasivam@linaro.org>
46Description:
47		(RW) Control the PTM context update mode. Applicable only for
48		Endpoint controllers.
49
50		Following values are supported:
51
52		* auto = PTM context auto update trigger for every 10ms
53
54		* manual = PTM context manual update. Writing 'manual' to this
55			   file triggers PTM context update (default)
56
57What:		/sys/kernel/debug/pcie_ptm_*/context_valid
58Date:		May 2025
59Contact:	Manivannan Sadhasivam <manivannan.sadhasivam@linaro.org>
60Description:
61		(RW) Control the PTM context validity (local clock timing).
62		Applicable only for Root Complex controllers. PTM context is
63		invalidated by hardware if the Root Complex enters low power
64		mode or changes link frequency.
65
66		Following values are supported:
67
68		* 0 = PTM context invalid (default)
69
70		* 1 = PTM context valid
71