sdrangel/plugins/samplesource/perseus
f4exb de94ea01b5 Updated main and plugin versions 2022-05-14 13:16:33 +02:00
..
CMakeLists.txt Install debug symbols on Windows for debug builds 2022-02-06 12:56:58 +00:00
perseusgui.cpp v7: API: added workspace handling for device, spectrum, feature and channel. Implements #1242 2022-05-13 22:24:48 +02:00
perseusgui.h v7: API: added workspace handling for device, spectrum, feature and channel. Implements #1242 2022-05-13 22:24:48 +02:00
perseusgui.ui Massive UI revamping (v7): fixed devices .ui files to correct display wwhen creating device. Part of #1209 2022-04-27 02:06:17 +02:00
perseusinput.cpp Fixed some signal/slot connects. Removed unnecessary m_channelMessageQueue in ChannelAPI. Fixes #1185 2022-03-23 22:32:23 +01:00
perseusinput.h Removed file recording function from device plugins 2020-08-09 00:47:06 +02:00
perseusplugin.cpp Updated main and plugin versions 2022-05-14 13:16:33 +02:00
perseusplugin.h Avoid global QString init in plugins 2020-11-22 04:06:32 +01:00
perseussettings.cpp Massive UI revamping (v7): fixed device workspace index save/restore and removed useless geometry blobs. Fixes #1207 2022-04-20 20:08:41 +02:00
perseussettings.h Massive UI revamping (v7): fixed device workspace index save/restore and removed useless geometry blobs. Fixes #1207 2022-04-20 20:08:41 +02:00
perseuswebapiadapter.cpp Fixed wrong structure being used in some sample source and sink plugins web API adapters. Fixes #842 2021-04-15 15:30:29 +02:00
perseuswebapiadapter.h REST API: config: GET (11). Support of the rest of devices 2019-08-04 20:24:44 +02:00
perseusworker.cpp Perseus: refactored PerseusInputThread to PerseusInputWorker object moved to thread. Equivalent to FileInput changes 2020-07-12 00:35:37 +02:00
perseusworker.h Perseus: refactored PerseusInputThread to PerseusInputWorker object moved to thread. Equivalent to FileInput changes 2020-07-12 00:35:37 +02:00
readme.md Massive UI revamping (v7): implemented device common settings from top bar and added documentation on device windows top and bottom bars 2022-04-17 01:31:50 +02:00

readme.md

Perseus input plugin

Introduction

This input sample source plugin gets its samples from a Perseus device.

Build

This plugin will be built only if the following conditions are met:

  • My fork of libperseus-sdr library is installed in your system. You will have to checkout the fixes branch which however is the default. There are a few fixes from the original mainly to make it work in a multi-device context.
  • The 24 bit Rx DSP chain is activated in the compilation with the -DRX_SAMPLE_24BIT=ON option on the cmake command line.

If you build it from source and install it in a custom location say: /opt/install/libperseus you will have to add -DPERSEUS_DIR=/opt/install/libperseus to the cmake command line.

☞ From version 3.12.0 the Linux binaries are built with the 24 bit Rx option and Perseus input plugin.

Interface

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

It has a limited number of controls compared to other source interfaces. This is because a lot of things are handled automatically within the Perseus:

  • gains
  • DC and IQ correction
  • filter selection based on frequency

Perseus input plugin GUI

1: Common stream parameters

Remote source input stream GUI

1.1: Frequency

This is the center frequency of reception in kHz.

1.2: Start/Stop

Device start / stop button.

  • Blue triangle icon: device is ready and can be started
  • Green square icon: device is running and can be stopped
  • Magenta (or pink) square icon: an error occurred. In the case the device was accidentally disconnected you may click on the icon, plug back in and start again.

1.4: Stream sample rate

Baseband I/Q sample rate in kS/s. This is the device to host sample rate (4) divided by the software decimation factor (6).

2: LO ppm correction

This is the correction factor in ppm applied to the local oscillator in software. This is normally not needed the Perseus is already on spot. You can reset the ppm value anytime by pressing on button (3)

3: Reset LO ppm correction

This resets the LO ppm correction (zero the value).

4: Device to hast sample rate

This is the device to host sample rate in kilo samples per second (kS/s). The sample rate can be as low as 48 kS/s so there is no need for software decimation. Note that at 48 kS/s some slight rate mismatch can appear with the audio that has the same nominal rate. This may cause some occasional audio samples drops however hardly noticeable.

5: Wideband mode

Switch on this button to disable the preselection filters. The corresponding LED on the Perseus front panel will be lit accordingly.

6: Decimation factor

The I/Q stream from the Perseus to host is downsampled by a power of two before being sent to the passband. This is normally not needed for most use cases as the Perseus can go as low as 48 kS/s which is the lower limit for audio channel plugins (AM, FM, SSB, Digital voice). So it can be left to 1 most of the time. A software decimation by 2 or 4 is still provided for easier analysis of very narrowband or slow varying signals. Note that there is no dynamic gain with this decimation as the precision is already limited to 24 significant bits either for integer or floating point (float) processing.

7: Transverter mode open dialog

This button opens a dialog to set the transverter mode frequency translation options. The details about this dialog can be found here

8: Attenuators control

Use this combo box to control the attenuators inside the Perseus:

  • 0 dB: no attenuation
  • 10 dB: 10 dB attenuator engaged
  • 20 dB: 20 dB attenuator engaged
  • 30 dB: 10 and 20 dB attenuators engaged

The LEDs on the Perseus front panel corresponding to each attenuator are lit accordingly.

9: ADC dither

Use this button to turn on or off the Perseus ADC dithering

10: ADC preamplifier

Use this button to turn on or off the Perseus ADC preamplifier