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