mirror of https://github.com/f4exb/sdrangel.git synced 2024-12-03 21:43:24 -05:00

History

f4exb 511686f820 Use new audio fifo based on audio sample type		2017-08-25 00:02:49 +02:00
..
CMakeLists.txt	Channel plugins: Removed useless link dependency on QT OpenGL and Multimedia	2016-10-27 08:46:06 +02:00
demodssb.pro	Windows build: set SSE options for all demodulator plugins	2016-11-07 18:57:52 +01:00
readme.md	SSB demod: updated documentation	2017-08-06 23:16:25 +02:00
ssbdemod.cpp	Use new audio fifo based on audio sample type	2017-08-25 00:02:49 +02:00
ssbdemod.h	Moved audio sample definitions to dsp types definitions	2017-08-24 15:24:28 +02:00
ssbdemodgui.cpp	SSB demod plugin: slow down channel power refresh rate	2017-08-17 17:43:27 +02:00
ssbdemodgui.h	SSB demod plugin: slow down channel power refresh rate	2017-08-17 17:43:27 +02:00
ssbdemodgui.ui	SSB demod: make AGC clamping optional	2017-08-06 00:58:30 +02:00
ssbplugin.cpp	SSB demod: make AGC clamping optional	2017-08-06 00:58:30 +02:00
ssbplugin.h	Tx ph.1: plugins (2)	2016-10-13 23:42:08 +02:00

readme.md

SSB/DSB demodulator plugin

Introduction

This plugin can be used to listen to a single sideband or double sidebands modulated signal.

Interface

☞ In order to toggle USB or LSB mode in SSB mode you have to set the "BW" in channel filter cutoff control (9) to a positive (USB) or negative (LSB) value. The above screenshot shows a LSB setup. See the (8) to (10) paragraphs below for details.

☞ The channel marker in the main spectrum display shows the actual band received taking in channel filtering into account.

1: Frequency shift from center frequency of reception

Use the wheels to adjust the frequency shift in Hz from the center frequency of reception. Left click on a digit sets the cursor position at this digit. Right click on a digit sets all digits on the right to zero. This effectively floors value at the digit position. Wheels are moved with the mousewheel while pointing at the wheel or by selecting the wheel with the left mouse click and using the keyboard arroews. Pressing shift simultanoeusly moves digit by 5 and pressing control moves it by 2.

3: Channel power

Average total power in dB relative to a +/- 1.0 amplitude signal received in the pass band.

4: Monaural/binaural toggle

Monaural: the scalar signal is routed to both left and right audio channels
Binaural: the complex signal is fed with the real part on the left audio channel and the imaginary part to the right audio channel

5: Invert left and right channels

Inverts left and right audio channels. Useful in binaural mode only.

6: SSB/DSB demodulation

Toggles between SSB (icon with one sideband signal) and DSB (icon with double sidebands signal)

7: Level meter in dB

top bar (green): average value
bottom bar (blue green): instantaneous peak value
tip vertical bar (bright green): peak hold value

8: Spectrum display frequency span

The 48 kHz channel sample rate is further decimated by powers of two for the spectrum display and in channel filter limits. This effectively sets the total available bandwidth depending on the decimation:

1 (no decimation): 24 kHz (SSB) or 48 kHz (DSB)
2: 12 kHz (SSB) or 24 kHz (DSB)
4: 6 kHz (SSB) or 12 kHz (DSB)
8: 3 kHz (SSB) or 6 kHz (DSB)
16: 1.5 kHz (SSB) or 3 kHz (DSB)

The span value display is set as follows depending on the SSB or DSB mode:

In SSB mode: the span goes from zero to the upper (USB: positive frequencies) or lower (LSB: negative frequencies) limit and the absolute value of the limit is displayed.
In DSB mode: the span goes from the lower to the upper limit of same absolute value and ± the absolute value of the limit is displayed.

This is how the Span (8) and bandpass (9, 10) fitler controls look like in the 3 possible modes:

DSB:

Decimation factor is 4 hence span is 6 kHz from -3 to +3 kHz and ±3.0k is displayed
In channel filter bandwidth is 4.8 kHz from -2.4 to +2.4 kHz and ±2.4k is displayed
In channel filter "low cut" is disabled and set to 0

USB:

Decimation factor is 4 hence span is 3 kHz from 0 to 3 kHz and 3.0k is displayed
In channel filter upper cutoff is 2.4 kHz and 2.4k is displayed
In channel filter lower cutoff is 0.3 kHz and 0.3k is displayed
Hence in channel filter bandwidth is 2.1 kHz

LSB:

Decimation factor is 4 hence span is 3 kHz from 0 to -3 kHz and 3.0k is displayed
In channel filter lower cutoff is -2.4 kHz and -2.4k is displayed
In channel filter upper cutoff is -0.3 kHz and -0.3k is displayed
Hence in channel filter bandwidth is 2.1 kHz

9: "BW": In channel bandpass filter cutoff frequency farthest from zero

Values are expressed in kHz and step is 100 Hz.

In SSB mode this is the upper (USB: positive frequencies) or lower (LSB: negative frequencies) cutoff of the in channel single side band bandpass filter. The value triggers LSB mode when negative and USB when positive
In DSB mode this is half the bandwidth of the double side band in channel bandpass filter therefore the value is prefixed with the ± sign.

10: "Low cut": In channel bandpass filter cutoff frequency closest to zero

Values are expressed in kHz and step is 100 Hz.

In SSB mode this is the lower cutoff (USB: positive frequencies) or higher cutoff (LSB: negative frequencies) of the in channel signe side band bandpass filter.
In DSB mode it is inactive and set to zero (double side band filter).

11: Volume and AGC

11.1: Volume

This is the volume of the audio signal from 0.0 (mute) to 10.0 (maximum). It can be varied continuously in 0.1 steps using the dial button.

11.2: AGC toggle

Use this checkbox to toggle AGC on and off.

If you are into digging weak signals out of the noise you probably will not turn the AGC on. AGC is intended for medium and large signals and help accomodate the signal power variations from a station to another or due to QSB.

This AGC is based on the calculated magnitude (square root of power of the filtered signal as I² + Q²) and will try to adjust audio volume as if a -20dB power signal was received.

11.2A: AGC clamping

When on this clamps signal at the maximum amplitude. Normally this is not needed for most signals as the AGC amplitude order is quite conservative at 10% of the maximum. You may switch it on if you notice a loud click when a transmission starts.

11.3: AGC time constant

This is the time window in milliseconds of the moving average used to calculate the signal power average. It can be varied in powers of two from 16 to 2048 ms that is: 16, 32, 64, 128, 256, 512, 1024 and 2048 ms. The most practical values are between 128 and 512 ms.

11.4: Signal power threshold (squelch)

Active only in AGC mode.

This threshold acts as a squelch and will mute the sound below this average signal power. To prevent short transient drop outs the squelch gets active only if the power has been below the threshold for a period equal to the AGC time constant (11.3)

This feature is mostly useful when more than one SSB channel is active. When there is no transmission the level of noise rises at the level of a normal signal due to the AGC and adds to the noise of other channels. Therefore it is desirable to shut down the audio when there is no signal in the channel.

To turn off the squelch completely move the knob all the way down (left). Then "---" will display as the value and the squelch will be disabled.

The signal power is calculated as the moving average over the AGC time constant (11.3) of the power of the filtered signal as I² + Q².

11.5: Signal power threshold (squelch) gate

Active only in AGC mode with squelch enabled.

To avoid unwanted squelch opening on short transient bursts only signals wilth power above threshold during this period in milliseconds will open the squelch.It can be varied from 0 to 20 ms in 1 ms steps.

When the power threshold is close to the noise floor a few milliseconds help in preventing noise power wiggle to open the squelch.

12: Audio mute

Use this button to toggle audio mute for this channel.

13: Spectrum display

This is the spectrum display of the demodulated signal (SSB) or translated signal (DSB). Controls on the bottom of the panel are identical to the ones of the main spectrum display.