fed60c571c
Intro: Some of the Hackrf board use a bad performance crystal, it will cause some program can't work---such as GNSS(GPS) simulation. Most GPS receiver can capture the satellite when the doppler within 10KHz, but 10ppm bias of the crystal will cause 15Khz doppler. And my hackrf board uses a 16ppm crystal :( normal Of course, I can replace the crystal or use a external clock. But for most people, add a ppm correct function to hackrf_transfer is useful. How to use: 1, measure your crystal's error You can use a precision counter to measure it. Connect the hackrf's "clock out" to the counter, get the frequency Fh, then , ppm = (Fh - 10000000)/10 You can use a standard clock source such as OCXO, TCXO, or Atom Clock, and a counter to measure the crystal error too. 2, add an argument "-C ppm " when you use hackrf_transfer. Eg. , your crystal error is -8ppm ( In other words , your clock is slower than the standard clock), then you should add "-C -8" follow the hackrf_transfer command. Hope you can understand my poor English:) -------------------------- Thanks to Michael Ossmann; Thanks to Jared Boone ; Thanks to Benjamin Vernoux ; Thanks to GPL.
This repository contains host software (Linux/Windows) for HackRF, a project to produce a low cost, open source software radio platform.
##How to build the host software on Linux:
###Prerequisites for Linux (Debian/Ubuntu):
sudo apt-get install build-essential cmake libusb-1.0-0-dev pkg-config
###Build host software on Linux:
cd host
mkdir build
cd build
cmake ../ -DINSTALL_UDEV_RULES=ON
make
sudo make install
sudo ldconfig
##Clean CMake temporary files/dirs:
cd host/build
rm -rf *
##How to build host software on Windows:
###Prerequisites for cygwin or mingw:
- cmake-2.8.12.1 or more see http://www.cmake.org/cmake/resources/software.html
- libusbx-1.0.18 or more see http://sourceforge.net/projects/libusbx/files/latest/download?source=files
- Install Windows driver for HackRF hardware or use Zadig see http://sourceforge.net/projects/libwdi/files/zadig
- If you want to use Zadig select HackRF USB device and just install/replace it with WinUSB driver.
Note for Windows build: You shall always execute hackrf-tools from Windows command shell and not from Cygwin or Mingw shell because on Cygwin/Mingw Ctrl C is not managed correctly and especially for hackrf_transfer the Ctrl C(abort) will not stop correctly and will corrupt the file.
###For Cygwin:
cd host
mkdir build
cd build
cmake ../ -G "Unix Makefiles" -DCMAKE_LEGACY_CYGWIN_WIN32=1 -DLIBUSB_INCLUDE_DIR=/usr/local/include/libusb-1.0/
make
make install
###For MinGW:
cd host
mkdir build
cd build
Normal version:
cmake ../ -G "MSYS Makefiles" -DLIBUSB_INCLUDE_DIR=/usr/local/include/libusb-1.0/
Debug version:
cmake ../ -G "MSYS Makefiles" -DCMAKE_BUILD_TYPE=Debug -DLIBUSB_INCLUDE_DIR=/usr/local/include/libusb-1.0/
make
make install
###For Visual Studio 2012 x64
c:\hackrf\host\cmake>cmake ../ -G "Visual Studio 11 2012 Win64" -DLIBUSB_INCLUDE_DIR=c:\libusb-1.0.18-win\include\libusb-1.0 -DLIBUSB_LIBRARIES=c:\libusb-1.0.18-win\MS64\static\libusb-1.0.lib -DTHREADS_PTHREADS_INCLUDE_DIR=c:\pthreads-w32-2-9-1-release\Pre-built.2\include -DTHREADS_PTHREADS_WIN32_LIBRARY=c:\pthreads-w32-2-9-1-release\Pre-built.2\lib\x64\pthreadVC2.lib
Solution file: c:\hackrf\host\cmake\hackrf_all.sln
##How to build host the software on FreeBSD
You can use the binary package:
# pkg install hackrf
You can build and install from ports:
# cd /usr/ports/comms/hackrf
# make install
principal author: Michael Ossmann mike@ossmann.com