sdrangel/plugins/samplesource/perseus/readme.md

4.1 KiB

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

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