Project

General

Profile

OsmoTRX » History » Version 17

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 9 ttsou
||Platform||Processor||SIMD/FPU||
69 17 ttsou
||!BeagleBoard-xM||ARM Cortex-A8||NEON||
70 17 ttsou
||!ArndaleBoard||ARM Cortex-A15||NEON-VFPv4||
71 17 ttsou
||!RaspberryPi||ARMv6k||VFP||
72 1 ttsou
||Shuttle PC||Intel Atom D2550||SSE3||
73 1 ttsou
||Ettus E100||ARM Cortex-A8||NEON||
74 1 ttsou
75 1 ttsou
== Mailing List ==
76 1 ttsou
77 1 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. Subscription information is available at [https://lists.sourceforge.net/lists/listinfo/openbts-discuss] and [http://lists.osmocom.org/mailman/listinfo/openbsc/]. Please direct questions to the list appropriate for the GSM stack being used.
78 1 ttsou
79 16 ttsou
== Status ==
80 16 ttsou
81 16 ttsou
== GPRS support ==
82 16 ttsou
83 16 ttsou
== Source code ==
84 16 ttsou
85 16 ttsou
The source code is available from git.osmocom.org (module osmo-trx).
86 16 ttsou
87 16 ttsou
Public read-only access is available via
88 16 ttsou
 git clone git://git.osmocom.org/osmo-trx
89 16 ttsou
You can browse it via cgit: http://cgit.osmocom.org/cgit/osmo-trx/
90 16 ttsou
91 16 ttsou
== Configuration and Build ==
92 16 ttsou
93 16 ttsou
The only package dependency is the Universal Hardware Driver (UHD).
94 16 ttsou
95 16 ttsou
{{{
96 16 ttsou
$ ./configure
97 16 ttsou
$ make
98 16 ttsou
$ sudo make install
99 16 ttsou
}}}
100 16 ttsou
101 16 ttsou
== Running ==
102 16 ttsou
103 16 ttsou
{{{
104 16 ttsou
$ osmo-trx -h
105 16 ttsou
linux; GNU C++ version 4.8.1 20130603 (Red Hat 4.8.1-1); Boost_105300; UHD_003.005.004-140-gfb32ed16
106 16 ttsou
107 16 ttsou
Options:
108 16 ttsou
  -h    This text
109 16 ttsou
  -a    UHD device args
110 16 ttsou
  -l    Logging level (EMERG, ALERT, CRT, ERR, WARNING, NOTICE, INFO, DEBUG)
111 16 ttsou
  -i    IP address of GSM core
112 16 ttsou
  -p    Base port number
113 16 ttsou
  -d    Enable dual channel diversity receiver
114 16 ttsou
  -x    Enable external 10 MHz reference
115 16 ttsou
  -s    Samples-per-symbol (1 or 4)
116 16 ttsou
  -c    Number of ARFCN channels (default=1)
117 16 ttsou
}}}
118 16 ttsou
119 16 ttsou
{{{
120 16 ttsou
$ osmo-trx -a "addr=192.168.10.2"
121 16 ttsou
linux; GNU C++ version 4.8.1 20130603 (Red Hat 4.8.1-1); Boost_105300; UHD_003.004.000-b14cde5
122 16 ttsou
123 16 ttsou
Config Settings
124 16 ttsou
   Log Level............... INFO
125 16 ttsou
   Device args............. addr=192.168.10.2
126 16 ttsou
   TRX Base Port........... 5700
127 16 ttsou
   TRX Address............. 127.0.0.1
128 16 ttsou
   Channels................ 1
129 16 ttsou
   Samples-per-Symbol...... 4
130 16 ttsou
   External Reference...... Disabled
131 16 ttsou
   Diversity............... Disabled
132 16 ttsou
133 16 ttsou
-- Opening a UmTRX device...
134 16 ttsou
-- Current recv frame size: 1472 bytes
135 16 ttsou
-- Current send frame size: 1472 bytes
136 16 ttsou
-- Setting UmTRX 4 SPS
137 16 ttsou
-- Transceiver active with 1 channel(s)
138 16 ttsou
}}}
139 16 ttsou
140 13 ttsou
== Benchmarks ==
141 13 ttsou
142 13 ttsou
Selected benchmark results are provided below. All tests run on a single core only.
143 13 ttsou
144 17 ttsou
'''Intel Haswell (i7 4770K 3.5 GHz)'''
145 13 ttsou
146 13 ttsou
{{{
147 13 ttsou
--- Floating point to integer conversions
148 13 ttsou
-- Testing 40000 iterations of 3120 values
149 13 ttsou
- Measuring conversion time
150 13 ttsou
- Elapsed time base...                  0.065508 secs
151 13 ttsou
- Validating SIMD conversion results... PASS
152 10 ttsou
- Measuring conversion time
153 10 ttsou
- Elapsed time SIMD ...                 0.011424 secs
154 1 ttsou
- Speedup...                            5.734244
155 1 ttsou
}}}
156 1 ttsou
157 1 ttsou
{{{
158 1 ttsou
[+] Testing: GSM TCH/AFS 7.95 (recursive, flushed, punctured)
159 1 ttsou
[.] Input length  : ret = 165  exp = 165 -> OK
160 1 ttsou
[.] Output length : ret = 448  exp = 448 -> OK
161 1 ttsou
[.] Pre computed vector checks:
162 1 ttsou
[..] Encoding: OK
163 1 ttsou
[..] Decoding base: 
164 1 ttsou
[..] Decoding SIMD: 
165 1 ttsou
[..] Code N 3
166 3 ttsou
[..] Code K 7
167 3 ttsou
OK
168 3 ttsou
[.] Random vector checks:
169 3 ttsou
[.] Testing baseline:
170 3 ttsou
[..] Encoding / Decoding 10000 cycles:
171 3 ttsou
[.] Elapsed time........................ 1.435066 secs
172 3 ttsou
[.] Rate................................ 3.121808 Mbps
173 3 ttsou
[.] Testing SIMD:
174 3 ttsou
[..] Encoding / Decoding 10000 cycles:
175 3 ttsou
[.] Elapsed time........................ 0.073524 secs
176 3 ttsou
[.] Rate................................ 60.932485 Mbps
177 3 ttsou
[.] Speedup............................. 19.518334
178 1 ttsou
}}}
179 1 ttsou
180 17 ttsou
'''Intel Atom (D2500 1.86 GHz)'''
181 1 ttsou
{{{
182 1 ttsou
--- Floating point to integer conversions
183 1 ttsou
-- Testing 40000 iterations of 3120 values
184 1 ttsou
- Measuring conversion time
185 17 ttsou
- Elapsed time base...                 1.147449 secs
186 17 ttsou
- Validating SSE conversion results... PASS
187 17 ttsou
- Measuring conversion time
188 17 ttsou
- Elapsed time SSE ...                 0.347838 secs
189 17 ttsou
- Quotient...                          3.298803
190 17 ttsou
}}}
191 17 ttsou
192 17 ttsou
{{{
193 17 ttsou
[+] Testing: GSM TCH/AFS 7.95 (recursive, flushed, punctured)
194 17 ttsou
[.] Input length  : ret = 165  exp = 165 -> OK
195 17 ttsou
[.] Output length : ret = 448  exp = 448 -> OK
196 17 ttsou
[.] Pre computed vector checks:
197 17 ttsou
[..] Encoding: OK
198 17 ttsou
[..] Decoding base: 
199 17 ttsou
[..] Decoding SIMD: 
200 17 ttsou
[..] Code N 3
201 17 ttsou
[..] Code K 7
202 17 ttsou
OK
203 17 ttsou
[.] Random vector checks:
204 17 ttsou
[.] Testing baseline:
205 17 ttsou
[..] Encoding / Decoding 10000 cycles:
206 17 ttsou
[.] Elapsed time........................ 11.822688 secs
207 17 ttsou
[.] Rate................................ 0.378932 Mbps
208 17 ttsou
[.] Testing SIMD:
209 17 ttsou
[..] Encoding / Decoding 10000 cycles:
210 17 ttsou
[.] Elapsed time........................ 0.550423 secs
211 17 ttsou
[.] Rate................................ 8.139195 Mbps
212 17 ttsou
[.] Speedup............................. 21.479277
213 17 ttsou
}}}
214 17 ttsou
215 17 ttsou
'''!ArndaleBoard (ARM Cortex-A15 1.7 GHz)'''
216 17 ttsou
{{{
217 17 ttsou
--- Floating point to integer conversions
218 17 ttsou
-- Testing 40000 iterations of 3120 values
219 17 ttsou
- Measuring conversion time
220 17 ttsou
- Elapsed time base...                 0.384097 secs
221 17 ttsou
- Validating SSE conversion results... PASS
222 17 ttsou
- Measuring conversion time
223 17 ttsou
- Elapsed time SSE ...                 0.100877 secs
224 17 ttsou
- Quotient...                          3.807578
225 17 ttsou
}}}
226 17 ttsou
227 17 ttsou
{{{
228 17 ttsou
[+] Testing: GSM TCH/AFS 7.95 (recursive, flushed, punctured)
229 17 ttsou
[.] Input length  : ret = 165  exp = 165 -> OK
230 17 ttsou
[.] Output length : ret = 448  exp = 448 -> OK
231 17 ttsou
[.] Pre computed vector checks:
232 17 ttsou
[..] Encoding: OK
233 17 ttsou
[..] Decoding base: 
234 17 ttsou
[..] Decoding SIMD: 
235 17 ttsou
[..] Code N 3
236 17 ttsou
[..] Code K 7
237 17 ttsou
OK
238 17 ttsou
[.] Random vector checks:
239 17 ttsou
[.] Testing baseline:
240 17 ttsou
[..] Encoding / Decoding 10000 cycles:
241 17 ttsou
[.] Elapsed time........................ 5.371288 secs
242 17 ttsou
[.] Rate................................ 0.834064 Mbps
243 17 ttsou
[.] Testing SIMD:
244 17 ttsou
[..] Encoding / Decoding 10000 cycles:
245 17 ttsou
[.] Elapsed time........................ 1.016621 secs
246 17 ttsou
[.] Rate................................ 4.406755 Mbps
247 17 ttsou
[.] Speedup............................. 5.283471
248 17 ttsou
}}}
249 17 ttsou
250 17 ttsou
'''!BeagleBoard-xM (ARM Cortex-A8 800 MHz)'''
251 17 ttsou
{{{
252 17 ttsou
--- Floating point to integer conversions
253 17 ttsou
-- Testing 40000 iterations of 3120 values
254 17 ttsou
- Measuring conversion time
255 3 ttsou
- Elapsed time base...                  6.292542 secs
256 3 ttsou
- Validating SIMD conversion results... PASS
257 3 ttsou
- Measuring conversion time
258 3 ttsou
- Elapsed time SIMD ...                 0.839081 secs
259 3 ttsou
- Quotient...                           7.499326
260 3 ttsou
}}}
261 3 ttsou
262 3 ttsou
{{{
263 3 ttsou
[+] Testing: GSM TCH/AFS 7.95 (recursive, flushed, punctured)
264 5 ttsou
[.] Input length  : ret = 165  exp = 165 -> OK
265 3 ttsou
[.] Output length : ret = 448  exp = 448 -> OK
266 3 ttsou
[.] Pre computed vector checks:
267 3 ttsou
[..] Encoding: OK
268 4 ttsou
[..] Decoding base: 
269 3 ttsou
[..] Decoding SIMD: 
270 3 ttsou
[..] Code N 3
271 3 ttsou
[..] Code K 7
272 3 ttsou
OK
273 3 ttsou
[.] Random vector checks:
274 3 ttsou
[.] Testing baseline:
275 3 ttsou
[..] Encoding / Decoding 10000 cycles:
276 3 ttsou
[.] Elapsed time........................ 21.963257 secs
277 3 ttsou
[.] Rate................................ 0.203977 Mbps
278 3 ttsou
[.] Testing SIMD:
279 1 ttsou
[..] Encoding / Decoding 10000 cycles:
280 3 ttsou
[.] Elapsed time........................ 3.083282 secs
281 3 ttsou
[.] Rate................................ 1.452997 Mbps
282 3 ttsou
[.] Speedup............................. 7.123337
283 3 ttsou
}}}
284 3 ttsou
285 1 ttsou
== Authors ==
286 1 ttsou
287 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)