TASSTA Documentation Center TASSTA Documentation Center More products
Hide table of contents Hide details Search My account

T.Bridge configuration

Modify provider-specific data in T.Bridge configuration file.

"ProviderDriver": "nxip",
"ProviderConfig": {
    "root_channel_name": "KENWOOD",
    "groups": [101, 102],
    "users": [1001, 1002],
    "broadcast_groups": [101],
    "statuses": {
        "0": "I need help!",
        "1": "Job Done!"
    },
    "system_type": 1,
    "system_no": 326,
    "site_no": 1,
    "console_id": 10,
    "site_ip": "172.16.1.10",
    "site_port": 50600,
    "local_ip": "10.0.0.5",
    "local_port": 50601,
    "network_category": 1,
    "channel_spacing": 1,
    "vocoders": "DVCOG80",
    "log_level_vocoders": 4,
    "begin_rtp_port": 25000,
    "end_rtp_port": 30000,
    "log_level_nxdn": 4,
    "ran_decode": 0,
    "ran_encode": 0,
    "private_call_timeout": 0,
    "lp": {
        "users": [1001, 1002],
        "times": {
            "reinitialization": 30,
            "error_times": {
                "timeout": 60,
                "busy": 20,
                "not_exist": 60,
                "other": 30
            }
        }
    },
    "preprocessor_from_tassta": {
        "agc_level":1,
        "agc_max_gain":150,
        "agc_increment":250,
        "agc_decrement":-250
    },
    "preprocessor_to_tassta": {
        "agc_level":1,
        "agc_max_gain":150,
        "agc_increment":250,
        "agc_decrement":-250
    }
}
Parameter Required Description
ProviderDriver Yes Must be nxip.
root_channel_name No The base channel name for the bridged Kenwood repeater. This channel will appear in TASSTA network when T.Bridge is running. All channels from the bridged network will be presented as sub-channels.
If omitted, the base channel will be named "KENWOOD".
groups Yes A list of bridged groups, an array of SSI's. Only the groups from this list are available in TASSTA network.
users Yes A list of bridged mobile radios, an array of SSI's. Only the radios from this list are available in TASSTA network.
broadcast_groups No A list of channels to which broadcast calls are allowed, an array of group SSI's.
If omitted, bridged broadcast calls are not allowed.
statuses No The mapping of common status messages for the Kenwood system and TASSTA network in the form of "<STATUS MESSAGE ID>": "<TEXT>". Status message ID should be from 0 to 255.
system_type Yes The type of the bridged Kenwood system:
  • 1 - trunked (a pool of channels which are available for different groups of users);
  • 2 - conventional (a dedicated channel for each individual group of users).
system_no Yes The identifier of the Kenwood system, from 1 to 131,071.
See Finding out Kenwood system parameters for details.
site_no Yes The identifier of the site.
See Finding out Kenwood system parameters for details.
console_id Yes The identifier of the console.
See Finding out Kenwood system parameters for details.
site_ip Yes IP address of the Kenwood repeater's site.
See Finding out Kenwood system parameters for details.
site_port Yes Port number of the Kenwood repeater's site. Use 50600.
local_ip Yes IP address of the computer running T.Bridge.
local_port Yes A port number that is used for communicating with Kenwood repeater on the computer running T.Bridge. You can specify any unused port.
network_category Yes The category of the Kenwood system:
  • 1 - local;
  • 2 - regional.
See Finding out Kenwood system parameters for details.
channel_spacing Yes Channel spacing:
  • 0 - narrow, 12.5 kHz;
  • 1 - very narrow, 6.25 kHz.
See Finding out Kenwood system parameters for details.
vocoders Yes Hardware ID of USB-3000 Vocoder Device.
log_level_vocoders Yes Severity level of logged events related to the Vocoder module:
  • 0 - no events logged;
  • 1 - log only errors;
  • 2 - log errors and warnings;
  • 3 - log errors, warnings and informational events;
  • 4 - log everything, including debug information. Warning: Log file may become too large.
The events are written to T.Bridge log.
begin_rtp_port Yes The start port of the interval used by T.Bridge to receive RTP.
end_rtp_port Yes The end port of the interval used by T.Bridge to receive RTP. Must be greater than begin_rtp_port.
log_level_nxdn Yes Severity level of logged events related to the Kenwood system:
  • 0 - no events logged;
  • 1 - log only errors;
  • 2 - log errors and warnings;
  • 3 - log errors, warnings and informational events;
  • 4 - log everything, including debug information. Warning: Log file may become too large.
The events are written to T.Bridge log.
ran_decode Yes Channel RAN decode setting.
See Finding out Kenwood system parameters for details.
ran_encode Yes Channel RAN encode setting.
See Finding out Kenwood system parameters for details.
private_call_timeout No Inactivity timeout (in seconds) after which private calls are automatically ended. Disabled by default (0).
lp No Location sharing configuration. See Location settings for details.
preprocessor_from_tassta No Automatic gain control for voice passed from TASSTA network to the external network. If omitted, the audio is left as is.
See Automatic gain control for details.
preprocessor_to_tassta No Automatic gain control for voice passed from the external network to TASSTA network. If omitted, the audio is left as is.
See Automatic gain control for details.

Location settings

lp section configures the periodic refresh of radios' position. Only works for mobile radios that report their geolocation.

Parameter Description
users A list of bridged mobile radios to get location information from; an array of SSI's.
If the value is set to null, T.Bridge queries all radios from ProviderConfig/users list.
times/reinitialization The time in seconds after which T.Bridge automatically reactivates the location request queue if no position data is received from the Kenwood repeater for more than for 3 minutes.
times/error_times/timeout The time in seconds before re-querying the location if the service is not responding.
times/error_times/busy The time in seconds before re-querying the location if the service is busy.
times/error_times/not_exist The time in seconds before re-querying the location if the service is unavailable.
times/error_times/other The time in seconds before re-querying the location in case of other errors.

Automatic gain control

You may encounter too quiet or too loud sound when the voice is transmitted between bridged networks. To mitigate the problem, balance the sound using automatic gain control settings:

  • agc_level is the maximum sound level at the output, percentage from 0 to 1.
  • agc_max_gain is the maximum gain in dB, positive integer.
  • agc_increment is the maximum energy increase in dB per second, positive integer.
  • agc_decrement is the maximum gain reduction in dB per second, negative integer.

You can configure automatic gain control for both directions: from the bridged system to TASSTA network (preprocessor_to_tassta), and from the TASSTA network to the bridged system (preprocessor_from_tassta), depending on your specific conditions.

If this parameter is not provided, the audio is transmitted as is, without any preprocessing.

Important:

Improper configuration of the automatic gain control can result in the sound being barely audible. It is recommended to test new settings before deploying them to production.