Skip to content

Hardware

Angelo Azevedo edited this page Jun 11, 2026 · 1 revision

Hardware & Hardware Fixes

Hardware support, particularly for the Samsung Galaxy Book 5 Pro / Book 4, involves specific NixOS modules and configurations to address hardware quirks. These are defined in the modules/hardware/samsung-galaxy-book/ directory.

Fingerprint Sensor

Integration is handled via fprintd combined with a custom libfprint overlay. The overlay fetches a newer source, patches the egismoc driver to add support for the 1c7a:05a5 sensor device, and enables PAM authentication across the system (login, sudo, swaylock, etc.).

Audio & Webcam

Custom NixOS modules configure ALSA/Pipewire routing for the speakers. The Intel MIPI camera is enabled through a dedicated libcamera stack:

  • Custom tuning files (ov02c10.yaml / ov02e10.yaml) are injected into the libcamera software ISP to fix color balancing and purple tints.
  • A custom bayer-fix-v0.7.patch applies a hardware-level 180-degree rotation inside libcamera to properly decode the Bayer grid for cameras mounted upside down.
  • A background camera-relay service dynamically bridges libcamera to a v4l2loopback device named "Built-in Front Camera" for seamless application compatibility.

Keyboard & Function Keys

Uses the keyd daemon for mapping specific samsung-galaxybook hardware keys, along with a custom script (kbdillumtoggle.sh) to toggle the keyboard backlight by interacting directly with the device hardware file.

Build Workarounds

Temporary Nixpkgs overlays disable failing tests and parallel builds for packages like sdl3 and ibus to ensure reliable system builds on this specific hardware environment.

Clone this wiki locally