Project

General

Profile

OsmoTRX » History » Version 19

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 19 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 performance and benchmarks section.
18 6 ttsou
19 16 ttsou
'''ARM NEON Support'''
20 6 ttsou
* NEON
21 6 ttsou
* NEON-VFPv4
22 6 ttsou
23 19 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). Loosely speaking, these platforms are representative of low cost embedded devices, mid-level handsets, and high-end smartphones respectively. Similarly, in order, these platforms include no NEON coprocessor, standard NEON, and NEON-VFPv4. The latter NEON variation, VFPv4, provides additional fused-multiply-accumulate (FMA) instructions useful for many DSP operations. For additional performance information, please see the performance and benchmarks section.
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 18 ttsou
75 1 ttsou
76 1 ttsou
== Mailing List ==
77 1 ttsou
78 19 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.
79 1 ttsou
80 19 ttsou
Please direct questions to the list appropriate for the GSM stack being used.
81 19 ttsou
82 18 ttsou
Subscription information is available at [https://lists.sourceforge.net/lists/listinfo/openbts-discuss] and [http://lists.osmocom.org/mailman/listinfo/openbsc/].
83 1 ttsou
84 1 ttsou
== GPRS support ==
85 1 ttsou
86 19 ttsou
OsmoTRX supports GPRS through OsmoBTS.
87 16 ttsou
88 19 ttsou
For GPRS support with OpenBTS, please use the transceiver supplied with OpenBTS.
89 19 ttsou
90 16 ttsou
== Source code ==
91 1 ttsou
92 16 ttsou
The source code is available from git.osmocom.org (module osmo-trx).
93 1 ttsou
94 1 ttsou
Public read-only access is available via
95 1 ttsou
 git clone git://git.osmocom.org/osmo-trx
96 16 ttsou
You can browse it via cgit: http://cgit.osmocom.org/cgit/osmo-trx/
97 1 ttsou
98 1 ttsou
== Configuration and Build ==
99 1 ttsou
100 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.
101 1 ttsou
102 18 ttsou
'''Intel Platforms (All)'''
103 18 ttsou
104 19 ttsou
Intel SSE support is automatically detected on Intel x86 platforms. No user intervention is necessary. The general configuration defaults to the low phase error modulator. Atom users may wish to use the low-CPU utilization modulator, which can be later enabled from the command line at runtime.
105 1 ttsou
{{{
106 1 ttsou
$ ./configure
107 18 ttsou
...
108 18 ttsou
checking whether mmx is supported... yes
109 18 ttsou
checking whether sse is supported... yes
110 18 ttsou
checking whether sse2 is supported... yes
111 18 ttsou
checking whether sse3 is supported... yes
112 18 ttsou
checking whether ssse3 is supported... yes
113 1 ttsou
checking whether sse4.1 is supported... yes
114 18 ttsou
checking whether sse4.2 is supported... yes
115 18 ttsou
...
116 18 ttsou
}}}
117 18 ttsou
118 18 ttsou
'''ARM Platforms with NEON'''
119 1 ttsou
120 19 ttsou
Many popular ARM development boards fall under this category including !BeagleBoard, !PandaBoard, and Ettus E100 USRP. This option will disable the low phase error modulator, which can be re-enabled at runtime. NEON support must be manually enabled.
121 18 ttsou
{{{
122 18 ttsou
$ ./configure --with-neon
123 18 ttsou
}}}
124 18 ttsou
125 18 ttsou
'''ARM Platforms with NEON-VFPv4'''
126 18 ttsou
127 19 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. This option will disable the low phase error modulator, which can be re-enabled at runtime. NEON-VFPv4 support must be manually enabled.
128 18 ttsou
{{{
129 18 ttsou
$ ./configure --with-neon-vfpv4
130 18 ttsou
}}}
131 18 ttsou
132 18 ttsou
'''ARM Platforms without NEON'''
133 18 ttsou
134 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.
135 18 ttsou
136 18 ttsou
Coming soon.
137 18 ttsou
138 18 ttsou
'''Build and Install'''
139 18 ttsou
140 1 ttsou
After configuration, installation is simple.
141 18 ttsou
142 18 ttsou
{{{
143 16 ttsou
$ make
144 16 ttsou
$ sudo make install
145 16 ttsou
}}}
146 16 ttsou
147 16 ttsou
== Running ==
148 18 ttsou
149 19 ttsou
OsmoTRX can be configured with a variety of options on the command line. In most cases, the default settings will suffice. Notable options include UHD device argument passing, which is often useful for using network based devices with firewalls, and external 10 MHz reference support.
150 16 ttsou
151 16 ttsou
{{{
152 16 ttsou
$ osmo-trx -h
153 16 ttsou
linux; GNU C++ version 4.8.1 20130603 (Red Hat 4.8.1-1); Boost_105300; UHD_003.005.004-140-gfb32ed16
154 16 ttsou
155 16 ttsou
Options:
156 16 ttsou
  -h    This text
157 16 ttsou
  -a    UHD device args
158 16 ttsou
  -l    Logging level (EMERG, ALERT, CRT, ERR, WARNING, NOTICE, INFO, DEBUG)
159 16 ttsou
  -i    IP address of GSM core
160 16 ttsou
  -p    Base port number
161 16 ttsou
  -d    Enable dual channel diversity receiver
162 16 ttsou
  -x    Enable external 10 MHz reference
163 16 ttsou
  -s    Samples-per-symbol (1 or 4)
164 16 ttsou
  -c    Number of ARFCN channels (default=1)
165 16 ttsou
}}}
166 16 ttsou
167 16 ttsou
{{{
168 16 ttsou
$ osmo-trx -a "addr=192.168.10.2"
169 16 ttsou
linux; GNU C++ version 4.8.1 20130603 (Red Hat 4.8.1-1); Boost_105300; UHD_003.004.000-b14cde5
170 16 ttsou
171 16 ttsou
Config Settings
172 16 ttsou
   Log Level............... INFO
173 16 ttsou
   Device args............. addr=192.168.10.2
174 16 ttsou
   TRX Base Port........... 5700
175 16 ttsou
   TRX Address............. 127.0.0.1
176 16 ttsou
   Channels................ 1
177 16 ttsou
   Samples-per-Symbol...... 4
178 16 ttsou
   External Reference...... Disabled
179 16 ttsou
   Diversity............... Disabled
180 1 ttsou
181 16 ttsou
-- Opening a UmTRX device...
182 1 ttsou
-- Current recv frame size: 1472 bytes
183 1 ttsou
-- Current send frame size: 1472 bytes
184 16 ttsou
-- Setting UmTRX 4 SPS
185 16 ttsou
-- Transceiver active with 1 channel(s)
186 16 ttsou
}}}
187 16 ttsou
188 16 ttsou
== Benchmarks ==
189 16 ttsou
190 19 ttsou
A variety of performance benchmarks are available for various code optimizations. These include floating point - integer conversions, convolution, and convolutional decoding. Note that convolutional decoding does not take place in OsmoTRX, but one stop higher in the Layer 1 stack - either in OsmoBTS or OpenBTS core.
191 13 ttsou
192 19 ttsou
Selected benchmark results are provided below. All tests are run on a single core only.
193 19 ttsou
194 17 ttsou
'''Intel Haswell (i7 4770K 3.5 GHz)'''
195 13 ttsou
196 13 ttsou
{{{
197 13 ttsou
--- Floating point to integer conversions
198 13 ttsou
-- Testing 40000 iterations of 3120 values
199 13 ttsou
- Measuring conversion time
200 13 ttsou
- Elapsed time base...                  0.065508 secs
201 13 ttsou
- Validating SIMD conversion results... PASS
202 10 ttsou
- Measuring conversion time
203 10 ttsou
- Elapsed time SIMD ...                 0.011424 secs
204 1 ttsou
- Speedup...                            5.734244
205 1 ttsou
}}}
206 1 ttsou
207 1 ttsou
{{{
208 1 ttsou
[+] Testing: GSM TCH/AFS 7.95 (recursive, flushed, punctured)
209 1 ttsou
[.] Input length  : ret = 165  exp = 165 -> OK
210 1 ttsou
[.] Output length : ret = 448  exp = 448 -> OK
211 1 ttsou
[.] Pre computed vector checks:
212 1 ttsou
[..] Encoding: OK
213 1 ttsou
[..] Decoding base: 
214 1 ttsou
[..] Decoding SIMD: 
215 1 ttsou
[..] Code N 3
216 3 ttsou
[..] Code K 7
217 3 ttsou
OK
218 3 ttsou
[.] Random vector checks:
219 3 ttsou
[.] Testing baseline:
220 3 ttsou
[..] Encoding / Decoding 10000 cycles:
221 3 ttsou
[.] Elapsed time........................ 1.435066 secs
222 3 ttsou
[.] Rate................................ 3.121808 Mbps
223 3 ttsou
[.] Testing SIMD:
224 3 ttsou
[..] Encoding / Decoding 10000 cycles:
225 3 ttsou
[.] Elapsed time........................ 0.073524 secs
226 3 ttsou
[.] Rate................................ 60.932485 Mbps
227 3 ttsou
[.] Speedup............................. 19.518334
228 1 ttsou
}}}
229 1 ttsou
230 17 ttsou
'''Intel Atom (D2500 1.86 GHz)'''
231 1 ttsou
{{{
232 1 ttsou
--- Floating point to integer conversions
233 1 ttsou
-- Testing 40000 iterations of 3120 values
234 1 ttsou
- Measuring conversion time
235 17 ttsou
- Elapsed time base...                 1.147449 secs
236 17 ttsou
- Validating SSE conversion results... PASS
237 17 ttsou
- Measuring conversion time
238 17 ttsou
- Elapsed time SSE ...                 0.347838 secs
239 17 ttsou
- Quotient...                          3.298803
240 17 ttsou
}}}
241 17 ttsou
242 17 ttsou
{{{
243 17 ttsou
[+] Testing: GSM TCH/AFS 7.95 (recursive, flushed, punctured)
244 17 ttsou
[.] Input length  : ret = 165  exp = 165 -> OK
245 17 ttsou
[.] Output length : ret = 448  exp = 448 -> OK
246 17 ttsou
[.] Pre computed vector checks:
247 17 ttsou
[..] Encoding: OK
248 17 ttsou
[..] Decoding base: 
249 17 ttsou
[..] Decoding SIMD: 
250 17 ttsou
[..] Code N 3
251 17 ttsou
[..] Code K 7
252 17 ttsou
OK
253 17 ttsou
[.] Random vector checks:
254 17 ttsou
[.] Testing baseline:
255 17 ttsou
[..] Encoding / Decoding 10000 cycles:
256 1 ttsou
[.] Elapsed time........................ 11.822688 secs
257 1 ttsou
[.] Rate................................ 0.378932 Mbps
258 1 ttsou
[.] Testing SIMD:
259 17 ttsou
[..] Encoding / Decoding 10000 cycles:
260 17 ttsou
[.] Elapsed time........................ 0.550423 secs
261 17 ttsou
[.] Rate................................ 8.139195 Mbps
262 17 ttsou
[.] Speedup............................. 21.479277
263 17 ttsou
}}}
264 17 ttsou
265 17 ttsou
'''!ArndaleBoard (ARM Cortex-A15 1.7 GHz)'''
266 19 ttsou
267 19 ttsou
Please note that the Viterbi implementations on ARM is largely C based with speedup generated primarily through algorithm changes. In comparison, vector optimization on Intel platforms with SSE is currently much more aggressive, which explains the disparity on decoding performance.
268 19 ttsou
269 17 ttsou
{{{
270 17 ttsou
--- Floating point to integer conversions
271 17 ttsou
-- Testing 40000 iterations of 3120 values
272 17 ttsou
- Measuring conversion time
273 17 ttsou
- Elapsed time base...                 0.384097 secs
274 17 ttsou
- Validating SSE conversion results... PASS
275 17 ttsou
- Measuring conversion time
276 17 ttsou
- Elapsed time SSE ...                 0.100877 secs
277 17 ttsou
- Quotient...                          3.807578
278 17 ttsou
}}}
279 17 ttsou
280 17 ttsou
{{{
281 17 ttsou
[+] Testing: GSM TCH/AFS 7.95 (recursive, flushed, punctured)
282 17 ttsou
[.] Input length  : ret = 165  exp = 165 -> OK
283 17 ttsou
[.] Output length : ret = 448  exp = 448 -> OK
284 17 ttsou
[.] Pre computed vector checks:
285 17 ttsou
[..] Encoding: OK
286 17 ttsou
[..] Decoding base: 
287 17 ttsou
[..] Decoding SIMD: 
288 17 ttsou
[..] Code N 3
289 17 ttsou
[..] Code K 7
290 17 ttsou
OK
291 17 ttsou
[.] Random vector checks:
292 17 ttsou
[.] Testing baseline:
293 17 ttsou
[..] Encoding / Decoding 10000 cycles:
294 17 ttsou
[.] Elapsed time........................ 5.371288 secs
295 17 ttsou
[.] Rate................................ 0.834064 Mbps
296 17 ttsou
[.] Testing SIMD:
297 17 ttsou
[..] Encoding / Decoding 10000 cycles:
298 17 ttsou
[.] Elapsed time........................ 1.016621 secs
299 17 ttsou
[.] Rate................................ 4.406755 Mbps
300 17 ttsou
[.] Speedup............................. 5.283471
301 17 ttsou
}}}
302 17 ttsou
303 17 ttsou
'''!BeagleBoard-xM (ARM Cortex-A8 800 MHz)'''
304 17 ttsou
{{{
305 17 ttsou
--- Floating point to integer conversions
306 17 ttsou
-- Testing 40000 iterations of 3120 values
307 17 ttsou
- Measuring conversion time
308 3 ttsou
- Elapsed time base...                  6.292542 secs
309 3 ttsou
- Validating SIMD conversion results... PASS
310 3 ttsou
- Measuring conversion time
311 3 ttsou
- Elapsed time SIMD ...                 0.839081 secs
312 3 ttsou
- Quotient...                           7.499326
313 3 ttsou
}}}
314 3 ttsou
315 3 ttsou
{{{
316 3 ttsou
[+] Testing: GSM TCH/AFS 7.95 (recursive, flushed, punctured)
317 5 ttsou
[.] Input length  : ret = 165  exp = 165 -> OK
318 3 ttsou
[.] Output length : ret = 448  exp = 448 -> OK
319 3 ttsou
[.] Pre computed vector checks:
320 3 ttsou
[..] Encoding: OK
321 4 ttsou
[..] Decoding base: 
322 3 ttsou
[..] Decoding SIMD: 
323 3 ttsou
[..] Code N 3
324 3 ttsou
[..] Code K 7
325 3 ttsou
OK
326 3 ttsou
[.] Random vector checks:
327 3 ttsou
[.] Testing baseline:
328 3 ttsou
[..] Encoding / Decoding 10000 cycles:
329 3 ttsou
[.] Elapsed time........................ 21.963257 secs
330 3 ttsou
[.] Rate................................ 0.203977 Mbps
331 3 ttsou
[.] Testing SIMD:
332 1 ttsou
[..] Encoding / Decoding 10000 cycles:
333 3 ttsou
[.] Elapsed time........................ 3.083282 secs
334 3 ttsou
[.] Rate................................ 1.452997 Mbps
335 3 ttsou
[.] Speedup............................. 7.123337
336 3 ttsou
}}}
337 3 ttsou
338 1 ttsou
== Authors ==
339 1 ttsou
340 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)