NixOS on ARM/Orange Pi Zero2 H616 - Revision history

Pigs: Add category

2025-05-19T05:21:58Z

Add category

← Older revision		Revision as of 05:21, 19 May 2025
Line 208:		Line 208:
	* [http://www.orangepi.org/html/hardWare/computerAndMicrocontrollers/details/Orange-Pi-Zero-2.html Official product page]		* [http://www.orangepi.org/html/hardWare/computerAndMicrocontrollers/details/Orange-Pi-Zero-2.html Official product page]
	* [https://linux-sunxi.org/Xunlong_Orange_Pi_Zero2 wiki page]		* [https://linux-sunxi.org/Xunlong_Orange_Pi_Zero2 wiki page]

			[[Category:NixOS on ARM]]

imported>Ein-shved: Add more info about USB, Wi-Fi and HDMI

2022-12-24T12:41:36Z

Add more info about USB, Wi-Fi and HDMI

← Older revision		Revision as of 12:41, 24 December 2022
Line 139:		Line 139:

	{{note\|Be careful with such firmware - the unstable kernel version may be harmfull}}		{{note\|Be careful with such firmware - the unstable kernel version may be harmfull}}

			=== USB ===

			The suggested master kernel supports only the onboard usb ports (not sure about USB type-C). If you want to use extension board or D+/D- pins, you need to add dts overlay to enable ehci and ohci ports. Just enable them all, putting this to configuration:

			<syntaxHighlight lang=nix>
			hardware.deviceTree = {
			enable = true;
			filter = "sun50i-h616-orangepi-zero2.dtb";
			overlays = [
			{
			name = "sun50i-h616-orangepi-zero2.dtb";
			dtsText = ''
			/dts-v1/;
			/plugin/;

			/ {
			compatible = "xunlong,orangepi-zero2", "allwinner,sun50i-h616";
			};

			&ehci0 {
			status = "okay";
			};

			&ehci1 {
			status = "okay";
			};

			&ehci2 {
			status = "okay";
			};

			&ehci3 {
			status = "okay";
			};

			&ohci0 {
			status = "okay";
			};

			&ohci1 {
			status = "okay";
			};

			&ohci2 {
			status = "okay";
			};

			&ohci3 {
			status = "okay";
			};
			'';
			}
			];
			};
			</syntaxHighlight>

			=== WiFi ===

			According to SOC [https://github.com/torvalds/linux/blob/master/arch/arm64/boot/dts/allwinner/sun50i-h616.dtsi dts], Wi-Fi does not supported yet in mainline.

			=== HDMI ===

			According to SOC [https://github.com/torvalds/linux/blob/master/arch/arm64/boot/dts/allwinner/sun50i-h616.dtsi dts], HDMI does not supported yet in mainline.

	== Resources ==		== Resources ==

imported>Ein-shved: Ein-shved moved page NixOS on ARM/Orange Pi Zero2 H626 to NixOS on ARM/Orange Pi Zero2 H616: Type withing SOC name

2022-12-23T13:26:12Z

Ein-shved moved page NixOS on ARM/Orange Pi Zero2 H626 to NixOS on ARM/Orange Pi Zero2 H616: Type withing SOC name

← Older revision		Revision as of 13:26, 23 December 2022
(No difference)

imported>Ein-shved: Got working USB

2022-12-22T21:44:49Z

Got working USB

Show changes

imported>Ein-shved at 08:18, 25 November 2022

2022-11-25T08:18:22Z

← Older revision		Revision as of 08:18, 25 November 2022
Line 91:		Line 91:

	Connected at 1Gbps mode.		Connected at 1Gbps mode.

			== USB ==

			The vanilla dts from kernel 6.0.9 does not contains required usb sections. Working on correct dts overlay for it.

	== Wireless ==		== Wireless ==

imported>Ein-shved at 22:07, 15 November 2022

2022-11-15T22:07:40Z

← Older revision		Revision as of 22:07, 15 November 2022
Line 22:		Line 22:
	== Status ==		== Status ==

	~~The support of allwiner H616 soc was introduced to the Linux upstream kernel since 6.0 version.~~
	Upstream unstable NixOS AArch64 image will boot on the Orange Pi Zero2 (H616), using the proper upstream u-boot.		Upstream unstable NixOS AArch64 image will boot on the Orange Pi Zero2 (H616), using the proper upstream u-boot.

			The support of allwiner H616 soc was introduced to the Linux upstream kernel since 6.0 version, but the 5.15.78 kernel still able to boot from unstable NixOS brunch.

	== Board-specific installation notes ==		== Board-specific installation notes ==

imported>Ein-shved: Created page with "{{ARM/breadcrumb}}
{|class="table" !colspan="2" class="title"|Orange Pi Zero2 (H616) |- |colspan="2"|File:Orange-pi-zero-two-h616.png|frameless|256px|A..."

2022-11-15T21:15:16Z

Created page with "{{ARM/breadcrumb}} <div class="infobox"> {|class="table" !colspan="2" class="title"|Orange Pi Zero2 (H616) |- |colspan="2"|File:Orange-pi-zero-two-h616.png|frameless|256px|A..."

New page

{{ARM/breadcrumb}}
<div class="infobox">
{|class="table"
!colspan="2" class="title"|Orange Pi Zero2 (H616)
|-
|colspan="2"|[[File:Orange-pi-zero-two-h616.png|frameless|256px|An Orange Pi Zero Plus2 (H5).]]
|-
!Manufacturer
|Xunlong / Orange Pi
|-
!Architecture
|AArch64
|-
!Bootloader
|[https://hydra.nixos.org/job/nixpkgs/trunk/ubootOrangePiZero2.aarch64-linux Upstream u-boot]<ref>https://github.com/NixOS/nixpkgs/pull/125743</ref>
|-
!Maintainer
|[[User:Ein-shved|Ein-shved]]
|}
</div>

== Status ==

The support of allwiner H616 soc was introduced to the Linux upstream kernel since 6.0 version.
Upstream unstable NixOS AArch64 image will boot on the Orange Pi Zero2 (H616), using the proper upstream u-boot.

== Board-specific installation notes ==

=== Fastest way ===

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]].

=== Better way ===

You can use next flake to prepare ready-to-work image

<syntaxHighlight lang=nix>
{
description = "Build image for Orange Pi Zero2 H616";
inputs.nixpkgs.url = github:nixos/nixpkgs;
outputs = { self, nixpkgs }: rec {
# Better to avoid cross-compiling to
# download derivations from cache
system = "aarch64-linux";
nixosConfigurations.orpiz2 = nixpkgs.lib.nixosSystem rec {
system = "aarch64-linux";
modules = [
# Based on generic aarch64 image
"${nixpkgs}/nixos/modules/installer/sd-card/sd-image-aarch64.nix"
{
config = let
# Appropriate bootloader
bootloader = nixpkgs.legacyPackages.
aarch64-linux.ubootOrangePiZero2;
in {
system.stateVersion = "22.11";
# Use the supported kernel
boot.kernelPackages = nixpkgs.legacyPackages.
aarch64-linux.linuxKernel.packages.linux_6_0;
sdImage.postBuildCommands = ''
# Emplace bootloader to specific place in firmware file
dd if=${bootloader}/u-boot-sunxi-with-spl.bin of=$img \
bs=1024 seek=8 \
conv=notrunc # avoid truncation of image
'';
};
}
];
};
images = {
orpiz2 = nixosConfigurations.orpiz2.config.system.build.sdImage;
};
};
}
</syntaxHighlight>

Run <syntaxhighlight lang="bash">nix build .#images.orpiz2</syntaxhighlight> to prepare image

== Serial console==

The default console configuration from sd-image-aarch64 works out of the box.

== Ethernet ==

Connected at 1Gbps mode.

== Wireless ==

Not tested

== HDMI ==

Not tested

== Resources ==

* [http://www.orangepi.org/html/hardWare/computerAndMicrocontrollers/details/Orange-Pi-Zero-2.html Official product page]
* [https://linux-sunxi.org/Xunlong_Orange_Pi_Zero2 wiki page]