# Hardwaretoegang

OpenRGB praat rechtstreeks met USB, HID, SMBus/I²C en soms seriële controllers. Geef LumaOps alleen de benodigde nodes.

## USB

De Compose-standaard geeft /dev/bus/usb door. Inventariseer op Unraid met:

    lsusb
    find /dev/bus/usb -maxdepth 2 -type c -ls

OpenRGB gebruikt de ingebouwde 60-openrgb.rules als referentie. In een container zijn expliciete device mappings en hostpermissies bepalend. Koppel stabiele fysieke apparaten bij voorkeur aan bus/VID/PID/serienummer; de LumaOps UUID is niet alleen op OpenRGB controller-index gebaseerd.

## I²C en SMBus

Laad op de host eerst i2c-dev en de chipsetdriver, bijvoorbeeld i2c-i801 voor veel Intel-systemen of i2c-piix4 voor sommige AMD-systemen:

    modprobe i2c-dev
    modprobe i2c-i801
    ls -l /dev/i2c-*
    i2cdetect -l

Voeg daarna uitsluitend de benodigde adapter toe:

    devices:
      - /dev/i2c-0:/dev/i2c-0

Adapterindices kunnen na hardware- of kernelwijzigingen veranderen. Controleer i2cdetect -l na een Unraid-update. Voer geen willekeurige i2cset-opdrachten uit; de OpenRGB-detectielogica is de enige hardwarelaag.

## LumaOps op de Widefrog Unraid-host

De huidige host gebruikt deze beperkte hardwaretoegang:

- `/dev/hidraw0`: ASUSTeK AURA LED Controller `0b05:18f3`;
- `/dev/i2c-0`: Intel I801 SMBus voor Corsair Vengeance RGB DDR4;
- `/dev/bus/usb`: USB-transport voor ondersteunde OpenRGB-apparaten.

Voer als root eenmalig `scripts/unraid-hardware-setup.sh` uit. Het script installeert een minimale udev-regel, geeft alleen deze apparaten toegang voor de Unraid-groep `users` en registreert zichzelf idempotent in `/boot/config/go`. Daarna kan de niet-root LumaOps-container de apparaten gebruiken zonder privileged modus of een volledige `/dev`-mount.

## Serieel

Voor controllers op /dev/ttyUSB0 of /dev/ttyACM0 voegt men de specifieke node als read/write device toe. Controleer dialout/uucp-groepsrechten op de host. Mount nooit standaard de volledige /dev-map.

## Diagnoseprofiel

Alleen wanneer een device in privileged mode wel werkt:

    docker compose -f docker-compose.yml -f docker/compose.diagnostic.yml up -d

Stop eerst de normale container. Het diagnoseprofiel is onveilig en tijdelijk. Identificeer de ontbrekende node/permissie, stop het profiel en keer terug naar expliciete devices. Voeg geen brede capabilities toe zonder aantoonbare noodzaak.

De eerste fysieke schrijfactie hoort een statische, gematigde kleur op één niet-experimenteel apparaat te zijn. Gebruik geen snelle effecten tijdens validatie.