<p>Pau Espin Pedrol has uploaded this change for <strong>review</strong>.</p><p><a href="https://gerrit.osmocom.org/11034">View Change</a></p><pre style="font-family: monospace,monospace; white-space: pre-wrap;">osmotrx: Write initial documentation for several supported devices<br><br>Change-Id: I902b01ca661416eb9705afac8a34ec8d2fb13789<br>---<br>M OsmoTRX/chapters/trx-backends.adoc<br>M OsmoTRX/chapters/trx-devices.adoc<br>2 files changed, 68 insertions(+), 1 deletion(-)<br><br></pre><pre style="font-family: monospace,monospace; white-space: pre-wrap;">git pull ssh://gerrit.osmocom.org:29418/osmo-gsm-manuals refs/changes/34/11034/1</pre><pre style="font-family: monospace,monospace; white-space: pre-wrap;"><span>diff --git a/OsmoTRX/chapters/trx-backends.adoc b/OsmoTRX/chapters/trx-backends.adoc</span><br><span>index 5da2e5c..e801886 100644</span><br><span>--- a/OsmoTRX/chapters/trx-backends.adoc</span><br><span>+++ b/OsmoTRX/chapters/trx-backends.adoc</span><br><span>@@ -1,3 +1,4 @@</span><br><span style="color: hsl(120, 100%, 40%);">+[[backend_uhd]]</span><br><span> == `osmo-trx-uhd` for UHD based Transceivers</span><br><span> </span><br><span> This OsmoTRX model uses _libuhd_ (UHD, USRP Hardware Driver) to drive the</span><br><span>@@ -15,6 +16,7 @@</span><br><span> Related code can be found in the _Transceiver52M/device/uhd/_ directory in</span><br><span> _osmo-trx.git_.</span><br><span> </span><br><span style="color: hsl(120, 100%, 40%);">+[[backend_lms]]</span><br><span> == `osmo-trx-lms` for LimeSuite based Transceivers</span><br><span> </span><br><span> This OsmoTRX model uses LimeSuite API and library to drive the device, that is</span><br><span>@@ -27,7 +29,7 @@</span><br><span> Related code can be found in the _Transceiver52M/device/lms/_ directory in</span><br><span> _osmo-trx.git_.</span><br><span> </span><br><span style="color: hsl(0, 100%, 40%);">-</span><br><span style="color: hsl(120, 100%, 40%);">+[[backend_usrp1]]</span><br><span> == `osmo-trx-usrp1` for libusrp based Transceivers</span><br><span> </span><br><span> This OsmoTRX model uses the legacy libusrp driver provided in GNU Radio 3.4.2.</span><br><span>diff --git a/OsmoTRX/chapters/trx-devices.adoc b/OsmoTRX/chapters/trx-devices.adoc</span><br><span>index 08ef773..10c8529 100644</span><br><span>--- a/OsmoTRX/chapters/trx-devices.adoc</span><br><span>+++ b/OsmoTRX/chapters/trx-devices.adoc</span><br><span>@@ -23,3 +23,68 @@</span><br><span> OsmoTRX is built with LimeSuite backend, an _osmo-trx-lms_ binary is generated.</span><br><span> Build of different backend can be enabled and disabled by means of configure</span><br><span> flags, which can be found in each subsection relative to each backend below.</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+[[dev_ettus_usrp1]]</span><br><span style="color: hsl(120, 100%, 40%);">+=== Ettus USRP1</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+The binary _osmo-trx-usrp1_ is used to drive this device, see <<backend_usrp1>>.</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+[[dev_ettus_b200]]</span><br><span style="color: hsl(120, 100%, 40%);">+=== Ettus B200</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+The binary _osmo-trx-uhd_ is used to drive this device, see <<backend_uhd>>.</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+Comes only with 1 RF channel. It can still be used in a multi-TRX setup by using</span><br><span style="color: hsl(120, 100%, 40%);">+the <<multiarfcn_mode>> feature. By using this feature, one can drive up to 3</span><br><span style="color: hsl(120, 100%, 40%);">+TRX (with the restrictions explained there).</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+[[dev_ettus_b200]]</span><br><span style="color: hsl(120, 100%, 40%);">+=== Ettus B210</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+The binary _osmo-trx-uhd_ is used to drive this device, see <<backend_uhd>>.</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+Comes with 2 RF channels, which can be used to set up a multi-TRX BTS. However,</span><br><span style="color: hsl(120, 100%, 40%);">+due to a shared local oscillator for both RF channels, ARFCN separation can be</span><br><span style="color: hsl(120, 100%, 40%);">+up about 25 MHz.</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+This device also supports the <<multiarfcn_mode>> feature. By using this</span><br><span style="color: hsl(120, 100%, 40%);">+feature, one can drive up to 3 TRX (with the restrictions explained there).</span><br><span style="color: hsl(120, 100%, 40%);">+Please note  that the above configurations cannot be combined, which means</span><br><span style="color: hsl(120, 100%, 40%);">+maximum number of TRX one can achieve is 2 by using separate physical RF</span><br><span style="color: hsl(120, 100%, 40%);">+channels, or 3 by using multi-ARFCN method. You cannot support, for example, 6</span><br><span style="color: hsl(120, 100%, 40%);">+ARFCN operation on B210 using 3 TRX on side A and another 3 TRX on side B.</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+[[dev_limesdr_usb]]</span><br><span style="color: hsl(120, 100%, 40%);">+=== LimeSDR-USB</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+The binary _osmo-trx-lms_ is used to drive this device, see <<backend_lms>>.</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+This device comes with 2 RF channels, so it should theoretically be possible to</span><br><span style="color: hsl(120, 100%, 40%);">+run a multi-TRX setup with it, but there are yet no records that this kind of</span><br><span style="color: hsl(120, 100%, 40%);">+setup was tested with this device.</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+This device has 3 different Rx paths with different antenna connectors in the</span><br><span style="color: hsl(120, 100%, 40%);">+PCB, each with a different frequency and bandwidth range. One should make sure</span><br><span style="color: hsl(120, 100%, 40%);">+the physical antenna is connected to the correct connector matching the Rx path</span><br><span style="color: hsl(120, 100%, 40%);">+you want to use. If one wants to be able to use the device in both 900 and 1800</span><br><span style="color: hsl(120, 100%, 40%);">+MHz GSM bands and easily switch between them, then Rx Path `LNAW` should be used</span><br><span style="color: hsl(120, 100%, 40%);">+,since it is the only one covering both bands, and the antenna physically plugged</span><br><span style="color: hsl(120, 100%, 40%);">+accordingly. Following example shows how to then configure _osmo-trx-lms_ to use</span><br><span style="color: hsl(120, 100%, 40%);">+that Rx path to read samples.</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+.Example: Configure osmo-trx-lms to use LNAW as Rx path and BAND1 as Tx Path</span><br><span style="color: hsl(120, 100%, 40%);">+----</span><br><span style="color: hsl(120, 100%, 40%);">+trx</span><br><span style="color: hsl(120, 100%, 40%);">+ ...</span><br><span style="color: hsl(120, 100%, 40%);">+ chan 0</span><br><span style="color: hsl(120, 100%, 40%);">+  tx-path BAND1</span><br><span style="color: hsl(120, 100%, 40%);">+  rx-path LNAW</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%);">+[[dev_limesdr_mini]]</span><br><span style="color: hsl(120, 100%, 40%);">+=== LimeSDR-mini</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+The binary _osmo-trx-lms_ is used to drive this device, see <<backend_lms>>.</span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+As a smaller brother of the [[dev_limesdr_usb]], this device comes only with 1</span><br><span style="color: hsl(120, 100%, 40%);">+RF channel. As a result, it can only hold 1 TRX as of today.</span><br><span></span><br></pre><p>To view, visit <a href="https://gerrit.osmocom.org/11034">change 11034</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/11034"/><meta itemprop="name" content="View Change"/></div></div>

<div style="display:none"> Gerrit-Project: osmo-gsm-manuals </div>
<div style="display:none"> Gerrit-Branch: master </div>
<div style="display:none"> Gerrit-MessageType: newchange </div>
<div style="display:none"> Gerrit-Change-Id: I902b01ca661416eb9705afac8a34ec8d2fb13789 </div>
<div style="display:none"> Gerrit-Change-Number: 11034 </div>
<div style="display:none"> Gerrit-PatchSet: 1 </div>
<div style="display:none"> Gerrit-Owner: Pau Espin Pedrol <pespin@sysmocom.de> </div>