View source for NixOS on ARM/Libre Computer AML-S905X-CC-V2

{{ARM/breadcrumb}}
<div class="infobox">
{|class="table"
!colspan="2" class="title"|AML-S905X-CC-V2
|-
!Manufacturer
|Libre Computer
|-
!Architecture
|AArch64
|-
!Bootloader
|U-Boot or UEFI
|-
!Maintainer
|[[User:Programmerino|Programmerino]]
|}
</div>
== Status ==

The only tested installation method is using [[NixOS_on_ARM/UEFI]], although limited testing with the [https://hydra.nixos.org/job/nixos/trunk-combined/nixos.sd_image.aarch64-linux generic SD image] also showed promise

== Board-specific installation notes ==

Follow the [[NixOS_on_ARM/UEFI|generic UEFI installation steps]], and make sure to use an image which has at least kernel 6.2 to avoid [https://hub.libre.computer/t/s805x-1gb-version-boots-nice-but-not-its-512mb-brother/1600/13 networking issues]. [https://hydra.nixos.org/job/nixos/trunk-combined/nixos.iso_minimal_new_kernel_no_zfs.aarch64-linux These images] are recommended.

The biggest hurdle is making sure you have the latest bootloader installed. The easiest approach is to use [https://github.com/libre-computer-project/libretech-flash-tool/tree/master the official flashing tool] on a microSD card (or potentially directly onto the SPI flash if you already have an OS booted), and then write the NixOS ISO to a USB drive. Although this isn't documented, it appears that the physical boot switch chooses whether to choose the bootloader from the flash memory or the microSD card. If you just flashed the new bootloader to a microSD card, make sure it is set in the position closest to the I/O (ethernet, USB ports, etc.), otherwise, set it to the opposite direction.

== Configuration ==

=== Use latest kernel ===

As of writing, the stable LTS kernel is not 6.2+ and thus the default configuration.nix will cause [https://hub.libre.computer/t/s805x-1gb-version-boots-nice-but-not-its-512mb-brother/1600/13 networking issues]. To avoid this, make the change below:

{{file|/etc/nixos/configuration.nix|nix|<nowiki>
{
  boot.kernelPackages = pkgs.linuxPackages_latest;
}
</nowiki>}}
== Troubleshooting ==

=== Selecting any boot option resets the board ===

You probably are not using the latest platform firmware, or the physical boot switch is not set correctly (and that is causing you to boot from the factory bootloader). See the instructions above. 

=== Squashfs errors ===

Use the copytoram boot option

<hr />