Project

General

Profile

OsmoTRX » History » Version 8

ttsou, 02/19/2016 10:47 PM

1 1 ttsou
= OsmoTRX =
2 1 ttsou
3 1 ttsou
OsmoTRX is a software-defined radio transceiver that implements the Layer 1 physical layer of a BTS comprising the following 3GPP specifications:
4 1 ttsou
 * TS 05.01 "Physical layer on the radio path"
5 1 ttsou
 * TS 05.02 "Multiplexing and Multiple Access on the Radio Path"
6 1 ttsou
 * TS 05.04 "Modulation"
7 1 ttsou
 * TS 05.10 "Radio subsystem synchronization"
8 1 ttsou
9 6 ttsou
OsmoTRX is based on the OpenBTS transceiver, but setup to operate independently with the purpose of using with non-OpenBTS software and projects. Currently there are numerous features contained in OsmoTRX that extend the functionality of the OpenBTS transceiver. These features include enhanced support for embedded platforms - notably ARM - and dual channel diversity support for the Fairwaves UmTRX. Most of these features will eventually be merged into mainline OpenBTS, but primary development will occur on OsmoTRX.
10 6 ttsou
11 6 ttsou
== Features ==
12 6 ttsou
13 6 ttsou
=Intel SSE Support=
14 6 ttsou
* SSE3
15 6 ttsou
* SSE4.1
16 6 ttsou
17 6 ttsou
On Intel processors, OsmoTRX makes heavy use of the Streaming SIMD Extensions (SSE) instruction set. Accelerated operations include pulse shape filtering, resampling, sequence correlation, and many other signal processing operations. SSE3 is the minimum requirement for accelerated use. SSE3 is present in the majority of Intel processors since later versions of the Pentium 4 architecture and is also present on low power Atom processors.
18 6 ttsou
19 6 ttsou
ARM NEON Support
20 6 ttsou
* NEON
21 6 ttsou
* NEON-VFPv4
22 6 ttsou
23 8 ttsou
OsmoTRX runs on a variety of ARM processors with and without NEON coprocessors. Like SSE on Intel processors, NEON provides acceleration with SIMD vectorized instructions. Tested popular architectures include ARM11 (Raspberry Pi), Cortex-A8 (BeagleBoard), and Cortex-A15 (ArndaleBoard). These platforms include no NEON coprocessor, standard NEON, and NEON-VFPv4 respectively. The latter NEON variation, VFPv4, provides additional fused-multiply-accumulate (FMA) instructions useful for many DSP operations. NEON optimization must be used enabled at built time.
24 6 ttsou
Dual Channel (UmTRX only)
25 6 ttsou
26 7 ttsou
Two dual channel modes are available: standard dual channel mode and diversity. In standard dual channel mode, each RF
27 7 ttsou
path of the dual channel device - currently only UmTRX - supports a different ARFCN. Each path operates independently a
28 7 ttsou
nd operates similarly to two separate devices. GSM channel capacity in this mode is doubled.
29 7 ttsou
30 6 ttsou
Dual Channel Diversity (UmTRX only)
31 7 ttsou
32 8 ttsou
Diversity mode is similar to the standard dual channel mode except each antenna supports both ARFCN channels. In this case, the receiver sample bandwidth is widened to handle both ARFCN's and subsequently converted and demultiplexed into separate sample streams. Each GSM receive path is fed dual signals, where antenna selection diversity is performed by taking the stronger signal on a burst-by-burst basis. The limitations are increased CPU utilization and that ARFCN spacing is restricted (currently at 400 kHz) by the receiver sampling bandwidth. Setting the ARFCN spacing beyond the sampling limit will disable the diversity path.
33 1 ttsou
34 7 ttsou
Low Phase Error Modulator
35 8 ttsou
36 8 ttsou
The default GSM downlink signal is configured for very low distortion using linearized GMSK implementation using a dual Laurent pulse approximation.
37 1 ttsou
38 1 ttsou
== Hardware support ==
39 1 ttsou
40 1 ttsou
Ettus Research
41 1 ttsou
||USRP1||
42 1 ttsou
||USRP2||
43 1 ttsou
||B100||
44 1 ttsou
||B110||
45 1 ttsou
||B200||
46 1 ttsou
||B210||
47 1 ttsou
||N200||
48 1 ttsou
||N210||
49 1 ttsou
||E100||
50 1 ttsou
||E110||
51 1 ttsou
52 1 ttsou
Fairwaves
53 1 ttsou
||UmTRX||
54 1 ttsou
55 1 ttsou
== Embedded Platform Support ==
56 1 ttsou
57 1 ttsou
OsmoTRX has been tested on the following embedded platforms.
58 1 ttsou
59 2 ttsou
||Platform||Processor||FPU||
60 1 ttsou
||BeagleBoard-xM||ARM Cortex-A8||NEON||
61 1 ttsou
||ArndaleBoard||ARM Cortex-A15||NEON-VFPv4||
62 2 ttsou
||RaspberryPi||ARMv6k||VFP||
63 2 ttsou
||Shuttle PC||Intel Atom D2550||SSE3||
64 2 ttsou
||Ettus E100||ARM Cortex-A8||NEON||
65 1 ttsou
66 1 ttsou
== Status ==
67 1 ttsou
68 1 ttsou
== GPRS support ==
69 1 ttsou
70 1 ttsou
== Source code ==
71 1 ttsou
72 1 ttsou
The source code is available from git.osmocom.org (module osmo-trx).
73 1 ttsou
74 1 ttsou
Public read-only access is available via
75 1 ttsou
 git clone git://git.osmocom.org/osmo-trx
76 1 ttsou
You can browse it via cgit: http://cgit.osmocom.org/cgit/osmo-trx/
77 1 ttsou
78 3 ttsou
== Configuration and Build ==
79 3 ttsou
80 3 ttsou
The only package dependency is the Universal Hardware Driver (UHD).
81 3 ttsou
82 3 ttsou
{{{
83 3 ttsou
$ ./configure
84 3 ttsou
$ make
85 3 ttsou
$ sudo make install
86 3 ttsou
}}}
87 3 ttsou
88 3 ttsou
== Running ==
89 3 ttsou
90 3 ttsou
{{{
91 3 ttsou
$ osmo-trx -h
92 3 ttsou
linux; GNU C++ version 4.8.1 20130603 (Red Hat 4.8.1-1); Boost_105300; UHD_003.005.004-140-gfb32ed16
93 3 ttsou
94 3 ttsou
Options:
95 3 ttsou
  -h    This text
96 3 ttsou
  -a    UHD device args
97 3 ttsou
  -l    Logging level (EMERG, ALERT, CRT, ERR, WARNING, NOTICE, INFO, DEBUG)
98 3 ttsou
  -i    IP address of GSM core
99 3 ttsou
  -p    Base port number
100 3 ttsou
  -d    Enable dual channel diversity receiver
101 3 ttsou
  -x    Enable external 10 MHz reference
102 3 ttsou
  -s    Samples-per-symbol (1 or 4)
103 3 ttsou
  -c    Number of ARFCN channels (default=1)
104 3 ttsou
}}}
105 3 ttsou
106 3 ttsou
{{{
107 5 ttsou
$ osmo-trx -a "addr=192.168.10.2"
108 3 ttsou
linux; GNU C++ version 4.8.1 20130603 (Red Hat 4.8.1-1); Boost_105300; UHD_003.004.000-b14cde5
109 3 ttsou
110 3 ttsou
Config Settings
111 4 ttsou
   Log Level............... INFO
112 3 ttsou
   Device args............. addr=192.168.10.2
113 3 ttsou
   TRX Base Port........... 5700
114 3 ttsou
   TRX Address............. 127.0.0.1
115 3 ttsou
   Channels................ 1
116 3 ttsou
   Samples-per-Symbol...... 4
117 3 ttsou
   External Reference...... Disabled
118 3 ttsou
   Diversity............... Disabled
119 3 ttsou
120 3 ttsou
-- Opening a UmTRX device...
121 3 ttsou
-- Current recv frame size: 1472 bytes
122 3 ttsou
-- Current send frame size: 1472 bytes
123 3 ttsou
-- Setting UmTRX 4 SPS
124 3 ttsou
-- Transceiver active with 1 channel(s)
125 3 ttsou
}}}
126 3 ttsou
127 1 ttsou
== Authors ==
128 1 ttsou
129 1 ttsou
OsmoTRX is currently developed and maintained by Thomas Tsou. The original code is derived from the OpenBTS project, which was developed by David Burgess and Harvind Samra at Range Networks.
Add picture from clipboard (Maximum size: 48.8 MB)