# Orange Pi Zero 2W OS 설치 준비

## 권장 이미지

Orange Pi Zero 2W용 공식 Debian 12 Bookworm Server 이미지를 우선 사용합니다.

```text
Orangepizero2w_1.0.0_debian_bookworm_server_linux6.1.31.7z
```

이 이미지를 권장하는 이유는 다음과 같습니다.

- 서버 이미지라 불필요한 데스크톱 환경이 없습니다.
- 마이크 송신기처럼 headless로 동작하는 장비에 적합합니다.
- Linux 6.1 기반 공식 이미지라 Zero 2W의 Wi-Fi, USB, TF 카드 부팅 등 기본 보드 기능을 기대할 수 있습니다.
- 이후 C++ 기반 송신기 소프트웨어를 올리기 좋은 가벼운 출발점입니다.

공식 참고 링크:

- https://www.orangepi.org/orangepiwiki/index.php/Orange_Pi_Zero_2W
- https://www.orangepi.org/html/hardWare/computerAndMicrocontrollers/service-and-support/Orange-Pi-Zero-2W.html
- http://www.orangepi.cn/html/hardWare/computerAndMicrocontrollers/service-and-support/Orange-Pi-Zero-2W.html

## 이미지 파일 확인

`os/` 폴더에 다운로드한 압축 파일을 보관합니다.

```text
os/Orangepizero2w_1.0.0_debian_bookworm_server_linux6.1.31.7z
```

압축 파일 안에는 보통 다음 파일들이 들어 있습니다.

```text
Orangepizero2w_1.0.0_debian_bookworm_server_linux6.1.31.img
Orangepizero2w_1.0.0_debian_bookworm_server_linux6.1.31.img.sha
```

`.img` 파일은 microSD에 실제로 기록할 OS 이미지이고, `.sha` 파일은 이미지 무결성 검증에 사용합니다.

## microSD에 기록하기

1. `.7z` 압축 파일을 풉니다.
2. 나온 `.img` 파일을 확인합니다.
3. Balena Etcher, Raspberry Pi Imager, Win32 Disk Imager 같은 도구로 `.img` 파일을 microSD에 기록합니다.
4. 기록이 끝나면 microSD를 다시 마운트해서 첫 부팅용 Wi-Fi 설정을 준비합니다.

## Headless Wi-Fi 첫 부팅 설정

키보드와 모니터 없이 처음 부팅하려면, 기록된 microSD의 boot 파티션에서 다음 파일을 찾습니다.

```text
/boot/orangepi_first_run.txt.template
```

이 파일을 복사해서 아래 이름으로 만듭니다.

```text
/boot/orangepi_first_run.txt
```

그다음 Wi-Fi 관련 값을 수정합니다. 예시는 `os/orangepi_first_run.example.txt`에 있습니다.

중요한 값은 다음과 같습니다.

```text
FR_net_change_defaults=1
FR_net_ethernet_enabled=0
FR_net_wifi_enabled=1
FR_net_wifi_ssid='YOUR_WIFI_SSID'
FR_net_wifi_key='YOUR_WIFI_PASSWORD'
FR_net_wifi_countrycode='KR'
```

한국에서 사용할 경우 국가 코드는 `KR`로 둡니다.

## 첫 로그인

Orange Pi 공식 Debian/Ubuntu 이미지의 기본 계정은 보통 다음과 같습니다.

```text
orangepi / orangepi
root     / orangepi
```

첫 로그인 후에는 반드시 비밀번호를 변경합니다.

```bash
passwd
sudo passwd root
```

## 다음 단계

OS 부팅과 SSH 접속이 확인되면, USB 라발리에 마이크 인식 여부와 Wi-Fi 연결 안정성을 확인합니다.

송신기와 수신기 소프트웨어는 이후 C++ 기준으로 설계하고 구현합니다.