From e759d57cc660e83d6135817206b785eabedf3bc3 Mon Sep 17 00:00:00 2001 From: Michael Ossmann Date: Mon, 11 Aug 2014 17:20:33 -0700 Subject: [PATCH] new page --- Getting-Started-with-HackRF-and-GNU-Radio.md | 23 ++++++++++++++++++++ 1 file changed, 23 insertions(+) create mode 100644 Getting-Started-with-HackRF-and-GNU-Radio.md diff --git a/Getting-Started-with-HackRF-and-GNU-Radio.md b/Getting-Started-with-HackRF-and-GNU-Radio.md new file mode 100644 index 0000000..ded6022 --- /dev/null +++ b/Getting-Started-with-HackRF-and-GNU-Radio.md @@ -0,0 +1,23 @@ +## Try Your HackRF with Pentoo Linux + +The easiest way to get started with your HackRF and ensure that it works is to use Pentoo, a Linux distribution with full support for HackRF and GNU Radio. Download the latest Pentoo .iso image from one of the mirrors listed at [http://pentoo.ch/download/](http://pentoo.ch/download/). Then burn the .iso to a DVD or use [UNetbootin](http://unetbootin.sourceforge.net/) to install the .iso on a USB flash drive. Boot your computer using the DVD or USB flash drive to run Pentoo. + +Once Pentoo is running, type `startx` at the command line to launch the desktop environment. Accept the "default config" in the first dialog box and then launch a Terminal Emulator window using the icon at the bottom of the screen. + +At the time of writing, the current Pentoo .iso (2014.0-RC3) has a minor bug that you need to work around by typing `eselect lapack set 1` at the command line in the terminal window before trying to use GNU Radio. You only need to do this once after starting up Pentoo, but you'll have to do it every time you boot an unmodified .iso. + +To verify that your HackRF is detected, type `hackrf_info` at the command line. It should produce a few lines of output including "Found HackRF board." The 3V3, 1V8, RF, and USB LEDs should all be illuminated. + +Now you can use programs such as gnuradio-companion or gqrx to start experimenting with your HackRF. If you are new to GNU Radio, an excellent place to start is with the [guided tutorials](http://gnuradio.org/redmine/projects/gnuradio/wiki/Guided_Tutorials). + +## Software + +As mentioned above, the best way to get started with HackRF is to use Pentoo Linux. Eventually you may want to install software to use HackRF with your favorite operating system. + +If your package manager includes the most recent release of libhackrf (2014.04.1 at the time of writing) and gr-osmosdr, then use it to install those packages in addition to GNU Radio. Otherwise, the recommended way to install these tools is by using [PyBOMBS](http://gnuradio.org/redmine/projects/pybombs/wiki). + +If you have any trouble, make sure that things work when booted to Pentoo. This will allow you to easily determine if your problem is being caused by hardware or software, and it will give you a way to see how the software is supposed to function. + +## Communication + +Please subscribe to the [HackRF-dev mailing list](http://nine.pairlist.net/mailman/listinfo/hackrf-dev). This is the preferred place for questions about HackRF. Be sure to check the [FAQ](https://github.com/mossmann/hackrf/wiki/FAQ) and other [documentation](https://github.com/mossmann/hackrf/wiki) before asking questions. Additionally, you may want to join the #hackrf IRC channel on [freenode](http://freenode.net/). Specific bugs and feature requests may be added to the [Issues List](https://github.com/mossmann/hackrf/issues?direction=desc&sort=updated&state=open) though they should probably be discussed on the mailing list or IRC first. \ No newline at end of file