Getting Started with OrangePi Zero 2: A Complete Beginner's Guide

Overview

The OrangePi Zero 2 is a low-cost single-board computer powered by the Allwinner H616 SoC (ARM Cortex-A53). It supports multiple operating systems including Ubuntu, Debian, and Android TV 10. This guide provides step-by-step instructions for setting up the board from scratch, covering hardware preparation, system installation, serial console access, network configuration, and basic system customization.

  1. Prerequisites

1.1 Hardware Requirements

  • OrangePi Zero 2 board
  • Power adapter (5V/2A minimum) or USB 3.0 port for initial testing
  • USB Type-C cable
  • USB-to-TTL adapter (e.g., CH340G or CP2102)
  • MicroSD card (class 10 or higher, 8GB+; SanDisk recommended to avoid boot issues)
  • Card reader
  • Dupont wires (female-to-female)

1.2 Software Downloads

  • OS image and documentation: Retrieve the official OrangePi Zero 2 image package from the manufacturer's cloud drive (Baidu Netdisk). Choose the Ubuntu desktop image with kernel 5.x for a modern experience.
  • SD Card Formatter: Download from the SD Association website.
  • Image writing tool: Use BalenaEtcher (portable edition) or Win32 Disk Imager.
  • Terminal emulator: MobaXterm (portable edition) – supports both serial and SSH sessions.
  • Serial driver: CH341SER.EXE (compatible with CH340/CH341 chips).

1.3 Software Installation

Install the serial driver if your PC does not automatically recognize the USB-to-TTL adapter. Verify successful installation by checking for "USB-SERIAL CH340" under "Ports (COM & LPT)" in Device Manager.

  1. System Installation

2.1 Format the MicroSD Card

Insert the card into the reader and launch SD Card Formatter. Select "Quick format" and click "Format". Confirm the warning. This prepares the card for the OS image.

2.2 Write the Image Using BalenaEtcher

  1. Extract the downloaded OS image (.img or .xz file).
  2. Run BalenaEtcher (as administrator if necessary).
  3. Click "Flash from file" and select the extracted image.
  4. Click "Select target" and choose the SD card drive.
  5. Click "Flash!" and wait for the process to complete. The tool will automatically verify the written data.

After verification, safely eject the card and insert it into the OrangePi Zero 2.

  1. Serial Console Access

3.1 Wiring

The OrangePi Zero 2 provides dedicated debug UART pins (3-pin header). Connect the USB-to-TTL adapter as follows:

  • Board TX → Adapter RX
  • Board RX → Adapter TX
  • Board GND → Adapter GND

After connecting, plug the adapter into a USB port on your PC. Note the assigned COM port from Device Manager.

3.2 Login via Serial

  1. Open MobaXterm and create a new session: click "Session" → "Serial".
  2. Set the serial port (e.g., COM13) and baud rate to 115200.
  3. Power on the OrangePi Zero 2. You will see boot logs in the terminal.
  4. When prompted with "orangepizero2 login:", enter the default credentials:
Username: orangepi
Password: orangepi
  1. Change the Default Password

Use the following command to update the password (replace with your own):

sudo passwd orangepi

Enter the current password (orangepi), then type a new password twice. The new password takes effect immediately. You can verify by rebooting:

sudo reboot
  1. Enable Full Boot Log Output

By default, the kernel log level is set to 1, which suppresses most boot messages. To see complete logs, edit the boot configuration file:

sudo vim /boot/orangepiEnv.txt

Locate the line verbosity=1 and change it to verbosity=7. Save and exit (in vim: press i to edit, make the change, press Esc, then type :wq and Enter). Reboot to see the extended log output.

  1. Network Configuration

6.1 Check Current Network Status

ifconfig

Look for eth0 (wired) and wlan0 (wireless). If no IP is assigned, proceed with one of the following methods.

6.2 Wired Connection (Ethernet)

Plug an Ethernet cable into the RJ-45 port. After a few seconds, run ifconfig again to obtain an IP address from the DHCP server.

6.3 Wireless Connection (Wi-Fi)

Use the nmcli tool to connect to a Wi-Fi network:

nmcli dev wifi

List available networks. Then connect using:

nmcli dev wifi connect "YOUR_SSID" password "YOUR_PASSWORD"

Example:

nmcli dev wifi connect "MyWiFi" password "secret123"

After successful connection, reboot and verify the IP with ifconfig.

6.4 Set a Static IP Address

Using the nmtui tool is convenient, but if your terminal does not display the TUI correctly, use the command-line method instead. Here we use nmtui:

  1. Run sudo nmtui.

  2. Select "Edit a connnection".

  3. Choose the interface (e.g., "Wired connection 1" for eth0).

  4. Set IPv4 configuration to "Manual".

  5. Enter the static IP (e.g., 192.168.1.100/24), gateway (e.g., 192.168.1.1), and DNS (e.g., 8.8.8.8).

  6. Deactivate and reactivate the connection to apply changes.

  7. Repeat for the Wi-Fi interface if needed.

  8. SSH Access

SSH is enabled by default. From MobaXterm (or any SSH client):

  1. Click "Session" → "SSH".
  2. Enter the OrangePi's IP address.
  3. Check "Specify username" and type "orangepi".
  4. Click OK, then enter the password.

After login, you can disconnect the serial adapter and continue working over SSH. MobaXterm saves sessions in the left sidebar for quick reconnection.

  1. Update System Repositories and Packages

8.1 (Optional) Change APT Mirror

The default mirror (Tsinghua TUNA) is already fast for Chinese users. To use a different mirrer, back up the sources list first:

sudo cp /etc/apt/sources.list /etc/apt/sources.list.save

Then edit the file:

sudo vim /etc/apt/sources.list

Replace with your preferred repository. Example for Tsinghua (Ubuntu Jammy):

deb http://mirrors.tuna.tsinghua.edu.cn/ubuntu-ports/ jammy main restricted universe multiverse
deb http://mirrors.tuna.tsinghua.edu.cn/ubuntu-ports/ jammy-security main restricted universe multiverse
deb http://mirrors.tuna.tsinghua.edu.cn/ubuntu-ports/ jammy-updates main restricted universe multiverse
deb http://mirrors.tuna.tsinghua.edu.cn/ubuntu-ports/ jammy-backports main restricted universe multiverse

8.2 Update and Upgrade

sudo apt update
sudo apt upgrade -y
  1. Set Correct Timezone

Check current time with date. If wrong, reconfigure timezone:

sudo dpkg-reconfigure tzdata

Select your geographic area (e.g., Asia/Shanghai). Then verify:

date
  1. Customize Vim Editor (Optional)

Edit the system-wide vim configuration file:

sudo vim /etc/vim/vimrc

Add or uncomment lines to enable features like line numbers, syntax highlighting, etc. Example additions:

set number
set cursorline
set tabstop=4
set laststatus=2
set ruler
set cindent

To apply changes without restarting, source the file:

source /etc/vim/vimrc

Next Steps

Your OrangePi Zero 2 is now ready for development projects. You can install additional software, connect peripherals, or experiment with GPIO programming.

Tags: OrangePi OrangePi Zero 2 Allwinner H616 ARM Cortex-A53 Ubuntu

Posted on Wed, 13 May 2026 11:35:45 +0000 by FunkyELF

Hot Tags

©2026 Freaks City