요약·해설, 영어 원문, 전체 번역을 구분해 실었습니다. API 이름, 코드 심벌, 소스 경로는 원문 표기를 유지합니다.
1. 요약·해설
원문의 핵심 내용을 정리하고 커널 프로그래밍에 필요한 설명을 덧붙였습니다. 아래의 전체 번역과는 별도로 작성한 해설입니다.
2. 영어 원문 전체
번역에 사용한 Linux v6.18.37 원문입니다. 줄 번호는 해당 버전의 소스 파일을 기준으로 합니다.
원문 전체 펼치기
1
.. SPDX-License-Identifier: (GPL-2.0+ OR MIT)
3
========
4
Firmware
5
========
7
Firmware Layout
8
===============
10
.. kernel-doc:: drivers/gpu/drm/xe/xe_uc_fw_abi.h
11
:doc: CSS-based Firmware Layout
13
.. kernel-doc:: drivers/gpu/drm/xe/xe_uc_fw_abi.h
14
:doc: GSC-based Firmware Layout
16
Write Once Protected Content Memory (WOPCM) Layout
17
==================================================
19
.. kernel-doc:: drivers/gpu/drm/xe/xe_wopcm.c
20
:doc: Write Once Protected Content Memory (WOPCM) Layout
22
GuC CTB Blob
23
============
25
.. kernel-doc:: drivers/gpu/drm/xe/xe_guc_ct.c
26
:doc: GuC CTB Blob
28
GuC Power Conservation (PC)
29
===========================
31
.. kernel-doc:: drivers/gpu/drm/xe/xe_guc_pc.c
32
:doc: GuC Power Conservation (PC)
34
PCIe Gen5 Limitations
35
=====================
37
.. kernel-doc:: drivers/gpu/drm/xe/xe_device_sysfs.c
38
:doc: PCIe Gen5 Limitations
40
Internal API
41
============
43
TODO
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미에 맞춰 전체 내용을 번역했습니다. 코드, 함수명, 코드 심벌, URL은 원문 표기를 유지합니다.
Firmware
1-43Firmware layout은 `drivers/gpu/drm/xe/xe_uc_fw_abi.h`의 `CSS-based Firmware Layout`과 `GSC-based Firmware Layout` kernel-doc section에서 설명합니다.
Write Once Protected Content Memory(WOPCM) layout은 `xe_wopcm.c`, GuC CTB blob은 `xe_guc_ct.c`, GuC Power Conservation(PC)은 `xe_guc_pc.c`의 해당 kernel-doc section에서 가져옵니다.
PCIe Gen5 limitation은 `drivers/gpu/drm/xe/xe_device_sysfs.c`에 문서화됩니다. 마지막 `Internal API` 항목은 현재 `TODO`로 남아 있습니다.
항목값
Firmware ABIxe_uc_fw_abi.h : CSS·GSC layout
WOPCMxe_wopcm.c
GuC CTBxe_guc_ct.c
GuC PCxe_guc_pc.c
PCIe Gen5xe_device_sysfs.c
Internal APITODO
문서와 구현의 연결 지점입니다.
Firmware format 식별→WOPCM 영역 배치→GuC CTB communication 준비→Power conservation 연결→PCIe Gen5 제한 적용
문서가 설명하는 기능의 핵심 경로입니다.
.. SPDX-License-Identifier: (GPL-2.0+ OR MIT)
========
Firmware
========
Firmware Layout
===============
.. kernel-doc:: drivers/gpu/drm/xe/xe_uc_fw_abi.h
:doc: CSS-based Firmware Layout
.. kernel-doc:: drivers/gpu/drm/xe/xe_uc_fw_abi.h
:doc: GSC-based Firmware Layout
Write Once Protected Content Memory (WOPCM) Layout
==================================================
.. kernel-doc:: drivers/gpu/drm/xe/xe_wopcm.c
:doc: Write Once Protected Content Memory (WOPCM) Layout
GuC CTB Blob
============
.. kernel-doc:: drivers/gpu/drm/xe/xe_guc_ct.c
:doc: GuC CTB Blob
GuC Power Conservation (PC)
===========================
.. kernel-doc:: drivers/gpu/drm/xe/xe_guc_pc.c
:doc: GuC Power Conservation (PC)
PCIe Gen5 Limitations
=====================
.. kernel-doc:: drivers/gpu/drm/xe/xe_device_sysfs.c
:doc: PCIe Gen5 Limitations
Internal API
============
TODO
요약·해설
xe_firmware.rst:1-43Xe firmware ABI, WOPCM, GuC CTB·power conservation과 PCIe Gen5 제한을 연결합니다.
Source와 관련 구현입니다.