SSB: updated documentation

pull/127/head v3.8.5
f4exb 2017-12-02 18:57:55 +01:00
rodzic 8d3541c5ad
commit 1d442fd077
12 zmienionych plików z 95 dodań i 83 usunięć

Plik binarny nie jest wyświetlany.

Przed

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

Po

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

Plik binarny nie jest wyświetlany.

Plik binarny nie jest wyświetlany.

Przed

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

Po

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

Plik binarny nie jest wyświetlany.

Plik binarny nie jest wyświetlany.

Przed

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

Po

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

Plik binarny nie jest wyświetlany.

Plik binarny nie jest wyświetlany.

Przed

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

Po

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

Plik binarny nie jest wyświetlany.

Plik binarny nie jest wyświetlany.

Przed

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

Po

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

Plik binarny nie jest wyświetlany.

Wyświetl plik

@ -16,22 +16,26 @@ This plugin can be used to listen to a single sideband or double sidebands modul
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.
<h3>3: Channel power</h3>
<h3>2: Channel power</h3>
Average total power in dB relative to a +/- 1.0 amplitude signal received in the pass band.
<h3>4: Monaural/binaural toggle</h3>
<h3>3: Monaural/binaural toggle</h3>
- 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
<h3>5: Invert left and right channels</h3>
<h3>4: Invert left and right channels</h3>
Inverts left and right audio channels. Useful in binaural mode only.
<h3>5: Sideband flip</h3>
Flip LSB/USB. Mirror filter bandwidth around zero frequency and change from LSB to USB or vice versa. Works in SSB mode only.
<h3>6: SSB/DSB demodulation</h3>
Toggles between SSB (icon with one sideband signal) and DSB (icon with double sidebands signal)
Toggles between SSB (icon with one sideband signal) and DSB (icon with double sidebands signal). In SSB mode the shape of the icon represents LSB or USB operation.
<h3>7: Level meter in dB</h3>
@ -61,7 +65,7 @@ This is how the Span (8) and bandpass (9, 10) fitler controls look like in the 3
![SSB Demodulator band controls DSB](../../../doc/img/SSBDemod_plugin_dsb.png)
- Decimation factor is 4 hence span is 6 kHz from -3 to +3 kHz and &#177;3.0k is displayed
- In channel filter bandwidth is 4.8 kHz from -2.4 to +2.4 kHz and &#177;2.4k is displayed
- In channel filter bandwidth is 5.2 kHz from -2.6 to +2.6 kHz and &#177;2.6k is displayed
- In channel filter "low cut" is disabled and set to 0
**USB**:
@ -69,18 +73,18 @@ This is how the Span (8) and bandpass (9, 10) fitler controls look like in the 3
![SSB Demodulator band controls USB](../../../doc/img/SSBDemod_plugin_usb.png)
- 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 upper cutoff is 2.6 kHz and 2.6k 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
- Hence in channel filter bandwidth is 2.3 kHz
**LSB**:
![SSB Demodulator band controls LSB](../../../doc/img/SSBDemod_plugin_lsb.png)
- 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 lower cutoff is -2.6 kHz and -2.6k 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
- Hence in channel filter bandwidth is 2.3 kHz
<h3>9: "BW": In channel bandpass filter cutoff frequency farthest from zero</h3>
@ -140,10 +144,14 @@ To avoid unwanted squelch opening on short transient bursts only signals wilth p
When the power threshold is close to the noise floor a few milliseconds help in preventing noise power wiggle to open the squelch.
<h3>12: Audio mute</h3>
<h3>12: Copy audio to UDP</h3>
Copies audio output to UDP. Output is mono S16LE samples regardless of binaural/monaural operation.
<h3>13: Audio mute</h3>
Use this button to toggle audio mute for this channel.
<h3>13: Spectrum display</h3>
<h3>14: 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.

Wyświetl plik

@ -16,63 +16,27 @@ This plugin can be used to generate a single sideband or double sidebands modula
Use the wheels to adjust the frequency shift in Hz from the center frequency of transmission. 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.
<h3>2: Audio compression</h3>
![SSB Modulator plugin compressor GUI](../../../doc/img/SSBModulator_plugin_cmp.png)
The audio compressor uses the same AGC as on the receive side (SSB demodulator) with the following changes:
- The clamping is always active to prevent modulation overload
- The amplitude (magnitude) order control is tunable (2.2)
- The squelch delay after return below threshold is tunable (2.6)
The audio compressor works only in monaural mode controlled by (4)
<h4>2.1: Audio compressor toggle</h4>
Use this button to toggle audio compressor on and off. In "on" mode the button is lit as on the picture.
<h4>2.2: AGC magnitude order</h4>
This is the ratio to maximum signal magnitude aimed by the AGC. The higher the stronger is the compression but the signal will have more chances to get clamped and therefore will get more severly distorted.
The default value is 0.2 which is rather mild. For normal voice you should not exceed 0.4 however the criteria is rather subjective. It is flexible enough to be tuned between 0 and 1 in 0.01 increments.
<h4>2.3: AGC time constant</h4>
Audio power is averaged during this period in ms. The lower the closer the compression reacts to audio signal variations and the "harder" it feels. This period can be set among these values: 1, 2, 5, 10, 20, 50, 100, 200, 500, 990 ms
The default value is 200 ms which is relatively "soft". Most practically useful values are between 20 and 500 ms.
<h4>2.4: Power threshold</h4>
in order to avoid small signals due to background noise or power wiggle to enter the system and raise to normal voice level a power based squelch is in place. This control allows to select a threshold in dB above which a signal will open the squalch if it lasts longer than the squelch gate (2.5). Default is -40 dB.
<h4>2.5: Squelch gate</h4>
This prevents short bursts to open the squelch. This is the time in ms after a signal with a power constantly above the threshold will effectively open the squelch. Default is 4 ms.
<h4>2.6: Squelch cut-off delay</h4>
This controls the delay in ms after which a signal drop below threshold will close the squelch. Default value is 50 ms.
<h3>3: Channel power</h3>
<h3>2: Channel power</h3>
Average total power in dB relative to a +/- 1.0 amplitude signal generated in the pass band.
<h3>4: Binaural mode</h3>
<h3>3: Binaural mode</h3>
Use this button to toggle between monaural and binaural mode. Monaural is classical single sideband or double sidebands modulation. In binaural mode I and Q samples are taken from the left and right stereo channels (or reversed).
When in monaural mode the icon shows a single loudspeaker and when in binaural mode it shows a pair of loudspeakers.
<h3>5: Reverse left and right channels in binaural mode</h3>
<h3>4: Reverse left and right channels in binaural mode</h3>
Effective only in binaural mode: reverses left and right audio channels so that the left is connected to Q and the right to the I complex signal channel.
<h3>5: Sideband flip</h3>
Flip LSB/USB. Mirror filter bandwidth around zero frequency and change from LSB to USB or vice versa. Works in SSB mode only.
<h3>6: SSB/DSB</h3>
Selects between SSB and DSB operation. When in SSB mode the icon shows a single sideband spectrum (USB side). When in DSB mode the icon shows a double sideband spectrum.
Selects between SSB and DSB operation. When in SSB mode the icon shows a single sideband spectrum (USB side). When in DSB mode the icon shows a double sideband spectrum. In SSB mode the shape of the icon represents LSB or USB operation.
<h3>7: Spectrum display frequency span</h3>
@ -96,7 +60,7 @@ This is how the Span (7) and bandpass (8, 9) fitler controls look like in the 3
![SSB Demodulator band controls DSB](../../../doc/img/SSBDemod_plugin_dsb.png)
- Decimation factor is 4 hence span is 6 kHz from -3 to +3 kHz and &#177;3.0k is displayed
- In channel filter bandwidth is 4.8 kHz from -2.4 to +2.4 kHz and &#177;2.4k is displayed
- In channel filter bandwidth is 5.2 kHz from -2.6 to +2.6 kHz and &#177;2.4k is displayed
- In channel filter "low cut" is disabled and set to 0
**USB**:
@ -104,18 +68,18 @@ This is how the Span (7) and bandpass (8, 9) fitler controls look like in the 3
![SSB Demodulator band controls USB](../../../doc/img/SSBDemod_plugin_usb.png)
- 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 upper cutoff is 2.4 kHz and 2.6k 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
- Hence in channel filter bandwidth is 2.3 kHz
**LSB**:
![SSB Demodulator band controls LSB](../../../doc/img/SSBDemod_plugin_lsb.png)
- 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 lower cutoff is -2.6 kHz and -2.6k 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
- Hence in channel filter bandwidth is 2.3 kHz
<h3>8: "BW": In channel bandpass filter cutoff frequency farthest from zero</h3>
@ -143,39 +107,79 @@ This is the volume of the audio signal from 0.0 (mute) to 2.0 (maximum). It can
You should aim at keepimg the peak value below 100% using the volume control
<h3>12: Input source control</h3>
<h3>12: Audio compression</h3>
![SSB Modulator plugin compressor GUI](../../../doc/img/SSBModulator_plugin_cmp.png)
The audio compressor uses the same AGC as on the receive side (SSB demodulator) with the following changes:
- The clamping is always active to prevent modulation overload
- The amplitude (magnitude) order control is tunable (2.2)
- The squelch delay after return below threshold is tunable (2.6)
The audio compressor works only in monaural mode controlled by (4)
<h4>12.1: Audio compressor toggle</h4>
Use this button to toggle audio compressor on and off. In "on" mode the button is lit as on the picture.
<h4>12.2: AGC magnitude order</h4>
This is the ratio to maximum signal magnitude aimed by the AGC. The higher the stronger is the compression but the signal will have more chances to get clamped and therefore will get more severly distorted.
The default value is 0.2 which is rather mild. For normal voice you should not exceed 0.4 however the criteria is rather subjective. It is flexible enough to be tuned between 0 and 1 in 0.01 increments.
<h4>12.3: AGC time constant</h4>
Audio power is averaged during this period in ms. The lower the closer the compression reacts to audio signal variations and the "harder" it feels. This period can be set among these values: 1, 2, 5, 10, 20, 50, 100, 200, 500, 990 ms
The default value is 200 ms which is relatively "soft". Most practically useful values are between 20 and 500 ms.
<h4>12.4: Power threshold</h4>
in order to avoid small signals due to background noise or power wiggle to enter the system and raise to normal voice level a power based squelch is in place. This control allows to select a threshold in dB above which a signal will open the squalch if it lasts longer than the squelch gate (2.5). Default is -40 dB.
<h4>12.5: Squelch gate</h4>
This prevents short bursts to open the squelch. This is the time in ms after a signal with a power constantly above the threshold will effectively open the squelch. Default is 4 ms.
<h4>12.6: Squelch cut-off delay</h4>
This controls the delay in ms after which a signal drop below threshold will close the squelch. Default value is 50 ms.
<h3>13: Input source control</h3>
![Modulator input source control GUI](../../../doc/img/ModControls.png)
<h4>12.1: Tone input select</h4>
<h4>13.1: Tone input select</h4>
Switches to the tone input. You must switch it off to make other inputs available.
<h4>12.2: Morse keyer input select</h4>
<h4>13.2: Morse keyer input select</h4>
Switches to the Morse keyer input. You must switch it off to make other inputs available.
<h4>12.3: Tone frequency (kHz)</h4>
<h4>13.3: Tone frequency (kHz)</h4>
Adjusts the tone frequency from 0.1 to 2.5 kHz in 0.01 kHz steps
<h4>12.4: Audio input select</h4>
<h4>13.4: Audio input select</h4>
Switches to the audio input. You must switch it off to make other inputs available.
<h3>13: CW (Morse) text</h3>
<h3>14: CW (Morse) text</h3>
Enter the text to be keyed when Morse input is active and in text mode
<h3>14: Clear CW text</h3>
<h3>15: Clear CW text</h3>
Clears the CW (Morse) text
<h3>15: Morse keyer controls</h3>
<h3>16: Morse keyer controls</h3>
![Morse keyer control GUI](../../../doc/img/ModCWControls.png)
<h4>15.1: CW keying speed</h4>
<h4>16.1: CW keying speed</h4>
Sets the CW speed in Words Per Minute (WPM). This is based on the word "PARIS" sent 5 times. For 5 WPM the dot length is 240 ms. In other terms the dot length is calculated as 1.2 / WPM seconds. The dot length is used as the base to compute other timings:
@ -184,58 +188,58 @@ Sets the CW speed in Words Per Minute (WPM). This is based on the word "PARIS" s
- Character silence separator: 3 dot lengths
- Word silence separator: 7 dot lengths
<h4>15.2: Dots keying</h4>
<h4>16.2: Dots keying</h4>
Switch this button to send dots continuously
<h4>15.3: Dashes keying</h4>
<h4>16.3: Dashes keying</h4>
Switch this button to send dashes continuously
<h4>15.4: Text keying</h4>
<h4>16.4: Text keying</h4>
Switch this button to send the text typed into the text box (13)
<h4>15.5: Text auto repeat</h4>
<h4>16.5: Text auto repeat</h4>
Switch this button to auto repeat the text keying
<h4>15.6: Text play/stop</h4>
<h4>16.6: Text play/stop</h4>
Use this button to stop sending text. When resuming keying restarts at the start of text
<h3>16: Audio file path</h3>
<h3>17: Audio file path</h3>
The path to the selected audio file to be played or dots if unselected
<h3>17: Audio file play controls</h3>
<h3>18: Audio file play controls</h3>
![Modulator audio file play control GUI](../../../doc/img/ModFileControls.png)
<h4>17.1: Audio file select</h4>
<h4>18.1: Audio file select</h4>
Opens a file dialog to select the audio file to be played. It must be mono 48 kHz 16LE raw format.
<h4>17.2: Audio file loop</h4>
<h4>18.2: Audio file loop</h4>
Audio replay file at the end
<h4>17.3: Play/pause file play</h4>
<h4>18.3: Play/pause file play</h4>
Toggle play/pause file play. When paused the slider below (20) can be used to randomly set the position in the file when re-starting.
<h3>18: Play file current position</h3>
<h3>19: Play file current position</h3>
This is the current audio file play position in time units relative to the start
<h3>19: Play file length</h3>
<h3>20: Play file length</h3>
This is the audio file play length in time units
<h3>20: Play file position slider</h3>
<h3>21: Play file position slider</h3>
This slider can be used to randomly set the currennt position in the file when file play is in pause state (button 17.3)
<h3>21: Channel spectrum display</h3>
<h3>22: Channel spectrum display</h3>
This is the channel spectrum display. Controls at the bottom of the panel are the same as with the central spectrum display.