Project

General

Profile

OsmoTRX » History » Version 18

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 16 ttsou
'''Intel SSE Support'''
14 6 ttsou
* SSE3
15 6 ttsou
* SSE4.1
16 6 ttsou
17 17 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. For additional performance information, please see the benchmarks section. SSE usage is detected and configured automatically at build time.
18 6 ttsou
19 16 ttsou
'''ARM NEON Support'''
20 6 ttsou
* NEON
21 6 ttsou
* NEON-VFPv4
22 6 ttsou
23 17 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. For additional performance information, please see the benchmarks section. NEON optimization must be used enabled at built time.
24 9 ttsou
25 16 ttsou
'''Dual Channel (UmTRX only)'''
26 6 ttsou
27 7 ttsou
Two dual channel modes are available: standard dual channel mode and diversity. In standard dual channel mode, each RF
28 7 ttsou
path of the dual channel device - currently only UmTRX - supports a different ARFCN. Each path operates independently a
29 7 ttsou
nd operates similarly to two separate devices. GSM channel capacity in this mode is doubled.
30 7 ttsou
31 16 ttsou
'''Dual Channel Diversity (UmTRX only)'''
32 7 ttsou
33 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.
34 1 ttsou
35 16 ttsou
'''Low Phase Error Modulator'''
36 1 ttsou
37 16 ttsou
The default GSM downlink signal is configured for low distortion using a linearized GMSK modulator. The implementation is based on a two pulse Laurent approximation of continuous phase modulated (CPM) signals. On capable devices, the signal measures with very low phase error and passes industry spectrum mask requirements.
38 1 ttsou
39 16 ttsou
Phase Error (Ettus Research N200)
40 1 ttsou
41 16 ttsou
[[Image(http://tsou.cc/gsm/osmo-trx-phase75.gif)]]
42 16 ttsou
43 16 ttsou
Frequency Spectrum (Ettus Research N200)
44 16 ttsou
45 16 ttsou
[[Image(http://tsou.cc/gsm/osmo-trx-spectrum75.gif)]]
46 16 ttsou
47 1 ttsou
== Hardware support ==
48 1 ttsou
49 9 ttsou
Fairwaves
50 9 ttsou
||UmTRX||
51 9 ttsou
52 1 ttsou
Ettus Research
53 1 ttsou
||USRP1||
54 1 ttsou
||USRP2||
55 1 ttsou
||B100||
56 1 ttsou
||B110||
57 1 ttsou
||B200||
58 1 ttsou
||B210||
59 1 ttsou
||N200||
60 1 ttsou
||N210||
61 1 ttsou
||E100||
62 1 ttsou
||E110||
63 1 ttsou
64 1 ttsou
== Embedded Platform Support ==
65 1 ttsou
66 1 ttsou
OsmoTRX has been tested on the following embedded platforms.
67 1 ttsou
68 18 ttsou
||'''Platform'''||'''SoC'''||'''Processor'''||'''SIMD/FPU'''||
69 18 ttsou
||!ArndaleBoard||Samsung Exynos 5250||ARM Cortex-A15||NEON-VFPv4||
70 18 ttsou
||!BeagleBoard-xM||Texas Instruments OMAP3||ARM Cortex-A8||NEON||
71 18 ttsou
||Ettus E100||Texas Instruments OMAP3||ARM Cortex-A8||NEON||
72 18 ttsou
||Shuttle PC||NA||Intel Atom D2550||SSE3||
73 18 ttsou
||Raspberry Pi||Broadcom BCM2835||ARM11||VFP||
74 1 ttsou
75 18 ttsou
76 18 ttsou
77 1 ttsou
== Mailing List ==
78 1 ttsou
79 18 ttsou
For development purposes, OsmoTRX is discussed on both OpenBTS and OpenBSC mailing lists at openbts-discuss@lists.sourceforge.net and openbsc@lists.osmocom.org respectively. Please direct questions to the list appropriate for the GSM stack being used.
80 1 ttsou
81 18 ttsou
Subscription information is available at [https://lists.sourceforge.net/lists/listinfo/openbts-discuss] and [http://lists.osmocom.org/mailman/listinfo/openbsc/].
82 1 ttsou
83 16 ttsou
== GPRS support ==
84 16 ttsou
85 18 ttsou
OsmoTRX supports GPRS through OsmoBTS. For GPRS support with OpenBTS, please use the transceiver supplied with OpenBTS.
86 18 ttsou
87 16 ttsou
== Source code ==
88 1 ttsou
89 16 ttsou
The source code is available from git.osmocom.org (module osmo-trx).
90 1 ttsou
91 1 ttsou
Public read-only access is available via
92 1 ttsou
 git clone git://git.osmocom.org/osmo-trx
93 16 ttsou
You can browse it via cgit: http://cgit.osmocom.org/cgit/osmo-trx/
94 16 ttsou
95 1 ttsou
== Configuration and Build ==
96 1 ttsou
97 18 ttsou
The only package dependency is the Universal Hardware Driver (UHD), which is available from Ettus Research or Fairwaves depending on the device. Please note that the UHD implementation must match hardware (i.e. Ettus Research UHD for USRP devices and Fairwaves UHD with UmTRX). The one device that does not use the UHD driver is the USRP1, which is supported through the legacy libusrp driver provided in GNU Radio 3.4.2.
98 1 ttsou
99 18 ttsou
'''Intel Platforms (All)'''
100 18 ttsou
101 18 ttsou
Intel SSE support is automatically detected on Intel x86 platforms. No user intervention is necessary.
102 1 ttsou
{{{
103 1 ttsou
$ ./configure
104 18 ttsou
...
105 18 ttsou
checking whether mmx is supported... yes
106 18 ttsou
checking whether sse is supported... yes
107 18 ttsou
checking whether sse2 is supported... yes
108 18 ttsou
checking whether sse3 is supported... yes
109 18 ttsou
checking whether ssse3 is supported... yes
110 18 ttsou
checking whether sse4.1 is supported... yes
111 18 ttsou
checking whether sse4.2 is supported... yes
112 18 ttsou
...
113 18 ttsou
}}}
114 18 ttsou
115 18 ttsou
'''ARM Platforms with NEON'''
116 18 ttsou
117 18 ttsou
Many popular ARM development boards fall under this category including !BeagleBoard, !PandaBoard, and Ettus E100 USRP. NEON support must be manually enabled.
118 18 ttsou
{{{
119 18 ttsou
$ ./configure --with-neon
120 18 ttsou
}}}
121 18 ttsou
122 18 ttsou
'''ARM Platforms with NEON-VFPv4'''
123 18 ttsou
124 18 ttsou
Currently very few development platforms support this instruction set, which is seen mainly in high end smartphones and tablets. Available development boards are !ArndaleBoard and ODROID-XU. NEON-VFPv4 support is manually enabled.
125 18 ttsou
{{{
126 18 ttsou
$ ./configure --with-neon-vfpv4
127 18 ttsou
}}}
128 18 ttsou
129 18 ttsou
'''ARM Platforms without NEON'''
130 18 ttsou
131 18 ttsou
This configuration mainly targets the Raspberry Pi. ARM platforms without NEON vector units are almost always very slow processors, and generally not very suitable for running OsmoTRX. Running OsmoTRX on a Raspberry Pi, however, is possible along with limited TCH (voice) channel support. Currently this configuration requires minor code changes.
132 18 ttsou
133 18 ttsou
Coming soon.
134 18 ttsou
135 18 ttsou
'''Build and Install'''
136 18 ttsou
137 18 ttsou
After configuration, installation is simple.
138 18 ttsou
139 18 ttsou
{{{
140 16 ttsou
$ make
141 16 ttsou
$ sudo make install
142 16 ttsou
}}}
143 16 ttsou
144 16 ttsou
== Running ==
145 18 ttsou
146 18 ttsou
OsmoTRX can be configured with a variety of options on the command line.
147 16 ttsou
148 16 ttsou
{{{
149 16 ttsou
$ osmo-trx -h
150 16 ttsou
linux; GNU C++ version 4.8.1 20130603 (Red Hat 4.8.1-1); Boost_105300; UHD_003.005.004-140-gfb32ed16
151 16 ttsou
152 16 ttsou
Options:
153 16 ttsou
  -h    This text
154 16 ttsou
  -a    UHD device args
155 16 ttsou
  -l    Logging level (EMERG, ALERT, CRT, ERR, WARNING, NOTICE, INFO, DEBUG)
156 16 ttsou
  -i    IP address of GSM core
157 16 ttsou
  -p    Base port number
158 16 ttsou
  -d    Enable dual channel diversity receiver
159 16 ttsou
  -x    Enable external 10 MHz reference
160 16 ttsou
  -s    Samples-per-symbol (1 or 4)
161 16 ttsou
  -c    Number of ARFCN channels (default=1)
162 16 ttsou
}}}
163 16 ttsou
164 16 ttsou
{{{
165 16 ttsou
$ osmo-trx -a "addr=192.168.10.2"
166 16 ttsou
linux; GNU C++ version 4.8.1 20130603 (Red Hat 4.8.1-1); Boost_105300; UHD_003.004.000-b14cde5
167 16 ttsou
168 16 ttsou
Config Settings
169 16 ttsou
   Log Level............... INFO
170 16 ttsou
   Device args............. addr=192.168.10.2
171 16 ttsou
   TRX Base Port........... 5700
172 16 ttsou
   TRX Address............. 127.0.0.1
173 16 ttsou
   Channels................ 1
174 16 ttsou
   Samples-per-Symbol...... 4
175 16 ttsou
   External Reference...... Disabled
176 16 ttsou
   Diversity............... Disabled
177 16 ttsou
178 16 ttsou
-- Opening a UmTRX device...
179 16 ttsou
-- Current recv frame size: 1472 bytes
180 16 ttsou
-- Current send frame size: 1472 bytes
181 16 ttsou
-- Setting UmTRX 4 SPS
182 16 ttsou
-- Transceiver active with 1 channel(s)
183 16 ttsou
}}}
184 16 ttsou
185 13 ttsou
== Benchmarks ==
186 13 ttsou
187 13 ttsou
Selected benchmark results are provided below. All tests run on a single core only.
188 13 ttsou
189 17 ttsou
'''Intel Haswell (i7 4770K 3.5 GHz)'''
190 13 ttsou
191 13 ttsou
{{{
192 13 ttsou
--- Floating point to integer conversions
193 13 ttsou
-- Testing 40000 iterations of 3120 values
194 13 ttsou
- Measuring conversion time
195 13 ttsou
- Elapsed time base...                  0.065508 secs
196 13 ttsou
- Validating SIMD conversion results... PASS
197 10 ttsou
- Measuring conversion time
198 10 ttsou
- Elapsed time SIMD ...                 0.011424 secs
199 1 ttsou
- Speedup...                            5.734244
200 1 ttsou
}}}
201 1 ttsou
202 1 ttsou
{{{
203 1 ttsou
[+] Testing: GSM TCH/AFS 7.95 (recursive, flushed, punctured)
204 1 ttsou
[.] Input length  : ret = 165  exp = 165 -> OK
205 1 ttsou
[.] Output length : ret = 448  exp = 448 -> OK
206 1 ttsou
[.] Pre computed vector checks:
207 1 ttsou
[..] Encoding: OK
208 1 ttsou
[..] Decoding base: 
209 1 ttsou
[..] Decoding SIMD: 
210 1 ttsou
[..] Code N 3
211 3 ttsou
[..] Code K 7
212 3 ttsou
OK
213 3 ttsou
[.] Random vector checks:
214 3 ttsou
[.] Testing baseline:
215 3 ttsou
[..] Encoding / Decoding 10000 cycles:
216 3 ttsou
[.] Elapsed time........................ 1.435066 secs
217 3 ttsou
[.] Rate................................ 3.121808 Mbps
218 3 ttsou
[.] Testing SIMD:
219 3 ttsou
[..] Encoding / Decoding 10000 cycles:
220 3 ttsou
[.] Elapsed time........................ 0.073524 secs
221 3 ttsou
[.] Rate................................ 60.932485 Mbps
222 3 ttsou
[.] Speedup............................. 19.518334
223 1 ttsou
}}}
224 1 ttsou
225 17 ttsou
'''Intel Atom (D2500 1.86 GHz)'''
226 1 ttsou
{{{
227 1 ttsou
--- Floating point to integer conversions
228 1 ttsou
-- Testing 40000 iterations of 3120 values
229 1 ttsou
- Measuring conversion time
230 17 ttsou
- Elapsed time base...                 1.147449 secs
231 17 ttsou
- Validating SSE conversion results... PASS
232 17 ttsou
- Measuring conversion time
233 17 ttsou
- Elapsed time SSE ...                 0.347838 secs
234 17 ttsou
- Quotient...                          3.298803
235 17 ttsou
}}}
236 17 ttsou
237 17 ttsou
{{{
238 17 ttsou
[+] Testing: GSM TCH/AFS 7.95 (recursive, flushed, punctured)
239 17 ttsou
[.] Input length  : ret = 165  exp = 165 -> OK
240 17 ttsou
[.] Output length : ret = 448  exp = 448 -> OK
241 17 ttsou
[.] Pre computed vector checks:
242 17 ttsou
[..] Encoding: OK
243 17 ttsou
[..] Decoding base: 
244 17 ttsou
[..] Decoding SIMD: 
245 17 ttsou
[..] Code N 3
246 17 ttsou
[..] Code K 7
247 17 ttsou
OK
248 17 ttsou
[.] Random vector checks:
249 17 ttsou
[.] Testing baseline:
250 17 ttsou
[..] Encoding / Decoding 10000 cycles:
251 17 ttsou
[.] Elapsed time........................ 11.822688 secs
252 17 ttsou
[.] Rate................................ 0.378932 Mbps
253 17 ttsou
[.] Testing SIMD:
254 17 ttsou
[..] Encoding / Decoding 10000 cycles:
255 17 ttsou
[.] Elapsed time........................ 0.550423 secs
256 17 ttsou
[.] Rate................................ 8.139195 Mbps
257 17 ttsou
[.] Speedup............................. 21.479277
258 17 ttsou
}}}
259 17 ttsou
260 17 ttsou
'''!ArndaleBoard (ARM Cortex-A15 1.7 GHz)'''
261 17 ttsou
{{{
262 17 ttsou
--- Floating point to integer conversions
263 17 ttsou
-- Testing 40000 iterations of 3120 values
264 17 ttsou
- Measuring conversion time
265 17 ttsou
- Elapsed time base...                 0.384097 secs
266 17 ttsou
- Validating SSE conversion results... PASS
267 17 ttsou
- Measuring conversion time
268 17 ttsou
- Elapsed time SSE ...                 0.100877 secs
269 17 ttsou
- Quotient...                          3.807578
270 17 ttsou
}}}
271 17 ttsou
272 17 ttsou
{{{
273 17 ttsou
[+] Testing: GSM TCH/AFS 7.95 (recursive, flushed, punctured)
274 17 ttsou
[.] Input length  : ret = 165  exp = 165 -> OK
275 17 ttsou
[.] Output length : ret = 448  exp = 448 -> OK
276 17 ttsou
[.] Pre computed vector checks:
277 17 ttsou
[..] Encoding: OK
278 17 ttsou
[..] Decoding base: 
279 17 ttsou
[..] Decoding SIMD: 
280 17 ttsou
[..] Code N 3
281 17 ttsou
[..] Code K 7
282 17 ttsou
OK
283 17 ttsou
[.] Random vector checks:
284 17 ttsou
[.] Testing baseline:
285 17 ttsou
[..] Encoding / Decoding 10000 cycles:
286 17 ttsou
[.] Elapsed time........................ 5.371288 secs
287 17 ttsou
[.] Rate................................ 0.834064 Mbps
288 17 ttsou
[.] Testing SIMD:
289 17 ttsou
[..] Encoding / Decoding 10000 cycles:
290 17 ttsou
[.] Elapsed time........................ 1.016621 secs
291 17 ttsou
[.] Rate................................ 4.406755 Mbps
292 17 ttsou
[.] Speedup............................. 5.283471
293 17 ttsou
}}}
294 17 ttsou
295 17 ttsou
'''!BeagleBoard-xM (ARM Cortex-A8 800 MHz)'''
296 17 ttsou
{{{
297 17 ttsou
--- Floating point to integer conversions
298 17 ttsou
-- Testing 40000 iterations of 3120 values
299 17 ttsou
- Measuring conversion time
300 3 ttsou
- Elapsed time base...                  6.292542 secs
301 3 ttsou
- Validating SIMD conversion results... PASS
302 3 ttsou
- Measuring conversion time
303 3 ttsou
- Elapsed time SIMD ...                 0.839081 secs
304 3 ttsou
- Quotient...                           7.499326
305 3 ttsou
}}}
306 3 ttsou
307 3 ttsou
{{{
308 3 ttsou
[+] Testing: GSM TCH/AFS 7.95 (recursive, flushed, punctured)
309 5 ttsou
[.] Input length  : ret = 165  exp = 165 -> OK
310 3 ttsou
[.] Output length : ret = 448  exp = 448 -> OK
311 3 ttsou
[.] Pre computed vector checks:
312 3 ttsou
[..] Encoding: OK
313 4 ttsou
[..] Decoding base: 
314 3 ttsou
[..] Decoding SIMD: 
315 3 ttsou
[..] Code N 3
316 3 ttsou
[..] Code K 7
317 3 ttsou
OK
318 3 ttsou
[.] Random vector checks:
319 3 ttsou
[.] Testing baseline:
320 3 ttsou
[..] Encoding / Decoding 10000 cycles:
321 3 ttsou
[.] Elapsed time........................ 21.963257 secs
322 3 ttsou
[.] Rate................................ 0.203977 Mbps
323 3 ttsou
[.] Testing SIMD:
324 1 ttsou
[..] Encoding / Decoding 10000 cycles:
325 3 ttsou
[.] Elapsed time........................ 3.083282 secs
326 3 ttsou
[.] Rate................................ 1.452997 Mbps
327 3 ttsou
[.] Speedup............................. 7.123337
328 3 ttsou
}}}
329 3 ttsou
330 1 ttsou
== Authors ==
331 1 ttsou
332 17 ttsou
OsmoTRX is currently developed and maintained by Thomas Tsou. The code is derived from the OpenBTS project, which was originally developed by David Burgess and Harvind Samra at Range Networks.
Add picture from clipboard (Maximum size: 48.8 MB)