LXC Container durch USB Audio-Device starten und stoppen
Im Arbeitszimmer steht ein Denon PMA-50, der bisher als DAC an einen Raspberry Pi angeschlossen war. Nachdem seit kurzem neben dem Raspberry ein Mini-PC mit Proxmox werkelt, lag die Idee nahe, den Raspberry durch einen LXC-Container zu ersetzen.
Damit die Audioausgabe über den Container erfolgen kann, muß das Audio-Device (zu finden unter “/dev/snd”) in diesen durchgereicht werden, was entweder über die graphische Oberfläche oder direkt in der Konfigurationsdatei des Containers erfolgen kann:
...
dev0: /dev/snd/controlC1,mode=0666
dev1: /dev/snd/pcmC1D0p,mode=0666
...
Leider verweigert der Container den Start, wenn die Devices (welche erst beim Einschalten des Verstärkers erzeugt werden) zum Startzeitpunkt noch nicht vorhanden sind. So entstand die Idee, den Container erst bei Einschalten des Verstärkers mittels einer udev-Regel zu starten und bei dessen Ausschalten auch wieder automatisiert zu stoppen.
Zum Erstellen der Regel müssen zuerst die Vendor- und Product-ID des Gerätes ermittelt werden. Zu beachten ist, daß diese IDs beim Ausschalten nicht mehr ausgelesen werden können, da das Gerät zu diesem Zeitpunkt bereits entfernt wurde. In diesem Fall kann man sich mit Umgebungsvariablen behelfen, welche udev ebenfalls bereitstellt.
# lsusb
Bus 001 Device 001: ID 1d6b:0002 Linux Foundation 2.0 root hub
Bus 001 Device 002: ID 154e:1003 D&M Holdings, Inc. (Denon/Marantz) PMA-50
Bus 002 Device 001: ID 1d6b:0003 Linux Foundation 3.0 root hub
Die zu verwendende Vendor ID des Denon PMA-50 ist “154e”, die Product ID “1003”.
Ein erster (Fehl-)Versuch
Die udev-Regel wird im Verzeichnis “/etc/udev/rules.d/” erstellt, der Dateiname beginnt mit einer Nummer, welche die Reihenfolge der Anwendung definiert, also z.B. “99-pma-50_connect-events.rules”.
ACTION=="add", SUBSYSTEM=="usb", ATTR{idVendor}=="154e", ATTR{idProduct}=="1003", RUN+="/root/bin/pma-50_connect.sh"
ACTION=="remove", SUBSYSTEM=="usb", ENV{PRODUCT}=="154e/1003/*", ENV{DEVTYPE}=="usb_device", RUN+="/root/bin/pma-50_disconnect.sh"
Nach Erstellen müssen die Regeln neu geladen werden:
udevadm control --reload-rules
Zum Starten und Stoppen wird je ein Skript verwendet. Die beiden Skripte “pma-50_connect.sh” und “pma-50_disconnect.sh” sind recht schlicht gehalten.
#!/bin/bash
# 2026-07-30 athul/initial
# 2026-08-04 athul/added loop to wait for device to become ready
PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin
CTID=666
DEVICE="dev/snd/controlC1"
LOG=/var/log/pma-50_connect-events.log
PCT=$(which pct)
GREP=$(which grep)
SLEEP=$(which sleep)
echo "[$(date)] PMA-50 connected" >> $LOG
if $PCT status $CTID | $GREP -q "stopped"; then
echo "[$(date)] container $CTID stopped -> waiting for device $DEVICE" >> $LOG
while [ ! -c "$DEVICE" ]; do
sleep 1
done
echo "[$(date)] container $CTID stopped -> starting" >> $LOG
$PCT start $CTID
fi
Als erstes wird überprüft, ob der Container bereits läuft oder noch angehalten ist. Da das Starten des Containers fehlschlägt, so lange das Device noch nicht zur Verfügung steht, wartet das Skript auf das Device und startet anschließend den Container.
#!/bin/bash
PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin
CTID=666
LOG=/var/log/pma-50_connect-events.log
PCT=$(which pct)
GREP=$(which grep)
echo "[$(date)] PMA-50 disconnected" >> $LOG
if $PCT status $CTID | $GREP -q "running"; then
echo "[$(date)] container $CTID is running -> shutting down" >> $LOG
$PCT shutdown $CTID
fi
Das Herunterfahren ist einfacher: sofern der Container läuft, wird dieser angehalten.
Leider hat sich diese Umsetzung als extrem unzuverlässig erwiesen und ich habe einige Zeit benötigt, um herauszufinden, wo die Ursache liegt: udev arbeitet alle Event-Regeln synchron ab.
Nach dem Aufruf von “pma-50_connect.sh” wartet udev, bis das Skript ausgeführt und beendet wurde, bevor es mit der Erstellung der Gerätedateien (wie z.B. “/dev/snd/controlC1”) fortfährt. Da das Skript aber auf das Erstellen der Gerätedateien wartet, kommt es zu einem Deadlock: das Skript wartet auf das Gerät, und die Erstellung des Geräts auf das Skript.
Die Lösung mit systemd
Nachdem die Ursache gefunden war, wurde eine andere Herangehensweise gewählt: das Starten und Stoppen des Containers über einen systemd-Dienst, welcher von udev gestartet wird.
ACTION=="add", SUBSYSTEM=="sound", KERNEL=="controlC*", ATTRS{idVendor}=="154e", ATTRS{idProduct}=="1003", SYMLINK+="snd/pma50", TAG+="systemd", ENV{SYSTEMD_ALIAS}="/dev/snd/pma50", ENV{SYSTEMD_WANTS}="pma50.service"
ACTION=="remove", SUBSYSTEM=="sound", KERNEL=="controlC*", ENV{ID_VENDOR_ID}=="154e", ENV{ID_PRODUCT_ID}=="1003", TAG+="systemd"
Beim Einschalten des Verstärkers erstellt udev ein virtuelles systemd-Gerät “/dev/snd/pma50” und triggert den Dienst “pma50.service”. Das Skript wird mit Hilfe von systemd asynchron ausgeführt und udev kann mit der Verarbeitung ohne Verzögerung fortfahren. Der Dienst verbleibt anschließend im Status “active (exited)”.
Beim Entfernen des Verstärkers verschwindet das virtuelle Gerät. systemd bemerkt das Verschwinden, setzt den Dienst auf den Status “stopping” und führt das Skript aus.
Die Kommunikation zwischen udev und systemd wird mittels TAG+=“systemd” und ENV{SYSTEMD_WANTS} realisiert. Der ENV{SYSTEMD_ALIAS}-Eintrag erzeugt das (virtuelle) Objekt “/dev/snd/pma50”.
[Unit]
Description=Denon PMA-50 Connection Service
BindsTo=dev-snd-pma50.device
After=dev-snd-pma50.device
[Service]
Type=simple
ExecStart=/root/bin/pma50.sh start
RemainAfterExit=yes
ExecStop=/root/bin/pma50.sh stop
[Install]
WantedBy=multi-user.target
Mit Hilfe der “BindsTo”-Regel im Service wird für systemd festgelegt, daß der Dienst “pma50.service” nur dann laufen darf, wenn das Device existiert.
Zur Vereinfachung wurden die getrennten Start- und Stop-Skripte in ein gemeinsames Skript zusammengeführt, welches die Parameter “start” und “stop” verwendet. Zusätzlich wurde beim Herunterfahren des Containers noch ein “kill” des im LXC-Container verwendeten shaiport-Sync-Dienstes eingebaut, da dieser mit dem plötzlichen Verschwinden seines Ausgabe-Devices mehr als unglücklich war und das Herunterfahren des Containers unnötig verzögerte.
#!/bin/bash
PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin
CTID=101
DEVICE="dev/snd/pma50"
PCT=$(command -v pct)
GREP=$(command -v grep)
SLEEP=$(command -v sleep)
case "$1" in
start)
echo "─── Executing $DEVICE start actions ───"
if $PCT status $CTID | $GREP -q "stopped"; then
echo "container $CTID is not running -> waiting for device $DEVICE"
while [ ! -c "$DEVICE" ]; do
sleep 1
done
echo "device $DEVICE found -> starting container $CTID"
$PCT start $CTID
fi
;;
stop)
echo "─── Executing $DEVICE stop actions ───"
if $PCT status $CTID | $GREP -q "running"; then
echo "killing shairport-sync.service in container $CTID"
pct exec $CTID -- systemctl kill shairport-sync.service
echo "container $CTID is running -> shutting down"
$PCT shutdown $CTID
fi
;;
*)
echo "Usage: $0 {start|stop}"
exit 1
;;
esac
Debug
Zur Suche, welche Werte man für die udev-Regeln am besten verwendet, hat sich “udevadm” bewährt. udevadm liefert detaillierte Informationen, welche IDs beim Verbinden erkannt werden und welche Informationen nach dem Trennen noch vorhanden sind.
ACTION=add
# udevadm monitor --environment --udev --subsystem-match=usb
UDEV [1449.673531] add /devices/pci0000:00/0000:00:14.0/usb1/1-3 (usb)
ACTION=add
DEVPATH=/devices/pci0000:00/0000:00:14.0/usb1/1-3
SUBSYSTEM=usb
DEVNAME=/dev/bus/usb/001/007
DEVTYPE=usb_device
PRODUCT=154e/1003/100
TYPE=239/2/1
BUSNUM=001
DEVNUM=007
SEQNUM=4431
USEC_INITIALIZED=1448104413
ID_BUS=usb
ID_MODEL=PMA-50
ID_MODEL_ENC=PMA-50
ID_MODEL_ID=1003
ID_SERIAL=D___M_Holdings_Inc._PMA-50
ID_VENDOR=D___M_Holdings_Inc.
ID_VENDOR_ENC=D\x20\x26\x20M\x20Holdings\x20Inc.
ID_VENDOR_ID=154e
ID_REVISION=0100
ID_USB_MODEL=PMA-50
ID_USB_MODEL_ENC=PMA-50
ID_USB_MODEL_ID=1003
ID_USB_SERIAL=D___M_Holdings_Inc._PMA-50
ID_USB_VENDOR=D___M_Holdings_Inc.
ID_USB_VENDOR_ENC=D\x20\x26\x20M\x20Holdings\x20Inc.
ID_USB_VENDOR_ID=154e
ID_USB_REVISION=0100
ID_USB_INTERFACES=:010120:010220:030000:
ID_VENDOR_FROM_DATABASE=D&M Holdings, Inc. (Denon/Marantz)
ID_PATH_WITH_USB_REVISION=pci-0000:00:14.0-usbv2-0:3
ID_PATH=pci-0000:00:14.0-usb-0:3
ID_PATH_TAG=pci-0000_00_14_0-usb-0_3
MAJOR=189
MINOR=6
ACTION=remove
# udevadm monitor --environment --udev --subsystem-match=usb
UDEV [1506.299068] remove /devices/pci0000:00/0000:00:14.0/usb1/1-3 (usb)
ACTION=remove
DEVPATH=/devices/pci0000:00/0000:00:14.0/usb1/1-3
SUBSYSTEM=usb
DEVNAME=/dev/bus/usb/001/007
DEVTYPE=usb_device
PRODUCT=154e/1003/100
TYPE=239/2/1
BUSNUM=001
DEVNUM=007
SEQNUM=4461
USEC_INITIALIZED=1448104413
ID_PATH_WITH_USB_REVISION=pci-0000:00:14.0-usbv2-0:3
ID_PATH=pci-0000:00:14.0-usb-0:3
ID_PATH_TAG=pci-0000_00_14_0-usb-0_3
MAJOR=189
MINOR=6