View source for NixOS on ARM/Orange Pi Zero Plus2 H5

{{ARM/breadcrumb}}
<div class="infobox">
{|class="table"
!colspan="2" class="title"|Orange Pi Zero Plus2 (H5)
|-
|colspan="2"|[[File:Orange-pi-zero-plus-two-h5_20180922_165004.jpg|frameless|256px|An Orange Pi Zero Plus2 (H5).]]
|-
!Manufacturer
|Xunlong / Orange Pi
|-
!Architecture
|AArch64
|-
!Bootloader
|[https://hydra.nixos.org/job/nixpkgs/trunk/ubootOrangePiZeroPlus2H5.aarch64-linux Upstream u-boot]<ref>https://github.com/NixOS/nixpkgs/pull/47187</ref>
|-
!Maintainer
|[[User:samueldr|samueldr]]
|}
</div>
{{note|While made by the same manufacturer and using an Allwinner SOC, the <em>H3 variant</em> does not use the same architecture; this page does not relate to the H3 variant.}}
<!-- TODO : write intro paragraph -->
== Status ==

Upstream NixOS AArch64 image will boot on the Orange Pi Zero Plus2 (H5), using the proper upstream u-boot.

== Board-specific installation notes ==

First follow the [[NixOS_on_ARM#Installation|generic installation steps]] to get the installer image on an SD card.

U-Boot needs to be copied to specific sectors on the microSD card with <code>dd</code>. Download u-boot for the board, and copy it to the correct location with (again, replace <code>/dev/sdX</code> with the correct path to the SD card device):

<syntaxhighlight lang="bash">sudo dd if=u-boot-sunxi-with-spl.bin of=/dev/sdX bs=1024 seek=8</syntaxhighlight>

Then, install using the [[NixOS_on_ARM#NixOS_installation_.26_configuration|installation and configuration steps]].

== Serial console==
{{expansion}}
<!--
Your configuration.nix will need to add <code>console=ttyS0,115200n8</code> to the <code>boot.kernelParams</code> configuration to use the serial console.

{{file|/etc/nixos/configuration.nix|nix|<nowiki>
{ config, pkgs, lib, ... }:
{
  boot.kernelParams = [
    "console=ttyS0,115200n8"
  ];
}
</nowiki>}}
-->
== Wireless ==
The wireless does not currently work using the upstream firmware from the firmware-linux-nonfree package. However there is a version of the firmware which does work in the Armbian [https://github.com/armbian/firmware firmware repository]. See [https://github.com/Thra11/nixpkgs/commit/f55c75458821de4af189d6e43ce497cb52694bb1 here] for an example of how the firmware from this repository can be added to nixpkgs, such that it overrides the upstream files.

== Compatibility notes ==

* Using the upstream kernel at 4.18, HDMI does work currently.

== Resources ==

* [http://www.orangepi.org/OrangePiZeroPlus2/ Official product page]
* [http://linux-sunxi.org/Xunlong_Orange_Pi_Zero_Plus_2 linux-sunxi wiki page]