summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-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