TEGO Gaming 사용설명서

기존 기록입니다. 현재 원본의 SHA256은 에디션 페이지에서 확인하세요.

# TEGO Gaming 0.1 ARM64 — Raspberry Pi 4

Raspberry Pi OS 기반 게임용 TEGO입니다. 대상은 Raspberry Pi 4, 권장 RAM은 **2GB**입니다. 실제 2GB 장치 성능은 실물 테스트 전까지 미검증입니다.

## 포함 기능

- IceWM 경량 데스크톱과 한글 게임 런처
- SuperTux: 2D 플랫포머
- OpenTTD: 운송 경영, 자유 배포 그래픽·음악·효과음 포함
- Neverball: 공 굴리기 게임
- USB 게임패드 확인 도구, Wi-Fi 설정, ALSA 볼륨 조절
- Pi 4 KMS 그래픽 드라이버와 Mesa, zram 압축 스왑

SuperTux와 Neverball은 1280×720 창 모드로 시작하도록 설정합니다. 게임 내 설정에서 변경할 수 있습니다. 게임패드 지원과 버튼 배치는 게임마다 다릅니다. 일반 PC용 Windows 게임 실행 기능은 포함하지 않습니다.

## 설치

결과: `../dist/TEGO-Gaming/TEGO-Gaming-0.1-arm64-rpi4.img.xz`

1. 16GB 이상 microSD를 준비합니다.
2. Raspberry Pi Imager에서 사용자 지정 이미지로 압축 IMG를 선택하고 카드를 기록합니다. 선택한 카드 내용은 지워집니다.
3. Pi 4에 HDMI 모니터, 키보드·마우스를 연결하고 전원을 켭니다.
4. 기반 Raspberry Pi OS의 최초 계정 설정을 완료하고 첫 번째 콘솔에 로그인합니다.
5. 데스크톱과 게임 런처가 열립니다. 게임 종료 후 Windows 키로 런처를 다시 열 수 있습니다. Esc는 바탕 화면으로 돌아갑니다.

공유 기본 비밀번호는 없습니다. 계정 생성은 기반 이미지의 첫 부팅 절차를 사용합니다. Imager의 OS 사용자 설정이 사용자 지정 이미지에 적용되었다고 가정하지 마세요.

Wi-Fi는 런처에서 설정합니다. 국가 설정이 필요하면 Pi 설정에서 무선 국가를 지정하세요. 소리가 나지 않으면 Pi 설정 및 볼륨 설정에서 출력 장치를 확인하세요.

## 빌드 및 검증

Linux root, ARM64 binfmt/QEMU, loop 장치, parted, e2fsprogs, xz가 필요합니다. 기반 `dist/TEGO-ARM64/SHA256SUMS`를 검증한 후 별도 임시 이미지 파일을 수정합니다. 물리 디스크는 수정하지 않습니다.

`sudo bash build.sh`로 빌드합니다. 이미지 생성 후 `sudo bash test-desktop.sh`는 ARM64 실행 파일을 QEMU 사용자 모드와 호스트 Xvfb에서 실행하여 런처 및 게임 창을 확인합니다. 이것은 Pi 커널 부팅이나 실제 GPU 성능 테스트가 아닙니다.

실물 검증: Pi 4 2GB에서 부팅, 첫 계정 생성, Wi-Fi, HDMI·오디오, USB 게임패드, 세 게임 플레이 및 재부팅 후 저장을 확인하세요. `glxinfo -B`의 렌더러가 소프트웨어 렌더링인 llvmpipe인지 확인하고, `free -h`, `swapon --show`, `systemctl --failed`도 확인하세요.

KMS 설정 참고: https://www.raspberrypi.com/documentation/computers/config_txt.html