LumaOps-Public/docs/HARDWARE_ACCESS.md

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.