요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
Endpoint context update mode
debugfs-pcie-ptm:43-55context_update는 Endpoint에서 10 ms 주기 auto update 또는 write 시 갱신하는 기본 manual mode를 선택합니다.
Root Complex context validity
debugfs-pcie-ptm:57-70context_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 <[email protected]>
4
Description:
5
(RO) PTM local clock in nanoseconds. Applicable for both Root
6
Complex and Endpoint controllers.
8
What: /sys/kernel/debug/pcie_ptm_*/master_clock
9
Date: May 2025
10
Contact: Manivannan Sadhasivam <[email protected]>
11
Description:
12
(RO) PTM master clock in nanoseconds. Applicable only for
13
Endpoint controllers.
15
What: /sys/kernel/debug/pcie_ptm_*/t1
16
Date: May 2025
17
Contact: Manivannan Sadhasivam <[email protected]>
18
Description:
19
(RO) PTM T1 timestamp in nanoseconds. Applicable only for
20
Endpoint controllers.
22
What: /sys/kernel/debug/pcie_ptm_*/t2
23
Date: May 2025
24
Contact: Manivannan Sadhasivam <[email protected]>
25
Description:
26
(RO) PTM T2 timestamp in nanoseconds. Applicable only for
27
Root Complex controllers.
29
What: /sys/kernel/debug/pcie_ptm_*/t3
30
Date: May 2025
31
Contact: Manivannan Sadhasivam <[email protected]>
32
Description:
33
(RO) PTM T3 timestamp in nanoseconds. Applicable only for
34
Root Complex controllers.
36
What: /sys/kernel/debug/pcie_ptm_*/t4
37
Date: May 2025
38
Contact: Manivannan Sadhasivam <[email protected]>
39
Description:
40
(RO) PTM T4 timestamp in nanoseconds. Applicable only for
41
Endpoint controllers.
43
What: /sys/kernel/debug/pcie_ptm_*/context_update
44
Date: May 2025
45
Contact: Manivannan Sadhasivam <[email protected]>
46
Description:
47
(RW) Control the PTM context update mode. Applicable only for
48
Endpoint controllers.
50
Following values are supported:
52
* auto = PTM context auto update trigger for every 10ms
54
* manual = PTM context manual update. Writing 'manual' to this
55
file triggers PTM context update (default)
57
What: /sys/kernel/debug/pcie_ptm_*/context_valid
58
Date: May 2025
59
Contact: Manivannan Sadhasivam <[email protected]>
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.
66
Following values are supported:
68
* 0 = PTM context invalid (default)
70
* 1 = PTM context valid
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
PTM clock과 timestamp
1-41| What | 접근 | 설명 | 적용 controller |
|---|---|---|---|
| /sys/kernel/debug/pcie_ptm_*/local_clock | RO | Nanoseconds 단위 PTM local clock | Root Complex와 Endpoint |
| /sys/kernel/debug/pcie_ptm_*/master_clock | RO | Nanoseconds 단위 PTM master clock | Endpoint만 |
| /sys/kernel/debug/pcie_ptm_*/t1 | RO | Nanoseconds 단위 PTM T1 timestamp | Endpoint만 |
| /sys/kernel/debug/pcie_ptm_*/t2 | RO | Nanoseconds 단위 PTM T2 timestamp | Root Complex만 |
| /sys/kernel/debug/pcie_ptm_*/t3 | RO | Nanoseconds 단위 PTM T3 timestamp | Root Complex만 |
| /sys/kernel/debug/pcie_ptm_*/t4 | RO | Nanoseconds 단위 PTM T4 timestamp | Endpoint만 |
| 공통 항목 | 내용 |
|---|---|
| Date | 2025년 5월 |
| Contact | Manivannan Sadhasivam <[email protected]> |
Endpoint PTM context update mode
43-55| 항목 | 내용 |
|---|---|
| What | /sys/kernel/debug/pcie_ptm_*/context_update |
| Date | 2025년 5월 |
| Contact | Manivannan Sadhasivam <[email protected]> |
| Access | RW |
| Description | PTM context update mode를 제어합니다. Endpoint controller에만 적용됩니다. |
| 값 | 동작 |
|---|---|
| auto | 10 ms마다 PTM context auto update를 trigger |
| manual | PTM context manual update. 이 파일에 manual을 쓰면 PTM context update를 trigger하며 기본값입니다. |
Root Complex PTM context validity
57-70| 항목 | 내용 |
|---|---|
| What | /sys/kernel/debug/pcie_ptm_*/context_valid |
| Date | 2025년 5월 |
| Contact | Manivannan Sadhasivam <[email protected]> |
| Access | RW |
| Description | PTM context validity, 즉 local clock timing을 제어합니다. Root Complex controller에만 적용됩니다. |
| Hardware invalidation | Root Complex가 low power mode에 들어가거나 link frequency를 변경하면 hardware가 PTM context를 invalid로 만듭니다. |
| 값 | 의미 |
|---|---|
| 0 | PTM context invalid, 기본값 |
| 1 | PTM context valid |
Endpoint→local_clock and master_clock→T1 and T4→context_update: auto 10 ms or manual
Root Complex→local_clock→T2 and T3→context_valid: 0 or 1
Root Complex low power or link frequency change→Hardware invalidates PTM context→context_valid = 0
두 controller가 공통 local clock을 가지며 timestamp와 context control의 소유 범위는 서로 다르다.
PTM clock과 T1..T4 timestamp
debugfs-pcie-ptm:1-41local_clock은 Root Complex와 Endpoint 모두에 적용되고 master_clock은 Endpoint 전용입니다. T1·T4는 Endpoint, T2·T3는 Root Complex에서 nanoseconds로 읽습니다.