Table of Contents
SDR Software for using the badge
overview
GNU Radio (Linux/Mac/Windows)
It's highly recommended to build GNU Radio from source to use the most up-to-date version: Installation
There were two GNU Radio workshops at Easterhegg 2015:
gnuradio-companion is the full-fledged signal processing application.
osmocom_fft is a nice little graphical tool for quick signal checks.
Gqrx SDR (Linux/Mac)
SDR# (Windows)
RF Analyzer (Android)
installation details
Linux
- GNU Radio - Powerful suit for signal processing. Also contains 'gnuradio-companion', a GUI for designing the the processing blocks.
- Gqrx SDR - Easy display of signal strengths/waterfall etc. with basic filtering and demodulation support.
- Baudline (not in the Debian package repository) - Another signal visualizer.
- inspectrum - Similar to baudline, but OSS.
Debian based systems
NOTE: Current versions of gqrx-sdr and gr-osmosdr in Ubuntu 14.04 are known to cause issues with the rad1o. (hackrf_info not detecting the badge, error loading libosmosdr etc.) The original hackrf wiki has a PPA with updated versions.
1. Install software:
apt-get install hackrf gqrx-sdr gnuradio gr-osmosdr
2. Make sure the hackrf kernel module is not loaded. If you don't do this, you'll get a -1000 error from hackrf_info
$ sudo rmmod hackrf $ sudo vim /etc/modprobe.d/blacklist.conf # module blacklisted for radi1o / gqrx usage blacklist hackrf
3. Additionally you will need some UDEV rules. Replace YOURUSER with your username (whoami)
$ sudo vim /etc/udev/rules.d/51-rad1o.rules SUBSYSTEM=="usb", ATTR{idVendor}=="1d50", ATTR{idProduct}=="cc15", MODE="0600", OWNER="YOURUSER", GROUP="YOURUSER" SUBSYSTEM=="usb", ATTR{idVendor}=="1d50", ATTR{idProduct}=="6089", MODE="0600", OWNER="YOURUSER", GROUP="YOURUSER"
4. make sure you boot the hackrf-old on the rad1o, as gqrx somehow only recognized the device as a hackrf then (at least with gqrx from debian testing)
5. check with hackrf_info that everything works
6. launch gqrx, it should autoconfigure itself
Archlinux
pacman -S gqrx python2 python2-lxml python2-cheetah # pulls hackrf and gnuradio automatically in
Gentoo Linux
Versions known to work:
net-wireless/gnuradio-3.7.7.x net-wireless/gr-osmosdr-1.4_x net-wireless/gqrx-2.3.x
Make sure the 'hackrf' useflag is enabled where available.
If you have the 'hackrf' kernel module compiled, prevent it from loading by adding
blacklist hackrf
to your /etc/modprobe.d/blacklist.conf. (update your modprobe config with 'depmod -a')
Fedora
1. Install software:
$ sudo dnf install gnuradio gnuradio-doc gnuradio-examples gqrx hackrf hackrf-doc gr-osmosdr gr-air-modes
2. boot into HKRF-OLD on the rad1o (for now, hopefully soon in HACKRF mode)
3. check if it's detected with hackrf_info
$ hackrf_info Found HackRF board. Board ID Number: 3 (Unknown Board ID) Firmware Version: [...] Part ID Number: [...] Serial Number: [...]
4. run gqrx, accepting the default of hackrf unknown device. Gqrx SDR Supported hardware
$ gqrx
5. if you get results in gqrx, move on to osmocom_fft, keeping in mind that the built-in antenna is tuned to 2.5GHz
$ osmocom_fft
6. now you are sure the rad1o speaks to your Fedora box and you can move on to GNU Radio
$ gnuradio-companion
To use the rad1o, search for blocks with osmocom in the name in GNU Radio.
You may want to check out the files in /usr/share/gnuradio/examples/
Windows
Mac
Follow these instructions to install Gnuradio-Suite on your Mac: Prerequisites:
- Install either HomeBrew, MacPorts or Fink
- Download and install XQuarz via http://xquartz.macosforge.org/landing/
- Download and install MacPorts: https://www.macports.org/install.php
Install GnuRadio with MacPorts:
sudo port install gnuradio
You also want to install the OsmoSDR radio blocks for GnuRadio
sudo port install gr-osmosdr
To install GnuRadio with HomeBrew, you can follow this guide.
Start GnuRadio in the terminal with
gnuradio-companion
Android
RF Analyzer (Android)
Patched version with rad1o support:
- Binary APK: RFAnalyzer-rad1o.apk (as of 2015-08-23, this APK seem to need HKRF-OLD mode)
- Source: RFAnalyzer
Requires an OTG cable or adapter and an OTG capable mobile (e.g. Jolla and Nexus 4 are not)