From 17eafc64f7a979eb84af266539a7106b3b1265b2 Mon Sep 17 00:00:00 2001 From: f4exb Date: Mon, 9 Jan 2017 00:51:08 +0100 Subject: [PATCH] HackRF output plugin: documentation --- doc/img/HackRFOutput_plugin.png | Bin 0 -> 19163 bytes plugins/samplesink/hackrfoutput/readme.md | 75 ++++++++++++++++++++++ 2 files changed, 75 insertions(+) create mode 100644 doc/img/HackRFOutput_plugin.png create mode 100644 plugins/samplesink/hackrfoutput/readme.md diff --git a/doc/img/HackRFOutput_plugin.png b/doc/img/HackRFOutput_plugin.png new file mode 100644 index 0000000000000000000000000000000000000000..c395a238b43a2a39cd0d299cbfd48e3ed71f719d GIT binary patch literal 19163 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 literal 0 HcmV?d00001 diff --git a/plugins/samplesink/hackrfoutput/readme.md b/plugins/samplesink/hackrfoutput/readme.md new file mode 100644 index 000000000..b2968623e --- /dev/null +++ b/plugins/samplesink/hackrfoutput/readme.md @@ -0,0 +1,75 @@ +

HackRF output plugin

+ +

Introduction

+ +This output sample sink plugin sends its samples to a [HackRF device](https://greatscottgadgets.com/hackrf/). It is supported in Linux only. + +

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 output plugin GUI](../../../doc/img/HackRFOutput_plugin.png) + +

1: Start/Stop

+ +Device start / stop button. + + - Blue triangle icon: device is ready and can be started + - Red square icon: device is running and can be stopped + - Magenta (or pink) 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 Rx open in another tab you have to stop it first before starting the Tx for it to work properly. In a similar manner you should stop the Tx before resuming the Rx. + +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. + +

2: Baseband sample rate

+ +This is the baseband sample rate in kS/s before interpolation (5) to produce the final stream that is sent to the HackRF device. Thus this is the device sample rate (8) divided by the interpolation factor (5). + +

3: Frequency

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

4: 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. + +

5: Interpolation factor

+ +The baseband stream is interpolated by this value before being sent to the HackRF device. Possible values are: + + - **1**: no interpolation + - **2**: multiply sample rate by 2 + +Larger values introduce performance problems. + +

6: Bias tee

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

7:RF amp

+ +Use this checkbox to toggle the output amplifier (PA). This PA gives an additional gain of 14 dB. + +According to HackRF documentation the output power when the PA is engaged and the Tx VGA (10) is at full power (47dB) is the following: + + - 10 MHz to 2150 MHz: 5 dBm to 15 dBm, generally increasing as frequency decreases + - 2150 MHz to 2750 MHz: 13 dBm to 15 dBm + - 2750 MHz to 4000 MHz: 0 dBm to 5 dBm, increasing as frequency decreases + - 4000 MHz to 6000 MHz: -10 dBm to 0 dBm, generally increasing as frequency decreases + +

8: Device sample rate

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

9: Tx filter bandwidth

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

10: Tx variable gain amplifier gain

+ +The Tx VGA gain can be adjusted from 0 dB to 47 dB in 1 dB steps. See (7) for an indication on maximum output power. \ No newline at end of file