GrOsmoSDR » History » Version 19
horiz0n, 02/19/2016 10:50 PM
1 | 1 | horiz0n | [[PageOutline]] |
---|---|---|---|
2 | |||
3 | 2 | horiz0n | = OsmoSDR Gnuradio Source = |
4 | 1 | horiz0n | |
5 | 3 | horiz0n | Primarily gr-osmosdr supports the OsmoSDR hardware, but it also offers a wrapper functionality for [http://tetra.osmocom.org/trac/wiki/Funcube_Dongle FunCube Dongle], [http://files.ettus.com/uhd_docs/manual/html/build.html Ettus UHD] and [http://sdr.osmocom.org/trac/wiki/rtl-sdr rtl-sdr] radios. By using gr-osmosdr source you can take advantage of a common software api in your application(s) independent of the underlying radio hardware. |
6 | 1 | horiz0n | |
7 | == Build process == |
||
8 | |||
9 | 17 | horiz0n | '''The gnuradio source requires a recent gnuradio (>= v3.6.4.1) to be installed.''' |
10 | 1 | horiz0n | |
11 | Please note: prior pulling a new version from git and compiling it, please do a "make uninstall" first to properly remove the previous version. |
||
12 | |||
13 | Building with cmake: |
||
14 | {{{ |
||
15 | git clone git://git.osmocom.org/gr-osmosdr |
||
16 | cd gr-osmosdr/ |
||
17 | mkdir build |
||
18 | cd build/ |
||
19 | 14 | horiz0n | cmake ../ |
20 | 1 | horiz0n | make |
21 | sudo make install |
||
22 | sudo ldconfig |
||
23 | }}} |
||
24 | |||
25 | 17 | horiz0n | NOTE: The OSMOCOM source block will appear under 'Sources' category in GRC menu. |
26 | 1 | horiz0n | |
27 | 10 | horiz0n | To build the API documentation: |
28 | {{{ |
||
29 | cd build/ |
||
30 | 14 | horiz0n | cmake ../ -DENABLE_DOXYGEN=1 |
31 | 10 | horiz0n | make -C docs |
32 | }}} |
||
33 | |||
34 | 1 | horiz0n | == Automated installation == |
35 | |||
36 | 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. |
||
37 | 7 | horiz0n | |
38 | 11 | horiz0n | == Device specification == |
39 | You can specify the source or sink device using a comma separated string of argument=value pairs. |
||
40 | |||
41 | 19 | horiz0n | The always-up-to-date block documentation is available [http://cgit.osmocom.org/gr-osmosdr/tree/grc/gen_osmosdr_blocks.py#n100 right here]. |
42 | |||
43 | 18 | horiz0n | === IQ File Source === |
44 | 11 | horiz0n | ||file=<path-to-file-name>|||| |
45 | ||freq=<frequency>|| in Hz|| |
||
46 | ||rate=<sampling-rate>|| in samples/s|| |
||
47 | ||repeat=true|false|| Default is false|| |
||
48 | ||throttle=true|false||Throttle flow of samples, default is false|| |
||
49 | 1 | horiz0n | |
50 | 18 | horiz0n | === FCD Source === |
51 | ||Argument||Notes|| |
||
52 | ||fcd=<device-index>|| || |
||
53 | |||
54 | === OsmoSDR Source === |
||
55 | 11 | horiz0n | ||osmosdr=<device-index>|| || |
56 | ||mcr=<rate>||Master clock rate. FIXME: Setting the MCR is not supported|| |
||
57 | ||nchan=<channel-number>||FIXME: Values of nchan != 1 are not supported|| |
||
58 | ||buffers=<number-of-buffers>|| Default is 32|| |
||
59 | |||
60 | 18 | horiz0n | === RTL-SDR Source === |
61 | 11 | horiz0n | ||rtl=<device-index>|| || |
62 | ||rtl_xtal=<frequency>|| Frequency in Hz of the crystal oscillator used for the RTL chip|| |
||
63 | 1 | horiz0n | ||tuner_xtal=<frequency>|| Frequency in Hz of the crystal oscillator used for the tuner chip|| |
64 | 11 | horiz0n | ||buffers=<number-of-buffers>|| Default is 32|| |
65 | 13 | horiz0n | NOTE: if you don't specify rtl_xtal/tuner_xtal, the underlying driver will use 28.0MHz |
66 | 11 | horiz0n | |
67 | 18 | horiz0n | === RTL-SDR TCP Source === |
68 | 11 | horiz0n | ||rtl_tcp=<hostname>:<port>|| hostname defaults to "localhost", port to "1234"|| |
69 | ||psize=<payload-size>|| Default is 16384 bytes|| |
||
70 | |||
71 | 18 | horiz0n | === UHD Source / Sink === |
72 | 11 | horiz0n | ||uhd|| Use this argument without value || |
73 | ||nchan=<channel-index>|| || |
||
74 | ||subdev=<subdev-spec>|| See below|| |
||
75 | |||
76 | Additional argument/value pairs will be passed to the underlying driver, for more information see |
||
77 | http://files.ettus.com/uhd_docs/manual/html/general.html#specifying-the-subdevice-to-use and |
||
78 | http://files.ettus.com/uhd_docs/manual/html/identification.html#common-device-identifiers |
||
79 | |||
80 | 18 | horiz0n | === HackRF Source / Sink === |
81 | ||hackrf|| Only the first device found may be used ATM because of libhackrf limitation.|| |
||
82 | ||buffers=<number-of-buffers>|| Default is 32|| |
||
83 | 11 | horiz0n | |
84 | 7 | horiz0n | == Known Apps == |
85 | |||
86 | The following 3rd party applications are successfully using gr-osmosdr: |
||
87 | |||
88 | ||'''Name'''||'''Type'''||'''Author'''||'''URL'''|| |
||
89 | ||gr-pocsag||GRC Flowgraph||Marcus Leech||[https://www.cgran.org/browser/projects/gr-pocsag/trunk]|| |
||
90 | ||multimode RX||GRC Flowgraph||Marcus Leech||[https://www.cgran.org/browser/projects/multimode/trunk]|| |
||
91 | ||simple_fm_rvc||GRC Flowgraph||Marcus Leech||[https://www.cgran.org/browser/projects/simple_fm_rcv/trunk]|| |
||
92 | ||Wireless Temp. Sensor RX||Gnuradio App||Kevin Mehall||[https://github.com/kevinmehall/rtlsdr-433m-sensor]|| |
||
93 | 1 | horiz0n | ||tetra_demod_fft||SDR GUI||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] || |
94 | 15 | horiz0n | ||gqrx||SDR GUI||Alexandru Csete||[https://github.com/csete/gqrx]|| |
95 | 8 | horiz0n | ||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] || |
96 | 16 | horiz0n | ||airprobe||GSM sniffer||osmocom team et al||[http://git.gnumonks.org/cgi-bin/gitweb.cgi?p=airprobe.git]|| |
97 | ||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]|| |
||
98 | ||gr-air-modes||ADS-B RX||Nick Foster||[https://www.cgran.org/wiki/gr-air-modes] call with --rtlsdr option|| |
||
99 | 15 | horiz0n | ||gr-ais (fork)||AIS RX||Nick Foster[[br]]Antoine Sirinelli[[br]]Christian Gagneraud||[https://github.com/chgans/gr-ais]|| |
100 | ||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]|| |
||
101 | ||gr-scan ||Scanner||techmeology||[http://www.techmeology.co.uk/gr-scan/]|| |
||
102 | ||pocsag-mrt||Multichannel Realtime[[br]]Decoder||iZsh||[https://github.com/iZsh/pocsag-mrt]|| |
||
103 | ||osmo-gmr-rtl||GMR1 RX||Dimitri Stolnikov||[http://gmr.osmocom.org/trac/wiki/GettingStarted#RTLSDRdongles]|| |
||
104 | ||simple_ra '''(NEW)'''||Radio Astronomy App||Marcus Leech||[https://cgran.org/wiki/simple_ra]|| |
||
105 | ||FS20_decode '''(NEW)'''||FS20 Decoder||Thomas Frisch||[https://github.com/eT0M/rtl_sdr_FS20_decoder]|| |
||
106 | ||OpenLTE '''(NEW)'''||LTE Toolkit||Ben Wojtowicz||[http://sourceforge.net/p/openlte/home/Home/]|| |