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.