8.1 KiB
UDP source plugin
Introduction
By "source" one should undetstand a source of samples for the outside of SDRangel application. An UDP connection is established from the plugin to the given address and port and samples are directed to it.
The UDP block size or UDP payload size is fixed at 512 bytes.
The receiving application must make sure it acknowledges this block size. UDP may fragment the block but there will be a point when the last UDP block will fill up a complete block of this amount of bytes. In particular in GNUradio the UDP source block must be configured with a 512 bytes payload size.
This plugin is available for Linux and Mac O/S only.
Interface
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.
2: Input channel power
Total power in dB relative to a +/- 1.0 amplitude signal received in the pass band.
3: Output channel power
Total power in dB relative to a +/- 1.0 amplitude signal sent over UDP.
4: Type of samples
Combo box to specify the type of samples that are sent over UDP.
S16LE I/Q
: Raw I/Q samples on signed 16 bits integers with Little Endian layout. Use it with software that accepts I/Q data as input like GNUradio with theUDP source
block. The output is interleaved I and Q samplesS16LE NFM
: AF of FM demodulated signal as 16 bits signed integers with Little Endian layout. Use it with software that takes the FM demodulated audio or the discriminator output of a radio as input. Make sure you specify the appropriate signal bandwidth (see 7) according to the AF bandwidth needs. The output is a repetition of NFM samples on real part and on imaginary part this facilitates integration wtih software expecting a stereo type of input with the same samples on L and R channels. With GNURadio just use a complex to real block.S16LE NFM Mono
: This is the same as above but only one sample is output for one NFM sample. This can be used with software that accept a mono type of input likedsd
ormultimon
.S16LE USB
: AF of USB demodulated signal as 16 bits signed integers with Little Endian layout. Use it with software that uses a SSB demodulated signal as input i.e. software that is based on the audio output of a SSB radio. The output is the I/Q binaural output of the demodulator.S16LE LSB
: AF of LSB demodulated signal as 16 bits signed integers with Little Endian layout. Use it with software that uses a SSB demodulated signal as input i.e. software that is based on the audio output of a SSB radio. The output is the I/Q binaural output of the demodulator.S16LE LSB Mono
: AF of the LSB part of a SSB demodulated signal as "mono" (I+Q)*0.7 samples that is one sample per demodulator output sample. This can be used with software that accepts mono type of input.S16LE USB Mono
: AF of the USB part of a SSB demodulated signal as "mono" (I+Q)*0.7 samples that is one sample per demodulator output sample. This can be used with software that accepts mono type of input.S16LE AM Mono
: AF of the enveloppe demodulated signal i.e. channel magnitude or sqrt(I² + Q²) as "mono" samples that is one sample per demodulator output sample. This can be used with software that accepts mono type of input.S16LE AM !DC Mono
: Same as above but with a DC block based on magnitude average over a 5 ms periodS16LE AM BPF Mono
: Same as AM Mono but raw magnitude signal is passed through a bandpass filter with lower cutoff at 300 Hz and higher cutoff at RF bandwidth frequency
5: Signal sample rate
Sample rate in samples per second of the signal that is sent over UDP. The actual byte rate depends on the type of sample which corresponds to a number of bytes per sample.
6: Remote IP address
IP address of the remote destination to which samples are sent
7: Signal bandwidth
The signal is bandpass filtered to this bandwidth (zero frequency centered) before being sent out as raw I/Q samples or before being demodulated for SSB and FM outputs. Thus a 20000 Hz bandwidth for example means +/-10000 Hz around center channel frequency.
When SSB formats are used only the lower half (LSB) or upper half (USB) of the bandwidth is used. Thus to pass SSB over 3000 Hz bandwidth one should set this signal bandwidth to 6000 Hz.
8: Remote data port
Remote UDP port number to which samples are sent
9: Local audio UDP port
There is a possible feedback of audio samples at 48 kHz into SDRangel using this port as the UDP port on the local machine to collect the audio samples.
10: Apply (validation) button
The changes in the following items only become effective when this button is pressed:
- Samples format (4)
- Output sample rate (5)
- Address (6)
- RF bandwidth (7)
- Data port (8)
- Audio port (9)
- FM deviation (11)
When any item of these items is changed the button is lit in green until it is pressed.
11: FM deviation
This is the maximum expected FM deviation in Hz for NFM demodulated samples. Therefore it is active only for NFM
types of sample formats. A positive deviation of this amount from the central carrier will result in a sample output value of 32767 (0x7FFF) corresponding to a +1.0 real value. A negative deviation of this amount from the central carrier will result in a sample output value of -32768 (0x8000) corresponding to a -1.0 real value.
12: AGC and audio feedback control
12.1: Toggle AGC
It is effective only for AM and SSB. Signal is normalized to +/- 0.5 times the maximum amplitude with a time constant (averaging) of 200 ms. When engaged the squelch gate is fixed at 50 ms. The release time controlled by (15.3) can be increased from the 50 ms default for SSB signals to prevent accidental signal drops due to drops in the voice.
12.2: Toggle audio feedback
This turns on or off the audio samples feedback
12.3: Mono/Stereo toggle for audio feedback
This toggles between mono or stereo audio feedback
13: Gain
This gain is applied to the samples just before they are sent via UDP.
Amplifies the input passband signal before processing. The level of amplification is the log2 of the amplification factor applied therefore it varies from 0 dB (0) to +30 dB (3) in 10 dB steps.
14: Audio volume
Volume of the audio feedback (when se with button 12.2).
15: Squelch
15.1: Squelch indicator
The background of the "Sq" text is lit in green when the squelch is open
15.2: Squelch level
Use the slider to set the squelch power threshold based on channel input power (2). At the right of the slider the value in dB is displayed
15.2: Squelch gate
Sets the delay after which a signal constantly above the squelch threshold effectively opens the squelch. The same delay is used for squelch release except for SSB where the gate is fixed at 50 ms and this controls the release time only.
The delay in milliseconds is displayed at the right of the button.
16: Spectrum display
This is the spectrum display of the channel signal after bandpass filtering. Please refer to the Spectrum display description for details.
This spectrum is centered on the center frequency of the channel (center frequency of reception + channel shift) and is that of a complex signal i.e. there are positive and negative frequencies. The width of the spectrum is proportional of the sample rate. That is for a sample rate of S samples per seconds the spectrum spans from -S/2 to +S/2 Hz.