← Documents Documentation/ABI/testing/debugfs-pcie-ptm GitHub 원문 ↗

Linux 6.18.37 · ABI / testing

PCIe Precision Time Measurement debugfs ABI

PCIe PTM의 local·master clock, T1..T4 timestamp, Endpoint context update mode, Root Complex context validity를 nanoseconds 단위와 controller 적용 범위별로 설명합니다.

Source pathDocumentation/ABI/testing/debugfs-pcie-ptm
Source versionLinux v6.18.37
TranslationDUJINLABS 전문 번역 + 해설

요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.

1. 요약·해설

원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.

PTM clock과 T1..T4 timestamp

debugfs-pcie-ptm:1-41

local_clock은 Root Complex와 Endpoint 모두에 적용되고 master_clock은 Endpoint 전용입니다. T1·T4는 Endpoint, T2·T3는 Root Complex에서 nanoseconds로 읽습니다.

Endpoint context update mode

debugfs-pcie-ptm:43-55

context_update는 Endpoint에서 10 ms 주기 auto update 또는 write 시 갱신하는 기본 manual mode를 선택합니다.

Root Complex context validity

debugfs-pcie-ptm:57-70

context_valid는 Root Complex local clock timing context를 0 invalid 또는 1 valid로 제어하며 low-power 진입이나 link frequency 변경 시 hardware가 invalid로 만듭니다.

2. 영어 원문 전체

번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.

원문 전체 펼치기
1 What: /sys/kernel/debug/pcie_ptm_*/local_clock
2 Date: May 2025
3 Contact: Manivannan Sadhasivam <manivannan.sadhasivam@linaro.org>
4 Description:
5 (RO) PTM local clock in nanoseconds. Applicable for both Root
6 Complex and Endpoint controllers.
7
8 What: /sys/kernel/debug/pcie_ptm_*/master_clock
9 Date: May 2025
10 Contact: Manivannan Sadhasivam <manivannan.sadhasivam@linaro.org>
11 Description:
12 (RO) PTM master clock in nanoseconds. Applicable only for
13 Endpoint controllers.
14
15 What: /sys/kernel/debug/pcie_ptm_*/t1
16 Date: May 2025
17 Contact: Manivannan Sadhasivam <manivannan.sadhasivam@linaro.org>
18 Description:
19 (RO) PTM T1 timestamp in nanoseconds. Applicable only for
20 Endpoint controllers.
21
22 What: /sys/kernel/debug/pcie_ptm_*/t2
23 Date: May 2025
24 Contact: Manivannan Sadhasivam <manivannan.sadhasivam@linaro.org>
25 Description:
26 (RO) PTM T2 timestamp in nanoseconds. Applicable only for
27 Root Complex controllers.
28
29 What: /sys/kernel/debug/pcie_ptm_*/t3
30 Date: May 2025
31 Contact: Manivannan Sadhasivam <manivannan.sadhasivam@linaro.org>
32 Description:
33 (RO) PTM T3 timestamp in nanoseconds. Applicable only for
34 Root Complex controllers.
35
36 What: /sys/kernel/debug/pcie_ptm_*/t4
37 Date: May 2025
38 Contact: Manivannan Sadhasivam <manivannan.sadhasivam@linaro.org>
39 Description:
40 (RO) PTM T4 timestamp in nanoseconds. Applicable only for
41 Endpoint controllers.
42
43 What: /sys/kernel/debug/pcie_ptm_*/context_update
44 Date: May 2025
45 Contact: Manivannan Sadhasivam <manivannan.sadhasivam@linaro.org>
46 Description:
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
57 What: /sys/kernel/debug/pcie_ptm_*/context_valid
58 Date: May 2025
59 Contact: Manivannan Sadhasivam <manivannan.sadhasivam@linaro.org>
60 Description:
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

3. 한국어 전문 번역

영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.

PTM clock과 timestamp

1-41
What접근설명적용 controller
/sys/kernel/debug/pcie_ptm_*/local_clockRONanoseconds 단위 PTM local clockRoot Complex와 Endpoint
/sys/kernel/debug/pcie_ptm_*/master_clockRONanoseconds 단위 PTM master clockEndpoint만
/sys/kernel/debug/pcie_ptm_*/t1RONanoseconds 단위 PTM T1 timestampEndpoint만
/sys/kernel/debug/pcie_ptm_*/t2RONanoseconds 단위 PTM T2 timestampRoot Complex만
/sys/kernel/debug/pcie_ptm_*/t3RONanoseconds 단위 PTM T3 timestampRoot Complex만
/sys/kernel/debug/pcie_ptm_*/t4RONanoseconds 단위 PTM T4 timestampEndpoint만
공통 항목내용
Date2025년 5월
ContactManivannan Sadhasivam <manivannan.sadhasivam@linaro.org>

Endpoint PTM context update mode

43-55
항목내용
What/sys/kernel/debug/pcie_ptm_*/context_update
Date2025년 5월
ContactManivannan Sadhasivam <manivannan.sadhasivam@linaro.org>
AccessRW
DescriptionPTM context update mode를 제어합니다. Endpoint controller에만 적용됩니다.
값동작
auto10 ms마다 PTM context auto update를 trigger
manualPTM context manual update. 이 파일에 manual을 쓰면 PTM context update를 trigger하며 기본값입니다.

Root Complex PTM context validity

57-70
항목내용
What/sys/kernel/debug/pcie_ptm_*/context_valid
Date2025년 5월
ContactManivannan Sadhasivam <manivannan.sadhasivam@linaro.org>
AccessRW
DescriptionPTM context validity, 즉 local clock timing을 제어합니다. Root Complex controller에만 적용됩니다.
Hardware invalidationRoot Complex가 low power mode에 들어가거나 link frequency를 변경하면 hardware가 PTM context를 invalid로 만듭니다.
값의미
0PTM context invalid, 기본값
1PTM context valid
Root Complex·Endpoint별 PTM debugfs 정보
Endpointlocal_clock and master_clockT1 and T4context_update: auto 10 ms or manual
Root Complexlocal_clockT2 and T3context_valid: 0 or 1
Root Complex low power or link frequency changeHardware invalidates PTM contextcontext_valid = 0

두 controller가 공통 local clock을 가지며 timestamp와 context control의 소유 범위는 서로 다르다.