1
0
mirror of https://github.com/f4exb/sdrangel.git synced 2024-11-05 00:11:16 -05:00
sdrangel/plugins/channeltx/modssb/readme.md

201 lines
8.2 KiB
Markdown
Raw Normal View History

2016-12-18 18:31:25 -05:00
<h1>SSB modulator plugin</h1>
<h2>Introduction</h2>
This plugin can be used to generate a single sideband or double sidebands modulated signal.
<h2>Interface</h2>
![SSB Modulator plugin GUI](../../../doc/img/SSBModulator_plugin.png)
2016-12-18 18:31:25 -05:00
2017-07-22 05:48:52 -04:00
&#9758; In order to toggle USB or LSB mode in SSB mode you have to set the "BW" in channel filter cutoff control (8) to a positive (USB) or negative (LSB) value. The above screenshot shows a USB setup. See the (7) to (9) paragraphs below for details.
&#9758; The channel marker in the main spectrum display shows the actual band received taking in channel filtering into account.
<h3>1: Frequency shift from center frequency of transmission</h3>
2016-12-18 18:31:25 -05:00
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.
2016-12-18 18:31:25 -05:00
<h3>3: 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>
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>
2016-12-19 07:09:13 -05:00
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.
2016-12-18 18:31:25 -05:00
<h3>6: SSB/DSB</h3>
2016-12-19 07:09:13 -05:00
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.
2016-12-18 18:31:25 -05:00
<h3>7: Spectrum display frequency span</h3>
2017-07-22 05:48:52 -04:00
The transmitted signal in the sideband (SSB) or sidebands (DSB) sample rate of 48 kHz is further decimated by a power of two before being applied to the channel spectrum display and used to set the 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 &#177; the absolute value of the limit is displayed.
This is how the Span (7) and bandpass (8, 9) fitler controls look like in the 3 possible modes:
**DSB**:
![SSB Demodulator band controls DSB](../../../doc/img/SSBDemod_plugin_dsb.png)
2017-07-22 06:02:09 -04:00
- 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 "low cut" is disabled and set to 0
2017-07-22 05:48:52 -04:00
**USB**:
![SSB Demodulator band controls USB](../../../doc/img/SSBDemod_plugin_usb.png)
2017-07-22 06:02:09 -04:00
- 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
2017-07-22 05:48:52 -04:00
**LSB**:
![SSB Demodulator band controls LSB](../../../doc/img/SSBDemod_plugin_lsb.png)
2017-07-22 06:02:09 -04:00
- 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
2017-07-22 05:48:52 -04:00
<h3>8: "BW": In channel bandpass filter cutoff frequency farthest from zero</h3>
2016-12-18 18:31:25 -05:00
2017-07-22 05:48:52 -04:00
Values are expressed in kHz and step is 100 Hz.
2016-12-18 18:31:25 -05:00
2017-07-22 05:48:52 -04:00
- 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.
2016-12-18 18:31:25 -05:00
2017-07-22 05:48:52 -04:00
<h3>9: "Low cut": In channel bandpass filter cutoff frequency closest to zero</h3>
2016-12-18 18:31:25 -05:00
2017-07-22 05:48:52 -04:00
Values are expressed in kHz and step is 100 Hz.
2016-12-18 18:31:25 -05:00
2017-07-22 05:48:52 -04:00
- 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).
2016-12-18 18:31:25 -05:00
<h3>10: Volume</h3>
This is the volume of the audio signal from 0.0 (mute) to 2.0 (maximum). It can be varied continuously in 0.1 steps using the dial button. The Loudspeaker button is the audio mute toggle.
<h3>11: Level meter in %</h3>
- top bar (beige): average value
- bottom bar (brown): instantaneous peak value
- tip vertical bar (bright red): peak hold value
You should aim at keepimg the peak value below 100% using the volume control
<h3>12: Input source control</h3>
![Modulator input source control GUI](../../../doc/img/ModControls.png)
<h4>12.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>
Switches to the Morse keyer input. You must switch it off to make other inputs available.
<h4>12.3: Tone frequency (kHz)</h4>
2016-12-19 07:09:13 -05:00
Adjusts the tone frequency from 0.1 to 2.5 kHz in 0.01 kHz steps
2016-12-18 18:31:25 -05:00
<h4>12.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>
Enter the text to be keyed when Morse input is active and in text mode
<h3>14: Clear CW text</h3>
Clears the CW (Morse) text
<h3>15: Morse keyer controls</h3>
![Morse keyer control GUI](../../../doc/img/ModCWControls.png)
<h4>15.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:
- Element (dot or dash) silence separator: 1 dot length
- Dash: 3 dot lengths
- Character silence separator: 3 dot lengths
2016-12-19 07:09:13 -05:00
- Word silence separator: 7 dot lengths
2016-12-18 18:31:25 -05:00
<h4>15.2: Dots keying</h4>
Switch this button to send dots continuously
<h4>15.3: Dashes keying</h4>
Switch this button to send dashes continuously
<h4>15.4: Text keying</h4>
2016-12-19 07:09:13 -05:00
Switch this button to send the text typed into the text box (13)
2016-12-18 18:31:25 -05:00
<h4>15.5: Text auto repeat</h4>
Switch this button to auto repeat the text keying
<h4>15.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>
The path to the selected audio file to be played or dots if unselected
<h3>17: Audio file play controls</h3>
![Modulator audio file play control GUI](../../../doc/img/ModFileControls.png)
<h4>17.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>
2016-12-19 07:09:13 -05:00
Audio replay file at the end
2016-12-18 18:31:25 -05:00
<h4>17.3: Play/pause file play</h4>
2016-12-19 07:09:13 -05:00
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.
2016-12-18 18:31:25 -05:00
<h3>18: 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>
2016-12-19 07:09:13 -05:00
This is the audio file play length in time units
2016-12-18 18:31:25 -05:00
2016-12-19 07:09:13 -05:00
<h3>20: Play file position slider</h3>
2016-12-18 18:31:25 -05:00
This slider can be used to randomly set the currennt position in the file when file play is in pause state (button 17.3)
2016-12-19 07:09:13 -05:00
<h3>21: Channel spectrum display</h3>
2016-12-18 18:31:25 -05:00
2016-12-19 07:09:13 -05:00
This is the channel spectrum display. Controls at the bottom of the panel are the same as with the central spectrum display.