1
0
mirror of https://github.com/f4exb/sdrangel.git synced 2024-11-08 17:46:03 -05:00
sdrangel/plugins/channelrx/demodbfm
Daniele Forsi 902012641d Fix typing errors in readme's
Fixed with:
find . -name '*.md' -exec codespell --ignore-words-list=doas,ehr,lits,verry --write-changes --summary {} \+
2022-05-15 12:39:57 +02:00
..
bfmdemod.cpp v7: API: added workspace handling for device, spectrum, feature and channel. Implements #1242 2022-05-13 22:24:48 +02:00
bfmdemod.h v7: API: added workspace handling for device, spectrum, feature and channel. Implements #1242 2022-05-13 22:24:48 +02:00
bfmdemodbaseband.cpp In some audio demods. Reapply audio sample rate only if channel sample rate effectively changes. Implements #791 2021-03-03 01:45:59 +01:00
bfmdemodbaseband.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
bfmdemodgui.cpp Massive UI revamping (v7): Restored channel highlighted by cursor function. Part of #1213 2022-04-26 00:42:26 +02:00
bfmdemodgui.h Massive UI revamping (v7): updated basic channel settings and indicate stream index for MIMO device and single stream channel 2022-04-18 01:42:03 +02:00
bfmdemodgui.ui Massive UI revamping (v7): added channels 2022-04-12 16:20:45 +02:00
bfmdemodreport.cpp Rx plugins: refactoring of classes (2) 2019-12-04 07:20:05 +01:00
bfmdemodreport.h Rx plugins: refactoring of classes (2) 2019-12-04 07:20:05 +01:00
bfmdemodsettings.cpp Massive UI revamping (v7): persistent channel show/hide 2022-04-12 18:27:27 +02:00
bfmdemodsettings.h Massive UI revamping (v7): persistent channel show/hide 2022-04-12 18:27:27 +02:00
bfmdemodsink.cpp Do not write tail audio samples and write to sample buffer only if necessary. May fix #1132 2022-02-08 00:55:31 +01:00
bfmdemodsink.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
bfmdemodwebapiadapter.cpp Fixed -Wunused-parameter warnings 2020-11-14 11:13:32 +01:00
bfmdemodwebapiadapter.h REST API: config: GET (13): corrected missing return in deserialize methods of the adapters 2019-08-05 03:42:04 +02:00
bfmplugin.cpp Updated main and plugin versions 2022-05-14 13:16:33 +02:00
bfmplugin.h Channel plugins: use specialized ChannelGUI superclass. Handle GUI lifecycle in MainWindow 2020-10-04 22:16:09 +02:00
CMakeLists.txt Install debug symbols on Windows for debug builds 2022-02-06 12:56:58 +00:00
rdsdecoder.cpp Fixed incomplete copyright headers (1) 2019-04-11 06:39:30 +02:00
rdsdecoder.h Fixed incomplete copyright headers (1) 2019-04-11 06:39:30 +02:00
rdsdemod.cpp Define _USE_MATH_DEFINES and clean M_PI redefinitions 2020-11-04 23:05:41 +01:00
rdsdemod.h Fixed incomplete copyright headers (1) 2019-04-11 06:39:30 +02:00
rdsparser.cpp BFM Demod: fixed RDS text clearscreen. Fixes #1101 2022-01-12 08:43:20 +01:00
rdsparser.h BFM demod: RDS: radio text on two lines with the bottom one keeping the previously decoded text 2022-01-12 13:54:19 +01:00
rdstmc.cpp Fix some typos 2019-07-22 23:14:23 +02:00
rdstmc.h Fixed incomplete copyright headers (1) 2019-04-11 06:39:30 +02:00
readme.md Fix typing errors in readme's 2022-05-15 12:39:57 +02:00

BFM demodulator plugin

Introduction

This plugin can be used to listen to a Broadcast FM modulated signal (BFM). In addition it can decode RDS data when available.

Interface

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

BFM Demodulator plugin GUI

The main three areas are:

  • A: radio settings
  • B: spectrum of FM demodulated signal. Please note that the annotations are custom and not generally available. Controls are similar to other spectrum displays including the main spectrum display.
  • C: RDS data. Note that decoding RDS data requires the locking to the stereo pilot carrier therefore you should switch to stereo (A.3) to be able to decode RDS data

A: Radio settings

BFM Demodulator plugin settings

A.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 arrows. Pressing shift simultaneously moves digit by 5 and pressing control moves it by 2.

A.2: Channel power

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

A.3: Mono/Stereo

Toggle between mono and stereo. The button lights in green if stereo is effectively active.

A.4: Stereo DSB or LSB

Some stations send only the lower side band of the stereo difference AM signal. This button let you select between lower or double side bands. Inspect the baseband spectrum (B) to tell if stereo is sent in LSB or DSB mode.

A.5: Show FM signal or pilot carrier on spectrum

This button let you select the spectrum display between the FM signal and the 38 kHz pilot signal to visualize its quality.

A.6: Stereo pilot power

This is the power of the reconstructed stereo pilot signal.

A.7: Toggle RDS decoding

USe this button to activate or de-activate RDS decoding

A.8: Level meter in dB

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

A.9: RF Bandwidth

This is the bandwidth in kHz of the channel signal before demodulation. It can be set in steps: 80, 100, 120, 140, 160, 180, 200, 220 and 250 kHz. Inspect the baseband spectrum (B) to adjust for best quality.

A.10: AF bandwidth

This is the AF bandwidth in kHz. It can be varied continuously between 1 and 20 kHz in steps of 1 kHz.

A.11: AF volume

This is the relative AF volume from 0 to 10.

A.12: Squelch

Adjust squelch in dB.

B: Spectrum

Details on the spectrum view and controls can be found here

C: RDS display

BFM Demodulator plugin RDS 1

C.1: Demodulator quality

DBPSK demodulator quality (0-100%)

C.2: Decoder synchronization

This indicator lights up (in green) when decoder acquires synchronization

C.3: Decoder quality

Decoder synchronization quality (0-100%)

C.4: Sample symbol power

Reconstructed sample symbol power in dB.

C.5: Symbol clock frequency

The RDS data rate is 1187 b/s therefore the clock frequency should be as close as possible to 1187 Hz.

C.6: Clear RDS data

Clear all RDS data.

C.7: Message types counters

Shows counters of received message by type.

  • PI: Program Identification (C.8)
  • BAS: BASic information (program service name - C.13)
  • PIN: Program Item Number (C.11)
  • TXT: TeXT message fragments (C.20, C.22)
  • AID: Application Information Data (C.18)
  • TIM: TIMe information (C.23)
  • TDC: Transparent Data Channel
  • IH_: In House applications
  • RP_: Radio Paging
  • TMC: Traffic Message Channel (C.28)
  • EWS: Emergency Warning System (C.19)
  • EON: Enhanced Other Networks information (C.24, 25, 26, 27)

C.8: Proram Identification

The ¨PI" label lights up if a PI message is received.

C.9: Traffic Program identification

The "TP" label lights up if a TP message is received. Next is the program type.

C.10: Program coverage

C.11: Program Item Number

The "PIN" label lights up if a PIN message is received next is the country code and language.

C.12: Day hour and minutes

BFM Demodulator plugin RDS 2

C.13: Program service name

The "BAS" indicator lights up if a BAS message is received. Next os the program service name

C.14: Traffic Announcement identification

The "TA" indicator lights up if a TA message is received

C.15: Music/Speech

Music/Speech indicator

C.16: Mono/Stereo

Mono/Stereo indicator

C.17: Alternate frequencies

List of alternate frequencies in MHz

C.18: Application Information Data

The "AID" indicator lights up if a AID message is received. Next is the application information data

C.19: Emergency Warning System

The "EWS" indicator lights up if a EWS message is received. Next is the emergency warning system raw data

C.20: Current text line

The "TXT" indicator ligths up if a text element is received. Next the current radio text line is displayed.

C.21: Clear previous text line

Push this button the clear the previous text line next (C.22)

C.22: Previous text line

Previous radio text line. The current line (C.20) is moved there when the message switch has been received.

C.23: Time

Some stations send the clock time at regular intervals. The "TIM" indicator lights up when a time message is received. The date and time is displayed next with the time zone shift from GMT.

C.24: Enhanced Other Networks

The "EON" indicator lights up when a EON message is received. The EON data is displayed next (C.25, C.26 and C.27).

C.25: EON station data

Station data: program PI and service names list.

C.26: EON frequencies

Station frequencies list.

C.27: EON alernate frequencies

Station alternate frequencies list.

C.28: Traffic Message Channel

The "TMC" indicator lights up if a TMC message is received. Next is the location and content of the event reported in the message.