<p>laforge <strong>submitted</strong> this change.</p><p><a href="https://gerrit.osmocom.org/c/osmo-mgw/+/21365">View Change</a></p><div style="white-space:pre-wrap">Approvals:
  laforge: Looks good to me, approved
  pespin: Looks good to me, but someone else must approve
  Jenkins Builder: Verified

</div><pre style="font-family: monospace,monospace; white-space: pre-wrap;">configuration: add section about E1 trunks<br><br>The cunfiguration chapter does not say anything about E1 trunk<br>configurations, lets add a subsection that explains how an E1<br>trunk is added.<br><br>Change-Id: I4059771df0f115242398d1af499c837005a7dabc<br>---<br>M doc/manuals/chapters/configuration.adoc<br>1 file changed, 65 insertions(+), 0 deletions(-)<br><br></pre><pre style="font-family: monospace,monospace; white-space: pre-wrap;"><span>diff --git a/doc/manuals/chapters/configuration.adoc b/doc/manuals/chapters/configuration.adoc</span><br><span>index 1d273b6..2e2772e 100644</span><br><span>--- a/doc/manuals/chapters/configuration.adoc</span><br><span>+++ b/doc/manuals/chapters/configuration.adoc</span><br><span>@@ -57,3 +57,68 @@</span><br><span> trunks or a change of the number of available endpoints, require a full restart</span><br><span> of osmo-mgw!</span><br><span> </span><br><span style="color: hsl(120, 100%, 40%);">+=== E1 trunk considerations</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+While the RTP bridge trunks are natively based on IP no special considerations</span><br><span style="color: hsl(120, 100%, 40%);">+are required during setup. E1 trunks are mapped on a physical E1 line, which has</span><br><span style="color: hsl(120, 100%, 40%);">+to be configured as shown below.</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+.Example: E1 line setup</span><br><span style="color: hsl(120, 100%, 40%);">+----</span><br><span style="color: hsl(120, 100%, 40%);">+OsmoMGW(config-e1_input)# e1_line 0 driver dahdi <1></span><br><span style="color: hsl(120, 100%, 40%);">+OsmoMGW(config-e1_input)# e1_line 0 port 2 <2></span><br><span style="color: hsl(120, 100%, 40%);">+----</span><br><span style="color: hsl(120, 100%, 40%);">+<1> Name of the libosmo-abis driver implementation ("dahdi")</span><br><span style="color: hsl(120, 100%, 40%);">+<2> Port number of the physical E1 port to use (2)</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+In osmo-mgw the e1_input node is used to configure the physical E1 line. The</span><br><span style="color: hsl(120, 100%, 40%);">+line number will be used internally to identify the configured E1 line. The</span><br><span style="color: hsl(120, 100%, 40%);">+port number is the physical E1 connector (sometimes called 'span') at the E1</span><br><span style="color: hsl(120, 100%, 40%);">+hardware. Per trunk an individual E1 line will be needed. Beware that the E1</span><br><span style="color: hsl(120, 100%, 40%);">+driver may also need configuration settings that are not discussed here.</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+.Example: E1 trunk setup</span><br><span style="color: hsl(120, 100%, 40%);">+----</span><br><span style="color: hsl(120, 100%, 40%);">+OsmoMGW(config-mgcp)# trunk 0 <1></span><br><span style="color: hsl(120, 100%, 40%);">+OsmoMGW(config-mgcp-trunk)# line 0 <2></span><br><span style="color: hsl(120, 100%, 40%);">+----</span><br><span style="color: hsl(120, 100%, 40%);">+<1> Creation of a trunk (0)</span><br><span style="color: hsl(120, 100%, 40%);">+<2> Reference to the E1 line to use (0)</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+The E1 trunk is created along with a number, typically starting at 0, but if</span><br><span style="color: hsl(120, 100%, 40%);">+required any number from 0-64 is allowed. The E1 trunk configuration concerning</span><br><span style="color: hsl(120, 100%, 40%);">+the IP related aspects is nearly identical to the configuration of the virtual</span><br><span style="color: hsl(120, 100%, 40%);">+trunk. However, it is important that the user assigns one of the E1 line numbers</span><br><span style="color: hsl(120, 100%, 40%);">+that were configured under the e1_input node.</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+.Example: A typical configuration with one E1 trunk</span><br><span style="color: hsl(120, 100%, 40%);">+----</span><br><span style="color: hsl(120, 100%, 40%);">+e1_input</span><br><span style="color: hsl(120, 100%, 40%);">+ e1_line 0 driver dahdi</span><br><span style="color: hsl(120, 100%, 40%);">+ e1_line 0 port 2</span><br><span style="color: hsl(120, 100%, 40%);">+mgcp</span><br><span style="color: hsl(120, 100%, 40%);">+ bind ip 127.0.0.1</span><br><span style="color: hsl(120, 100%, 40%);">+ rtp net-range 6000 6011</span><br><span style="color: hsl(120, 100%, 40%);">+ rtp net-bind-ip 192.168.100.130</span><br><span style="color: hsl(120, 100%, 40%);">+ rtp ip-probing</span><br><span style="color: hsl(120, 100%, 40%);">+ rtp ip-tos 184</span><br><span style="color: hsl(120, 100%, 40%);">+ no rtp keep-alive</span><br><span style="color: hsl(120, 100%, 40%);">+ bind port 2428</span><br><span style="color: hsl(120, 100%, 40%);">+ number endpoints 30</span><br><span style="color: hsl(120, 100%, 40%);">+ loop 0</span><br><span style="color: hsl(120, 100%, 40%);">+ force-realloc 1</span><br><span style="color: hsl(120, 100%, 40%);">+ osmux off</span><br><span style="color: hsl(120, 100%, 40%);">+ rtp-patch rfc5993hr</span><br><span style="color: hsl(120, 100%, 40%);">+ trunk 0</span><br><span style="color: hsl(120, 100%, 40%);">+  rtp keep-alive once</span><br><span style="color: hsl(120, 100%, 40%);">+  no rtp keep-alive</span><br><span style="color: hsl(120, 100%, 40%);">+  line 0</span><br><span style="color: hsl(120, 100%, 40%);">+----</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+NOTE: One E1 trunk always covers a whole E1 line. All subslots (I.640) will be mapped</span><br><span style="color: hsl(120, 100%, 40%);">+to individual MGCP endpoints. As long as the endpoints remain unused the</span><br><span style="color: hsl(120, 100%, 40%);">+underlying E1 timeslot is not used.</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+NOTE: The E1 trunk implementation also works with T1 lines, however since T1 has</span><br><span style="color: hsl(120, 100%, 40%);">+24 instead of 31 usable timeslots only the endpoints that fall into that 1-24 timeslot</span><br><span style="color: hsl(120, 100%, 40%);">+range will be useable.</span><br><span></span><br></pre><p>To view, visit <a href="https://gerrit.osmocom.org/c/osmo-mgw/+/21365">change 21365</a>. To unsubscribe, or for help writing mail filters, visit <a href="https://gerrit.osmocom.org/settings">settings</a>.</p><div itemscope itemtype="http://schema.org/EmailMessage"><div itemscope itemprop="action" itemtype="http://schema.org/ViewAction"><link itemprop="url" href="https://gerrit.osmocom.org/c/osmo-mgw/+/21365"/><meta itemprop="name" content="View Change"/></div></div>

<div style="display:none"> Gerrit-Project: osmo-mgw </div>
<div style="display:none"> Gerrit-Branch: master </div>
<div style="display:none"> Gerrit-Change-Id: I4059771df0f115242398d1af499c837005a7dabc </div>
<div style="display:none"> Gerrit-Change-Number: 21365 </div>
<div style="display:none"> Gerrit-PatchSet: 4 </div>
<div style="display:none"> Gerrit-Owner: dexter <pmaier@sysmocom.de> </div>
<div style="display:none"> Gerrit-Reviewer: Jenkins Builder </div>
<div style="display:none"> Gerrit-Reviewer: laforge <laforge@osmocom.org> </div>
<div style="display:none"> Gerrit-Reviewer: pespin <pespin@sysmocom.de> </div>
<div style="display:none"> Gerrit-MessageType: merged </div>