summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorxengineering <me@xengineering.eu>2024-01-19 16:33:22 +0100
committerxengineering <me@xengineering.eu>2024-01-20 12:05:15 +0100
commit75a661f088ff48b87c67af4ed14d8dc162e3bb93 (patch)
tree171f099f6b1c08ba1658d7b99101792863bf9f25 /doc
parent36341f1e9856e17ad00e3741bb5bc1224aadc225 (diff)
downloadsoundbox-75a661f088ff48b87c67af4ed14d8dc162e3bb93.tar
soundbox-75a661f088ff48b87c67af4ed14d8dc162e3bb93.tar.zst
soundbox-75a661f088ff48b87c67af4ed14d8dc162e3bb93.zip
doc: Add lldpd configuration
This makes a soundbox device discoverable via the Link Layer Discovery Protocol (LLDP). That way a client application can lookup the available soundbox devices inside the network to display playback options.
Diffstat (limited to 'doc')
-rw-r--r--doc/documentation.tex15
1 files changed, 15 insertions, 0 deletions
diff --git a/doc/documentation.tex b/doc/documentation.tex
index f099b30..ba9aab3 100644
--- a/doc/documentation.tex
+++ b/doc/documentation.tex
@@ -210,6 +210,8 @@ busybox-mdev-openrc
chrony
ffplay
iw
+lldpd
+lldpd-openrc
openssh
openssl
wpa_supplicant' > /etc/apk/world
@@ -217,6 +219,19 @@ wpa_supplicant' > /etc/apk/world
apk add
\end{verbatim}
+To make the soundbox device discoverable inside the network the Link Layer
+Discovery Protocol (LLDP) is used. With \texttt{echo} a new configuration file
+for the \texttt{lldpd} software can be added. After configuration the
+\texttt{lldpd} service is enabled to start by default with the next reboot.
+
+\begin{verbatim}
+echo 'configure system hostname soundbox.local
+configure lldp agent-type nearest-customer-bridge' \
+> /etc/lldpd.d/soundbox.conf
+
+rc-update add lldpd default
+\end{verbatim}
+
The only user on a soundbox device is \texttt{root}. Even that super user has
to be added to the \texttt{audio} group to be able to play sound via ALSA. This
can be achieved with \texttt{addgroup}.