Help a model get there

Your laptop still has Windows

The Omarchy Arm Installer reads the laptop from its own Windows and writes a hardware report with the ACPI and SMBIOS tables Windows uses to describe the hardware, its hardware IDs, every device with its driver and resources, and a list of the firmware files in its drivers. A device tree is written from exactly that. Serial numbers and other personal details are taken out, and no firmware files go into the report.

1. Download OmarchyArmInstaller.exe from the installer's latest release. It's a pre-release, so expect rough edges.
2. Right-click it and choose Run as administrator, which it needs to read the firmware tables.
3. Choose Share a hardware report. If Linux doesn't know the laptop yet, the installer offers it by itself.
4. Choose Collect the report. The zip lands in Downloads, next to a list of what was taken out of it.
5. Choose Open the form. The model and its hardware IDs are filled in already. Drag the zip in, add a link to the vendor's driver page if you know it, and submit. Reports are public in omarchy-hardware-reports.

If you can test boot images on the laptop later, say so in the report. An owner who can test is what gets a device tree finished.

You already run Linux on it

If Linux boots on it, with another model's device tree or one you patched, the tree it boots with is the best start for its own. The kernel keeps a copy of it you can save.

1. Install the device tree compiler and fwupd.

   sudo pacman -S dtc fwupd                     # Arch, Omarchy
   sudo apt install device-tree-compiler fwupd  # Debian, Ubuntu
   sudo dnf install dtc fwupd                   # Fedora

2. Save the device tree the laptop booted with, without its serial number. Warnings from dtc are normal.

   dtc -I fs -O dts /sys/firmware/devicetree/base > tree.dts
   sed -i '/serial-number/d' tree.dts

3. Save its hardware IDs.

   sudo fwupdtool hwids > hwids.txt

4. Open Add your model, drag in both files, and say which device tree you started from and what you changed. A patch or a link to your branch is even better.

It's ready to test

A model marked Ready to test has every piece in place, with a device tree in Linux, hardware IDs in systemd and its firmware. Nobody has confirmed it on the real hardware yet.

1. Make an Omarchy USB stick. With Windows still on the laptop, the Omarchy Arm Installer makes one and copies the laptop's firmware onto it from Windows' own drivers.
2. Turn off Secure Boot, boot from the stick, and install, or just see how far it gets.
3. Open Add your model and choose how far it got. Say what didn't work, like sound, the battery status or an external screen. If you run another distro on it, tell us how that does too.