Publish LumaOps source

2026-09-03 01:18:36 +02:00
commit 7f1c0e5f71
2363 changed files with 501543 additions and 0 deletions
@@ -0,0 +1,52 @@
+# 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.