sdrangel/plugins/channelrx/freqscanner/readme.md

Frequency Scanner Plugin

Introduction

This plugin can be used to scan a range of frequencies looking for a transmission and then tune another channel (such as an AM or DSD Demod) to that frequency.

Interface

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

1: Channel

Specifies the channel (such as an AM, NFM or DSD Demod), by device set and channel index, that should be tuned to the active frequency.

2: Minimum frequency shift from center frequency of reception for channel

Use the wheels of keyboard to adjust the minimim frequency shift in Hz from the center frequency of reception for the channel (1). 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.

3: Active frequency power

Average power in dB relative to a +/- 1.0 amplitude signal received for the active frequency. This is set to '-' while scanning.

4: TH - Threshold

Power threshold in dB that determines whether a frequency is active or not.

5: t_delta_f - Tune time

Specifies the time in milliseconds that the Frequency Scanner should wait after adjusting the device center frequency, before starting a measurement. This time should take in to account PLL settle time and the device to host transfer latency, so that the measurement only starts when IQ data that corresponds to the set frequency is being recieved.

6: t_s - Scan time

Specifies the time in seconds that the Frequency Scanner will average its power measurement over.

7: t_rtx - Retransmission Time

Specifies the time in seconds that the Frequency Scanner will wait after the power on the active frequency falls below the threshold, before restarting scanning. This enables the channel to remain tuned to a single frequency while there is a temporary break in transmission.

8: Ch BW - Channel Bandwidth

This specifies the bandwidth of the channels to be scanned.

9: Pri - Priority

Specifies which frequency will be chosen as the active frequency, when multiple frequencies exceed the threshold (4):

• Max power: The frequency with the highest power will be chosen
• Table order: The frequency first in the frequency table (14) will be chosen.

10: Meas - Power Measurement

Specifies how power is measured. In both cases, a FFT is used, with the channel bandwidth being spread over 8 to 32 bins, with the first and last bins being excluded from the measurement (to reduce spectral leakage from adjacent channels):

• Peak: Power is the highest value in all of the bins, averaged over the scan time (6).
• Total: Power is the sum of power in all of the bins, averaged over the scan time (6).

Peak can be used when you wish to set the threshold roughly according to the level displayed in the Main Spectrum. Total is potentially more useful for wideband signals, that are close to the noise floor.

11: Run Mode

Specifies the run mode:

• Single: All frequencies are scanned once. Channel (1) is tuned to the active frequency at the end of the scan. The scan does not repeat.
• Continuous: All frequencies scanned, with channel (1) being tuned to active frequency at the end of the scan. Scan repeats once the power on the active frequency falls below the threshold (4) for longer than the retransmission time (7).
• Scan only: All frequencies are scanned repeatedly. The channel will not be tuned. This mode is just for counting how often frequencies are active, which can be seen in the Active Count column in the frequency table (14).

12: Start/Stop Scanning

Press this button to start or stop scanning.

13: Status Text

Displays the current status of the Frequency Scanner.

• "Scanning": When scanning for active frequencies.
• Frequency and annotation for active frequency.

14: Frequency Table

The frequency table contains the list of frequencies to be scanned, along with results of a scan. The columns are:

• Freq (Hz): Specifies the channel center frequencies to be scanned. These should be spaced by integer multiples of the channel bandwidth (8). Values should be entered in Hertz.
• Annotation: An annotation (description) for the frequency, that is obtained from the closest matching annotation marker in the Main Spectrum.
• Enable: Determines whether the frequency will be scanned. This can be used to temporaily disable frequencies you aren't interested in.
• Power (dB): Displays the measured power in decibels from the last scan. The cell will have a green background if the power was above the threshold (4).
• Active Count: Displays the number of scans in which the power for this frequency was above the threshold (4). This allows you to see which frequencies are commonly in use.
• Notes: Available for user-entry of notes/information about this frequency.

When an active frequency is found after a scan, the corresponding row in the table will be selected.

Right clicking on a cell will display a popup menu:

• Copy contents of cell to clipboard.
• Tune selected channel (1) to the frequency in the row clicked on.

15: Add

Press to add a single row to the frequency table (14).

16: Add Range

Press to add a range of frequencies to the frequency table (14). A dialog is displayed with start and stop frequencies, as well as a step value. The step value should typically be an integer multiple of the channel bandwidth (8).

17: Remove

Removes the selected rows from the frequency table (14).

18: Up

Moves the selected rows up the frequency table (14).

19: Down

Moves the selected rows the the frequency table (14).