dotfiles/firmware/README.md

Asahi peripheral firmware (vendored)

hardware.asahi.peripheralFirmwareDirectory points here. A pure flake cannot read /boot/vendorfw, so the Wi-Fi/Bluetooth firmware must live inside the repo tree and be git-tracked.

Since nixos-apple-silicon 66d8dd2 the module expects the pre-extracted firmware.cpio (placed on the ESP by the Asahi installer) instead of all_firmware.tar.gz + kernelcache.*.

During install, on the Mac:

cp /boot/vendorfw/firmware.cpio ~/.dotfiles/firmware/
git -C ~/.dotfiles add -f firmware/firmware.cpio

(They're .gitignore-exempt via -f if needed — but the flake only sees tracked files, so they must be added.)

⚠ Keep this repository PRIVATE

This firmware is non-free and non-redistributable. Do not push it to a public remote.

Until you copy these files in, nixos-rebuild/nixos-install will fail at the firmware-extraction step — that's expected, same as the placeholder hardware-configuration.nix.