1
0
mirror of https://github.com/f4exb/sdrangel.git synced 2024-11-04 16:01:14 -05:00
sdrangel/plugins/samplemimo/metismiso/readme.md
Daniele Forsi c6195634f9 Fix repeated words
Found with:
grep -r " \([[:alpha:]]\+\) \1 " --color=yes --include=*.md
2023-05-04 21:42:49 +02:00

6.3 KiB

Metis Multiple Input Single Output plugin

Introduction

This plugin is mainly intended to be used to process samples to/from a Red Pitaya board with Pavel's HPSDR compatible applications. More precisely:

The plugin has 8 receiving (sink) streams and one transmitting (source) stream. Depending on the design of the Metis compatible hardware you may or may not have all of them available. Streams with no connection will just be filled with zero samples. You may choose the number of active streams with the control (9.5) - see next.

While compatible with Metis HPSDR-2 protocol implementation is minimal in order to be able to control and work with the Red Pitaya. It has not been tested in another context nor has provision to control the Red Pitaya or HPSDR peripherals. These controls may be added in the future as needs arise.

Build

The plugin is present in the core of the software and thus is always present in the list of MIMO devices.

Interface

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

Metis MISO plugin GUI

1: Active stream selection

Select for which streams the controls are active. Controls specific to each stream are:

  • Center frequency
  • Subsampling index

2: Spectrum source selection

Select which stream is routed to the main spectrum display

3: Active stream / spectrum source lock

This ties together the stream selection and spectrum source stream selections.

4: 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.

Starting the device means that the network stream from the Metis compatible device is started. It will be stopped by the stop button. This effectively starts all available streams that can be controlled with the Rx number select (9.5) or Tx enable (9.6)

5: Stream sample rate

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

6: Center frequency

Tunes the center frequency of the active stream

7: Local Oscillator frequency correction in ppm

This lets you compensate for the main oscillator frequency inaccuracy. Value is in ppm (parts per million)

8: Sample rate - Decimation - Subsampling - DC and IQ corrections

Metis Miso GUI 1

8.1: Sample rate

This combo box lets you control the four possible values for the device to host sample rate (Rx). Host to device (Tx) sample rate is fixed by design of the Metis interface at 48 kS/s:

  • 48k: 48000 samples per second
  • 96k: 96000 samples per second
  • 192k: 192000 samples per second
  • 384k: 384000 samples per second

8.2: Decimation factor

The I/Q stream from the Metis stream is downsampled by a power of two before being sent to the passband. Possible values are increasing powers of two: 1 (no decimation), 2, 4, 8.

Note that there is no interpolation on the Tx side.

8.3: Subsampling index

The Red Pitaya has a LTC2185 ADC specified for a bandwidth up to 550 MHz. This lets you use the Red Pitaya receivers in subsampling mode with appropriate filtering and LNA chain as a front end. In this mode the received frequency may extend above 61.44 MHz in successive 61.44 MHz wide bands. This index corresponds to the frequency band index from 0 to 7 and let you input the frequency directly corresponding to the subsampling scheme. The band limits appear in the tooltip and are the following:

  • 0: 0 to 61.44 MHz - fundamental no subsampling
  • 1: 61.44 to 122.88 MHz
  • 2: 122.88 to 184.32 MHz
  • 3: 184.32 to 245.76 MHz
  • 4: 245.76 to 307.2 MHz
  • 5: 307.2 to 368.64 MHz
  • 6: 368.64 to 430.08 MHz
  • 7: 430.08 to 491.52 MHz

Of course the more the higher the frequency above the fundamental range the worse the performance is. In practice it is still OK at VHF frequencies but not much above.

8.4: DC correction

This corrects residual DC present at the center of the passband. By construction this is useless for the Red Pitaya.

8.5: IQ imbalance correction

This corrects I/Q imbalance. By construction this is useless for the Red Pitaya.

9: Preamp - Random - Dither - Duplex - Number of receivers - Tx enable - Transverter

Metis Miso GUI 1

9.1: Preamp

Toggle Rx preamplifier - not found to be effective

9.2: Random

Toggle LTC2185 randomization - not found to be effective

9.3: Dither

Toggle LTC2185 dithering - not found to be effective

9.4: Duplex

Toggle duplex - not found to be effective

9.5: Number or active receivers

Controls the number of active receivers. Each receiver allocates a slot in the data stream from the Metis interface.

  • For the SDR receiver compatible with HPSDR choose a maximum of 4 receivers
  • For the SDR receiver compatible with HPSDR choose a maximum of 8 receivers

It is a waste to have more active receivers than you actually need because it will increase network traffic for nothing

9.6: Toggle Tx activation

Use this button to toggle the generation and sending of Tx samples in the Metis stream from host to device. When inactivated null samples are sent in the return payload from host to device.

9.7: Transverter mode

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

Transverter mixing is the same for all receivers and may be different for the transmitter.

10: Tx drive level

Choose a level from 0 (deactivated) to 15 (full power)