Project

General

Profile

GrOsmoSDR » History » Version 69

horiz0n, 02/19/2016 10:50 PM

1 1 horiz0n
[[PageOutline]]
2
3 47 horiz0n
= osmocom Gnu Radio Blocks =
4 1 horiz0n
5 20 horiz0n
While primarily being developed for the OsmoSDR hardware, this block as well supports:
6 1 horiz0n
7 20 horiz0n
 * [http://tetra.osmocom.org/trac/wiki/Funcube_Dongle FunCube Dongle] through libgnuradio-fcd
8 50 horiz0n
 * [http://www.funcubedongle.com/?page_id=1073 FUNcube Dongle Pro+] through [https://github.com/dl1ksv/gr-fcdproplus gr-fcdproplus]
9 44 horiz0n
 * [http://sdr.osmocom.org/trac/ sysmocom OsmoSDR] Devices through [http://cgit.osmocom.org/osmo-sdr/ libosmosdr]
10 51 horiz0n
 * [http://nuand.com/ Nuand LLC bladeRF] through [https://github.com/Nuand/bladeRF libbladeRF library]
11 20 horiz0n
 * [http://greatscottgadgets.com/hackrf/ Great Scott Gadgets HackRF] through [https://github.com/mossmann/hackrf libhackrf]
12 56 horiz0n
 * [http://www.ettus.com/product Ettus USRP] Devices through [http://files.ettus.com/uhd_docs/manual/html/build.html Ettus UHD library]
13
 * [http://umtrx.org Fairwaves UmTRX] through [https://github.com/fairwaves/UHD-Fairwaves Fairwaves' fork of Ettus' UHD library]
14 61 horiz0n
 * RFSPACE [http://www.rfspace.com/RFSPACE/SDR-IQ.html SDR-IQ], [http://www.rfspace.com/RFSPACE/SDR-IP.html SDR-IP], [http://rfspace.com/RFSPACE/NetSDR.html NetSDR] [http://www.rfspace.com/RFSPACE/NetSDR-X2.html (incl. X2 option)]
15 20 horiz0n
 * RTL2832U based DVB-T dongles through [http://sdr.osmocom.org/trac/wiki/rtl-sdr librtlsdr]
16
 * RTL-TCP spectrum server (see librtlsdr project)
17
 * MSi2500 based DVB-T dongles through [http://cgit.osmocom.org/libmirisdr/ libmirisdr]
18 69 horiz0n
 * [http://www.airspy.com/ AirSpy R820t] dongles through [https://github.com/airspy/host libairspy]
19 42 horiz0n
 * gnuradio .cfile input through libgnuradio-blocks
20 20 horiz0n
21
By using the OsmoSDR block you can take advantage of a common software api in your application(s) independent of the underlying radio hardware.
22
23 1 horiz0n
== Build process ==
24
25 48 horiz0n
'''The Gnu Radio block requires a recent gnuradio (>= v3.7 if building master branch or 3.6.5 when building gr3.6 branch) to be installed.'''
26 20 horiz0n
27 43 horiz0n
Before building the block you have to make sure that all the dependencies (see list of supported devices above) you are intend to work with are properly installed. The build system of gr-osmosdr will recognize them and enable specific source/sink components thereafter.
28 1 horiz0n
29
Please note: prior pulling a new version from git and compiling it, please do a "make uninstall" first to properly remove the previous version.
30
31
Building with cmake:
32 30 horiz0n
33 1 horiz0n
{{{
34
git clone git://git.osmocom.org/gr-osmosdr
35
cd gr-osmosdr/
36 48 horiz0n
}}}
37
38
If you are building for gnuradio 3.6 series, you have to switch to the gr3.6 branch as follows
39
{{{
40
git checkout gr3.6
41
}}}
42
43 51 horiz0n
then continue with
44 48 horiz0n
{{{
45 1 horiz0n
mkdir build
46
cd build/
47 14 horiz0n
cmake ../
48 30 horiz0n
}}}
49
50 34 horiz0n
Now cmake should print out a summary of enabled/disabled components. You may disable certain components by following guidelines shown by cmake. Make sure the device of your interest is listed here. Check your dependencies and retry otherwise.
51 30 horiz0n
{{{
52
-- ######################################################
53
-- # gr-osmosdr enabled components                         
54
-- ######################################################
55
--   * Python support
56
--   * Osmocom IQ Imbalance Correction
57 1 horiz0n
--   * sysmocom OsmoSDR
58 51 horiz0n
--   * FUNcube Dongle
59
--   * FUNcube Dongle Pro+
60 30 horiz0n
--   * IQ File Source
61
--   * Osmocom RTLSDR
62
--   * RTLSDR TCP Client
63
--   * Ettus USRP Devices
64
--   * Osmocom MiriSDR
65 1 horiz0n
--   * HackRF Jawbreaker
66 51 horiz0n
--   * nuand bladeRF
67 61 horiz0n
--   * RFSPACE Receivers
68 30 horiz0n
-- 
69
-- ######################################################
70
-- # gr-osmosdr disabled components                        
71 1 horiz0n
-- ######################################################
72 30 horiz0n
-- 
73 51 horiz0n
-- Building for version: v0.1.0-4-g37aba331 / 0.1.1git
74 30 horiz0n
-- Using install prefix: /usr/local
75
}}}
76
77
Now build & install
78
{{{
79 1 horiz0n
make
80
sudo make install
81
sudo ldconfig
82
}}}
83
84 44 horiz0n
NOTE: The osmocom source/sink blocks will appear under 'Sources' and 'Sinks' categories in GRC menu.
85 1 horiz0n
86 10 horiz0n
To build the API documentation:
87
{{{
88
cd build/
89 1 horiz0n
cmake ../ -DENABLE_DOXYGEN=1
90
make -C docs
91 14 horiz0n
}}}
92 44 horiz0n
93 1 horiz0n
== Automated installation ==
94
95
Marcus D. Leech has kindly integrated the forementioned build steps into his gnuradio installation script at [http://www.sbrac.org/files/build-gnuradio]. This is the most user-friendly option so far.
96 7 horiz0n
97 11 horiz0n
== Device specification ==
98 33 horiz0n
You can specify the source or sink device using a comma separated string of argument=value pairs. The always-up-to-date block documentation with examples is available [http://cgit.osmocom.org/gr-osmosdr/tree/grc/gen_osmosdr_blocks.py#n100 right here].
99 19 horiz0n
100 18 horiz0n
=== FCD Source ===
101
||Argument||Notes||
102 54 horiz0n
||fcd=<device-index>|| 0-based device identifier, optional||
103
||device=hw:2|| overrides the audio device||
104
||type=2|| selects the dongle type, 1 for Classic, 2 for Pro+||
105 50 horiz0n
106
The "device" argument overrides the audio device used by the underlying driver to access the dongle's IQ sample stream.
107
108
The "type" argument selects the dongle type, 1 for Classic, 2 for Pro+.
109 18 horiz0n
110 58 horiz0n
=== IQ File Source ===
111
||Argument||Notes||
112
||file=<path-to-file-name>||||
113
||freq=<frequency>|| Center frequency in Hz, accepts eng notation||
114
||rate=<sampling-rate>|| Mandatory, in samples/s, accepts eng notation||
115
||repeat=true|false|| Default is true||
116
||throttle=true|false|| Throttle flow of samples, default is true||
117
118 1 horiz0n
=== OsmoSDR Source ===
119 28 horiz0n
||Argument||Notes||
120
||osmosdr=<device-index>|| 0-based device identifier||
121 1 horiz0n
||buffers=<number-of-buffers>|| Default is 32||
122 28 horiz0n
||buflen=<length-of-buffer>|| Default is 256kB, must be multiple of 512||
123 1 horiz0n
124 11 horiz0n
=== RTL-SDR Source ===
125 28 horiz0n
||Argument||Notes||
126
||rtl=<device-index>|| 0-based device identifier OR serial number||
127
||rtl_xtal=<frequency>|| Frequency (Hz) used for the RTL chip, accepts eng notation||
128
||tuner_xtal=<frequency>|| Frequency (Hz) used for the tuner chip, accepts eng notation||
129 1 horiz0n
||buffers=<number-of-buffers>|| Default is 32||
130 28 horiz0n
||buflen=<length-of-buffer>|| Default is 256kB, must be multiple of 512||
131 29 horiz0n
||direct_samp=0|1|2|| Enable direct sampling mode on the RTL chip. 0: Disable, 1: use I channel, 2: use Q channel||
132
||offset_tune=0|1|| Enable offset tune mode for E4000 tuners||
133 28 horiz0n
134
NOTE: use rtl_eeprom -s to program your own serial number to the device
135 32 horiz0n
136 11 horiz0n
NOTE: if you don't specify rtl_xtal/tuner_xtal, the underlying driver will use 28.0MHz
137 1 horiz0n
138
=== RTL-SDR TCP Source ===
139 28 horiz0n
||Argument||Notes||
140 1 horiz0n
||rtl_tcp=<hostname>:<port>|| hostname defaults to "localhost", port to "1234"||
141
||psize=<payload-size>|| Default is 16384 bytes||
142 29 horiz0n
||direct_samp=0|1|2|| Enable direct sampling mode on the RTL chip 0=Off, 1=I-ADC input enabled, 2=Q-ADC input enabled||
143
||offset_tune=0|1|| Enable offset tune mode for E4000 tuners||
144 1 horiz0n
145 28 horiz0n
=== Miri Source ===
146
||Argument||Notes||
147
||miri=<device-index>|| 0-based device identifier||
148
||buffers=<number-of-buffers>|| Default is 32||
149
150 1 horiz0n
=== UHD Source / Sink ===
151 28 horiz0n
||Argument||Notes||
152
||uhd|| Use this argument without a value||
153
||nchan=<channel-count>|| For multichannel USRP configurations use the subdev parameter to specify stream mapping||
154
||subdev=<subdev-spec>|| Examples: "A:0", "B:0", "A:0 B:0" when nchan=2. Refer original ettus documentation on this||
155
||lo_offset=<frequency>|| Offset frequency in Hz, must be within daughterboard bandwidth. Accepts eng notation||
156 1 horiz0n
157
Additional argument/value pairs will be passed to the underlying driver, for more information see
158
[http://files.ettus.com/uhd_docs/manual/html/general.html#specifying-the-subdevice-to-use specifying the subdevice] and 
159
[http://files.ettus.com/uhd_docs/manual/html/identification.html#common-device-identifiers common device identifiers] in the Ettus documentation.
160 54 horiz0n
161
=== bladeRF Source / Sink ===
162
||Argument||Notes||
163
||bladerf[=0]|| 0-based device identifier (optional)||
164 55 horiz0n
||fpga='/path/to/the/bitstream.rbf'|| load FPGA bitstream from given file. required only at first run at the moment.||
165 1 horiz0n
166 28 horiz0n
=== HackRF Source / Sink ===
167 38 horiz0n
||Argument||Notes||
168
||hackrf|| Use this argument without a value||
169 24 horiz0n
||buffers=<number-of-buffers>|| Default is 32||
170 28 horiz0n
171 1 horiz0n
Only the first device found may be used at the moment because of libhackrf limitation.
172
173 28 horiz0n
Transmit support has been verified by using the [http://sdr.osmocom.org/trac/attachment/wiki/GrOsmoSDR/hackrf-dab.jpg crc-mmbTools DAB sdr transmitter].
174 1 horiz0n
175 61 horiz0n
=== RFSPACE Source ===
176 1 horiz0n
||Argument||Notes||
177 61 horiz0n
||sdr-iq[=<serial-port>]|| Optional parameter, serial-port defaults to the serial port (like /dev/ttyUSB0) used by first detected SDR-IQ||
178 63 horiz0n
||sdr-ip[=<hostname>][:<port>]|| Optional parameters, hostname defaults to "localhost", port to "50000" or the first detected SDR-IP||
179
||netsdr[=<hostname>][:<port>]|| Optional parameters, hostname defaults to "localhost", port to "50000" or the first detected NetSDR||
180 61 horiz0n
||nchan=<channel-count>|| Optional parameter for NetSDR, must be 1 or 2||
181 7 horiz0n
182 63 horiz0n
The SDR-IP/NetSDR discovery protocol (UDP broadcast) is implemented, thus specifying the ip & port should not be neccessary. Note: for the receiver to operate properly it is required that the UDP packets (port 50000) carrying the sample data can reach your PC, therefore configure your firewall/router/etc. accordingly...
183 58 horiz0n
184 64 horiz0n
The ftdi_sio driver is being used for SDR-IQ. It creates a character device of the form:
185
186
crw-rw---- 1 root dialout 188, 0 Dec 19 22:14 /dev/ttyUSB0
187
188
To be able to open the device without root permissions add yourself to the "dialout" group or do a "chmod 666 /dev/ttyUSB0" after pluggin in.
189
190 35 horiz0n
== Included Apps ==
191
192
=== Spectrum Browser ===
193 45 horiz0n
194
[[Image(fft-lte.png)]]
195 57 horiz0n
196 58 horiz0n
RTSA-like spectrum visualization is available through [https://sdr.osmocom.org/trac/wiki/fosphor fosphor] component. Call osmocom_fft with -F switch to enable it (a graphics card supporting OpenCL/OpenGL interop is a requirement).
197 57 horiz0n
198
[[Image(fosphor.png)]]
199
200
[[Image(fosphor2.png)]]
201 35 horiz0n
202 36 horiz0n
usage examples:
203 35 horiz0n
{{{
204 1 horiz0n
osmocom_fft -a rtl=0 -v -f 100e6 -s 2.4e6 -g 15
205 66 horiz0n
osmocom_fft -a rfspace -v
206
osmocom_fft -a bladerf -v
207 35 horiz0n
osmocom_fft -a hackrf -v
208 36 horiz0n
osmocom_fft -a uhd -v
209 69 horiz0n
osmocom_fft -a airspy -v
210 35 horiz0n
}}}
211 67 horiz0n
212
DC offset and IQ imbalance correction controls may be enabled using --dc-offset-mode=0 and --iq-balance-mode=0 command line switches respectively.
213
214 1 horiz0n
=== Signal generator ===
215 45 horiz0n
216 65 horiz0n
[[Image(siggen-gsm.png)]]   [[Image(gsm-hackrf-8M.png, 500px)]]
217 35 horiz0n
218 36 horiz0n
usage examples:
219 49 horiz0n
{{{
220
osmocom_siggen -a hackrf -f 100e6 --sine
221 39 horiz0n
osmocom_siggen -a hackrf -f 100e6 --sweep -x 2M -y 1 -c34
222
osmocom_siggen_nogui -a hackrf -f 100e6 --sweep -x 2e6 -y 10 -v
223 36 horiz0n
osmocom_siggen_nogui -a uhd,subdev=A:0 -f 100e6 --sweep -x 2e6 -y 10 -s 4e6 -v
224 67 horiz0n
osmocom_siggen -a bladerf -f 1G --sweep -x 4M -y 1 -s 4M
225 35 horiz0n
}}}
226
=== Spectrum sensing ===
227
228
TODO: document
229 7 horiz0n
230
== Known Apps ==
231
232
The following 3rd party applications are successfully using gr-osmosdr:
233
234
||'''Name'''||'''Type'''||'''Author'''||'''URL'''||
235 15 horiz0n
||gr-pocsag||GRC Flowgraph||Marcus Leech||[https://www.cgran.org/browser/projects/gr-pocsag/trunk]||
236 8 horiz0n
||multimode RX||GRC Flowgraph||Marcus Leech||[https://www.cgran.org/browser/projects/multimode/trunk]||
237 16 horiz0n
||simple_fm_rvc||GRC Flowgraph||Marcus Leech||[https://www.cgran.org/browser/projects/simple_fm_rcv/trunk]||
238 1 horiz0n
||Wireless Temp. Sensor RX||Gnuradio App||Kevin Mehall||[https://github.com/kevinmehall/rtlsdr-433m-sensor]||
239
||gqrx||SDR GUI||Alexandru Csete||[https://github.com/csete/gqrx]||
240
||tetra_demod_fft||Trunking RX||osmocom team||[http://cgit.osmocom.org/cgit/osmo-tetra/tree/src/demod/python/osmosdr-tetra_demod_fft.py osmosdr-tetra_demod_fft.py] and the [http://tetra.osmocom.org/trac/wiki/osmo-tetra#Quickexample HOWTO] ||
241
||airprobe||GSM sniffer||osmocom team et al||[http://git.gnumonks.org/cgi-bin/gitweb.cgi?p=airprobe.git]||
242
||gr-smartnet (WIP)||Trunking RX||Nick Foster||[http://www.reddit.com/r/RTLSDR/comments/us3yo/rtlsdr_smartnet/][[br]][http://www.reddit.com/r/RTLSDR/comments/vbxl0/attention_grsmartnet_users_or_attempted_users/ Notes from the author]||
243 16 horiz0n
||gr-air-modes||ADS-B RX||Nick Foster||[https://www.cgran.org/wiki/gr-air-modes] call with --rtlsdr option||
244
||gr-ais (fork)||AIS RX||Nick Foster[[br]]Antoine Sirinelli[[br]]Christian Gagneraud||[https://github.com/chgans/gr-ais]||
245 15 horiz0n
||GNSS-SDR ||GPS RX (Realtime!)||Centre Tecnològic de[[br]]Telecomunicacions de Catalunya||[http://www.gnss-sdr.org/documentation/gnss-sdr-operation-realtek-rtl2832u-usb-dongle-dvb-t-receiver Documentation] and [http://www.gnss-sdr.org]||
246
||gr-scan ||Scanner||techmeology||[http://www.techmeology.co.uk/gr-scan/]||
247
||pocsag-mrt||Multichannel Realtime[[br]]Decoder||iZsh||[https://github.com/iZsh/pocsag-mrt]||
248
||osmo-gmr-rtl||GMR1 RX||Dimitri Stolnikov||[http://gmr.osmocom.org/trac/wiki/GettingStarted#RTLSDRdongles]||
249 68 horiz0n
||simple_ra||Radio Astronomy App||Marcus Leech||[https://cgran.org/wiki/simple_ra]||
250
||FS20_decode||FS20 Decoder||Thomas Frisch||[https://github.com/eT0M/rtl_sdr_FS20_decoder]||
251 1 horiz0n
||OpenLTE '''(NEW)'''||LTE Toolkit||Ben Wojtowicz||[http://sourceforge.net/p/openlte/home/Home/]||
252 56 horiz0n
||sdrangelove '''(NEW)'''||SDR GUI||Christian Daniel||[http://sdrangelove.org]||
253 68 horiz0n
||gr-dvbt '''(NEW)'''||DVB-T Transmitter & Receiver||Bogdan Diaconescu||[https://github.com/BogdanDIA/gr-dvbt] [http://yo3iiu.ro/blog/?p=1191 Blog Post] [http://nuand.com/forums/viewtopic.php?f=8&t=3499#p5124 bladeRF transmit flowgraph]||
254 28 horiz0n
255
== Credits ==
256 53 horiz0n
257 59 horiz0n
gr-osmosdr is developed by Dimitri Stolnikov with contributions from Hoernchen, Steve Markgraf, Sylvain Munaut and Nuand LLC folks.
Add picture from clipboard (Maximum size: 48.8 MB)