101Cats Help

Integrating with third-party applications

101Cats provides good support for integration with third-party applications including log books and digital mode applications such as WSJT-X. As well as controlling the radio itself, 101Cats also functions as a hub to allow multiple third-party applications to connect to the radio. It implements multiple virtual FTdx101s so that each third-party application thinks it has sole control of the radio and 101Cats takes care of routing commands and responses accordingly so that no two applications will block each other.

101Cats makes use of an external virtual serial port driver application in order to establish the interfaces with the third-party applications. There are several virtual serial port driver applications available including com0com, Eltima Virtual Serial Port Driver and Eterlogic VIRTUAL SERIAL PORTS EMULATOR. Com0com is probably the most widely used - it is free and works well. The others may have more modern user interfaces, but they cost money and don't seem to have any significant benefit over com0com. Note that Windows 11 is more touchy that previous versions about third-party drivers. Com0com is available both signed and unsigned - you probably want to install the unsigned version with Windows 11.

Once you have chosen and installed your virtual serial port framework, you will have to create virtual serial port pairs to support the third-party applications that you wish to connect. Think of each virtual serial port pair as a virtual cable that can connect two applications together. You will need as many virtual serial port pairs as you have third-party applications to connect (actually, this may not be strictly true if you use Omnirig - see below).

I use Com0com and the screenshot below shows my configuration:

image

If you are creating multiple port-pairs, it can become difficult to keep track of them. Adopt a numbering scheme which makes it easy to remember the two ends of a port pair - in my example, the port numbers at each end differ by 20. If you are using com0com, you probably don't need to change any of the port parameters from their default settings.

Once you have created the port pairs, you need to configure one end of each of them into 101Cats. You can do this through the configuration dialogue box of 101Cats as shown below. Note that the configuration dialogue box does not currently include functionality to add or remove ports from the configuration. The standard configuration file includes six port entries and you can update these to suit your requirements. If you don't need all six, mark some of them as not enabled. If you need more than six, you'll have to manually edit the config.xml file.

image

Note that each virtual port configured into 101Cats is one end of a virtual serial port pair - the other end will be used by the corresponding application. In my example, port COM48 is configured for WSJT-X. Under my chosen numbering scheme, COM48 is one end of a pair with COM28 - hence the configuration of WSJT-X on my PC is:

image

You'll need to determine the Auto Information setting by trial and error in most cases. Auto Information is a function of the FTdx101 which can be turned on and off by the application - when it is on, the radio sends a continuous stream of status messages to the application, avoiding the need for the application to poll repeatedly for data. 101Cats is able to replicate the Auto Information stream out to each third-party application but doing so unnecessarily will increase the load on your PC, so try disabling it and checking if the application still works. Auto Information is controllable on a per application basis.

Omnirig

As far as 101Cats is concerned, Omnirig is just another third-party application. Create a virtual port pair, configure one side into 101Cats and the other into Omnirig, set Omnirig to connect to a Yaesu FTdx101D and that should then work. Omnirig is a CAT multiplexer and you may have multiple applications trying to control the radio simultaneously which can increase traffic through the virtual port pair, so don't set the speed low. You should enable Auto Information on the 101Cats port that connects to Omnirig and allow Omnirig to manage the onward flow or information to third-party applications. I've never tested Omnirig2 with 101Cats, but I see no reason why it should not work. Omnirig2 is not compatible with Omnirig1 and few applications use it.

Omnirig is driven by a configuration file which defines the interface to each of the radio models that it supports. As new models are added, this file is updated to include them and it is now a large and complex file. Errors do creep in and new releases of the configuration file are made. There have been errors in the configuration relating to the FTdx101 series in some releases. So, if you enable Omnirig and one or more applications do not behave as expected, do some internet research to see if you are experiencing a problem that has been diagnosed and fixed. See https://groups.io/g/FTDX-101D/topic/70262621#msg586 for information on one such Omnirig bug and how to fix it.

Last modified: 10 January 2025