Updated documentation

pull/1253/head
f4exb 2022-05-18 23:09:22 +02:00
rodzic 0a83f50821
commit a10fe91c5d
5 zmienionych plików z 41 dodań i 14 usunięć

Plik binarny nie jest wyświetlany.

Przed

Szerokość:  |  Wysokość:  |  Rozmiar: 57 KiB

Po

Szerokość:  |  Wysokość:  |  Rozmiar: 60 KiB

Plik binarny nie jest wyświetlany.

Wyświetl plik

@ -92,12 +92,14 @@ Decode errors are very likely to happen when this value falls below 4 dB.
A choice of FFT Windows to apply to the FFT performed on the de-chirped signal is provided. These are the same windows as those used in the spectrum display. The effect of windowing is to reduce the spill over in adjacent bins at the expense of a flatter top and fatter main lobe. When the purpose is frequency detection this is not what is desired necessarily and thus the "Rectangular" window (i.e. no window) should be chosen. However a variety of windows is provided to experiment with. Experimentally the best alternative to "Rectangular" is "Kaiser" then "Bartlett" and "Hanning". The complete list is:
- **Bart**: Bartlett
- **B-H**:
- **B-H**: 4 term Blackman-Harris
- **FT**: Flat Top
- **Ham**: Hamming
- **Han**: Hanning
- **Rec**: Rectangular (no window)
- **Kai**: Kaiser with α = π
- **Black**: Blackman (3 term)
- **B-H7**: 7 term Blackman-Harris
<h3>8: Spread Factor</h3>

Wyświetl plik

@ -2,7 +2,7 @@
<h2>Introduction</h2>
This plugin can be used to listen to a single sideband or double sidebands modulated signal.
This plugin can be used to listen to a single sideband or double sidebands modulated signal. This includes CW (Morse code) signals.
<h2>Interface</h2>
@ -88,29 +88,52 @@ This is how the Span (8) and bandpass (9, 10) filter controls look like in the 3
- In channel filter upper cutoff is -0.3 kHz and -0.3k is displayed
- Hence in channel filter bandwidth is 2.3 kHz
<h3>9: "BW": In channel bandpass filter cutoff frequency farthest from zero</h3>
<h3>9: FFT filter window</h3>
The bandpass filter is a FFT filter. This controls the FFT window type:
- **Bart**: Bartlett
- **B-H**: 4 term Blackman-Harris
- **FT**: Flat top
- **Ham**: Hamming
- **Han**: Hanning
- **Rec**: Rectangular (no window)
- **Kai**: Kaiser with alpha = 2.15 (beta = 6.76) gives sidelobes &lt; -70dB
- **Blackman**: Blackman (3 term - default)
- **B-H7**: 7 term Blackman-Harris
<h3>10: Select filter in filter bank</h3>
There are 10 filters in the filter bank with indexes 0 to 9. This selects the current filter in the bank the filter index is displayed at the right of the button. The following controls are covered by the filter settings:
- Span (8)
- FFT window (9)
- BW (11)
- Low cut (12)
<h3>11: "BW": In channel bandpass filter cutoff frequency farthest from zero</h3>
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 &#177; sign.
<h3>10: "Low cut": In channel bandpass filter cutoff frequency closest to zero</h3>
<h3>12: "Low cut": In channel bandpass filter cutoff frequency closest to zero</h3>
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 single side band bandpass filter.
- In DSB mode it is inactive and set to zero (double side band filter).
<h3>11: Volume and AGC</h3>
<h3>13: Volume and AGC</h3>
![SSB volume and AGC controls](../../../doc/img/SSBDemod_plugin_vol.png)
<h4>11.1: Volume</h4>
<h4>13.1: Volume</h4>
This is the volume of the audio signal in dB from 0 (no gain) to 40 (10000). It can be varied continuously in 1 dB steps using the dial button. When AGC is engaged it is recommended to set a low value in dB not exceeding 3 db (gain 2). When AGC is not engaged the volume entirely depends on the RF power and can vary in large proportions. Hence setting the value in dB is more convenient to accommodate large differences.
<h4>11.2: AGC toggle</h4>
<h4>13.2: AGC toggle</h4>
Use this checkbox to toggle AGC on and off.
@ -118,15 +141,15 @@ If you are into digging weak signals out of the noise you probably will not turn
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.
<h4>11.2A: AGC clamping</h4>
<h4>13.2A: AGC clamping</h4>
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.
<h4>11.3: AGC time constant</h4>
<h4>13.3: AGC time constant</h4>
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.
<h4>11.4: Signal power threshold (squelch)</h4>
<h4>13.4: Signal power threshold (squelch)</h4>
Active only in AGC mode.
@ -138,7 +161,7 @@ To turn off the squelch completely move the knob all the way down (left). Then "
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².
<h4>11.5: Signal power threshold (squelch) gate</h4>
<h4>13.5: Signal power threshold (squelch) gate</h4>
Active only in AGC mode with squelch enabled.
@ -146,12 +169,12 @@ To avoid unwanted squelch opening on short transient bursts only signals with po
When the power threshold is close to the noise floor a few milliseconds help in preventing noise power wiggle to open the squelch.
<h3>13: Audio mute and audio output select</h3>
<h3>14: Audio mute and audio output select</h3>
Left click on this button to toggle audio mute for this channel.
If you right click on it a dialog will open to select the audio output device. See [audio management documentation](../../../sdrgui/audio.md) for details.
<h3>14: Spectrum display</h3>
<h3>15: Spectrum display</h3>
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. Details on the spectrum view and controls can be found [here](../../../sdrgui/gui/spectrum.md)

Wyświetl plik

@ -162,12 +162,14 @@ Controls the intensity of the grid display
Use this combo box to select which window is applied to the FFT:
- **Bart**: Bartlett
- **B-H**: Blackmann-Harris
- **B-H**: 4 term Blackman-Harris
- **FT**: Flat top
- **Ham**: Hamming
- **Han**: Hanning (default)
- **Rec**: Rectangular (no window)
- **Kai**: Kaiser with alpha = 2.15 (beta = 6.76) gives sidelobes &lt; -70dB
- **Blackman**: Blackman (3 term)
- **B-H7**: 7 term Blackman-Harris
<h4>B.2.2. FFT size</h4>