Project

General

Profile

OsmoTRX » History » Version 16

ttsou, 02/19/2016 10:47 PM

1 1 ttsou
= OsmoTRX =
2
3
OsmoTRX is a software-defined radio transceiver that implements the Layer 1 physical layer of a BTS comprising the following 3GPP specifications:
4
 * TS 05.01 "Physical layer on the radio path"
5
 * TS 05.02 "Multiplexing and Multiple Access on the Radio Path"
6
 * TS 05.04 "Modulation"
7
 * TS 05.10 "Radio subsystem synchronization"
8
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
11
== Features ==
12
13 16 ttsou
'''Intel SSE Support'''
14 6 ttsou
* SSE3
15
* SSE4.1
16
17
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
19 16 ttsou
'''ARM NEON Support'''
20 6 ttsou
* NEON
21
* NEON-VFPv4
22
23 1 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 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
path of the dual channel device - currently only UmTRX - supports a different ARFCN. Each path operates independently a
29
nd operates similarly to two separate devices. GSM channel capacity in this mode is doubled.
30
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
43
Frequency Spectrum (Ettus Research N200)
44
45
[[Image(http://tsou.cc/gsm/osmo-trx-spectrum75.gif)]]
46
47 1 ttsou
== Hardware support ==
48
49 9 ttsou
Fairwaves
50
||UmTRX||
51
52 1 ttsou
Ettus Research
53
||USRP1||
54
||USRP2||
55
||B100||
56
||B110||
57
||B200||
58
||B210||
59
||N200||
60
||N210||
61
||E100||
62
||E110||
63
64
== Embedded Platform Support ==
65
66
OsmoTRX has been tested on the following embedded platforms.
67
68 9 ttsou
||Platform||Processor||SIMD/FPU||
69 1 ttsou
||BeagleBoard-xM||ARM Cortex-A8||NEON||
70
||ArndaleBoard||ARM Cortex-A15||NEON-VFPv4||
71 2 ttsou
||RaspberryPi||ARMv6k||VFP||
72 1 ttsou
||Shuttle PC||Intel Atom D2550||SSE3||
73
||Ettus E100||ARM Cortex-A8||NEON||
74
75
== Mailing List ==
76
77
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
79 16 ttsou
== Status ==
80
81
== GPRS support ==
82
83
== Source code ==
84
85
The source code is available from git.osmocom.org (module osmo-trx).
86
87
Public read-only access is available via
88
 git clone git://git.osmocom.org/osmo-trx
89
You can browse it via cgit: http://cgit.osmocom.org/cgit/osmo-trx/
90
91
== Configuration and Build ==
92
93
The only package dependency is the Universal Hardware Driver (UHD).
94
95
{{{
96
$ ./configure
97
$ make
98
$ sudo make install
99
}}}
100
101
== Running ==
102
103
{{{
104
$ osmo-trx -h
105
linux; GNU C++ version 4.8.1 20130603 (Red Hat 4.8.1-1); Boost_105300; UHD_003.005.004-140-gfb32ed16
106
107
Options:
108
  -h    This text
109
  -a    UHD device args
110
  -l    Logging level (EMERG, ALERT, CRT, ERR, WARNING, NOTICE, INFO, DEBUG)
111
  -i    IP address of GSM core
112
  -p    Base port number
113
  -d    Enable dual channel diversity receiver
114
  -x    Enable external 10 MHz reference
115
  -s    Samples-per-symbol (1 or 4)
116
  -c    Number of ARFCN channels (default=1)
117
}}}
118
119
{{{
120
$ osmo-trx -a "addr=192.168.10.2"
121
linux; GNU C++ version 4.8.1 20130603 (Red Hat 4.8.1-1); Boost_105300; UHD_003.004.000-b14cde5
122
123
Config Settings
124
   Log Level............... INFO
125
   Device args............. addr=192.168.10.2
126
   TRX Base Port........... 5700
127
   TRX Address............. 127.0.0.1
128
   Channels................ 1
129
   Samples-per-Symbol...... 4
130
   External Reference...... Disabled
131
   Diversity............... Disabled
132
133
-- Opening a UmTRX device...
134
-- Current recv frame size: 1472 bytes
135
-- Current send frame size: 1472 bytes
136
-- Setting UmTRX 4 SPS
137
-- Transceiver active with 1 channel(s)
138
}}}
139
140 13 ttsou
== Benchmarks ==
141
142
Selected benchmark results are provided below. All tests run on a single core only.
143
144
Intel Haswell (i7 4770K 3.5 GHz)
145
146
{{{
147
--- Floating point to integer conversions
148
-- Testing 40000 iterations of 3120 values
149
- Measuring conversion time
150
- Elapsed time base...                  0.065508 secs
151
- Validating SIMD conversion results... PASS
152 10 ttsou
- Measuring conversion time
153
- Elapsed time SIMD ...                 0.011424 secs
154 1 ttsou
- Speedup...                            5.734244
155
}}}
156
157
{{{
158
[+] Testing: GSM TCH/AFS 7.95 (recursive, flushed, punctured)
159
[.] Input length  : ret = 165  exp = 165 -> OK
160
[.] Output length : ret = 448  exp = 448 -> OK
161
[.] Pre computed vector checks:
162
[..] Encoding: OK
163
[..] Decoding base: 
164
[..] Decoding SIMD: 
165
[..] Code N 3
166 3 ttsou
[..] Code K 7
167
OK
168
[.] Random vector checks:
169
[.] Testing baseline:
170
[..] Encoding / Decoding 10000 cycles:
171
[.] Elapsed time........................ 1.435066 secs
172
[.] Rate................................ 3.121808 Mbps
173
[.] Testing SIMD:
174
[..] Encoding / Decoding 10000 cycles:
175
[.] Elapsed time........................ 0.073524 secs
176
[.] Rate................................ 60.932485 Mbps
177
[.] Speedup............................. 19.518334
178
}}}
179
180
BeagleBoard-xM (ARM Cortex-A8 800 MHz)
181
{{{
182
--- Floating point to integer conversions
183
-- Testing 40000 iterations of 3120 values
184
- Measuring conversion time
185
- Elapsed time base...                  6.292542 secs
186
- Validating SIMD conversion results... PASS
187
- Measuring conversion time
188
- Elapsed time SIMD ...                 0.839081 secs
189
- Quotient...                           7.499326
190
}}}
191
192
{{{
193
[+] Testing: GSM TCH/AFS 7.95 (recursive, flushed, punctured)
194
[.] Input length  : ret = 165  exp = 165 -> OK
195 5 ttsou
[.] Output length : ret = 448  exp = 448 -> OK
196 3 ttsou
[.] Pre computed vector checks:
197
[..] Encoding: OK
198
[..] Decoding base: 
199 4 ttsou
[..] Decoding SIMD: 
200 3 ttsou
[..] Code N 3
201
[..] Code K 7
202
OK
203
[.] Random vector checks:
204
[.] Testing baseline:
205
[..] Encoding / Decoding 10000 cycles:
206
[.] Elapsed time........................ 21.963257 secs
207
[.] Rate................................ 0.203977 Mbps
208
[.] Testing SIMD:
209
[..] Encoding / Decoding 10000 cycles:
210
[.] Elapsed time........................ 3.083282 secs
211
[.] Rate................................ 1.452997 Mbps
212
[.] Speedup............................. 7.123337
213
}}}
214
215 1 ttsou
== Authors ==
216
217
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)