1
0
mirror of https://github.com/f4exb/sdrangel.git synced 2024-12-23 10:05:46 -05:00
sdrangel/plugins/channelrx/demodnfm
2023-04-22 12:33:37 +02:00
..
CMakeLists.txt Update CMakeLists.txt to support both Qt5 and Qt6. Add option ENABLE_QT6 2022-11-17 14:34:54 +00:00
dcsdetector.cpp Replace deprecated QMutex(Recursive) with QRecursiveMutex 2022-09-17 23:00:07 +02:00
dcsdetector.h Replace deprecated QMutex(Recursive) with QRecursiveMutex 2022-09-17 23:00:07 +02:00
nfmdemod.cpp NFM demod: protect from m_basebandSink is null 2022-10-13 01:45:31 +02:00
nfmdemod.h NFM demod: protect from m_basebandSink is null 2022-10-13 01:45:31 +02:00
nfmdemodbaseband.cpp Replace deprecated QMutex(Recursive) with QRecursiveMutex 2022-09-17 23:00:07 +02:00
nfmdemodbaseband.h Replace deprecated QMutex(Recursive) with QRecursiveMutex 2022-09-17 23:00:07 +02:00
nfmdemodgui.cpp Fixed passing QPoint reference from right click enabler to connected method. Fixes #1549 2022-12-28 20:33:28 +01:00
nfmdemodgui.h Fixed passing QPoint reference from right click enabler to connected method. Fixes #1549 2022-12-28 20:33:28 +01:00
nfmdemodgui.ui Massive UI revamping (v7): make AM, NFM and WFM demods horizontally resizable within limits. Part of #1209 2022-04-23 14:00:23 +02:00
nfmdemodreport.cpp NFM demod: DCS squelch (1) 2021-04-17 23:13:09 +02:00
nfmdemodreport.h NFM demod: DCS squelch (1) 2021-04-17 23:13:09 +02:00
nfmdemodsettings.cpp Massive UI revamping (v7): persistent channel show/hide 2022-04-12 18:27:27 +02:00
nfmdemodsettings.h Massive UI revamping (v7): persistent channel show/hide 2022-04-12 18:27:27 +02:00
nfmdemodsink.cpp Rx channel demods: prevent possible reading past audio buffer end. For #1661 2023-04-22 12:33:37 +02:00
nfmdemodsink.h Set label in AudioFifo to identify the controlling component in error messages. Use a signal to retrieve the channel index in device set appropriately 2022-03-18 21:53:53 +01:00
nfmdemodwebapiadapter.cpp Fixed -Wunused-parameter warnings 2020-11-14 11:13:32 +01:00
nfmdemodwebapiadapter.h REST API: config: GET (13): corrected missing return in deserialize methods of the adapters 2019-08-05 03:42:04 +02:00
nfmplugin.cpp Updated versions and changelogs 2022-10-19 17:40:14 +02:00
nfmplugin.h Channel plugins: use specialized ChannelGUI superclass. Handle GUI lifecycle in MainWindow 2020-10-04 22:16:09 +02:00
readme.md Massive UI revamping (v7): Channel window documentation. Show device type name in index tooltip 2022-04-17 10:20:07 +02:00

NFM demodulator plugin

Introduction

This plugin can be used to listen to a narrowband FM modulated signal. "Narrowband" means that the bandwidth can vary from 5 to 40 kHz.

Interface

The top and bottom bars of the channel window are described here

NFM Demodulator plugin GUI

1: Frequency shift from center frequency of reception value

Use the wheels to adjust the frequency shift in Hz from the center frequency of reception. 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 arrows. Pressing shift simultaneously moves digit by 5 and pressing control moves it by 2. Left click on a digit sets the cursor position at this digit.

2: Channel power

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

3: Level meter in dB

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

4: Volume

This is the volume of the audio signal from 0% (mute) to 200% (maximum) of volume at nominal frequency deviation. It can be varied continuously 1% steps using the dial button.

5: Audio high pass filter

Toggle a 300 Hz cutoff high pass filter on audio to cut-off CTCSS frequencies. It is on by default for normal audio channels usage. You can switch it off to pipe the audio in programs requiring DC like DSD+ or Multimon.

6: Audio mute and audio output select

Left click on this button to toggle audio mute for this channel. The button will light up in green if the squelch is open. This helps identifying which channels are active in a multi-channel configuration.

If you right click on it it will open a dialog to select the audio output device. See audio management documentation for details.

A: RF parameters

NFM Demodulator plugin GUI A

A.1: Apply channel spacing preset

Use this push button to apply the channel spacing preset selected next (A.2) It will apply RF bandwidth, AF bandwidth and FM deviation settings according to the channel spacing scheme.

A.2: Select channel spacing preset

Select the RF bandwidth, AF bandwidth and FM deviation settings according to the channel spacing scheme specified as follows:

CS (kHz) RFBW (kHz) AFBW (kHz) FM Δ (±kHz) β
5 4.8 1.7 0.7 0.43
6.25 6 2.1 0.9 0.43
7.5 7.2 2.5 1.1 0.43
8.33 8 2.8 1.2 0.43
12.5 11 3 2.5 0.83
25 16 3 5 1.67
40 36 9 9 1
  • All these settings apply the Carson's rule: RFBW = 2 × (FMΔ + AFBW)
  • The 12.5 and 25 kHz channel spacings correspond to standard 11F3 and 16F3 settings respectively and are widely accepted and mostly used
  • For spacings lower than 12.5 kHz values are empirically built using Carson's rule from β=0.43 which is the only standard provided
  • For spacing higher than 25 kHz values are derived from an old 36F9 standard.

When you are lost with the RF, AF bandwidths and FM deviation settings you can always come back to these standards and generally get good results.

When changing the RF bandwidth the channel spacing selection in the combo box is adjusted to fit within this bandwidth.

☞ The demodulation is done at the channel sample rate which is guaranteed not to be lower than the requested audio sample rate but can possibly be equal to it. This means that for correct operation in any case you must ensure that the sample rate of the audio device is not lower than the Nyquist rate required to process this channel bandwidth.

☞ The channel sample rate is always the baseband signal rate divided by an integer power of two so depending on the baseband sample rate obtained from the sampling device you could also guarantee a minimal channel bandwidth. For example with a 125 kS/s baseband sample rate and a 8 kS/s audio sample rate the channel sample rate cannot be lower than 125/8 = 15.625 kS/s (125/16 = 7.8125 kS/s is too small) which is still OK for 5 or 6.25 kHz channel bandwidths.

A.3: RF bandwidth

This is the bandwidth in kHz of the filter applied before the discriminator and therefore called "RF" bandwidth but is applied in the device pass band in fact.

A.4: AF bandwidth

This is the bandwidth of the audio signal in kHz (i.e. after demodulation).

B: Modulation parameters and squelch

NFM Demodulator plugin GUI B

B.1: Expected FM peak deviation

This is the peak FM deviation in ±kHz expected in the received signal and corresponds to 100% audio volume

B.2: Delta/Level squelch

Use this button to toggle between AF (on) and RF power (off) based squelch.

B.3: Squelch threshold

Power threshold mode

Case when the delta/Level squelch control (8) is off (power). This is the squelch threshold in dB. The average total power received in the signal bandwidth before demodulation is compared to this value and the squelch input is open above this value. It can be varied continuously in 1 dB steps from 0 to -100 dB using the dial button.

Audio frequency delta mode

Case when the delta/Level squelch control (8) is on (delta). In this mode the squelch compares the power of the demodulated audio signal in a low frequency band and a high frequency band. In the absence of signal the discriminator response is nearly flat and the power in the two bands is more or less balanced. In the presence of a signal the lower band will receive more power than the higher band. The squelch does the ratio of both powers and the squelch is opened if this ratio is lower than the threshold given in percent.

A ratio of 1 (100%) will always open the squelch and a ratio of 0 will always close it. The value can be varied to detect more distorted and thus weak signals towards the higher values. The button rotation runs from higher to lower as you turn it clockwise thus giving the same feel as in power mode. The best ratio for a standard NFM transmission is ~40%.

The distinct advantage of this type of squelch is that it guarantees the quality level of the audio signal (optimized for voice) thus remaining closed for too noisy signals received on marginal conditions or bursts of noise independently of the signal power.

☞ The signal used is the one before AF filtering and the bands are centered around 1000 Hz for the lower band and 6000 Hz for the higher band. This means that it will not work if your audio device runs at 8000 or 11025 Hz. You will need at least a 16000 Hz sample rate. Choose power squelch for lower audio rates.

☞ The chosen bands around 1000 and 6000 Hz are optimized for standard voice signals in the 300-3000 Hz range.

B.4: Squelch gate

This is the squelch gate in milliseconds. The squelch input must be open for this amount of time before the squelch actually opens. This prevents the opening of the squelch by parasitic transients. It can be varied continuously in 10ms steps from 10 to 500ms using the dial button.

C: CTCSS/DCS

NFM Demodulator plugin GUI C

C.1: CTCSS on/off

Use the checkbox to toggle CTCSS activation. When activated it will look for a tone squelch in the demodulated signal and display its frequency (see 10).

C.2: CTCSS tone

This is the tone squelch in Hz. It can be selected using the toolbox among these CTCSS values and -- for none. When a value is given and the CTCSS is activated the squelch will open only for signals with this tone squelch.

C.3: CTCSS tone value

This is the value of the tone squelch received when the CTCSS is activated. It displays -- if the CTCSS system is de-activated.

C.4: DCS on/off

Use the checkbox to toggle DCS activation. When activated it will look for a squelch code in the demodulated signal and display its octal value in C.7.

C.5: DCS code

This is the DCS code to be selected among the normalized values. The value is in octal format suffixed by "P" for positive or normal codes and "N" for negative or inverted codes. The values are those listed here. The special value -- desactivates the squelch but the DCS code is still searched.

C.6: Show positive or negative code

The DCS code is searched with a positive modulation (i.e. positive shift for bit "1" else negative). When + is selected the code is displayed directly in C.7 and when - is selected the corresponding negative code is displayed in C.7

C.7: DCS code detected

This is the value of the code detected when the DCS is activated. It displays -- if the DCS system is de-activated or no code can be detected.