blob: 8829fa6246dc0863453d617805dd21a563a09dcb [file] [log] [blame]
Pau Espin Pedrol46560ea2018-09-20 15:03:19 +02001[[trx_backends]]
2== OsmoTRX backend support
3
Pau Espin Pedrol6b50b622018-09-19 17:05:30 +02004[[backend_uhd]]
Pau Espin Pedrol46560ea2018-09-20 15:03:19 +02005=== `osmo-trx-uhd` for UHD based Transceivers
Pau Espin Pedrold06172c2018-07-05 18:26:52 +02006
7This OsmoTRX model uses _libuhd_ (UHD, USRP Hardware Driver) to drive the
8device, that is configuring it and reading/writing samples from/to it.
9
10So far, this backend has been mostly used to drive devices such as the Ettus
11B200 family and Fairwaves UmTRX family, and used to be the default backend used
12for legacy @osmo-trx@ binary when per-backend binaries didn't exist yet.
13
14Any device providing generic support for UHD should theoretically be able to be
15run through this backend without much effort, but pracitcal experience showed
16that some devices don't play well with it, such as the LimeSDR family of
17devices, which showed far better results when using its native interface.
18
19Related code can be found in the _Transceiver52M/device/uhd/_ directory in
20_osmo-trx.git_.
21
Pau Espin Pedrol6b50b622018-09-19 17:05:30 +020022[[backend_lms]]
Pau Espin Pedrol46560ea2018-09-20 15:03:19 +020023=== `osmo-trx-lms` for LimeSuite based Transceivers
Pau Espin Pedrold06172c2018-07-05 18:26:52 +020024
25This OsmoTRX model uses LimeSuite API and library to drive the device, that is
26configuring it and reading/writing samples from/to it.
27
28This backend was developed in order to be used together with LimeSDR-USB and
29LimeSDR-mini devices, due to to the poor results obtained with the UHD backend,
30and to simplify the stack.
31
32Related code can be found in the _Transceiver52M/device/lms/_ directory in
33_osmo-trx.git_.
34
Pau Espin Pedrol6b50b622018-09-19 17:05:30 +020035[[backend_usrp1]]
Pau Espin Pedrol46560ea2018-09-20 15:03:19 +020036=== `osmo-trx-usrp1` for libusrp based Transceivers
Pau Espin Pedrold06172c2018-07-05 18:26:52 +020037
38This OsmoTRX model uses the legacy libusrp driver provided in GNU Radio 3.4.2.
39
40As this code was dropped from GNU Radio at some point and was found very
41difficult to build, some work was done to create a standalone libusrp which can
42be nowadays found as a separate git repository together with other osmocom git
43repositories, in https://git.osmocom.org/libusrp/
44
45Related code can be found in the _Transceiver52M/device/usrp1/_ directory in
46_osmo-trx.git_.