NixOS on ARM/Raspberry Pi 4 - Revision history

Hunorg: /* Customizing & Generating SD image without installation step */

2026-04-18T15:22:42Z

Customizing & Generating SD image without installation step

← Older revision		Revision as of 15:22, 18 April 2026
Line 312:		Line 312:
	[https://github.com/nix-community/raspberry-pi-nix/ nix-community/raspberry-pi-nix]		[https://github.com/nix-community/raspberry-pi-nix/ nix-community/raspberry-pi-nix]

	For a minimal flake-based image that boots directly into Wi-Fi with Tailscale preconfigured and no Ethernet required, see [https://gitlab.com/hunorg/nixos-rpi-headless nixos-rpi-headless]. It includes workarounds for brcmfmac Wi-Fi driver quirks.		For a minimal flake-based image that boots directly into Wi-Fi with Tailscale preconfigured and no Ethernet required, see [https://gitlab.com/hunorg/nixos-rpi-headless nixos-rpi-headless]. It also includes workarounds for brcmfmac Wi-Fi driver quirks..

	== Notes about the boot process ==		== Notes about the boot process ==

Hunorg: /* Customizing & Generating SD image without installation step */

2026-04-18T15:16:16Z

Customizing & Generating SD image without installation step

← Older revision		Revision as of 15:16, 18 April 2026
Line 312:		Line 312:
	[https://github.com/nix-community/raspberry-pi-nix/ nix-community/raspberry-pi-nix]		[https://github.com/nix-community/raspberry-pi-nix/ nix-community/raspberry-pi-nix]

	For a minimal flake-based image that boots directly into Wi-Fi with Tailscale preconfigured and no Ethernet required, see [~~nixos-rpi-headless](<nowiki>~~https://gitlab.com/hunorg/nixos-rpi-headless~~</nowiki>)~~. It includes workarounds for brcmfmac Wi-Fi driver quirks.		For a minimal flake-based image that boots directly into Wi-Fi with Tailscale preconfigured and no Ethernet required, see [https://gitlab.com/hunorg/nixos-rpi-headless nixos-rpi-headless]. It includes workarounds for brcmfmac Wi-Fi driver quirks.

	== Notes about the boot process ==		== Notes about the boot process ==

Hunorg: /* Customizing & Generating SD image without installation step */

2026-04-18T15:13:28Z

Customizing & Generating SD image without installation step

← Older revision		Revision as of 15:13, 18 April 2026
Line 312:		Line 312:
	[https://github.com/nix-community/raspberry-pi-nix/ nix-community/raspberry-pi-nix]		[https://github.com/nix-community/raspberry-pi-nix/ nix-community/raspberry-pi-nix]

	For a minimal flake-based image that boots directly into ~~WiFi~~ with Tailscale ~~pre-configured (~~no ~~ethernet~~ required), see [https://gitlab.com/hunorg/nixos-rpi-headless ~~nixos-rpi-headless]~~. ~~Includes~~ workarounds for brcmfmac ~~WiFi~~ driver quirks.		For a minimal flake-based image that boots directly into Wi-Fi with Tailscale preconfigured and no Ethernet required, see [nixos-rpi-headless](<nowiki>https://gitlab.com/hunorg/nixos-rpi-headless</nowiki>). It includes workarounds for brcmfmac Wi-Fi driver quirks.

	== Notes about the boot process ==		== Notes about the boot process ==

Hunor Gered: /* Customizing & Generating SD image without installation step */

2026-04-05T14:45:37Z

Customizing & Generating SD image without installation step

← Older revision		Revision as of 14:45, 5 April 2026
Line 311:		Line 311:

	[https://github.com/nix-community/raspberry-pi-nix/ nix-community/raspberry-pi-nix]		[https://github.com/nix-community/raspberry-pi-nix/ nix-community/raspberry-pi-nix]

			For a minimal flake-based image that boots directly into WiFi with Tailscale pre-configured (no ethernet required), see [https://gitlab.com/hunorg/nixos-rpi-headless nixos-rpi-headless]. Includes workarounds for brcmfmac WiFi driver quirks.

	== Notes about the boot process ==		== Notes about the boot process ==

Msladecek: add udev rule for non-root access through libgpiod

2025-10-24T13:35:27Z

add udev rule for non-root access through libgpiod

← Older revision		Revision as of 13:35, 24 October 2025
Line 185:		Line 185:
	The <code>extraRules</code> changes the owner of <code>gpiomem</code> and all other files needed for GPIO to work to <code>root:gpio</code> and changes the permissions to <code>0660</code>.		The <code>extraRules</code> changes the owner of <code>gpiomem</code> and all other files needed for GPIO to work to <code>root:gpio</code> and changes the permissions to <code>0660</code>.
	Therefore, the root user and anyone in the gpio group can now access the GPIO pins.		Therefore, the root user and anyone in the gpio group can now access the GPIO pins.
			Permissions on the <code>/dev/gpiochip*</code> devices are needed to support access through the newer '''GPIO character device''' interface (see [https://libgpiod.readthedocs.io/en/latest/ libgpiod]).

	<syntaxHighlight lang="nix">		<syntaxHighlight lang="nix">
Line 195:		Line 196:
	SUBSYSTEM=="gpio", KERNEL=="gpiochip*", ACTION=="add", RUN+="${pkgs.bash}/bin/bash -c 'chown root:gpio /sys/class/gpio/export /sys/class/gpio/unexport ; chmod 220 /sys/class/gpio/export /sys/class/gpio/unexport'"		SUBSYSTEM=="gpio", KERNEL=="gpiochip*", ACTION=="add", RUN+="${pkgs.bash}/bin/bash -c 'chown root:gpio /sys/class/gpio/export /sys/class/gpio/unexport ; chmod 220 /sys/class/gpio/export /sys/class/gpio/unexport'"
	SUBSYSTEM=="gpio", KERNEL=="gpio*", ACTION=="add",RUN+="${pkgs.bash}/bin/bash -c 'chown root:gpio /sys%p/active_low /sys%p/direction /sys%p/edge /sys%p/value ; chmod 660 /sys%p/active_low /sys%p/direction /sys%p/edge /sys%p/value'"		SUBSYSTEM=="gpio", KERNEL=="gpio*", ACTION=="add",RUN+="${pkgs.bash}/bin/bash -c 'chown root:gpio /sys%p/active_low /sys%p/direction /sys%p/edge /sys%p/value ; chmod 660 /sys%p/active_low /sys%p/direction /sys%p/edge /sys%p/value'"
			SUBSYSTEM=="gpio", KERNEL=="gpiochip", ACTION=="add", RUN+="${pkgs.bash}/bin/bash -c 'chown root:gpio /dev/gpiochip && chmod 0660 /dev/gpiochip*'"
	'';		'';

DerKaktus: Filename had wrong spelling - spi0-0cd - d has to be replaced by an s - see code box above

2025-10-06T16:23:47Z

Filename had wrong spelling - spi0-0cd - d has to be replaced by an s - see code box above

← Older revision		Revision as of 16:23, 6 October 2025
Line 233:		Line 233:
	</syntaxhighlight>		</syntaxhighlight>

	The the <code>spi0-~~0cd~~.dtso</code> file can be downloaded [https://github.com/raspberrypi/firmware/blob/master/boot/overlays/spi0-0cs.dtbo here].		The the <code>spi0-0cs.dtso</code> file can be downloaded [https://github.com/raspberrypi/firmware/blob/master/boot/overlays/spi0-0cs.dtbo here].
	You might have to change the <code>compatible</code> field to "raspberrypi" in the dtbo file.		You might have to change the <code>compatible</code> field to "raspberrypi" in the dtbo file.

Mmxgn: remove extra whitespace

2025-05-12T18:25:21Z

remove extra whitespace

← Older revision		Revision as of 18:25, 12 May 2025
Line 94:		Line 94:
	over_voltage=6		over_voltage=6
	</nowiki>}}		</nowiki>}}


	=== USB boot ===		=== USB boot ===

Mmxgn: Add closing code tag

2025-05-12T18:24:07Z

Add closing code tag

← Older revision		Revision as of 18:24, 12 May 2025
Line 79:		Line 79:
	</nowiki>}}		</nowiki>}}

	=== <code>config.txt ===		=== <code>config.txt</code> ===
	{{warning\|Since 24.11, the option <code>boot.loader.raspberrypi</code> which included <code>firmwareConfig</code> is removed from <code>nixpkgs</code>, therefore changes have to be written to <code>config.txt</code> directly<ref>https://github.com/NixOS/nixpkgs/pull/241534</ref>}}		{{warning\|Since 24.11, the option <code>boot.loader.raspberrypi</code> which included <code>firmwareConfig</code> is removed from <code>nixpkgs</code>, therefore changes have to be written to <code>config.txt</code> directly<ref>https://github.com/NixOS/nixpkgs/pull/241534</ref>}}
	To edit options only available through <code>config.txt</code>, as of May 12, 2025, you can only do so non-declaratively:		To edit options only available through <code>config.txt</code>, as of May 12, 2025, you can only do so non-declaratively:
Line 86:		Line 86:
	$ sudo mount /dev/disk/by-label/FIRMWARE /mnt		$ sudo mount /dev/disk/by-label/FIRMWARE /mnt
	$ sudo vim /mnt/config.txt # <-- make changes here		$ sudo vim /mnt/config.txt # <-- make changes here
	</nowiki>		</nowiki>}}
	}}

	For example, [[https://www.raspberrypi-spy.co.uk/2020/11/overclocking-the-raspberry-pi-400/ overclocking]] the Raspberry Pi 400 can be done by adding the following:		For example, [https://www.raspberrypi-spy.co.uk/2020/11/overclocking-the-raspberry-pi-400/ overclocking] the Raspberry Pi 400 can be done by adding the following:

	{{file\|config.txt\|text\|<nowiki>		{{file\|config.txt\|text\|<nowiki>
Line 95:		Line 94:
	over_voltage=6		over_voltage=6
	</nowiki>}}		</nowiki>}}


	=== USB boot ===		=== USB boot ===

Mmxgn: /* config.txt */

2025-05-12T18:21:39Z

config.txt

← Older revision		Revision as of 18:21, 12 May 2025
Line 94:		Line 94:
	arm_freq=2000		arm_freq=2000
	over_voltage=6		over_voltage=6
	</nowiki>		</nowiki>}}
	}}
	=== USB boot ===		=== USB boot ===

Mmxgn: fix formatting

2025-05-12T18:20:23Z

fix formatting

← Older revision		Revision as of 18:20, 12 May 2025
Line 91:		Line 91:
	For example, [[https://www.raspberrypi-spy.co.uk/2020/11/overclocking-the-raspberry-pi-400/ overclocking]] the Raspberry Pi 400 can be done by adding the following:		For example, [[https://www.raspberrypi-spy.co.uk/2020/11/overclocking-the-raspberry-pi-400/ overclocking]] the Raspberry Pi 400 can be done by adding the following:

	{{file\|config.txt\|<nowiki>		{{file\|config.txt\|text\|<nowiki>
	arm_freq=2000		arm_freq=2000
	over_voltage=6		over_voltage=6