This meta layer is mainly a mix of meta-sunxi and armbian.

This meta layer supports only boards with the allwinner H2, H3 and H5 cpus. The boards that are supported are the same ones that supported in armbian. The current supported list is the following ones:

  • nanopi-duo
  • nanopi-k1-plus
  • nanopi-m1
  • nanopi-m1-plus
  • nanopi-neo
  • nanopi-neo2
  • nanopi-neo-air
  • nanopi-neo-core2
  • nanopi-neo-plus2
  • orange-pi-one
  • orange-pi-pc
  • orange-pi-pc-plus
  • orange-pi-prime
  • orange-pi-win
  • orange-pi-zero
  • orange-pi-zero-plus
  • orange-pi-zero-plus2

The way this meta layer works is that it uses the u-boot and kernel patches from the armbian distro. The patches are located in: u-boot: recipes-bsp/u-boot/files/patches kernel: recipes-kernel/linux/linux-stable/patches

Also the patcher is ported from armbian and actually is the same for u-boot and the kernel, but it's in two places now: u-boot: recipes-bsp/u-boot/files/ kernel: recipes-kernel/linux/linux-stable/

Maybe at some point this will be converted in a bbclass.

Note: Not all of the above boards are tested, because I don't have them. I've only tested nanopi-k1-plus and nanopi-neo2.

How to use the layer

Create a folder for your project, then create a folder inside and name it sources. You have to use that name.

Then git clone this repo inside with poky and meta-openembedded.

cd sources
git clone
git clone --depth 1 -b sumo git://
git clone --depth 1 -b sumo

Then from the top directory that includes the sources run this command:

cp sources/meta-allwinner-hx/scripts/ .
cp sources/meta-allwinner-hx/scripts/ .

Then your top dir contects should look like this:

Then depending on the board you have, you need to set the MACHINE variable to the correct name. To list the names of supported boards you can the script like this:

source ./ build

Now in your build/conf/local.conf file you can choose which kernel you want to build. By default the linux-stable 4.14 version is build. In case you want to build the RT kernel then un-comment these two lines in the file:

PREFERRED_PROVIDER_virtual/kernel ?= "linux-stable-rt"
PREFERRED_VERSION_linux-stable-rt ?= "4.14%"

This will result in error, but it will also print the supported boards. Therefore, for nanopi-k1-plus, you can run:

MACHINE=nanopi-k1-plus source ./ build

Then to start building the image run as prompted:

bitbake allwinner-image

In this case this will create a .wic.bz2 image inside your build/tmp/deploy/images/nanopi-k1-plus.

WiFi networking

If your board has only a wifi network then you can add the SSID and the PSK password in the build/conf/local.conf and build the image. You can remove the comment on those two lines in the build/conf/local.conf and the proper values for your network.


For some reason it seems that the wpa_supplicant@wlan0.service service is not installed and started automatically. Because of that, on the first boot after the SD flash you need to run the following command manually and after that it works fine forever.

systemctl enable wpa_supplicant@wlan0

Flashing the image

After the image is build, you can use bmaptool to flash the image on your SD card. To this you first need to install bmap-tools.

sudo apt-get install bmap-tools

Then you need to run lsblk to find the device path of the SD and only after you verified the correct device then from your top directory run this:

sudo ./ /dev/sdX

If you want to do the steps manually then:

sudo umount /dev/sdX*
sudo bmaptool copy <.wic.bz2_image_path> /dev/sdX

Of course you need to change /dev/sdX with you actuall SD card dev path.


You can also build the core-image-minimal using this meta layer. But for some reason when you'll get the login prompt, then the root account doesn't work. This problem seems to be quite common, though.

The allwinner-image will install a service that forces the perfomance governor for all the cores by default. If you want to disable this, then you can remove the allwinner-performance entry from the meta-allwinner-hx/recipes-images/images/ image file. Or you can disable the service after you boot with

systemctl disable allwinner-performance

Once again, I haven't test this with all the boards, as I don't have them, but I expect that it should work also for the others!