summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorxengineering <me@xengineering.eu>2024-01-20 15:12:42 +0100
committerxengineering <me@xengineering.eu>2024-01-20 15:12:42 +0100
commite7f055deddf551c32de631c4579c53589ea14948 (patch)
tree8f53566c076bbecf53142ac27167231caf91188a
parent75a661f088ff48b87c67af4ed14d8dc162e3bb93 (diff)
downloadsoundbox-e7f055deddf551c32de631c4579c53589ea14948.tar
soundbox-e7f055deddf551c32de631c4579c53589ea14948.tar.zst
soundbox-e7f055deddf551c32de631c4579c53589ea14948.zip
doc: Split configuration section into subsections
-rw-r--r--doc/documentation.tex8
1 files changed, 8 insertions, 0 deletions
diff --git a/doc/documentation.tex b/doc/documentation.tex
index ba9aab3..fb004f7 100644
--- a/doc/documentation.tex
+++ b/doc/documentation.tex
@@ -183,6 +183,8 @@ With this setup the Alpine Linux installation is completed.
\section{Configure Alpine Linux for soundbox}
+\subsection{Package installation}
+
soundbox requires packages from the Alpine Linux community package repository.
Since this is not enabled by default it has to be done manually. This can be
done by editing the \texttt{/etc/apk/repositories} file with an editor like
@@ -219,6 +221,8 @@ wpa_supplicant' > /etc/apk/world
apk add
\end{verbatim}
+\subsection{LLDP network discovery}
+
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
@@ -232,6 +236,8 @@ configure lldp agent-type nearest-customer-bridge' \
rc-update add lldpd default
\end{verbatim}
+\subsection{Audio configuration}
+
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}.
@@ -258,6 +264,8 @@ option has to be inserted instead:
echo 'dtparam=audio=on' >> /media/mmcblk0p1/config.txt
\end{verbatim}
+\subsection{Persistence of changes and reboot}
+
Since a diskless Alpine Linux installation is preferred for soundbox the
changes have to be made persistent with \texttt{lbu}. Rebooting after it makes
sure the SD card is again mounted in read-only mode and all Kernel-affecting