Orange Pi PC

allwinner H3 legacy mainline
ServerDesktopQuick startKnown issuesNightly releasesKernels
Legacy 3.4.113

Mainline
No stable releases yet. Check nightly releases tab to see if experimental images are available.

Preparation

Make sure you have a good & reliable SD card and a proper power supply. Archives can be uncompressed with 7-Zip on Windows, Keka on OS X and 7z on Linux (apt-get install p7zip-full). RAW images can be written with Etcher (all OS).

How to boot?

Insert SD card into a slot and power the board. First boot takes around 3 minutes then it might reboot and you will need to wait another one minute to login. This delay is because system creates 128Mb emergency SWAP and expand SD card to it's full capacity. Worst case scenario boot (with DHCP) takes up to 35 seconds.

How to login?

Login as root on HDMI / serial console or via SSH and use password 1234. You will be prompted to change this password at first login. Next you will be asked to create a normal user account that is sudo enabled (beware of default QWERTY keyboard settings at this stage).

How to connect to your router via WIFI?

Required condition: a board with onboard or supported 3rd party wireless adapter on USB

nmtui-connect YOUR_ROUTER_SSID

Legacy kernel images (all boards) (default branch)

  • HDMI output supports only limited number of predefined resolutions
  • TV Out doesn't work as expected (only PAL/NTSC resolution, overscanning, no h3disp support)
  • 1-Wire protocol requires setting the minimum CPU frequency to 480MHz or higher
  • Hardware accelerated video decoding supports only limited number of video formats
  • OOM issues are possible due to a kernel bug

Mainline kernel images (all boards) (next/dev branches)

  • No Mali drivers
  • No hardware accelerated video decoding
  • schedutil CPU governor may cause clicks and pops on audio output - change to ondemand to work around this issue

Board: Orange Pi Zero

  • Onboard wireless chip (XR819) has poor software support so wireless connection issues are expected
Nightly 4.9.4
Warning: nightly downloads are automated untested builds and no end user support is provided for them!
Updating from nightly repository?

sed -i "s/apt/beta/" /etc/apt/sources.list.d/armbian.list
apt-get update
apt-get upgrade
When bug is found?

Warning: you are entering developers area and things can be completely broken. Don’t use this in production.
default, vendor provided / legacy (3.4.x – 4.4.x)
To make sure you won’t run into conflicts within newly installed packages, remove them all before upgrade:

 aptitude remove ~nlinux-dtb ~nlinux-u-boot ~nlinux-image ~nlinux-headers 
aptitude remove ~nlinux-firmware ~narmbian-firmware ~nlinux-$(lsb_release -cs)-root

Proceed with install:

apt-get install linux-image-sun8i linux-headers-sun8i 
apt-get install linux-u-boot-orangepipc-default linux-$(lsb_release -cs)-root-orangepipc 
apt-get install armbian-firmware sunxi-tools swconfig a10disp
reboot
dev – developement (4.x)
To make sure you won’t run into conflicts within newly installed packages, remove them all before upgrade:

 aptitude remove ~nlinux-dtb ~nlinux-u-boot ~nlinux-image ~nlinux-headers 
aptitude remove ~nlinux-firmware ~narmbian-firmware ~nlinux-$(lsb_release -cs)-root

Proceed with install:

apt-get install linux-image-dev-sun8i linux-dtb-dev-sun8i linux-headers-dev-sun8i 
apt-get install linux-u-boot-orangepipc-dev linux-$(lsb_release -cs)-root-dev-orangepipc 
apt-get install armbian-firmware sunxi-tools swconfig a10disp
reboot