Skip to content

Commit

Permalink
Extended introduction.
Browse files Browse the repository at this point in the history
  • Loading branch information
@hmatuschek
hmatuschek committed Oct 2, 2021
1 parent dca5fb2 commit daa25e8
Show file tree
Hide file tree
Showing 27 changed files with 987 additions and 14 deletions.
9 changes: 8 additions & 1 deletion doc/dmr-intro/script/script_de_06_textmsg.tex
View file
Original file line number Diff line number Diff line change
@@ -1,5 +1,12 @@
\section{Datendienste} \label{sec:data}
Da DMR von sich aus schon eine digitale Betriebsart ist, bei der meist Sprache in digitalisierter Form übertragen wird, ist es natürlich auch möglich reine Datendienste über DMR anzubieten. Zum einen gibt es einen Textnachrichtendienst, der dem SMS-Dienst der Mobiltelefone nachempfunden ist. Zum anderen gibt es auch die Möglichkeit, die eigene Position per DMR an das APRS\footnote{APRS steht für \emph{Automatic Packet Reporting System} und ermöglicht das Übertragen von kleinen Datensätzen über Packet-Radio wie zum Beispiel die Position, Wetter oder Textnachrichten. Mehr dazu erfahren sie in der \href{https://de.wikipedia.org/wiki/Automatic_Packet_Reporting_System}{Wikipedia}.} Netz zu übertragen.
Da DMR von sich aus schon eine digitale Betriebsart ist, bei der meist Sprache in digitalisierter
Form übertragen wird, ist es natürlich auch möglich reine Datendienste über DMR anzubieten. Zum
einen gibt es einen Textnachrichtendienst, der dem SMS-Dienst der Mobiltelefone nachempfunden ist.
Zum anderen gibt es auch die Möglichkeit, die eigene Position per DMR an das APRS\footnote{APRS
steht für \emph{Automatic Packet Reporting System} und ermöglicht das Übertragen von kleinen
Datensätzen über Packet-Radio wie zum Beispiel die Position, Wetter oder Textnachrichten. Mehr
dazu erfahren sie in der \href{https://de.wikipedia.org/wiki/Automatic_Packet_Reporting_System}{Wikipedia}.}
Netz zu übertragen.

\subsection{Textnachrichten (SMS)} \label{sec:textmsg}
Mit diesem Dienst können sie kurze Textnachrichten\footnote{Bis zu 144 Zeichen.} direkt an andere Teilnehmer verschicken\footnote{Sie können auch Textnachrichten an ganze Sprechgruppen versenden. Dies ist aber eher unüblich und nicht wünschenswert.}. Im Prinzip funktioniert eine Textnachricht wie ein Direktruf. Ist der andere Teilnehmer erreichbar, wird die Textnachricht übermittelt.
Expand Down
6 changes: 5 additions & 1 deletion doc/manual/intro/fig/Makefile
View file
Original file line number Diff line number Diff line change
@@ -1,4 +1,8 @@
IMG = fm_simplex_a.png fm_simplex_b.png fm_duplex_a.png fm_duplex_b.png fm_echolink_a.png fm_echolink_b.png fm_echolink_c.png
IMG = fm_simplex_a.png fm_simplex_b.png fm_duplex_a.png fm_duplex_b.png fm_echolink_a.png fm_echolink_b.png fm_echolink_c.png \
trunk_net_ex1.png trunk_net_ex2.png trunk_net_ex3.png trunk_net_ex4a.png trunk_net_ex4b.png \
simplex_allcall.png simplex_groupcall.png simplex_privatecall.png \
repeater_local.png repeater_privatecall.png \
talkgroup_ex1a.png talkgroup_ex1b.png talkgroup_ex1c.png

#.PRECIOUS: %.pdf # keep PDFs
all: $(IMG)
Expand Down
25 changes: 25 additions & 0 deletions doc/manual/intro/fig/repeater_local.tex
View file
Original file line number Diff line number Diff line change
@@ -0,0 +1,25 @@
\documentclass{standalone}
\usepackage{tikz}
\usetikzlibrary{shapes.geometric}
\input{repeater}
\begin{document}
\begin{tikzpicture}[every node/.style={scale=.8}]
\activeuser{u1}{ 0,0}{DM3MAT};
\user{u2}{ 2,0}{DL1XYZ};
\user{u3}{ 4,0}{DL2XYZ};
\draw[dotted] (5,4) -- (5,-1);
\activeuser{u4}{ 6,0}{DL3XYZ};
\user{u5}{ 8,0}{DL4XYZ};
\user{u6}{10,0}{DL5XYZ};
\activerepeater{R1}{1,3}{DB0ABC};
\repeater{R2}{3,3}{DB0DEF};
\activerepeater{R3}{7,3}{DB0GHI};
\activerepeater{R4}{9,3}{DB0JKL};
\draw[->] (u1) -- node[above,rotate=70]{GC: TG9} (R1);
\draw[->] (R1) -- node[above,rotate=-70]{GC: TG9} (u2);
\draw[->] (u4) -- node[above,rotate=70]{GC: TG8} (R3);
\draw[->] (R3) -- node[above,rotate=-70]{GC: TG8} (u5);
\draw[->] (R4) -- node[above,rotate=-70]{GC: TG8} (u6);
\path[->] (R3) edge[dashed,bend left] node[above]{via Netzwerk} (R4);
\end{tikzpicture}
\end{document}
16 changes: 16 additions & 0 deletions doc/manual/intro/fig/repeater_privatecall.tex
View file
Original file line number Diff line number Diff line change
@@ -0,0 +1,16 @@
\documentclass{standalone}
\usepackage{tikz}
\usetikzlibrary{shapes.geometric}
\input{repeater}
\begin{document}
\begin{tikzpicture}[every node/.style={scale=.8}]
\activeuser{u1}{ 0,0}{DM3MAT 2621370};
\activerepeater{R1}{1,3}{DB0ABC};
\draw[dotted] (2,4) -- (2,-1);
\user{u2}{ 4,0}{I/DL2XYZ\\2621234};
\activerepeater{R2}{3,3}{I0ABC};
\draw[->] (u1) -- node[above,rotate=70]{PC: 2621234} (R1);
\draw[->] (R2) -- node[above,rotate=-70]{PC: 2621234} (u2);
\path[->] (R1) edge[dashed,bend left] node[above]{via Netzwerk} (R2);
\end{tikzpicture}
\end{document}
15 changes: 15 additions & 0 deletions doc/manual/intro/fig/simplex_allcall.tex
View file
Original file line number Diff line number Diff line change
@@ -0,0 +1,15 @@
\documentclass{standalone}
\usepackage{tikz}
\usetikzlibrary{shapes.geometric}
\input{repeater}
\begin{document}
\begin{tikzpicture}[every node/.style={scale=.8}]
\activeuser{u1}{ 0,0}{DM3MAT};
\user{u2}{ 6,1}{DL1XYZ, TG99};
\user{u3}{ 6,0}{DL2XYZ, TG99};
\user{u4}{ 6,-1}{DL3XYZ};
\path[->] (u1) edge[bend left] node[above, rotate=10]{$433.450 MHz$} node[below, rotate=10]{All Call} (u2);
\path[->] (u1) edge node[above]{$433.450 MHz$} node[below]{All Call} (u3);
\path[->] (u1) edge[bend right] node[above, rotate=-10]{$433.450 MHz$} node[below, rotate=-10]{All Call} (u4);
\end{tikzpicture}
\end{document}
14 changes: 14 additions & 0 deletions doc/manual/intro/fig/simplex_groupcall.tex
View file
Original file line number Diff line number Diff line change
@@ -0,0 +1,14 @@
\documentclass{standalone}
\usepackage{tikz}
\usetikzlibrary{shapes.geometric}
\input{repeater}
\begin{document}
\begin{tikzpicture}[every node/.style={scale=.8}]
\activeuser{u1}{ 0,0}{DM3MAT};
\user{u2}{ 6,1}{DL1XYZ, TG99};
\user{u3}{ 6,0}{DL2XYZ, TG99};
\user{u4}{ 6,-1}{DL3XYZ};
\path[->] (u1) edge[bend left] node[above, rotate=10]{$433.450 MHz$} node[below, rotate=10]{GC: TG99} (u2);
\path[->] (u1) edge node[above]{$433.450 MHz$} node[below]{GC: TG99} (u3);
\end{tikzpicture}
\end{document}
14 changes: 14 additions & 0 deletions doc/manual/intro/fig/simplex_privatecall.tex
View file
Original file line number Diff line number Diff line change
@@ -0,0 +1,14 @@
\documentclass{standalone}
\usepackage{tikz}
\usetikzlibrary{shapes.geometric}
\input{repeater}
\begin{document}
\begin{tikzpicture}[every node/.style={scale=.8}]
\activeuser{u1}{ 0,0}{DM3MAT};
\activeuser{u2}{ 6,1}{DL1XYZ, TG99};
\user{u3}{ 6,0}{DL2XYZ, TG99};
\user{u4}{ 6,-1}{DL3XYZ};
\path[->] (u1) edge[bend left] node[above, rotate=10]{$433.450 MHz$} node[below, rotate=10]{PC: DL1XYZ} (u2);
\path[->] (u2) edge[bend left] node[above, rotate=10]{$433.450 MHz$} node[below, rotate=10]{PC: DM3MAT} (u1);
\end{tikzpicture}
\end{document}
20 changes: 20 additions & 0 deletions doc/manual/intro/fig/talkgroup_ex1a.tex
View file
Original file line number Diff line number Diff line change
@@ -0,0 +1,20 @@
\documentclass{standalone}
\usepackage{tikz}
\usetikzlibrary{shapes.geometric}
\input{repeater}
\begin{document}
\begin{tikzpicture}[every node/.style={scale=.8}]
\activeuser{u1}{ 0,0}{DM3MAT};
\user{u2}{ 2,0}{DL1XYZ};
\user{u3}{ 6,0}{DL2XYZ};
\draw[dotted] (7,4) -- (7,-1);
\user{u4}{10,0}{I/DL3XYZ};
\activerepeater{R1}{1,3}{DB0ABC, TG2621};
\activerepeater{R2}{5,3}{DB0DEF, TG2621};
\repeater{R3}{9,3}{I0ABC};
\path[->] (u1) edge node[above,rotate=70]{GC: TG2621} (R1);
\path[->] (R1) edge node[above,rotate=-70]{GC: TG2621} (u2);
\path[->] (R2) edge node[above,rotate=-70]{GC: TG2621} (u3);
\path[->] (R1) edge[bend left] node[above]{GC: TG2621} (R2);
\end{tikzpicture}
\end{document}
22 changes: 22 additions & 0 deletions doc/manual/intro/fig/talkgroup_ex1b.tex
View file
Original file line number Diff line number Diff line change
@@ -0,0 +1,22 @@
\documentclass{standalone}
\usepackage{tikz}
\usetikzlibrary{shapes.geometric}
\input{repeater}
\begin{document}
\begin{tikzpicture}[every node/.style={scale=.8}]
\user{u1}{ 0,0}{DM3MAT};
\user{u2}{ 2,0}{DL1XYZ};
\user{u3}{ 6,0}{DL2XYZ};
\draw[dotted] (7,4) -- (7,-1);
\activeuser{u4}{10,0}{I/DL3XYZ};
\activerepeater{R1}{1,3}{DB0ABC, TG2621};
\activerepeater{R2}{5,3}{DB0DEF, TG2621};
\activerepeater{R3}{9,3}{I0ABC, (TG2621)};
\path[->] (u4) edge node[above,rotate=-70]{GC: TG2621} (R3);
\path[->] (R1) edge node[above,rotate=70]{GC: TG2621} (u1);
\path[->] (R1) edge node[above,rotate=-70]{GC: TG2621} (u2);
\path[->] (R2) edge node[above,rotate=-70]{GC: TG2621} (u3);
\path[->] (R3) edge[bend right] node[below]{GC: TG2621} (R2);
\path[->] (R3) edge[bend right] node[above]{GC: TG2621} (R1);
\end{tikzpicture}
\end{document}
22 changes: 22 additions & 0 deletions doc/manual/intro/fig/talkgroup_ex1c.tex
View file
Original file line number Diff line number Diff line change
@@ -0,0 +1,22 @@
\documentclass{standalone}
\usepackage{tikz}
\usetikzlibrary{shapes.geometric}
\input{repeater}
\begin{document}
\begin{tikzpicture}[every node/.style={scale=.8}]
\activeuser{u1}{ 0,0}{DM3MAT};
\user{u2}{ 2,0}{DL1XYZ};
\user{u3}{ 6,0}{DL2XYZ};
\draw[dotted] (7,4) -- (7,-1);
\user{u4}{10,0}{I/DL3XYZ};
\activerepeater{R1}{1,3}{DB0ABC, TG2621};
\activerepeater{R2}{5,3}{DB0DEF, TG2621};
\activerepeater{R3}{9,3}{I0ABC, (TG2621)};
\path[->] (u1) edge node[above,rotate=70]{GC: TG2621} (R1);
\path[->] (R1) edge node[above,rotate=-70]{GC: TG2621} (u2);
\path[->] (R2) edge node[above,rotate=-70]{GC: TG2621} (u3);
\path[->] (R3) edge node[above,rotate=-70]{GC: TG2621} (u4);
\path[->] (R1) edge[bend left] node[below]{GC: TG2621} (R2);
\path[->] (R1) edge[bend left] node[above]{GC: TG2621} (R3);
\end{tikzpicture}
\end{document}
19 changes: 19 additions & 0 deletions doc/manual/intro/fig/trunk_net_ex1.tex
View file
Original file line number Diff line number Diff line change
@@ -0,0 +1,19 @@
\documentclass{standalone}
\usepackage{tikz}
\usetikzlibrary{shapes.geometric}
\input{repeater}
\begin{document}
\begin{tikzpicture}[every node/.style={scale=.8}]
\user{r1}{ 0,0}{Reinigung 1};
\user{r2}{ 2,0}{Reinigung 2};
\draw[dotted] (3,4) -- (3,-1);
\user{s1}{ 4,0}{Sicherheit 1};
\user{z} { 6,0}{Zentrale};
\draw[dotted] (7,4) -- (7,-1);
\user{s2}{ 8,0}{Sicherheit 2};
\user{r3}{10,0}{Reinigung 3};
\repeater{R1}{1,3}{Terminal 1, TG: R,S};
\repeater{R2}{5,3}{Terminal 2, TG: R,S};
\repeater{R3}{9,3}{Vorfeld, TG: S};
\end{tikzpicture}
\end{document}
24 changes: 24 additions & 0 deletions doc/manual/intro/fig/trunk_net_ex2.tex
View file
Original file line number Diff line number Diff line change
@@ -0,0 +1,24 @@
\documentclass{standalone}
\usepackage{tikz}
\usetikzlibrary{shapes.geometric}
\input{repeater}
\begin{document}
\begin{tikzpicture}[every node/.style={scale=.8}]
\activeuser{r1}{ 0,0}{Reinigung 1};
\user{r2}{ 2,0}{Reinigung 2};
\draw[dotted] (3,4) -- (3,-1);
\activeuser{s1}{ 4,0}{Sicherheit 1};
\activeuser{z} { 6,0}{Zentrale};
\draw[dotted] (7,4) -- (7,-1);
\user{s2}{ 8,0}{Sicherheit 2};
\activeuser{r3}{10,0}{Reinigung 3};
\activerepeater{R1}{1,3.5}{Terminal 1, TG: R,S};
\activerepeater{R2}{5,3.5}{Terminal 2, TG: R,S};
\activerepeater{R3}{9,3.5}{Vorfeld, TG: S};
\draw[->] (r1) -- node[above,rotate=74] {PC: Reinigung 3} (R1);
\path[->,dashed] (R1) edge [bend left] node[above] {via Netzwerk} (R3);
\draw[->] (R3) -- node[above,rotate=-74] {PC: Reinigung 3} (r3);
\draw[->] (z) -- node[above,rotate=-74] {PC: Sicherheit 1} (R2);
\draw[->] (R2) -- node[above,rotate=74] {PC: Sicherheit 1} (s1);
\end{tikzpicture}
\end{document}
23 changes: 23 additions & 0 deletions doc/manual/intro/fig/trunk_net_ex3.tex
View file
Original file line number Diff line number Diff line change
@@ -0,0 +1,23 @@
\documentclass{standalone}
\usepackage{tikz}
\usetikzlibrary{shapes.geometric}
\input{repeater}
\begin{document}
\begin{tikzpicture}[every node/.style={scale=.8}]
\activeuser{r1}{ 0,0}{Reinigung 1};
\activeuser{r2}{ 2,0}{Reinigung 2};
\draw[dotted] (3,4) -- (3,-1);
\user{s1}{ 4,0}{Sicherheit 1};
\activeuser{z} { 6,0}{Zentrale};
\draw[dotted] (7,4) -- (7,-1);
\user{s2}{ 8,0}{Sicherheit 2};
\user{r3}{10,0}{Reinigung 3};
\activerepeater{R1}{1,3}{Terminal 1, TG: R,S};
\activerepeater{R2}{5,3}{Terminal 2, TG: R,S};
\repeater{R3}{9,3}{Vorfeld, TG: S};
\draw[->] (z) -- node[above,rotate=-74] {TG: R} (R2);
\path[->,dashed] (R2) edge [bend right] node[above] {via Netzwerk} (R1);
\draw[->] (R1) -- node[above,rotate=74] {TG: R} (r1);
\draw[->] (R1) -- node[above,rotate=-74] {TG: R} (r2);
\end{tikzpicture}
\end{document}
23 changes: 23 additions & 0 deletions doc/manual/intro/fig/trunk_net_ex4a.tex
View file
Original file line number Diff line number Diff line change
@@ -0,0 +1,23 @@
\documentclass{standalone}
\usepackage{tikz}
\usetikzlibrary{shapes.geometric}
\input{repeater}
\begin{document}
\begin{tikzpicture}[every node/.style={scale=.8}]
\activeuser{r1}{ 0,0}{Reinigung 1};
\activeuser{r2}{ 2,0}{Reinigung 2};
\draw[dotted] (3,4) -- (3,-1);
\user{s1}{ 4,0}{Sicherheit 1};
\user{z} { 6,0}{Zentrale};
\draw[dotted] (7,4) -- (7,-1);
\user{s2}{ 8,0}{Sicherheit 2};
\user{r3}{10,0}{Reinigung 3};
\activerepeater{R1}{1,3}{Terminal 1, TG: R,S};
\repeater{R2}{5,3}{Terminal 2, TG: R,S};
\activerepeater{R3}{9,3}{Vorfeld, TG: S,(R)};
\draw[->] (r3) -- node[above,rotate=-74] {TG: R} (R3);
\path[->,dashed] (R3) edge [bend right] node[above] {via Netzwerk} (R1);
\draw[->] (R1) -- node[above,rotate=74] {TG: R} (r1);
\draw[->] (R1) -- node[above,rotate=-74] {TG: R} (r2);
\end{tikzpicture}
\end{document}
25 changes: 25 additions & 0 deletions doc/manual/intro/fig/trunk_net_ex4b.tex
View file
Original file line number Diff line number Diff line change
@@ -0,0 +1,25 @@
\documentclass{standalone}
\usepackage{tikz}
\usetikzlibrary{shapes.geometric}
\input{repeater}
\begin{document}
\begin{tikzpicture}[every node/.style={scale=.8}]
\activeuser{r1}{ 0,0}{Reinigung 1};
\activeuser{r2}{ 2,0}{Reinigung 2};
\draw[dotted] (3,4) -- (3,-1);
\user{s1}{ 4,0}{Sicherheit 1};
\activeuser{z} { 6,0}{Zentrale};
\draw[dotted] (7,4) -- (7,-1);
\user{s2}{ 8,0}{Sicherheit 2};
\activeuser{r3}{10,0}{Reinigung 3};
\activerepeater{R1}{1,3}{Terminal 1, TG: R,S};
\activerepeater{R2}{5,3}{Terminal 2, TG: R,S};
\activerepeater{R3}{9,3}{Vorfeld, TG: S,(R)};
\draw[->] (z) -- node[above,rotate=-74] {TG: R} (R2);
\path[->,dashed] (R2) edge [bend right] node[above] {via Netzwerk} (R1);
\path[->,dashed] (R2) edge [bend left] node[above] {via Netzwerk} (R3);
\draw[->] (R1) -- node[above,rotate=74] {TG: R} (r1);
\draw[->] (R1) -- node[above,rotate=-74] {TG: R} (r2);
\draw[->] (R3) -- node[above,rotate=-74] {TG: R} (r3);
\end{tikzpicture}
\end{document}
7 changes: 7 additions & 0 deletions doc/manual/intro/introduction.xml
View file
Original file line number Diff line number Diff line change
Expand Up @@ -31,5 +31,12 @@

<xi:include href="foreknowledge.xml"/>
<xi:include href="origin.xml"/>
<xi:include href="simplex.xml"/>
<xi:include href="local.xml"/>
<xi:include href="private.xml"/>
<xi:include href="textmessages.xml"/>
<xi:include href="talkgroup.xml"/>
<xi:include href="roaming.xml"/>
<xi:include href="networks.xml"/>

</chapter>
48 changes: 48 additions & 0 deletions doc/manual/intro/local.xml
View file
Original file line number Diff line number Diff line change
@@ -0,0 +1,48 @@
<?xml version="1.0" encoding="UTF-8"?>

<section xml:id="introLocal"
xmlns="http://docbook.org/ns/docbook"
xmlns:xlink="http://www.w3.org/1999/xlink"
xmlns:xi="http://www.w3.org/2001/XInclude">

<info>
<title>Local Repeater Operation</title>
</info>

<para>
One central objective of DMR is to be repeater transparent. That is, it does not matter which
repeater you use. You will always be able to reach the same groups. An be always reachable
through the same means (private or group call). This concept is violated by the talk groups 8
&amp; 9. The are the regional and local talk groups.
</para>

<example xml:id="figIntroTG9TG8">
<title>Two regions with two repeaters each.</title>
<mediaobject>
<imageobject><imagedata fileref="fig/repeater_local.png" width="10cm" align="center"/></imageobject>
</mediaobject>
</example>

<para>
The talk group 9 (TG9) is the so-called local talk group. Group calls to that talk group are not
forwarded though the network and only retransmitted locally. Usually <quote>locally</quote> means
only be the repeater. Sometimes, however, these calls are also forwarded to other repeaters
nearby. This case is shown in <xref linkend="figIntroTG9TG8"/> on the left side. Here DM3MAT sends
a group call to TG9 via the repeater DB0ABC. This call is not forwarded to any other repeater and
thus is only received in the local area around the repeater. DL1XYZ is in that local area and may
receive that call if he configured his radio to receive calls from the TG9.
</para>

<para>
The talk group 8 (TG8) is the so-called regional talk group. A call to that talk group is usually
forwarded to all repeaters within a specific region. Which repeaters are part of a
<quote>region</quote>, is a decision of the repeater administrators. So it is hard to predict to
which repeaters a regional call gets forwarded. In <xref linkend="figIntroTG9TG8"/> on the right
side, DL3XYZ sends a group call to TG8 to the repeater DB0GHI. This call then gets forwarded to
all repeaters in the <quote>region</quote>. In this case, also to the repeater DB0JKL within the
same region. Therefore, all participants within that region are able to receive the group call
if they configured their radios accordingly. In this example, not only DL4XYZ received the call
but also DL5XYZ who is not close to the repeater DB0GHI and would have missed a group call to the
local talk group.
</para>
</section>
Loading

0 comments on commit daa25e8

Please sign in to comment.