1
0
mirror of https://github.com/f4exb/sdrangel.git synced 2024-11-03 07:21:14 -05:00
sdrangel/Readme.md

149 lines
8.8 KiB
Markdown
Raw Normal View History

2015-07-24 02:46:26 -04:00
===============
RTL-SDRangelove
===============
![Channel analyzer plugins](https://github.com/f4exb/rtl-sdrangelove/blob/f4exb/doc/img/sdrangelove_cover.png)
======================
Cloning the repository
======================
- Clone as usual
- Checkout the f4exb branch: `git checkout f4exb`
=======================
GNURadio and libosmosdr
=======================
These plugins have a lot of bugs and they have been removed trom the build. Original sources still exist in the tree. So current version only supports the following hardware:
- RTL-SDR
- Funcube
- BladeRF (standard and with XB-200 transverter)
2014-12-09 14:13:33 -05:00
==============
Funcube Dongle
==============
2014-12-09 07:52:00 -05:00
2015-05-05 13:21:30 -04:00
Funcube Dongle Pro+ support will need "libasound2-dev" installed. ("libhid" is built from source). Install the rules file "fcdpp.rules" in "/etc/udev/rules.d" to gain the "root access" needed to control the dongle.
2014-06-07 13:30:03 -04:00
2015-05-05 13:21:30 -04:00
Funcube Dongle Pro+ USB drivers are broken on some hardware with recent kernels. It works well for me with an Atom Chipset, which has Full Speed USB ports, or a "Valleyview" Chromebook (kernel 3.10). A Desktop with the "same" chipset needs kernel 3.2, available with Debian 7 "wheezy". YMMV.
2014-12-09 07:52:00 -05:00
=======
BladeRF
=======
A complete new plugin has been written for the BladeRF that interfaces libbladeRF directly. Osmosdr/GnuRadio interface is not implemented correctly and has a lot of bugs as mentioned previously and was not reasonably usable with the BladeRF.
If you use your own location for libbladeRF install directory you need to specify library and include locations. Example with `opt/install/libbladerf` with the following defines on `cmake` command line:
`-DLIBBLADERF_LIBRARIES=/opt/install/libbladeRF/lib/libbladeRF.so -DLIBBLADERF_INCLUDE_DIR=/opt/install/libbladeRF/include`
2014-12-09 07:52:00 -05:00
==========
2015-05-05 13:21:30 -04:00
For Ubuntu
2014-12-09 07:52:00 -05:00
==========
2014-10-30 08:31:21 -04:00
`sudo apt-get install libqt5multimedia5-plugins qtmultimedia5-dev qttools5-dev qttools5-dev-tools libqt5opengl5-dev qtbase5-dev libusb-1.0 librtlsdr-dev libboost-all-dev`
`mkdir build && cd build && cmake ../ && make`
2014-12-09 14:13:33 -05:00
`librtlsdr-dev` is in the `universe` repo. (utopic 14.10 amd64.)
2014-11-05 07:34:33 -05:00
Use `cmake ../ -DV4L-RTL=ON` to build the Linux kernel driver for RTL-SDR (Experimental). Needs a recent kernel and libv4l2. Will need extra work to support SDRPlay. Needs `cp KERNEL_SOURCE/include/linux/compiler.h /usr/include/linux/` and `cp KERNEL_SOURCE/include/uapi/linux/videodev2.h /usr/include/uapi/linux/` and package `libv4l-dev`.
2014-11-30 16:59:06 -05:00
The Gnuradio plugin source needs extra packages, including `liblog4cpp-dev libboost-system-dev gnuradio-dev libosmosdr-dev`
2014-11-05 07:34:33 -05:00
For non standard installations of RTL-SDR library, the GNU Radio runtime and gr.osmocom drivers use the following variables in the cmake command line. The paths specified are just examples:
2014-11-23 04:22:02 -05:00
- For GNU Radio runtime:
- Includes: `-DGNURADIO_RUNTIME_INCLUDE_DIRS=/opt/install/gnuradio-3.7.5.1/include`
- Library: `-DGNURADIO_RUNTIME_LIBRARIES=/opt/install/gnuradio-3.7.5.1/lib/libgnuradio-runtime.so`
- For gr.osmocom:
- Includes: `-DGNURADIO_OSMOSDR_INCLUDE_DIRS=/opt/install/gr-osmosdr/include`
- Library: `-DGNURADIO_OSMOSDR_LIBRARIES=/opt/install/gr-osmosdr/lib/libgnuradio-osmosdr.so`
- For RTL-SDR library:
- Includes: `-DLIBRTLSDR_INCLUDE_DIR=/opt/install/rtlsdr/include`
- Library: `-DLIBRTLSDR_LIBRARIES=/opt/install/rtlsdr/lib/librtlsdr.so`
There is no installation procedure the executable is at the root of the build directory
2014-12-09 14:13:33 -05:00
============
2015-05-05 13:21:30 -04:00
For Debian 8
2014-12-09 14:13:33 -05:00
============
Debian 7 "wheezy" uses Qt4. Qt5 is available from the "wheezy-backports" repo, but this will remove Qt4. Debian 8 "jessie" uses Qt5.
2014-12-09 14:13:33 -05:00
`sudo apt-get install cmake g++ pkg-config libfftw3-dev libusb-1.0-0-dev libusb-dev qt5-default qtbase5-dev qtchooser libqt5multimedia5-plugins qtmultimedia5-dev qttools5-dev qttools5-dev-tools libqt5opengl5-dev qtbase5-dev librtlsdr-dev libboost-all-dev`
2014-12-09 14:13:33 -05:00
`mkdir build && cd build && cmake ../ && make`
The same remarks as for Ubuntu apply...
2014-12-09 14:13:33 -05:00
2015-02-20 03:45:57 -05:00
============
Known Issues
============
- Actually NFM seems to be working pretty well
- RTL frontend will have bad aliasing in noisy environments. Considering the size of the hardware there is no place for proper filters. With good filtering and a good antenna up front these devices work remarkably well for the price!
- Aliasing can be annoying for broadcast FM. In this case try to shift the signal until you find a clear background for your station. This is a limitation of the RTL hardware so just use this workaround.
- GNU Radio plugin is not fully functional and has serious bugs (frequent segfaults). Trying to repair it is abandonned.
===================
Done since the fork
===================
- Added ppm correction for the LO of RTL-SDR. This uses the corresponding function in the librtlsdr interface (range -99..99 ppm)
- Added a preset update button (the diskette with the yellow corner) to be able to save the current settings on an existing preset
- Added variable decimation in log2 increments from 2^0=1 to 2^4=16 allowing to see the full 2048 kHz of spectrum if so you wish
- Better handling of rtlsdr GUI display when settings change (initial load, load of presets)
- Added display and precise control of the shift frequency from center frequency of the NFM receivers.
- Removed useless spectrum visualizer in NFM receivers. Created a null sink class to fit corresponding parameter in NFMDemod class constructor.
2015-05-10 21:32:13 -04:00
- Added display and precise control of the shift frequency from center frequency of the SSB receivers.
- SSB filter bounds are tunable so that filter can be set off from center frequency allowing aural decoding of CW
2015-05-10 21:32:13 -04:00
- Make the sidebands appear correctly on SSB channel overlay. Limit to +/- 6 kHz to fit channel spectrum analyzer window
- SSB bandwidth can now be tuned in steps of 100 Hz
- NFM and SSB receiver in focus trigger the display of the central frequency line on the spectrum frequency scale thus facilitating its identification
2015-05-11 20:53:35 -04:00
- Added AM demod so now you can listen to air traffic!
- Added the possibility to change the brightness and/or color of the grid.
- Make the low cutoff frequency of the SSB filter variable so it can be used for CW also.
- NFM demodulation without using atan and smooth squelch with AGC suppressing most clicks on low level signals and hiss on carrier tails. Only useful modulation comes through.
- Added working WFM demodulation. Optimized for no atan2.
- OsmoSDR and GNURadio plugins removed from the build as they have too many bugs that are too difficult to correct
- New plugin for BladeRF interfacing libbladeRF directly
- Corrected the nasty audio band resampling bug preventing use of sample rates that are not power of 2 multiples of 48kHz. This was because the resampling ratio was calculated with an integer division instead of a float division.
- As a consequence of the above added more interesting values for the available sampling rates of the BladeRF plugin
2015-06-15 13:50:09 -04:00
- Variable span for the SSB demod down to 1.5 kHz
2015-06-16 20:35:24 -04:00
- Filter out CTCSS tones for audio and full CTCSS support in NFMDemod
- Enhancement of the NFM squelch mimicking professional analog squelch circuits (based on balance between two AF filters)
- Added a channel analyzer plugin focusing on measurement (DSA/DSO functionnality). Basic functions.
- Added a scope widget in the channel analyzer plugin
- Channel analyzer bandwidth up to half the available RF (IF) bandwidth (was 48k fixed)
- Enhanced scope display and controls: scale display, better X (time) and Y scales control, grid fit to scale, effectively implementing triggers, trigger on magnitude and phase, properly handling time shift, ...
2015-07-23 19:09:03 -04:00
- Enhanced spectrum display: Histogram: wider decay range, make stroke and late holdoff adjustable. Added option to show live spectrum (had only max hold before).
- Enhanced channel analyzer: enhanced scope and spectrum displays as mentioned above, make the spectrum display synchronous to scope (hence triggerable a la E4406A).
- Sort channel plugins by delta frequency and type before saving to preset
- Implemented scope pre-trigger delay
2015-07-22 22:58:27 -04:00
- Implemented variable scope memory depth
- Implemented trigger delay
2015-07-23 00:52:12 -04:00
- Trigger on both edges
2015-07-23 19:09:03 -04:00
- Spectrum histogram clear
- Trigger line display for all trigger modes
- Coarse and fine trigger level sliders
- Minimalist recording (no file choice)
- File sample source plugin (recording reader) not working
2015-08-17 02:29:34 -04:00
- Redesign:
- Make the DSP engine global static
- Fixed startup initialization sequence. New initialization phase in DSP engine and new ready state
- Synchronous messaging class to push message to thread and wait for completion
- Message queuing and handling redesign
- Many other little things...
=====
To Do
=====
- Level calibration
2015-07-23 19:09:03 -04:00
- Enhance presets management (Edit, Move, Import/Export from/to human readable format like JSON)
2015-06-15 13:50:09 -04:00
- Tx channels for Rx/Tx boards like BladeRF
2015-07-23 19:09:03 -04:00
- Enhance WFM (stereo, RDS?)
- Even more demods ...
2015-07-24 02:46:26 -04:00