1
0
mirror of https://github.com/f4exb/sdrangel.git synced 2024-11-26 17:58:43 -05:00
sdrangel/plugins/samplemimo/audiocatsiso/readme.md
2023-06-18 09:25:07 +02:00

6.5 KiB

Audio CAT SISO plugin

Introduction

This MIMO plugin gets its samples from an audio device on the Rx side and sends its samples to an audio device on the Tx side. It is single stream on both Rx and Tx therefore it has "SISO" in the name. In addition it allows CAT control of a radio device using Hamlib.

CAT control is limited to frequency and PTT for transceivers. You can enable or disable the Tx side. It does not use VFO-A and VFO-B to manage split operation instead it holds one frequency for Rx and one for Tx and switches the current VFO to the appropriate value according to PTT status.

It is specifically designed for radios with internal audio cards but you may also connect the audio I/O of a "traditional" radio to the line in and out of a soundcard. Not a lot of radios (if any) allow true I/Q modulation through their audio in interface therefore transmission will be limited to mono audio transfer with the radio in USB mode and have limited bandwidth only on the positive frequencies of the baseband.

Interface

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

Audio CAT SISO plugin GUI

1. Rx/Tx settings selection

Use this combo to target UI to Rx or Tx streams for Rx/Tx specific items.

2. Rx/Tx spectrum display selection

Use this combo to select Rx or Tx side for main spectrum display.

3: Active stream / spectrum source lock

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

4: Tx enable

Enable or disable Tx functions. Accessible only if device plugin is stopped (7).

5: PTT

Push To Talk toggle button. Turns on/off Tx via CAT thus works only when connected (24)

5a: Spectrum follows PTT

Use this toggle button to have the Rx or Tx spectrum display follow PTT or not.

6. 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

7: Start/Stop

Device plugin start / stop button.

8: Audio sample rate

Audio sample rate in Hz (Sa/s) with multiplier indicator (k).

9. Center frequency

This controls the center frequency of the rig in Rx or Tx mode in kHz depending on the Rx/Tx settings selection (1). This may allow split operation if frequencies are different when in Rx and Tx mode.

10. Refresh list of audio devices

11: Select input (Rx) audio device

Use this push button to open a dialog that lets you choose the audio input device. See audio management documentation for details. The name of the audio device in use appears next.

12. Decimation factor

Sets the decimation factor on Rx side.

13. Baseband center frequency position relative to the center frequency

Possible values are:

  • Cen: the decimation operation takes place around the Rx center frequency Fs
  • Inf: the decimation operation takes place around Fs - Fc.
  • Sup: the decimation operation takes place around Fs + Fc.

14. DC auto correction option (Rx)

This button controls the local DSP DC auto remove DC component.

15. IQ auto correction option (Rx)

This button controls the local DSP auto make I/Q balance. The DC correction must be enabled for this to be effective.

16. Input volume

Controls the input volume (Rx)

17. Input channel mapping (Rx)

  • I=L Q=R: Left channel is connected to in-phase and right channel is connected to quadrature. Works with a complex signal.
  • I=R Q=L: Left channel is connected to quadrature and right channel is connected to in-phase. Works with a complex signal.
  • Mono L: Left channel is connected to both in-phase and quadrature. Works with real signals.
  • Mono R: Right channel is connected to both in-phase and quadrature. Works with real signals.

In mono modes only the positive side of frequencies is displayed in the main spectrum.

18: Select output (Tx) audio device

Use this push button to open a dialog that lets you choose the audio playback device. See audio management documentation for details. The name of the audio device in use appears next.

19. Output volume

Controls the output (Tx) volume in decibels. You may adjust Tx output power this way.

20. Output channel mapping

  • I=L Q=R: Left channel represents the in-phase signal and right channel represents the quadrature signal. To be used when radio accepts complex I/Q modulation.
  • I=R Q=L: Left channel represents the quadrature signal and right channel represents the in-phase signal. To be used when radio accepts complex I/Q modulation.
  • Mono L: Left channel is used as a real signal. To be used when radio works with real signals i.e. USB mode.
  • Mono R: Right channel is used as a real signal. To be used when radio works with real signals i.e. USB mode.

In mono modes only the positive side of frequencies is displayed in the main spectrum.

21. Serial device used for CAT

Select device from the combo list

22. Hamlib radio model

Select model from the combo list

23. CAT details

Opens a dialog to set serial connection and CAT details:

Audio CAT settings GUI

23.1. Serial link baud rate

Choice between 1200, 2400, 4800, 9600, 19200, 38400, 57600 and 115200 bauds.

23.2. Handshake method

Choice between none, XON/XOFF and hardware.

23.3. Data bits

Choice between 7 or 8 bits.

23.4. Stop bits

Choice between 1 or 2 bits.

23.5. PTT method

Choice between CAT, DTR or RTS signals.

23.6. Polling interval

Set polling interval in milliseconds. Polls current VFO frequency via CAT regularly at this interval.

23.7. DTR signal type

When selecting PTT control via DTR signal (23.5) selects if a low or high signal triggers PTT.

23.8. RTS signal type

When selecting PTT control via RTS signal (23.5) selects if a low or high signal triggers PTT.

23.9. Accept dialog

Click OK to validate changes and close dialog.

23.10. Dismiss dialog

Click Cancel to dismiss dialog changes and close dialog.

24. Connect to radio

Use this toggle button to connect or disconnect the radio.

25. Radio connection status

  • grey: idle (not connected)
  • green: connected
  • red: error