<p>laforge <strong>submitted</strong> this change.</p><p><a href="https://gerrit.osmocom.org/c/osmo-bsc/+/26367">View Change</a></p><div style="white-space:pre-wrap">Approvals:
Jenkins Builder: Verified
pespin: Looks good to me, but someone else must approve
laforge: Looks good to me, approved
</div><pre style="font-family: monospace,monospace; white-space: pre-wrap;">bts-examples: add example for E1 connected BTS<br><br>The manual lacks an example on how to set up an E1 connected BTS.<br>Especially the relation between trunk number and E1 line number is not<br>obvious.<br><br>Change-Id: I02f5d4fe059e5cc9c3ffc2e3636d812532c09239<br>Related: OS#5308<br>---<br>M doc/manuals/chapters/bts-examples.adoc<br>1 file changed, 117 insertions(+), 0 deletions(-)<br><br></pre><pre style="font-family: monospace,monospace; white-space: pre-wrap;"><span>diff --git a/doc/manuals/chapters/bts-examples.adoc b/doc/manuals/chapters/bts-examples.adoc</span><br><span>index 58cb3ab..836dec0 100644</span><br><span>--- a/doc/manuals/chapters/bts-examples.adoc</span><br><span>+++ b/doc/manuals/chapters/bts-examples.adoc</span><br><span>@@ -174,3 +174,120 @@</span><br><span> For building a multi-TRX setup, you also need to connect the TIB cables</span><br><span> between the two nanoBTS units, as well as the coaxial/RF AUX cabling.</span><br><span> ====</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+=== Example configuration for OsmoBSC with E1 BTS</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+The following configuration sample illustrates the usage of BTSs that are</span><br><span style="color: hsl(120, 100%, 40%);">+connected via an E1/T1 backhaul.</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+.OsmoBSC configured for single-TRX E1 Ericsson DUG20</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%);">+e1_input <1></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 3</span><br><span style="color: hsl(120, 100%, 40%);">+network</span><br><span style="color: hsl(120, 100%, 40%);">+ network country code 1</span><br><span style="color: hsl(120, 100%, 40%);">+ mobile network code 1</span><br><span style="color: hsl(120, 100%, 40%);">+ encryption a5 0</span><br><span style="color: hsl(120, 100%, 40%);">+ neci 1</span><br><span style="color: hsl(120, 100%, 40%);">+ handover 0</span><br><span style="color: hsl(120, 100%, 40%);">+ bts 0</span><br><span style="color: hsl(120, 100%, 40%);">+ type rbs2000</span><br><span style="color: hsl(120, 100%, 40%);">+ band GSM900</span><br><span style="color: hsl(120, 100%, 40%);">+ om2000 version-limit oml gen 12 rev 10 <2></span><br><span style="color: hsl(120, 100%, 40%);">+ cell_identity 0</span><br><span style="color: hsl(120, 100%, 40%);">+ location_area_code 1</span><br><span style="color: hsl(120, 100%, 40%);">+ training_sequence_code 7</span><br><span style="color: hsl(120, 100%, 40%);">+ base_station_id_code 63</span><br><span style="color: hsl(120, 100%, 40%);">+ ms max power 15</span><br><span style="color: hsl(120, 100%, 40%);">+ cell reselection hysteresis 4</span><br><span style="color: hsl(120, 100%, 40%);">+ rxlev access min 0</span><br><span style="color: hsl(120, 100%, 40%);">+ channel allocator ascending</span><br><span style="color: hsl(120, 100%, 40%);">+ rach tx integer 9</span><br><span style="color: hsl(120, 100%, 40%);">+ rach max transmission 7</span><br><span style="color: hsl(120, 100%, 40%);">+ oml e1 line 0 timeslot 1 sub-slot full <3></span><br><span style="color: hsl(120, 100%, 40%);">+ oml e1 tei 62 <4></span><br><span style="color: hsl(120, 100%, 40%);">+ gprs mode none</span><br><span style="color: hsl(120, 100%, 40%);">+ is-connection-list add 4 512 12 <5></span><br><span style="color: hsl(120, 100%, 40%);">+ is-connection-list add 16 524 12</span><br><span style="color: hsl(120, 100%, 40%);">+ is-connection-list add 28 536 12</span><br><span style="color: hsl(120, 100%, 40%);">+ is-connection-list add 40 548 12</span><br><span style="color: hsl(120, 100%, 40%);">+ trx 0</span><br><span style="color: hsl(120, 100%, 40%);">+ rf_locked 0</span><br><span style="color: hsl(120, 100%, 40%);">+ arfcn 123</span><br><span style="color: hsl(120, 100%, 40%);">+ nominal power 42</span><br><span style="color: hsl(120, 100%, 40%);">+ max_power_red 12</span><br><span style="color: hsl(120, 100%, 40%);">+ rsl e1 line 0 timeslot 1 sub-slot full <6></span><br><span style="color: hsl(120, 100%, 40%);">+ rsl e1 tei 0 <7></span><br><span style="color: hsl(120, 100%, 40%);">+ timeslot 0</span><br><span style="color: hsl(120, 100%, 40%);">+ phys_chan_config CCCH+SDCCH4</span><br><span style="color: hsl(120, 100%, 40%);">+ hopping enabled 0</span><br><span style="color: hsl(120, 100%, 40%);">+ e1 line 0 timeslot 1 sub-slot full <8></span><br><span style="color: hsl(120, 100%, 40%);">+ timeslot 1</span><br><span style="color: hsl(120, 100%, 40%);">+ phys_chan_config TCH/F</span><br><span style="color: hsl(120, 100%, 40%);">+ hopping enabled 0</span><br><span style="color: hsl(120, 100%, 40%);">+ e1 line 0 timeslot 2 sub-slot 1 <9></span><br><span style="color: hsl(120, 100%, 40%);">+ timeslot 2</span><br><span style="color: hsl(120, 100%, 40%);">+ phys_chan_config TCH/F</span><br><span style="color: hsl(120, 100%, 40%);">+ hopping enabled 0</span><br><span style="color: hsl(120, 100%, 40%);">+ e1 line 0 timeslot 2 sub-slot 2</span><br><span style="color: hsl(120, 100%, 40%);">+ timeslot 3</span><br><span style="color: hsl(120, 100%, 40%);">+ phys_chan_config TCH/F</span><br><span style="color: hsl(120, 100%, 40%);">+ hopping enabled 0</span><br><span style="color: hsl(120, 100%, 40%);">+ e1 line 0 timeslot 2 sub-slot 3</span><br><span style="color: hsl(120, 100%, 40%);">+ timeslot 4</span><br><span style="color: hsl(120, 100%, 40%);">+ phys_chan_config TCH/F</span><br><span style="color: hsl(120, 100%, 40%);">+ hopping enabled 0</span><br><span style="color: hsl(120, 100%, 40%);">+ e1 line 0 timeslot 3 sub-slot 0</span><br><span style="color: hsl(120, 100%, 40%);">+ timeslot 5</span><br><span style="color: hsl(120, 100%, 40%);">+ phys_chan_config TCH/F</span><br><span style="color: hsl(120, 100%, 40%);">+ hopping enabled 0</span><br><span style="color: hsl(120, 100%, 40%);">+ e1 line 0 timeslot 3 sub-slot 1</span><br><span style="color: hsl(120, 100%, 40%);">+ timeslot 6</span><br><span style="color: hsl(120, 100%, 40%);">+ phys_chan_config TCH/F</span><br><span style="color: hsl(120, 100%, 40%);">+ hopping enabled 0</span><br><span style="color: hsl(120, 100%, 40%);">+ e1 line 0 timeslot 3 sub-slot 2</span><br><span style="color: hsl(120, 100%, 40%);">+ timeslot 7</span><br><span style="color: hsl(120, 100%, 40%);">+ phys_chan_config TCH/F</span><br><span style="color: hsl(120, 100%, 40%);">+ hopping enabled 0</span><br><span style="color: hsl(120, 100%, 40%);">+ e1 line 0 timeslot 3 sub-slot 3</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%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+<1> In this example we use a dahdi E1 card. This card has 4 ports. Here we use port numer 3. It should be noted that the dahdi driver also requires additional configuration, which is not covered by this manual.</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+<2> In this example we use an E1 Ericsson DUG20, which uses an OML dialect, called "OM2000".</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+<3> The first usable timeslot on an E1 line is TS1. In this example we will assume that TS1-TS3 are connected to the BTS stright through. TS1 will handle all signaling traffic. Here we assign this timeslot to OML.</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+<4> OML always requires a TEI (Terminal Equipment Identifier) to set up. This number can be found in the manual of the BTS.</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+<5> This BTS has an built in “Interface Switch” (IS) that offers flexible way to reconfigure the interconnection between the internal components of the BTS and the external E1 line. This depends on the exact BTS type and configuration.</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+<6> Similar to OML we assign TS1 to RSL as well.</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+<7> Like with OML, RSL also requires a TEI to be configured. Usually each TRX will have a specific TEI assigned.</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+<8> CCCH+SDCCH4 will also be mapped on TS1. The traffic for those control channels will be multiplexed alongside the RSL and OML traffic.</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+<9> The bandwidth of one E1 timeslot matches the bandwidth of 4 GSM air interface timeslots. The E1 timeslot is split up into four sub-slots, which are then assigned to one GSM air interface timeslot each. Since the first timeslot on the first TRX is already used for signaling we begin the sub-slot counting with sub-slot 1 for alignment reasons.</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+=== E1 Line number and MGCP trunk number</span><br><span style="color: hsl(120, 100%, 40%);">+The switching of the voice channels is done via OsmoMGW, which acts as a media</span><br><span style="color: hsl(120, 100%, 40%);">+converter between E1 and VoIP (RTP). OsmoBSC will use the E1 line number to</span><br><span style="color: hsl(120, 100%, 40%);">+address the trunk via MGCP.</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+When configuring OsmoMGW, one needs to make sure that the trunk number that is</span><br><span style="color: hsl(120, 100%, 40%);">+set up on OsmoMGW, matches the line number that is set up on OsmoBSC. When those</span><br><span style="color: hsl(120, 100%, 40%);">+numbers mismatch the trunk cannot be addressed correctly.</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+.OsmoMGW trunk configuration that matches the OsmoBSC configuration above</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%);">+ 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>\ No newline at end of file</span><br><span></span><br></pre><p>To view, visit <a href="https://gerrit.osmocom.org/c/osmo-bsc/+/26367">change 26367</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-bsc/+/26367"/><meta itemprop="name" content="View Change"/></div></div>
<div style="display:none"> Gerrit-Project: osmo-bsc </div>
<div style="display:none"> Gerrit-Branch: master </div>
<div style="display:none"> Gerrit-Change-Id: I02f5d4fe059e5cc9c3ffc2e3636d812532c09239 </div>
<div style="display:none"> Gerrit-Change-Number: 26367 </div>
<div style="display:none"> Gerrit-PatchSet: 3 </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>