Soapy HackRF Source: Difference between revisions

From GNU Radio
Jump to navigation Jump to search
(initial creation)
 
(Added description and image of the HackRF One along with an example flowgraph.)
Line 1: Line 1:
<!-- Soapy_HackRF_Source.mediawiki -->
<!-- Soapy_HackRF_Source.mediawiki -->
<!-- /dcs/local/share/gnuradio/grc/blocks/soapy_hackrf_source.block.yml -->
<!-- /dcs/local/share/gnuradio/grc/blocks/soapy_hackrf_source.block.yml -->
Statement of purpose / function<br>
 
This block controls the HackRF One software defined radio. The HackRF One tunes from 1 - 6000 MHz, provides 8-bit digitizing, and sample rates up to 20 MHz over a USB2 connection. This block controls the following parameters:
* Center frequency: (1 MHz - 6 GHz).
* Sample rate: up to 20 MHz.
* RF amplifier: +14 dB when on.
* IF amplifier: up to 40 dB. This controls an amplifier just before the quadrature demodulator (conversion of real to complex signal).
* Video gain amplifier (VGA): up to 62 dB. This controls an amplifier just after the quadrature demodulator. NOTE: "Video" here does not mean "moving pictures"; rather, it is an older term used for baseband signals.
 
[[File:HackRF-One-fully-annotated.jpg|700px]]
 
''Board view of the HackRF One. The '''RF Gain''' value controls the RF amplifier, while the '''IF Gain''' and '''VGA Gain''' control the RF transceiver.''
 
== Parameters ==
== Parameters ==
<b>(R):</b> <span class="plainlinks">[https://wiki.gnuradio.org/index.php/GNURadioCompanion#Variable_Controls <b>Run-time adjustable</b>]</span><br>
<b>(R):</b> <span class="plainlinks">[https://wiki.gnuradio.org/index.php/GNURadioCompanion#Variable_Controls <b>Run-time adjustable</b>]</span><br>
Line 12: Line 23:


;Sample Rate
;Sample Rate
:default: 'samp_rate'
:default: '''samp_rate''', allowable values are 1 - 20 MHz in 1 MHz increments.


;Bandwidth (0=auto)
;Bandwidth (0=auto)
:default: '0'
:default: '''0'''


;'Center Freq (Hz)'
;Center Freq (Hz)
:default: 'freq'
:default: '''freq''', allowable values are 1- 6000 MHz.


;'Amp On (+14 dB)'
;Amp On (+14 dB)
:default: 'False'
:default: '''False''', when set to '''True''', the amplifier provides +14 dB of gain and ~2 dB of noise figure.


;'IF Gain (0dB - 40dB)'
;IF Gain (0dB - 40dB)
:default: '16'
:default: '''16'''


;'VGA Gain (0dB - 62dB)'
;VGA Gain (0dB - 62dB)
:default: '16'
:default: '''16'''


== Example Flowgraph ==
== Example Flowgraph ==
This flowgraph uses the HackRF One to tune in the [https://www.weather.gov/nwr/ USA's NOAA Weather Radio service].
[[ File:SoapyHackrfSource.jpg|700px]]


== Example Output ==
== Example Output ==
The flowgraph will produce a display similar to that below.
[[File:SoapyHackRF-Source-display.png|700px]]
The specific display of signals is restricted to the United States and depends on the antenna and location.


== Source Files ==
== Source Files ==

Revision as of 14:49, 29 July 2025


This block controls the HackRF One software defined radio. The HackRF One tunes from 1 - 6000 MHz, provides 8-bit digitizing, and sample rates up to 20 MHz over a USB2 connection. This block controls the following parameters:

  • Center frequency: (1 MHz - 6 GHz).
  • Sample rate: up to 20 MHz.
  • RF amplifier: +14 dB when on.
  • IF amplifier: up to 40 dB. This controls an amplifier just before the quadrature demodulator (conversion of real to complex signal).
  • Video gain amplifier (VGA): up to 62 dB. This controls an amplifier just after the quadrature demodulator. NOTE: "Video" here does not mean "moving pictures"; rather, it is an older term used for baseband signals.

HackRF-One-fully-annotated.jpg

Board view of the HackRF One. The RF Gain value controls the RF amplifier, while the IF Gain and VGA Gain control the RF transceiver.

Parameters

(R): Run-time adjustable

Output Type
options: [Complex Float32, Complex Int16, Complex Byte]
Device arguments
dtype: string
Sample Rate
default: samp_rate, allowable values are 1 - 20 MHz in 1 MHz increments.
Bandwidth (0=auto)
default: 0
Center Freq (Hz)
default: freq, allowable values are 1- 6000 MHz.
Amp On (+14 dB)
default: False, when set to True, the amplifier provides +14 dB of gain and ~2 dB of noise figure.
IF Gain (0dB - 40dB)
default: 16
VGA Gain (0dB - 62dB)
default: 16

Example Flowgraph

This flowgraph uses the HackRF One to tune in the USA's NOAA Weather Radio service.

SoapyHackrfSource.jpg

Example Output

The flowgraph will produce a display similar to that below.

SoapyHackRF-Source-display.png

The specific display of signals is restricted to the United States and depends on the antenna and location.

Source Files

C++ files
TODO
Header files
TODO
Public header files
TODO
Block definition
soapy_hackrf_source.block.yml