From 90286663aa293deeb91bed3ae2319bc77a461467 Mon Sep 17 00:00:00 2001
From: xengineering <me@xengineering.eu>
Date: Fri, 5 Jan 2024 12:03:13 +0100
Subject: doc: Add example for FFMpeg MP3 streaming

This allows more testing than only streaming sine waves.
---
 doc/documentation.tex | 14 +++++++++++---
 1 file changed, 11 insertions(+), 3 deletions(-)

(limited to 'doc/documentation.tex')

diff --git a/doc/documentation.tex b/doc/documentation.tex
index e4ec97c..eea482a 100644
--- a/doc/documentation.tex
+++ b/doc/documentation.tex
@@ -59,9 +59,9 @@ devices..
 
 For a simple audio streaming test the following commands from the FFmpeg
 streaming
-guide\footnote{\href{https://trac.ffmpeg.org/wiki/StreamingGuide\#StreamingasimpleRTPaudiostreamfromFFmpeg}{ffmpeg
-streaming guide}} can be used. The following command has to be executed on the
-soundbox to start listening on port \texttt{1234} for incoming audio streams:
+guide\footnote{\href{https://trac.ffmpeg.org/wiki/StreamingGuide\#StreamingasimpleRTPaudiostreamfromFFmpeg}{https://trac.ffmpeg.org/wiki/StreamingGuide\#StreamingasimpleRTPaudiostreamfromFFmpeg}}
+can be used. The following command has to be executed on the soundbox to start
+listening on port \texttt{1234} for incoming audio streams:
 
 \begin{verbatim}
 	ffplay rtp://127.0.0.1:1234
@@ -76,6 +76,14 @@ computer in the same network with this command:
 \end{verbatim}
 
 It will send a simple sine wave with 400~Hz to the soundbox device.
+Alternatively a mp3 file can be sent like this:
+
+\begin{verbatim}
+	ffmpeg -i '/path/to/file.mp3' -acodec libmp3lame -ar 11025 \
+	    -f rtp rtp://<soundbox-ip>:1234
+\end{verbatim}
+
+These commands allow to test the \texttt{soundbox} device setup.
 
 %\chapter{Production}
 %\section{Printing mechanical parts}
-- 
cgit v1.2.3-70-g09d2

