요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
Name, Mask Value
INFO, 0x1
IRQ SVC, 0x2
VBIOS, 0x4
REGISTER, 0x8
PHY DBG, 0x10
PSR, 0x20
AUX, 0x40
SMU, 0x80
MALL, 0x100
ABM, 0x200
ALPM, 0x400
TIMER, 0x800
HW LOCK MGR, 0x1000
INBOX1, 0x2000
PHY SEQ, 0x4000
PSR STATE, 0x8000
ZSTATE, 0x10000
TRANSMITTER CTL, 0x20000
PANEL CNTL, 0x40000
FAMS, 0x80000
DPIA, 0x100000
SUBVP, 0x200000
INBOX0, 0x400000
SDP, 0x4000000
REPLAY, 0x8000000
REPLAY RESIDENCY, 0x20000000
CURSOR INFO, 0x80000000
IPS, 0x100000000
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
DMUB 추적 그룹과 마스크 값
1-29이 CSV는 AMDGPU Display Core의 DMUB 펌웨어 추적 마스크에서 사용할 28개 그룹을 정의합니다. `Name`은 추적 그룹 식별자이고 `Mask Value`는 해당 그룹에 배정된 16진수 단일 비트입니다. 원문 1행은 헤더, 2-29행은 그룹 데이터입니다.
각 값은 하나의 비트만 켜진 2의 거듭제곱이므로 여러 그룹을 동시에 추적할 때 비트 OR로 결합할 수 있습니다. 예를 들어 `PSR`의 `0x20`과 `PSR STATE`의 `0x8000`을 합치면 `0x8020`입니다. 이 조합은 관련 문서 `Documentation/gpu/amdgpu/display/dc-debug.rst`의 PSR 추적 예시와 일치합니다.
표의 그룹 이름은 드라이버와 펌웨어에서 사용하는 식별자이므로 번역하지 않고 별도 한국어 의미 열을 제공했습니다. CSV와 관련 문서가 약어 확장을 명시하지 않은 `MALL`, `FAMS`, `DPIA`, `SUBVP`, `SDP`, `IPS` 등은 의미를 과도하게 추정하지 않고 해당 기능 관련 추적으로 설명합니다.
CSV 헤더를 한국어로 옮기고 값의 보존 원칙을 명시합니다.
문제와 관련된 그룹을 고르고 마스크를 결합해 추적한 뒤 로그를 수집합니다.
28개 그룹 전체입니다. 그룹 이름과 마스크 값은 원문 그대로이고 한국어 의미만 별도 열에 추가했습니다.
각 16진수 마스크에서 켜지는 비트 번호입니다. 비트 번호는 최하위 비트를 0으로 계산합니다.
조회 편의를 위해 28개 원문 이름을 기능 영역으로 묶었습니다. 그룹 식별자 자체는 변경하지 않습니다.
단일 비트를 OR한 결과이며 원문 마스크 값에서 직접 계산했습니다.
헤더와 그룹 행을 연속된 마스크 범위로 나눴습니다.
아래 코드 블록은 Linux v6.18.37 CSV 원문 29줄 전체입니다. 그룹 이름, 16진수 표기, 쉼표 구분과 행 순서를 변경하지 않았습니다.
Name, Mask Value
INFO, 0x1
IRQ SVC, 0x2
VBIOS, 0x4
REGISTER, 0x8
PHY DBG, 0x10
PSR, 0x20
AUX, 0x40
SMU, 0x80
MALL, 0x100
ABM, 0x200
ALPM, 0x400
TIMER, 0x800
HW LOCK MGR, 0x1000
INBOX1, 0x2000
PHY SEQ, 0x4000
PSR STATE, 0x8000
ZSTATE, 0x10000
TRANSMITTER CTL, 0x20000
PANEL CNTL, 0x40000
FAMS, 0x80000
DPIA, 0x100000
SUBVP, 0x200000
INBOX0, 0x400000
SDP, 0x4000000
REPLAY, 0x8000000
REPLAY RESIDENCY, 0x20000000
CURSOR INFO, 0x80000000
IPS, 0x100000000
요약·해설
trace-groups-table.csv:1-29DMUB 펌웨어 추적에서 선택할 수 있는 28개 그룹 이름과 단일 비트 마스크를 정리하고, 여러 그룹을 비트 OR로 조합하는 방법을 설명합니다.
모든 행은 서로 겹치지 않는 단일 비트입니다. 필요한 그룹의 값을 OR해 `amdgpu_dm_dmub_trace_mask`에 지정하며, 그룹 이름과 마스크 값은 디버깅 인터페이스의 식별 정보이므로 그대로 사용합니다.
추적 목적에서 로그 수집까지의 최소 경로입니다.