1df07b21ae
Add BUILD_BENCH, BUILD_SHARED_LIBS, ENABLE_AARONIARTSA and ENABLE_METIS options. |
||
---|---|---|
.. | ||
audiocatinputworker.cpp | ||
audiocatinputworker.h | ||
audiocatoutputworker.cpp | ||
audiocatoutputworker.h | ||
audiocatsiso.cpp | ||
audiocatsiso.h | ||
audiocatsisocatdialog.cpp | ||
audiocatsisocatdialog.h | ||
audiocatsisocatdialog.ui | ||
audiocatsisocatworker.cpp | ||
audiocatsisocatworker.h | ||
audiocatsisogui.cpp | ||
audiocatsisogui.h | ||
audiocatsisogui.ui | ||
audiocatsisohamlib.cpp | ||
audiocatsisohamlib.h | ||
audiocatsisoplugin.cpp | ||
audiocatsisoplugin.h | ||
audiocatsisosettings.cpp | ||
audiocatsisosettings.h | ||
audiocatsisowebapiadapter.cpp | ||
audiocatsisowebapiadapter.h | ||
CMakeLists.txt | ||
readme.md |
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
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:
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