68 lines
1.6 KiB
Markdown
68 lines
1.6 KiB
Markdown
# Orange Pi Zero 2W OS setup
|
|
|
|
## Recommended image
|
|
|
|
Use the official Debian 12 Bookworm server image for Orange Pi Zero 2W:
|
|
|
|
```text
|
|
orangepizero2w_1.0.0_debian_bookworm_server_linux6.1.31.7z
|
|
```
|
|
|
|
Orange Pi's Zero 2W wiki lists Debian 12 Bookworm with Linux 6.1 as supported, and its Linux 6.1 driver table marks Wi-Fi, Type-C USB2.0, TF card boot, and related board features as OK.
|
|
|
|
Official references:
|
|
|
|
- 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
|
|
|
|
## Flashing
|
|
|
|
1. Download the image into `os/`.
|
|
2. Extract the `.7z` file to get the `.img`.
|
|
3. Flash the `.img` to the microSD with Balena Etcher, Raspberry Pi Imager, or another verified imaging tool.
|
|
4. Mount the flashed boot/root partition and configure first-run Wi-Fi before inserting it into the Orange Pi.
|
|
|
|
## Headless Wi-Fi first boot
|
|
|
|
On the flashed SD card, find:
|
|
|
|
```text
|
|
/boot/orangepi_first_run.txt.template
|
|
```
|
|
|
|
Copy it to:
|
|
|
|
```text
|
|
/boot/orangepi_first_run.txt
|
|
```
|
|
|
|
Then set the Wi-Fi fields. `os/orangepi_first_run.example.txt` contains a local example for Korea region code `KR`.
|
|
|
|
The important values are:
|
|
|
|
```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'
|
|
```
|
|
|
|
## First login
|
|
|
|
For official Debian/Ubuntu Orange Pi images, the usual default accounts are:
|
|
|
|
```text
|
|
orangepi / orangepi
|
|
root / orangepi
|
|
```
|
|
|
|
Change the password on first login.
|
|
|
|
```bash
|
|
passwd
|
|
sudo passwd root
|
|
```
|
|
|