From a7dc6b07781cb7901e9bbcffbe0d5ffa1c690c73 Mon Sep 17 00:00:00 2001
From: xengineering <me@xengineering.eu>
Date: Sun, 14 Jan 2024 14:14:45 +0100
Subject: doc: Switch to multicast for streaming

This allows to stream to multiple devices at the same time. Nevertheless
it still works for a point to point stream.
---
 doc/documentation.tex | 12 +++++++-----
 1 file changed, 7 insertions(+), 5 deletions(-)

(limited to 'doc/documentation.tex')

diff --git a/doc/documentation.tex b/doc/documentation.tex
index b374794..1787f50 100644
--- a/doc/documentation.tex
+++ b/doc/documentation.tex
@@ -60,10 +60,12 @@ For a simple audio streaming test the following commands from the FFmpeg
 streaming
 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{5316} for incoming audio streams:
+listening on port \texttt{5316} of a local multicast IPv4 address for incoming
+audio streams. Since multicast is used, this can be executed on multiple
+soundbox devices to stream to all of them.
 
 \begin{verbatim}
-	ffplay rtp://127.0.0.1:5316
+	ffplay rtp://224.0.0.99:5316
 \end{verbatim}
 
 As soon as the soundbox is listening the stream can be send from another
@@ -71,15 +73,15 @@ computer in the same network with this command:
 
 \begin{verbatim}
 	ffmpeg -re -f lavfi -i aevalsrc="sin(400*2*PI*t)" -ar 8000 -f mulaw \
-	    -f rtp rtp://<soundbox-ip>:5316
+	    -f rtp rtp://224.0.0.99:5316
 \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:
+Alternatively a MP3 file can be sent like this:
 
 \begin{verbatim}
 	ffmpeg -re -i <file-path> -acodec copy -ar 11025 \
-	    -f rtp rtp://<soundbox-ip>:5316
+	    -f rtp rtp://224.0.0.99:5316
 \end{verbatim}
 
 These commands allow to test the \texttt{soundbox} device setup.
-- 
cgit v1.2.3-70-g09d2

