From 75a661f088ff48b87c67af4ed14d8dc162e3bb93 Mon Sep 17 00:00:00 2001
From: xengineering <me@xengineering.eu>
Date: Fri, 19 Jan 2024 16:33:22 +0100
Subject: 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.
---
 doc/documentation.tex | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

(limited to 'doc/documentation.tex')

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}.
-- 
cgit v1.2.3-70-g09d2

