Frequency Xlating FIR Filter

From GNU Radio
Revision as of 13:06, 19 May 2024 by Duggabe (talk | contribs) (add (R) flag to Taps and Center Frequency)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

The Frequency Translating Finite Impulse Response Filter block performs a frequency translation on the signal and simultaneously downsamples the signal via a decimating FIR filter. The main use of this block is an effective channelizer, to pull out a narrowband portion of a wideband signal, without that narrowband portion having to be centered in frequency. Channelization in this manner is particularly useful for Software Defined Radios (SDRs) that capture a wide bandwidth via a very high sampling rate, yet the desired signal only occupies a narrow slice of bandwidth.

Freq-xlating-filter.png

This block does not support C++ output, so it cannot be used when the output language of a flowgraph in GRC is C++.

See this page for more details.

Parameters

(R): Run-time adjustable

Decimation
The integer ratio between the input and the output signal’s sampling rate.
Taps (R)
The vector of the complex or real taps of the FIR filter. You can generate these taps within the parameter box using firdes, for example:
Real taps:
 firdes.low_pass(1,samp_rate,samp_rate/(2*decimation), transition_bw)
Complex taps:
 firdes.complex_band_pass(1, samp_rate, -samp_rate/(2*decimation), samp_rate/(2*decimation), transition_bw)
Note: transition_bw is the transition bandwidth of the filter in Hz. The lower it is, the more taps the function will generate, and the more CPU time it will take to apply this filter. This parameter will determine the CPU usage and thus the execution speed of the block.
Center Frequency (R)
The frequency translation offset frequency.
Sample Rate
The sample rate of the input signal.

Example Flowgraph

Example 1

Since sampling rate is mathematically correlated to the captured bandwidth via the Nyquist–Shannon sampling theorem, this block can safely downsample while isolating a narrow signal. This makes the block operationally identical to a series of Rotator, Bandpass, and Rational Resampler blocks, except the Frequency Xlating FIR Filter block does all these steps at once much more efficiently. So if your SDR is delivering I/Q samples at 2.56 million samples/second, but your Frequency-Shift Keying signal is 20 kHz wide, you can use the block to downsample to a minimum of 40 kS/s, saving substantial CPU resources in future processing steps. In practice though, it is often handy to use a higher-than-minimum sampling rate; this gives you extra samples that can be used for filter roll-off, averaged out to help pull a pulse signal out of noise, or for other purposes.

In the above example, Taps is set to firdes.band_pass(1.0, samp_rate, fsk_deviation/2 - bandpass_filter_width, fsk_deviation/2 + bandpass_filter_width, bandpass_filter_width), Center Frequency is set to recording_offset + (fsk_deviation / 2) and Sampling Rate is set to samp_rate. Due to the decimation factor of 2, the sampling rate on the output is now half.

Example 2

This flowgraph uses the Frequency Xlating FIR Filter block to center Frequency Shift Keying tones around zero. Then a Quadrature Demod block can detect the high and low tones as positive or negative values. This decodes RTTY.

RTTY rcv.png

Source Files

C++ files
freq_xlating_fir_filter_impl.cc
Header files
freq_xlating_fir_filter_impl.h
Block definition
filter_freq_xlating_fir_filter_xxx.block.yml