53 lines
2.5 KiB
Markdown
53 lines
2.5 KiB
Markdown
# 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.
|