← Documents Documentation/gpu/amdgpu/flashing.rst GitHub 원문 ↗

Linux 6.18.37 · GPU

dGPU 펌웨어 플래시

AMDGPU dGPU IFWI와 USB-C PD 펌웨어의 sysfs 기반 갱신 절차를 원문 전체와 함께 번역합니다.

Source pathDocumentation/gpu/amdgpu/flashing.rst
Source versionLinux v6.18.37
TranslationDUJINLABS 전문 번역 + 해설

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

1. 요약·해설

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

요약·해설

flashing.rst:1-33

이 문서는 AMD dGPU의 두 가지 펌웨어 갱신 경로를 설명합니다. IFWI는 호환성 확인, 메모리 스테이징, 플래시 시작, 상태 폴링의 네 단계로 진행합니다. USB-C PD 펌웨어는 `usbc_pd_fw`를 읽어 현재 버전을 확인하고, `/lib/firmware/amdgpu`에 둔 payload 이름을 써서 갱신을 시작합니다.

두 플래시 경로 비교
대상인터페이스핵심 절차
dGPU IFWIpsp_vbflash, psp_vbflash_status쓰기 스테이징, 읽기 시작, 상태 폴링
USB-C PD F/Wusbc_pd_fw읽기 버전 조회, payload 이름 쓰기
세부 sysfs 정의amdgpu_psp.c kernel-doc구현 소스의 문서 주석 확인

대상별 sysfs 인터페이스와 핵심 동작을 빠르게 대조합니다.

2. 영어 원문 전체

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

원문 전체 펼치기
1 =======================
2 dGPU firmware flashing
3 =======================
4
5 IFWI
6 ----
7 Flashing the dGPU integrated firmware image (IFWI) is supported by GPUs that
8 use the PSP to orchestrate the update (Navi3x or newer GPUs).
9 For supported GPUs, `amdgpu` will export a series of sysfs files that can be
10 used for the flash process.
11
12 The IFWI flash process is:
13
14 1. Ensure the IFWI image is intended for the dGPU on the system.
15 2. "Write" the IFWI image to the sysfs file `psp_vbflash`. This will stage the IFWI in memory.
16 3. "Read" from the `psp_vbflash` sysfs file to initiate the flash process.
17 4. Poll the `psp_vbflash_status` sysfs file to determine when the flash process completes.
18
19 USB-C PD F/W
20 ------------
21 On GPUs that support flashing an updated USB-C PD firmware image, the process
22 is done using the `usbc_pd_fw` sysfs file.
23
24 * Reading the file will provide the current firmware version.
25 * Writing the name of a firmware payload stored in `/lib/firmware/amdgpu` to the sysfs file will initiate the flash process.
26
27 The firmware payload stored in `/lib/firmware/amdgpu` can be named any name
28 as long as it doesn't conflict with other existing binaries that are used by
29 `amdgpu`.
30
31 sysfs files
32 -----------
33 .. kernel-doc:: drivers/gpu/drm/amd/amdgpu/amdgpu_psp.c
34

3. 한국어 전문 번역

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

dGPU IFWI 플래시 절차

1-18

dGPU 통합 펌웨어 이미지(IFWI) 플래시는 PSP가 업데이트를 조정하는 GPU에서 지원됩니다. 원문은 그 범위를 Navi3x 또는 그 이후 GPU로 설명합니다. 지원되는 GPU에서는 `amdgpu`가 플래시 과정에 사용할 여러 sysfs 파일을 내보냅니다.

첫 단계의 호환성 확인은 선택 사항이 아닙니다. 사용할 IFWI 이미지가 현재 시스템의 dGPU용인지 먼저 확인해야 합니다. 이어지는 `psp_vbflash` 접근은 같은 파일에 대한 쓰기와 읽기가 서로 다른 역할을 한다는 점이 핵심입니다.

IFWI 플래시 순서
IFWI 이미지가 시스템의 dGPU용인지 확인IFWI 이미지를 psp_vbflash에 써서 메모리에 스테이징psp_vbflash를 읽어 실제 플래시 과정 시작psp_vbflash_status를 폴링하여 완료 여부 확인

원문에 정의된 네 단계는 순서를 바꾸지 않고 수행합니다.

IFWI sysfs 접근 의미
대상접근원문이 정의한 동작
psp_vbflash쓰기IFWI 이미지를 메모리에 스테이징
psp_vbflash읽기플래시 과정 시작
psp_vbflash_status반복 읽기플래시 과정의 완료 여부 확인

같은 psp_vbflash 파일이라도 접근 방향에 따라 의미가 달라집니다.

=======================
 dGPU firmware flashing
=======================

IFWI
----
Flashing the dGPU integrated firmware image (IFWI) is supported by GPUs that
use the PSP to orchestrate the update (Navi3x or newer GPUs).
For supported GPUs, `amdgpu` will export a series of sysfs files that can be
used for the flash process.

The IFWI flash process is:

1. Ensure the IFWI image is intended for the dGPU on the system.
2. "Write" the IFWI image to the sysfs file `psp_vbflash`. This will stage the IFWI in memory.
3. "Read" from the `psp_vbflash` sysfs file to initiate the flash process.
4. Poll the `psp_vbflash_status` sysfs file to determine when the flash process completes.

USB-C PD 펌웨어 갱신

19-29

업데이트된 USB-C PD 펌웨어 이미지의 플래시를 지원하는 GPU에서는 `usbc_pd_fw` sysfs 파일을 사용합니다. 이 파일을 읽으면 현재 펌웨어 버전을 얻고, 이 파일에 firmware payload의 이름을 쓰면 플래시 과정을 시작합니다.

payload 자체는 `/lib/firmware/amdgpu`에 저장되어 있어야 합니다. sysfs에 쓰는 값은 전체 경로가 아니라 그곳에 저장된 firmware payload의 이름입니다. 이름은 자유롭게 정할 수 있지만 `amdgpu`가 사용하는 기존 바이너리와 충돌해서는 안 됩니다.

USB-C PD 펌웨어 접근 흐름
usbc_pd_fw를 읽어 현재 펌웨어 버전 확인payload가 /lib/firmware/amdgpu에 저장되어 있는지 확인기존 amdgpu 바이너리와 충돌하지 않는 payload 이름 선택그 payload 이름을 usbc_pd_fw에 써서 플래시 시작

읽기와 쓰기가 각각 조회와 갱신 시작을 담당합니다.

USB-C PD 파일 규칙
항목규칙
sysfs 파일usbc_pd_fw
읽기 결과현재 펌웨어 버전
쓰기 값/lib/firmware/amdgpu에 저장된 firmware payload의 이름
payload 이름임의의 이름을 사용할 수 있으나 기존 amdgpu 바이너리와 충돌하면 안 됨

원문이 명시한 경로와 접근 의미를 구분합니다.

USB-C PD F/W
------------
On GPUs that support flashing an updated USB-C PD firmware image, the process
is done using the `usbc_pd_fw` sysfs file.

* Reading the file will provide the current firmware version.
* Writing the name of a firmware payload stored in `/lib/firmware/amdgpu` to the sysfs file will initiate the flash process.

The firmware payload stored in `/lib/firmware/amdgpu` can be named any name
as long as it doesn't conflict with other existing binaries that are used by
`amdgpu`.

sysfs kernel-doc 연결

30-33

각 sysfs 파일의 구체적인 인터페이스 정의는 `drivers/gpu/drm/amd/amdgpu/amdgpu_psp.c`의 kernel-doc에서 가져옵니다. 이 문서는 플래시 흐름을 설명하고, 개별 속성의 실제 정의는 해당 소스의 문서 주석에 연결합니다.

문서에서 구현 정의로 이동
Documentation/gpu/amdgpu/flashing.rst에서 전체 플래시 순서 확인kernel-doc 지시어가 amdgpu_psp.c를 참조하는지 확인drivers/gpu/drm/amd/amdgpu/amdgpu_psp.c에서 sysfs 파일 정의 확인

플래시 절차와 sysfs 세부 정의의 소유 위치를 분리해 확인합니다.


sysfs files
-----------
.. kernel-doc:: drivers/gpu/drm/amd/amdgpu/amdgpu_psp.c