Page Comparison

...

Trebuchet populates it's application list and creates a listener for discovery data based on a JSON configuration file. On start up, the launcher looks for this file, called appConfiguration.json in the same folder as the Trebuchet executable. On first start up, a blank config file will be created and written to disk (the blank config should allow radar discovery on most systems).

If the app cannot parse the config file (usually due to a syntax error, or if the file is empty), no data will be displayed in the app:

...

A cause for this will usually be found in the log file, found in the Logs folder within the Trebuchet exe trebuchet_debug folder. The log file will usually indicate the exact location of any syntax errors. Another common error is to mistype the name of a field, resulting in an error message referencing a mis-matched constructor.

The config file itself consists of two sections: ConnectionConfig and TrebuchetApps, which are the Radar Discovery Connection Details and the App Configuration respectively.

Connection Details - ConnectionConfig

The first section of an appConfiguration.json file , - ConnectionConfig, instructs the app on how to listen for radar discovery data for the Radar Discovery section. For example:

DiscoveryIPAddress: The multicast address from which to expect the messages.

DiscoveryInterface: The IP Address address of the receiving machine (Ii.Ee. The the PC being used).

DiscoveryPublishPeriod: The time, in milliseconds, between publication of received discovery messages.

...

For example, a launcher used on a PC with a network IP address of 10.77.3.59the (auto generated) default config file:

 "ConnectionConfig": {
    "DiscoveryIPAddress": "239.69.69.69",
    "DiscoveryInterface": "100.770.30.590",
    "DiscoveryPublishPeriod": 5000,
    "Port": 6317
  }

App Configuration - TrebuchetApps

Configuration of a single app The second section of an appConfiguration.json file - TrebuchetApps, consists primarily of providing a name, description, app location, and parameters for a the given app. At the top level, an app entry consists of the following fields:

...

An individual parameter consists of short and long names, whether or not they are required by the app, a default argument, and whether or not they have arguments. For example:

{
  "ShortForm": "i",
  "LongForm": "ipaddress",
  "Required": false true,
  "HasArguments": true,
  "DefaultValue": "127192.0168.0.1180",
"HasArguments": true
}

Parameter groups consist of a name (which may be blank i.e. for global options) and any number of parameters. They are designed to represent named groups of arguments that may be passed to the app.

...

{
"GroupName": "server",
     "Parameters": [
      {
             "ShortForm": "i",
    "LongForm": "ipaddress",
             "Required": false,
          
    "HasArguments": true,
    "DefaultValue": "127.0.0.1"
},
          
"HasArguments": true },{
    {            "ShortForm": "p",
              "LongForm": "port",
              "Required": false,
          
    "HasArguments": true,
    "DefaultValue": "6317",             "HasArguments": true
}
       ]
}

...

When displayed in the launcher, parameters are separated by their group name. Only the long form of the parameter name is given, and the DefaultValue field sets the value of the entry on start up. If the value of Required is set to true, then the launch button is disabled until that parameter is given a value.

...

Mutually exclusive parameter groups ensure that only one of these modes can be selected for a given instance. Within the configuration file, they are treated as a separate list to ParameterGroups:

...

.

When viewed in the UI, mutually exclusive groups are represented by a drop-down menu:

...

Once a group is selected, its constituent parameters are displayed to you.:

...

Special Treatment of Ipaddress and Port Parameters

Above the App Parameters panel in Trebuchet is the Connection Details panel, which contains the Hostname Use fixed address for all apps option, IP Address and Port fields. These The fields have some special characteristics unique to themselves.

If an app takes in parameters named ipaddress/ip_address and port as either global parameters (i.e. a blank group name) or as part of a Radar Group, then they will be translated to Hostname IP Address and Port in the radar. In other words, the values of Hostname IP Address and Port will always represent the radar’s connection details.

If you enter ipaddress and port as global options and do not see those options appear in the side panel, you should check to see if Hostname IP Address and Port are enabled in the connection panel. If the app cannot find these parameters in the config under the blank or Radar Group names, then these options will be greyed out.

This does not mean that all apps that connect to the radar may make use of this feature. For example, the Colossus Record and Playback tool only connects to the radar if it is taking a recording, so the ipaddress option is only available within the group Playback. Trebuchet will not recognise this as an app that can connect to the radar.

Example appConfiguration.json file:

{
    "ConnectionConfig": {
      "DiscoveryIPAddress": "239.69.69.69",
      "DiscoveryInterface": "0.0.0.0",
      "DiscoveryPublishPeriod": 5000,
      "Port": 6317
    },
    "TrebuchetApps": [
      {
        "Name": "Radar Utilities",
        "Description": "Manage radars and onboard trackers",
        "LaunchCommand": "",
        "ExePath": "C:\\Local\\Tools\\RadarUtilities-1.2.0.88\\RadarUtilities.exe",
        "ParameterGroups": [
          {
            "GroupName": "radar",
            "Parameters": [
              {
                "ShortForm": "i",
                "LongForm": "ipaddress",
                "Required": true,
                "HasArguments": true,
                "DefaultValue": "192.168.0.180"
              }
            ]
          }
        ],
        "MutualExclusiveGroups": [
          {
            "GroupName": "versioninfo",
            "Parameters": [
              {
                "ShortForm": null,
                "LongForm": "versioninfo",
                "Required": true,
                "HasArguments": false,
                "DefaultValue": ""
              }
            ]
          },
          {
            "GroupName": "reboot",
            "Parameters": [
              {
                "ShortForm": null,
                "LongForm": "reboot",
                "Required": true,
                "HasArguments": false,
                "DefaultValue": ""
              }
            ]
          }
        ],
        "ExecutionEnv": null
      },
      {
        "Name": "Radar Utilities 2",
        "Description": "Manage radars and onboard trackers",
        "LaunchCommand": "",
        "ExePath": "C:\\Local\\Tools\\RadarUtilities-1.2.0.88\\RadarUtilities.exe",
        "ParameterGroups": [
          {
            "GroupName": "radar",
            "Parameters": [
              {
                "ShortForm": "i",
                "LongForm": "ipaddress",
                "Required": true,
                "HasArguments": true,
                "DefaultValue": "10.77.5.233"
              }
            ]
          }
        ],
        "MutualExclusiveGroups": [
          {
            "GroupName": "versioninfo",
            "Parameters": [
              {
                "ShortForm": null,
                "LongForm": "versioninfo",
                "Required": true,
                "HasArguments": false,
                "DefaultValue": ""
              }
            ]
          },
          {
            "GroupName": "reboot",
            "Parameters": [
              {
                "ShortForm": null,
                "LongForm": "reboot",
                "Required": true,
                "HasArguments": false,
                "DefaultValue": ""
              }
            ]
          }
        ],
        "ExecutionEnv": null
      }
    ]
  }

...

Related Information