TCI

From Tučňák Wiki
Jump to navigation Jump to search

TCI is the text protocol of the SDR program ExpertSDR3 by Expert Electronics (SunSDR2 DX, SunSDR2 PRO, ColibriNANO). The description of the protocol is at github.com/ExpertSDR3/TCI. Tucnak connects to ExpertSDR3 as a client over a WebSocket (TCI version 2.0). The TCI support was written by R5AK.

Through TCI Tucnak can follow and set the frequency and the mode of the radio, key PTT, send CW and record the audio. It does not need Hamlib.

Settings

The dialog is in Setup -> Rig/TCI options -> TCI (ExpertSDR3) (see Rig options).

  • Enabled - switches the TCI connection on.
  • Hostname and Port - the address of the TCI server of ExpertSDR3. The defaults are 127.0.0.1 and 40001. TCI server must be running in ExpertSDR3 with the same port.
  • Transceiver number (0=first) - which transceiver of ExpertSDR3 Tucnak controls (0 to 7). Tucnak reads and sets only the first VFO (VFO A) of this transceiver.
  • Transverter LO [Hz] - the frequency which is added to the frequency of the radio, the same as the LO of a rig (see Rig options): fTucnak = fradio + fLO. If the band has its own LO in Band defaults and it is not 0, this one is used instead.
  • Set band from radio - Tucnak always shows the frequency of the radio. This item decides if the band in the log is switched when you tune the radio out of the active band.
  • Change band on radio - when you change the frequency or the band in Tucnak, Tucnak sets the radio too (also RIT). If the radio is already on the band, it stays where it is. Otherwise Tucnak sets the last frequency of the band or the lower edge of the band.
  • Change mode on radio - when you change the mode in Tucnak, Tucnak sets the mode of the radio. SSB is LSB below 10 MHz and USB above, CW is CW, AM is AM, FM is NFM, MGM is DIGU and SSTV is USB. For other modes (for example ATV) the mode of the radio is not changed.
  • Mode from radio - when you change the mode on the radio, the mode in the log follows it (CW, SSB, AM, FM or MGM). It works only when a contest is open. The mode which Tucnak itself has just set is not sent back, so LSB does not change to USB.
  • Set PTT on radio (TRX command) - Tucnak keys PTT of the radio with the command TRX. Esc also releases the transmit.
  • Sequencer: PTT also on serial port - see below.

When the connection is lost, Tucnak tries to connect again every 3 seconds. The messages TCI: connected to host:port and TCI: disconnected and the errors (for example Can't connect or Connection refused) are in the Log window. The same error is written only once.

CW over TCI

Select the keying method TCI in CW keying. Tucnak sends the text of the CW CQ messages to ExpertSDR3 as a CW macro and the program keys the transmitter.

  • Tucnak knows that the message has ended from the state of the transmitter (the radio goes back to receive). The repeated CQ and the Run mode use it.
  • The speed is set by Tucnak. When you change the speed in ExpertSDR3, Tucnak takes it if it is in the range of WPM Range in CW keying.
  • Esc stops the message.
  • Only the printable ASCII characters are sent, in upper case. Other characters are skipped, because ExpertSDR3 could close the connection. The characters : , and ; are replaced.
  • The CW from the keyboard (Tab) works too: Tucnak sends the typed text word by word. Enter sends the rest and switches to receive. Backspace deletes only the text which was not yet given to the radio.
  • TCI must be enabled, otherwise Tucnak writes CW via TCI needs TCI connection enabled or TCI: not connected to the log and sends nothing.
  • ExpertSDR3 2.1 has some bugs in the CW (for example it ignores the command for the CW terminal) and Tucnak works around them.

Audio recording over TCI

In Setup -> Audio (see Audio) you can choose TCI RX audio or TCI line out instead of a sound card as the source of the recording of the band traffic.

  • It is only for the recording. The playback of the voice CQ messages stays on the sound card.
  • The audio is received as a stream from ExpertSDR3, with the sample rate 8, 12, 24 or 48 kHz, mono or stereo. Tucnak changes the sample rate and the channels in Audio to the nearest allowed values.
  • When you change the source, the recording restarts. ExpertSDR3 may ignore a start right after a stop, so the restart takes about a second.
  • TCI must be enabled, otherwise Tucnak writes recording from TCI needs TCI enabled.

Sequencer

The sequencer switches also a serial port when Tucnak transmits, for example to control an amplifier or an LNA.

  • Port - the serial port. It is opened with 9600 baud. If it cannot be opened, Tucnak writes TCI sequencer: can't open ... to the log and does not use the sequencer.
  • DTR or RTS - which line is switched.
  • TX delay after port PTT [ms] - Tucnak switches the line on and sends the command to transmit after this time (default 50 ms), so the amplifier is ready before the power comes.
  • Port PTT off after RX [ms] - Tucnak switches the line off this time after the end of the transmit (default 50 ms).

It works for PTT (TRX), tune and CW. If the transmit is started by someone else (ExpertSDR3 or a foot switch), the line is switched on at once, so a bit late.

Problems

  • TCI: transmit is not allowed on this band - ExpertSDR3 does not allow the transmit on this frequency.
  • No connection - check that the TCI server is running in ExpertSDR3 and that the hostname and the port are the same in both programs.