From d0d2a2de0ab8c3e6b13f97d32cbfe1f13cf9851f Mon Sep 17 00:00:00 2001 From: f4exb Date: Wed, 11 Jan 2017 19:48:45 +0100 Subject: [PATCH] HackRF input plugin: documentation --- doc/img/HackRFInput_plugin.png | Bin 0 -> 24306 bytes plugins/samplesource/hackrfinput/readme.md | 89 +++++++++++++++++++++ 2 files changed, 89 insertions(+) create mode 100644 doc/img/HackRFInput_plugin.png create mode 100644 plugins/samplesource/hackrfinput/readme.md diff --git a/doc/img/HackRFInput_plugin.png b/doc/img/HackRFInput_plugin.png new file mode 100644 index 0000000000000000000000000000000000000000..024009110f7adf5f03e6e5f847030e80cfe430c9 GIT binary patch literal 24306 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 F{{eAq=-vPT literal 0 HcmV?d00001 diff --git a/plugins/samplesource/hackrfinput/readme.md b/plugins/samplesource/hackrfinput/readme.md new file mode 100644 index 000000000..330477681 --- /dev/null +++ b/plugins/samplesource/hackrfinput/readme.md @@ -0,0 +1,89 @@ +

HackRF input plugin

+ +

Introduction

+ +This intput sample source plugin gets its samples from a [HackRF device](https://greatscottgadgets.com/hackrf/). + +

Build

+ +The plugin will be built only if the [HackRF host library](https://github.com/mossmann/hackrf) is installed in your system. If you build it from source and install it in a custom location say: `/opt/install/libhackrf` you will have to add `-DLIBHACKRF_INCLUDE_DIR=/opt/install/libhackrf/include -DLIBHACKRF_LIBRARIES=/opt/install/libhackrf/lib/libhackrf.so` to the cmake command line. + +The HackRF Host library is also provided by many Linux distributions and is built in the SDRangel binary releases. + +

Interface

+ +![HackRF input plugin GUI](../../../doc/img/HackRFInput_plugin.png) + +

1: Common stream parameters

+ +![SDR Daemon FEC stream GUI](../../../doc/img/SDRdaemonFEC_plugin_01.png) + +

1.1: Frequency

+ +This is the center frequency of reception in kHz. + +

1.2: Start/Stop

+ +Device start / stop button. + + - Blue triangle icon: device is ready and can be started + - Green square icon: device is running and can be stopped + - Red square icon: an error occured. In the case the device was accidentally disconnected you may click on the icon, plug back in and start again. + +Please note that HackRF is a half duplex device so if you have the Tx open in another tab you have to stop it first before starting the Rx for it to work properly. In a similar manner you should stop the Rx before resuming the Tx. + +The settings on Tx or Rx tab are reapplied on start so provided the half duplex is handled correctly as stated above these settings can be considered independent. + +

1.3: Record

+ +Record baseband I/Q stream toggle button + +

1.4: Baseband sample rate

+ +Baseband I/Q sample rate in kS/s. This is the device sample rate (4) divided by the decimation factor (6). + +

2: Local Oscillator correction

+ +Use this slider to adjust LO correction in ppm. It can be varied from -10.0 to 10.0 in 0.1 steps and is applied in software. + +

3: Auto correction options

+ +These buttons control the local DSP auto correction options: + + - **DC**: auto remove DC component + - **IQ**: auto make I/Q balance + +

4: Bias tee

+ +Use this checkbox to toggle the +5V power supply on the antenna connector. + +

5:RF amp

+ +Use this checkbox to toggle the extra low noise amplifier (LNA). This gives an additional gain of 14 dB. + +

6: Device sample rate

+ +This is the HackRF device ADC sample rate in kS/s. Possible values are: 2400, 3200, 4800, 5600, 6400, 8000, 9600, 12800, 19200 kS/s. + +

7: Rx filter bandwidth

+ +This is the Rx filter bandwidth in kHz. Possible values are: 1750, 2500, 3500, 5000, 5500, 6000, 7000, 8000, 9000, 10000, 12000, 14000, 15000, 20000, 24000, 28000 kHz. + +

8: Decimation factor

+ +The device stream from the HackRF is decimated to obtain the baseband stream. Possible values are: + + - **1**: no decimation + - **2**: divide devcie stream sample rate by 2 + - **4**: divide devcie stream sample rate by 4 + - **8**: divide devcie stream sample rate by 8 + - **16**: divide devcie stream sample rate by 16 + - **32**: divide devcie stream sample rate by 32 + +

10: Internal LNA gain

+ +The LNA gain can be adjusted from 0 dB to 40 dB in 8 dB steps. + +

11: Rx variable gain amplifier gain

+ +The Rx VGA gain can be adjusted from 0 dB to 62 dB in 2 dB steps.