Orange Pi Zero2 Setup Guide
The Orange Pi Zero2 is a highly compact, open-source single-board computer equipped with dual-band WiFi and Bluetooth 5.0. It can run Ubuntu, Android10, or Debian distributions.
Follow this guide to set up your Orange Pi Zero2 to run viam-server.
Hardware requirements
- Development machine: laptop or computer workstation
- An Orange Pi Zero2
- A 5V 3A power supply with a USB-C connector
- A microSD card: Minimum of 8GB, 16GB recommended
- SD card reader (recommended with USB-C connector)
- A monitor: for display
- Micro-HDMI to HDMI cable: to connect Orange Pi to monitor display
- USB keyboard and mouse
- USB-C to USB-A cables: to connect keyboard and mouse to USB hub
- USB hub with USB-A connector (recommended)
Power your Orange Pi Zero2
Before you power the board, you need to install an operating system.
- First, download an Orange Pi Ubuntu image to your development machine.
We recommend
ubuntu_jammy_desktop. - Unzip the image.
- Insert the micro-SD card into the SD card reader and connect the reader to your development machine.
- Follow this guide to flash the OS to your micro-SD card using balenaEtcher.
Tip: How to think about building a machine
While flashing your microSD card, we recommend reading How to think about building a machine.
- Insert the micro-SD into the Orange Pi.
To power your Orange Pi Zero2, connect your power adapter to the Zero2’s USB-C port. The LED should light up, which indicates that the board is powered.
Tip
If your board’s LED does not light up when powered, try re-flashing your micro-SD card with the ubuntu_jammy_desktop image or using a different micro-SD card.
The Orange Pi will only power on with a compatible operating system installed.
To connect to a display, connect the micro-HDMI end of your HDMI cable to the Orange Pi and the other end to your monitor. Then, to connect the keyboard and mouse, plug the two devices into your USB hub and connect the USB hub to your Orange Pi’s USB-A port.
After it boots, you should be greeted with the Orange Pi desktop display. If it prompts you for a password, note that the default password for Orange Pi devices is “orangepi”.
Establish a network connection
The Orange Pi Zero2 comes equipped with a wireless network antenna. To connect to WiFi, click on the WiFi icon in the top right of the monitor display, select your preferred network or hotspot, and enter the password.
Tip
You can also connect to WiFi while connected to the Orange Pi on the terminal with several different methods, including the nmcli tool.
For more information, consult the official user manual (page 80).
Next steps
You have now installed an operating system on your Orange Pi. To use your Orange Pi, follow the setup guide:
If you want to use the GPIO pins on the board, add a orangepi board as a component after installing viam-server.
Troubleshooting
If you are prompted for a password in the terminal, the default password for Orange Pis is “orangepi”.
Visit the Orange Pi Forum for troubleshooting tips and tricks specific to the Orange Pi.
Was this page helpful?
Glad to hear it! If you have any other feedback please let us know:
We're sorry about that. To help us improve, please tell us what we can do better:
Thank you!