Serial Port (CAT)

 

 

 


 

Serial Port Configuration

This program supports the use of serial ports for exchanging information with third-party programs such as logbooks. Normally you use virtual serial ports, for example those created using the VSP Manager by K5FR or VSPE from Eterlogic.

You connect the third-party program to one end of the serial cable and this program to the other. The third-party program sends commands to this program, for example to set the frequency and mode. The serial port cannot be used to monitor and synchronise another radio. In this window you select the ports which are opened by this program. This program opens and closes ports as you make changes to the selections in this window. The status is shown in the main logfile window.

In the program options select Port Selection:

Protocol: in your logbook program select the Kenwood TS-2000 protocol.

Note: you cannot use a serial port for a third-party program and at the same time use it to connect to an external radio unless these programs use Omni-Rig or similar. Use one serial port per program.

Speed: If you are using a virtual serial port the default speed of 57,600 can be used, if using a hardware port then the speed must match the speed at the other end of the connection. To change the speed you first select an entry in the list and then select the new speed from the dropdown at the top of the window.

Diagnostics

Use the I/O Monitor window to record and diagnose the serial port traffic. The View option displays the logfile with your default text file viewer.

Testing

Use the I/O test window to verify the serial port protocol. It is recommended to use a second instance of SDR Console for tests.

Connect to the other end of the virtual serial cable, then use Read All / Apply to return the values for the current receiver. The response should always be instantaneous.

Band Switching

When you change the frequency of the active receiver, the frequency range (band) in the main waterfall will only change if the corresponding option is enabled in the Receiver tuning options below.



 

 

Omni-Rig

If you are using Omni-Rig set the timeout to 100ms (the lowest value supported).

The above image shows the recommended Omni-Rig settings, remeber to select the correct Port, COM 11 is used as example.

Serial Port Commands

The serial port commands are shown below. The format follows the Kenwood TS-2000 protocol so software which uses the basic TS-2000 commands will not require significant changes.

FA FB, FC, FD, FE, FF

Frequency in Hz for receiver 1 (FA) to 6 (FF).

Read: FA; reads the frequency for receiver 1;

Write: FC + <11 digit frequency> + ; sets the frequency of receiver 3.

AI

Auto information

Read: AI; always returns AI0; (auto-information off).

Write: ignored. Auto information is always disabled.

IF

Transceiver information

Read: IF; returns the standard IF data 9see TS-2000 format).

Write: ignored.

SM

Signal meter level

Read: SM; returns the signal level as a four-digit value in 3dB steps (one S-unit is 6dB):

  • S0 = 0 units
  • S5 = 10 units
  • S9 - 18 units.

If the current signal level is below S0 the value returned is 0.

Write: ignored.

MD

Mode

Read: MD; returns the current mode.

Write MD<mode>;

The mode values are:

0 DSB
1 LSB
2 USB
3 CW (upper sideband)
4 FM
5 AM (includes ECSS)
6 Not used
7 Not used
8 Wide FM
9 Broadcast FM
10 Synchronous AM

TX

Transmit status, currently ignored

RX

Receive status, currently ignored

PS

Power status

Read: PS; always returns PS1; (power on) - if the power is not supplied to the computer then it is unlikely that it will function in a reliable way - on indeed function at all. If you have a computer that runs without power first find a good patent lawyer and then contact your local Green party representative.

GT

AGC - Off (0), Fast (1), Medium (2), Slow (3)

Read: GT; returns the current AGC setting, for example GT3; (slow).

Write: GT<agc>;

SH

Filter high value in Hz

Read: SH; returns the filter high value in Hz, for example SH03000; (3 kHz).

Write SH<value>;

SL

Filter low value in Hz, otherwise same as SH above.

AG

AF gain, range is 0 to 100.

Read: AG; returns the current value, for example AG075; (75 %).

Write: AG<value>;

MU

Audio mute status.

Read: MU; returns wither 0 (muted) or 1 (not muted).

Write: MU<status>; tba

NA

Read-only, returns the radio name, for example NetSDR. This is the same value shown at the bottom left of the status bar.

SA

Read-only, returns the current sample rate.

FT

Read-only, returns the transmitter index which is always 0.

FR

Read-only, returns the current receiver index.