AD103_win_unlocker / docs /INSTALL.ko.md

Duplicate from TOTORONG/AD103_win_unlocker

e95a646 12 days ago

5.88 kB

# 추출·준비·USB 설치 — 한국어

## 1. 본인 카드의 VBIOS 추출
1. Windows에서 https://www.techpowerup.com/gpuz/ 의 GPU-Z를 실행하고 대상 RTX 4080을 선택합니다.
2. BIOS Version 오른쪽 저장 아이콘 → Save to file로 `AD103.rom`을 본인 로컬 폴더에 저장합니다. 온라인 데이터베이스 제출을 선택할 필요는 없습니다.
3. 도구 버전, 카드 PCI ID/서브시스템 ID, BIOS 버전, 메모리 크기와 추출 날짜를 기록합니다.
4. PowerShell에서 해시를 확인합니다:
```powershell
Get-FileHash .\AD103.rom -Algorithm SHA256
```
5. WSL의 저장소 루트에서 로컬 파일을 검사합니다:
```bash
python3 tools/check_rom.py /mnt/c/Users/YOUR_NAME/Desktop/AD103.rom
```
이 도구는 읽기 전용 파일 검사이며 직접 하드웨어 덤프나 플래싱을 하지 않습니다. GPU-Z는 별도 공식 도구이며 이 저장소에 재배포하지 않습니다. 실제 추출 기능의 기준은 NVIDIA의 GPU-Z 안내입니다: https://nvidia.custhelp.com/app/answers/detail/a_id/4188/
배포본은 성공 사례 ROM 해시 `ebb63e82992d07e04da1e22ff78e855ce136c0702ee1909b2fb5d8c1e2f0674a`에 고정됩니다. 다른 ROM이면 이 EFI의 지원 범위 밖입니다. ROM 해시 불일치를 숨기거나 게이트를 제거하지 마십시오. ROM을 USB에 넣어 플래싱하는 방식이 아니며 EFI는 살아 있는 PROM을 검사합니다.
원래 PROM 읽기·덤프 저장 소스는 `source/unlock/app.c`와 `app_io.c`에 포함돼 있습니다. 이 전체 언락 EFI를 범용 BIOS 덤프 유틸리티라고 부르지는 않습니다.

## 2. 정품 자산의 로컬 준비
NVIDIA 610.43.03 소스와 고정된 nvidia-utils 패키지를 내려받아 SHA-256 검사 후 필요한 파일만 추출합니다. 설치하거나 실행하는 것이 아닙니다. 충분한 다운로드/디스크 공간이 필요합니다. Python 3.14는 추출용이며 기존 WSL PyTorch 환경은 바꾸지 마십시오.

```bash
# From the extracted public repository root, in WSL/Linux.
# Python 3.14+ is needed by the inherited tar.zst extraction path.
python3.14 tools/prepare_assets.py
```

| USB-root relative path | Source |
|---|---|
| `EFI/BOOT/BOOTX64.EFI` | Included / 포함 |
| `RTX4080-EXPERIMENT/ASSETS/v67-ad102-610.43.03-four-plm.bin` | Included / 포함 |
| `RTX4080-EXPERIMENT/ASSETS/booter_load_ad102.bin` | Local extraction / 로컬 추출 |
| `RTX4080-EXPERIMENT/ASSETS/gsp_boot_ad102.bin` | Local extraction / 로컬 추출 |
| `RTX4080-EXPERIMENT/ASSETS/gsp_boot_desc_ad102.bin` | Local extraction / 로컬 추출 |
| `RTX4080-EXPERIMENT/ASSETS/gsp_ga10x.bin` | Local extraction / 로컬 추출 |

```bash
# Optional EFI rebuild: Python 3 + Zig 0.14.1. GCC is also needed for simulated tests.
python3 source/build.py --zig /absolute/path/to/zig
# Built EFI: source/USB/EFI/BOOT/BOOTX64.EFI
```

Released EFI SHA-256:
`9f821b8e9fa11cd8e145908e6abcf36bd28bfe96a138ddc07365f1700338eb01`

Payload SHA-256:
`44c36b2d6b3424e53e18f3e55db85c833655de071ce66ce42749588a4a7dc8cb`

준비 도구는 원래 GA102용 생성기의 임시 GA102 페이로드를 제거하고 공개본의 AD102 four-PLM 페이로드를 유지합니다. 펌웨어 라이선스는 로컬 ASSETS/NVIDIA-LICENSE에 보존됩니다. 다운로드가 실패하면 다른 버전으로 대체하지 말고 입력 URL/해시를 확인하십시오. 이 공개 패키지 제작 시 원격 다운로드 전체를 재실행하지는 않았습니다.

## 3. FAT32 USB/SD 배치
기존 USB를 백업하고 비어 있는 FAT32 USB/SD를 준비합니다. 디스크 자동 포맷 명령은 제공하지 않습니다.
자산 준비 완료 후 프로젝트의 `USB` 폴더 **내부 내용**을 USB 드라이브 루트로 복사합니다. Windows 드라이브가 E:라면 EFI 위치는 `E:\EFI\BOOT\BOOTX64.EFI`입니다. `E:\USB\EFI...`나 `E:\BOOT\EFI...`로 배치하면 안 됩니다.
기존 USB에 다른 BOOTX64.EFI가 있으면 먼저 보관하십시오. Windows ESP의 bootmgfw.efi를 덮어쓰지 않습니다.

## 4. 수동 실행
- 실기 사례처럼 Secure Boot를 끄고 UEFI 부팅 메뉴에서 USB/SD를 선택합니다.
- v0.4.18 표시와 READY를 확인합니다. 준비 검사를 통과하지 못하면 U 단계에 도달하지 않습니다.
- U를 한 번 누릅니다. Esc 또는 30초 대기는 취소입니다.
- GPU 펌웨어 드라이버 분리 후 화면이 꺼지거나 마지막 화면이 남을 수 있습니다. 이것만으로 성공·실패를 판단하지 않습니다.
- 복원 검사 성공 시 Windows Boot Manager로 인계합니다. 자동 재부팅이나 매 부팅 자동 실행을 등록하지 않습니다.
- STOP이면 실행 중인 GPU가 정리되지 않았을 수 있으므로 해당 세션에서 반복 실행하지 말고 완전 전원 차단 후 정상 Windows 경로로 복구하십시오.

## 5. 관측과 벤치마크
필요한 요약은 SELECTOR RESULT, POST-FLR, POST-GOP, FINAL입니다. FINAL status=0만으로 성능 향상을 주장하지 마십시오. 상세 로그를 공개 저장소에 올릴 필요는 없습니다.
`benchmarks/wsl`에서 `python3 bench.py --label unlocked`를 실행하고, 완전 전원 차단 후 EFI 없이 Windows/동일 WSL 부팅에서 `--label baseline`, 마지막으로 `--compare-latest`를 실행합니다. 같은 드라이버·전력 한도·오버클럭 조건을 유지합니다.

## 6. 테스트 재현의 범위
원본 모의 테스트는 해당 로컬 ROM과 PROM을 요구합니다. 파일은 공개하지 않으므로 다른 보드 파일로 그대로 테스트를 통과시키는 것을 지원하지 않습니다. 최종 소스 재빌드는 성공 EFI와 바이트 일치가 확인됐습니다. 43개 코어 및 50개 앱 모의 시나리오가 기존 개발 과정에서 통과했으며 실기 결과는 RUN19 한 카드입니다.

	# 추출·준비·USB 설치 — 한국어

	## 1. 본인 카드의 VBIOS 추출
	1. Windows에서 https://www.techpowerup.com/gpuz/ 의 GPU-Z를 실행하고 대상 RTX 4080을 선택합니다.
	2. BIOS Version 오른쪽 저장 아이콘 → Save to file로 `AD103.rom`을 본인 로컬 폴더에 저장합니다. 온라인 데이터베이스 제출을 선택할 필요는 없습니다.
	3. 도구 버전, 카드 PCI ID/서브시스템 ID, BIOS 버전, 메모리 크기와 추출 날짜를 기록합니다.
	4. PowerShell에서 해시를 확인합니다:
	```powershell
	Get-FileHash .\AD103.rom -Algorithm SHA256
	```
	5. WSL의 저장소 루트에서 로컬 파일을 검사합니다:
	```bash
	python3 tools/check_rom.py /mnt/c/Users/YOUR_NAME/Desktop/AD103.rom
	```
	이 도구는 읽기 전용 파일 검사이며 직접 하드웨어 덤프나 플래싱을 하지 않습니다. GPU-Z는 별도 공식 도구이며 이 저장소에 재배포하지 않습니다. 실제 추출 기능의 기준은 NVIDIA의 GPU-Z 안내입니다: https://nvidia.custhelp.com/app/answers/detail/a_id/4188/

	배포본은 성공 사례 ROM 해시 `ebb63e82992d07e04da1e22ff78e855ce136c0702ee1909b2fb5d8c1e2f0674a`에 고정됩니다. 다른 ROM이면 이 EFI의 지원 범위 밖입니다. ROM 해시 불일치를 숨기거나 게이트를 제거하지 마십시오. ROM을 USB에 넣어 플래싱하는 방식이 아니며 EFI는 살아 있는 PROM을 검사합니다.
	원래 PROM 읽기·덤프 저장 소스는 `source/unlock/app.c`와 `app_io.c`에 포함돼 있습니다. 이 전체 언락 EFI를 범용 BIOS 덤프 유틸리티라고 부르지는 않습니다.

	## 2. 정품 자산의 로컬 준비
	NVIDIA 610.43.03 소스와 고정된 nvidia-utils 패키지를 내려받아 SHA-256 검사 후 필요한 파일만 추출합니다. 설치하거나 실행하는 것이 아닙니다. 충분한 다운로드/디스크 공간이 필요합니다. Python 3.14는 추출용이며 기존 WSL PyTorch 환경은 바꾸지 마십시오.

	```bash
	# From the extracted public repository root, in WSL/Linux.
	# Python 3.14+ is needed by the inherited tar.zst extraction path.
	python3.14 tools/prepare_assets.py
	```

	\| USB-root relative path \| Source \|
	\|---\|---\|
	\| `EFI/BOOT/BOOTX64.EFI` \| Included / 포함 \|
	\| `RTX4080-EXPERIMENT/ASSETS/v67-ad102-610.43.03-four-plm.bin` \| Included / 포함 \|
	\| `RTX4080-EXPERIMENT/ASSETS/booter_load_ad102.bin` \| Local extraction / 로컬 추출 \|
	\| `RTX4080-EXPERIMENT/ASSETS/gsp_boot_ad102.bin` \| Local extraction / 로컬 추출 \|
	\| `RTX4080-EXPERIMENT/ASSETS/gsp_boot_desc_ad102.bin` \| Local extraction / 로컬 추출 \|
	\| `RTX4080-EXPERIMENT/ASSETS/gsp_ga10x.bin` \| Local extraction / 로컬 추출 \|

	```bash
	# Optional EFI rebuild: Python 3 + Zig 0.14.1. GCC is also needed for simulated tests.
	python3 source/build.py --zig /absolute/path/to/zig
	# Built EFI: source/USB/EFI/BOOT/BOOTX64.EFI
	```

	Released EFI SHA-256:
	`9f821b8e9fa11cd8e145908e6abcf36bd28bfe96a138ddc07365f1700338eb01`

	Payload SHA-256:
	`44c36b2d6b3424e53e18f3e55db85c833655de071ce66ce42749588a4a7dc8cb`

	준비 도구는 원래 GA102용 생성기의 임시 GA102 페이로드를 제거하고 공개본의 AD102 four-PLM 페이로드를 유지합니다. 펌웨어 라이선스는 로컬 ASSETS/NVIDIA-LICENSE에 보존됩니다. 다운로드가 실패하면 다른 버전으로 대체하지 말고 입력 URL/해시를 확인하십시오. 이 공개 패키지 제작 시 원격 다운로드 전체를 재실행하지는 않았습니다.

	## 3. FAT32 USB/SD 배치
	기존 USB를 백업하고 비어 있는 FAT32 USB/SD를 준비합니다. 디스크 자동 포맷 명령은 제공하지 않습니다.
	자산 준비 완료 후 프로젝트의 `USB` 폴더 내부 내용을 USB 드라이브 루트로 복사합니다. Windows 드라이브가 E:라면 EFI 위치는 `E:\EFI\BOOT\BOOTX64.EFI`입니다. `E:\USB\EFI...`나 `E:\BOOT\EFI...`로 배치하면 안 됩니다.
	기존 USB에 다른 BOOTX64.EFI가 있으면 먼저 보관하십시오. Windows ESP의 bootmgfw.efi를 덮어쓰지 않습니다.

	## 4. 수동 실행
	- 실기 사례처럼 Secure Boot를 끄고 UEFI 부팅 메뉴에서 USB/SD를 선택합니다.
	- v0.4.18 표시와 READY를 확인합니다. 준비 검사를 통과하지 못하면 U 단계에 도달하지 않습니다.
	- U를 한 번 누릅니다. Esc 또는 30초 대기는 취소입니다.
	- GPU 펌웨어 드라이버 분리 후 화면이 꺼지거나 마지막 화면이 남을 수 있습니다. 이것만으로 성공·실패를 판단하지 않습니다.
	- 복원 검사 성공 시 Windows Boot Manager로 인계합니다. 자동 재부팅이나 매 부팅 자동 실행을 등록하지 않습니다.
	- STOP이면 실행 중인 GPU가 정리되지 않았을 수 있으므로 해당 세션에서 반복 실행하지 말고 완전 전원 차단 후 정상 Windows 경로로 복구하십시오.

	## 5. 관측과 벤치마크
	필요한 요약은 SELECTOR RESULT, POST-FLR, POST-GOP, FINAL입니다. FINAL status=0만으로 성능 향상을 주장하지 마십시오. 상세 로그를 공개 저장소에 올릴 필요는 없습니다.
	`benchmarks/wsl`에서 `python3 bench.py --label unlocked`를 실행하고, 완전 전원 차단 후 EFI 없이 Windows/동일 WSL 부팅에서 `--label baseline`, 마지막으로 `--compare-latest`를 실행합니다. 같은 드라이버·전력 한도·오버클럭 조건을 유지합니다.

	## 6. 테스트 재현의 범위
	원본 모의 테스트는 해당 로컬 ROM과 PROM을 요구합니다. 파일은 공개하지 않으므로 다른 보드 파일로 그대로 테스트를 통과시키는 것을 지원하지 않습니다. 최종 소스 재빌드는 성공 EFI와 바이트 일치가 확인됐습니다. 43개 코어 및 50개 앱 모의 시나리오가 기존 개발 과정에서 통과했으며 실기 결과는 RUN19 한 카드입니다.