TPISS configuration file

To determine the behavior of TPISS, a configuration file can be used. To use a configuration file, a command line parameter when starting TPISS must be used to define the configuration file.

# Configuration example for TiePie Instrument Sharing Server

server:
{
#  name = "TPISS";
#  description = "DESCRIPTION";

#  port = 5450;
#  discovery = false;
#  allow = [ "10.1.0.0/16" , "192.168.1.0/24" ];
#  deny = [ "10.0.0.0/8" ];

#  dataratemax = 0.0;

  combine =
  (
#    [ 12204 , 16559 ] ,
#    [ 54321 , 11223 ]
  );
};

The file default installed with TPISS contains no settings, but shows examples of the possible settings, as out commented instructions.

The name setting defines the name of the server, as will be shown in the Multi Channel oscilloscope software on remote computers. When no name is set, TPISS uses the computer name / host name that is set.

The description setting defines an optional description of the server, as will be shown in the Multi Channel oscilloscope software on remote computers. It can e.g. contain the physical location of the server.

The port setting defines which port is used by TPISS. The default setting is IANA assigned port 5450. When using a different port, the Multi Channel oscilloscope software on remote computers will not be able to locate network instruments automatically. Network locations will then have to be added manually, using the correct port number.

The discovery setting defines whether TPISS will respond to discovery requests from remote computers running Multi Channel oscilloscope software. When set to false, the server will have to be added manually to the Multi Channel oscilloscope software in order to use instruments on the server.

The allow and deny settings define IP addresses of remote computers that are allowed and/or denied to connect to TPISS. IP addresses need to be entered in CIDR notation.

  • When no IP addresses are allowed or denied, all IP addresses are allowed to connect to TPISS.
  • When only IP addresses are allowed, all other addresses are denied to connect to TPISS.
  • When only IP addresses are denied, all other addresses are allowed to connect to TPISS.
  • When IP addresses are allowed and IP addresses are denied, all addresses that are not specifically denied, are allowed to connect to TPISS. Additionally, all addresses that are specifically allowed, are allowed to connect to TPISS, even if they fall in the range of denied addresses.

Some examples:

  • allow = ["192.168.0.0/24"]
    All addresses in the range from 192.168.0.0 to 192.168.0.255 are allowed to connect to TPISS.
    All other addresses are denied to connect.
  • deny = ["192.168.0.0/16"]
    All addresses in the range from 192.168.0.0 to 192.168.255.255 are denied to connect to TPISS.
    All other addresses are allowed to connect.
  • allow = ["192.168.1.0/24"]
    deny = ["192.168.0.0/16"]
    All addresses in the range from from 192.168.0.0 to 192.168.255.255 are denied to connect to TPISS.
    But all addresses in the range from 192.168.1.0 to 192.168.1.255 are allowed to connect.
    And all addresses outside the range from 192.168.0.0 to 192.168.255.255 are allowed to connect.
  • allow = ["192.168.0.0/24", "192.168.4.0/24"]
    All addresses in the range from 192.168.0.0 to 192.168.0.255 are allowed to connect to TPISS.
    All addresses in the range from 192.168.4.0 to 192.168.4.255 are allowed to connect to TPISS.
    All other addresses are denied to connect.

The dataratemax setting defines the maximum data rate TPISS will allow per instrument when operating in streaming mode, in Mbps. The rate can be defined as a floating point number.

When multiple instruments are connected to the computer running TPISS to be used as a combined instrument, the instruments will be automatically combined by TPISS and shared as combined instrument. The instruments need to be connected to each other using the TP-C50H Coupling cable CMI before starting TPISS or before the instruments are connected to the USB.