Add/Edit Trunk

When adding new trunk, first step requires 'Provider' and 'Device' selection.

[Tip] Tip

Although new trunk can be created without it, it is preferred that 'Provider' template is created first under 'Settings: Providers'

Table 4.3. Add/Edit Trunk

Field Description Example Field Type

Provider:

Select a service provider template

 BT Select box

Device:

If the providers service requires a device in order to provide the service, this field will become visible.

 None, T100 Select box


VoIP

Second step of the trunk installation and trunk edit command, opens the following options

Table 4.4. VoIP

Field Description Example Field Type

Name or Number:

Some providers require this field to be equal to DID number (e.g.55510205); but if connecting two systems, IP address may be used as well.

 2554433, myvoiceboxlink [a-z] [0-9]

Emergency trunk:

Should emergency services (Police, Ambulance etc) be dialed through this trunk

 Dialling 911 will pass the call through this trunk Option buttons

Peer Host:

IP of a peer host system sends the calls to

 192.168.1.1 IP Address

Username:

Username for authenticating with the service provider

 2554433 [0-9]

Peer Username:

Peer username for authenticating with the service provider

 2554433 [a-z] [0-9]

Secret:

Secret/Password used for authenticating with the service provider

 123456 [a-z] [0-9]

Peer secret:

Peer secret/password used for authenticating with the service provider

 123456 [a-z] [0-9]


Advanced Options

In this chapter we will cover:

General

These options are used frequently and required for normal trunk operation. Some of these fields are pre-configured with the default values. It is not recommended to change them.

Table 4.5. General

Field Description Example Field Type

User Type:

User's relationship to the system

  • user - Trunk accepts incoming calls only

  • peer - Trunk makes outgoing calls only

  • friend - Trunk does both incoming and outgoing calls

 Select box

DTMF Mode (Dual Tone Multi-Frequency):

Trunk DTMF mode. A specific frequency (consisting of two separate tones) to each key so that it can easily be identified by a microprocessor

  • inband - inband audio(requires 64 kbit codec - alaw, ulaw)

  • rfc2833 - default

  • info - SIP INFO messages

 Select box

Context:

Contexts define a scope within the PBXware. Trunk context cannot be modified and is same as the trunk name or number

 2554433 [a-z][0-9]

Status:

Set trunk status on the system

Rather then deleting the trunk you can disable it on system level by selecting 'Not Activated' here

 Select box

Qualify:

Timing interval in milliseconds at which a 'ping' is sent to a host in order to find out its status

 Set this field to 2000 for example. If more time then provided here is needed to reach the host, host is considered offline [0-9]

VoiceMaster Trunk:

Set whether this trunk leads to VoiceMaster gateway

 If you have a VoiceMaster gateway and are creating this trunk to connect it with this system, select 'Yes' here Option buttons

Country:

Country where service provider resides

 Select USA for example if provider is from United States Select box

National Dialing Code:

National dialing code used at the trunk destination

 For USA 1, United Kingdom, Germany 0 [0-9]

International Dialing Code:

International dialing code used at the trunk destination

 For USA 011, United Kingdom, Germany 00 [0-9]

E164 Accepted:

Does the trunk support dialing destinations in E164 format

Enabling this option will reformat any dialled number into following form COUNTRY_CODE + AREA_CODE + DIALED_NUMBER. For example, if you dial 55510205, system will dial 121255510205

 Option buttons

Pass-thru mode:

Pass the digits dialed without any conversion (E164, National, Area code). NOTE: When active, 'Leave National Code and 'Local Area Code' will be disabled

If this option is disabled PBXware will convert all dialed numbers to E164 format (COUNTRY_CODE + AREA_CODE + DIALED_NUMBER) and then make a call to converted number. If this option is enabled, PBXware will call directly DIALED_NUMBER without making any number conversions

 Option buttons

Leave National Code:

In some countries, national code is stripped automatically. If set to 'Yes', national code will not be stripped from the dialed number. NOTE: Before settings this option to 'Yes', go to 'Settings: Servers' and enable this options as well.

 John dials 121255510205. With this option enabled [0-9]

Local Area Code:

Add local area code to dialed number, if required by service provider. (By default, local area code is stripped when dialing)

User dials 55510205, local area code is 212. If call goes through this trunk PBXware will dial 21210205

 [0-9]

Prefix:

Value added to all dialed numbers going over the trunk

 Prefix 5, Dialed number 123, System dials 5123 [0-9]

Outbound Caller ID:

If Caller ID is not set by UAD, value provided here will be used instead for all outgoing calls

 55599999 [0-9]

Allow ES Caller ID:

Should ES (Enhanced Services) caller id be allowed over this trunk

Any extension can set custom caller id for each system trunk. With this option enabled, that caller id will be used instead of the trunk outbound caller id

 [0-9]


Network Related

These options set important network related values regarding NAT

Table 4.6. Network Related

Field Description Example Field Type

Canreinvite:

Should you allow RTP voice traffic to bypass PBXware. NOTE: All enhanced services for the extension have to be disabled

 Some devices do not support this especially if one of them is behind a NAT Options buttons

Default IP:

IP address to be used until registration

 192.168.1.1 IP Address


Channels

Table 4.7. Channels

Field Description Example Field Type

Incoming Limit:

Number of simultaneous incoming calls trunk can handle

4 equals to four simultaneous incoming calls. Any additional calls will get the busy sound

 [0-9]

Outgoing Limit:

Number of simultaneous outgoing calls trunk can handle

4 equals to four simultaneous outgoing calls. Any additional calls attempting to use this trunk will be rejected or will be redirected to other trunks depending on what is set in the system/extensions

 [0-9]

Notransfer:

Disable native IAX transfer

   Option buttons

Send ANI:

Should ANI ("super" Caller ID) be sent over this trunk

Set 'Yes' to enable

 Option buttons

Trunk:

Use IAX2 trunking with this host

Set 'Yes' to enable

 Option buttons


Authentication

Table 4.8. Authentication

Field Description Example Field Type

Host:

IP address of a host trunk is connecting to

Enter host IP, 192.168.1.1 for example or set 'dynamic' if host is behind dynamic IP address

 [0-9][a-z]

Register:

Method for registering to remote server

Providers may require different way of registration to their server. You may choose between 'registration not required', 'register with phone number' and 'register with username'

 Select box

Register suffix:

Service provider may request different registration methods for their services. Select the proper method, as required by the provider

 1234567 [0-9]

From Domain:

From domain data required by some providers

If your provider requires this information, provide the exact value here

 [a-z][0-9]

Auth Method:

Authentication method required by provider

 md5 [a-z] [0-9]

RSA key:

RSA authentication key

If Auth Method is set to RSA, then provide the RSA key here

 [a-z][0-9]

Encryption:

Should encryption be used when authenticating with the peer

   [a-z][0-9]


Codecs

Codecs are used to convert analog to digital voice signals and vice versa. These options set preferred codecs used by the extension.

[Tip] Tip

If some of the desired codecs cannot be checked, go to 'Settings: Servers: Edit: Default Codecs' and enable them under the 'Remote' group.

Table 4.9. 

Field Description Example Field Type

Disallow:

Set the codecs trunk is now allowed to use

This field is very unique. In order to work properly, this setting is automatically set to 'Disallow All' and it cannot be modified

 Read only

Allow:

Set the codecs extension is allowed to use

Only the codecs set under 'Settings: Server' will be available to choose from

  • ITU G.711 ulaw - 64 Kbps, sample-based, used in US

  • ITU G.711 alaw - 64 Kbps, sample-based, used in Europe

  • ITU G.723.1 - 5.3/6.3 Kbps, 30ms frame size

  • ITU G.726 - 16/24/32/40 Kbps

  • ITU G.729 - 8 Kbps, 10ms frame size

  • GSM - 13 Kbps (full rate), 20ms frame size

  • iLBC - 15Kbps,20ms frame size: 13.3 Kbps, 30ms frame size

  • Speex - 2.15 to 44.2 Kbps

  • LPC10 - 2.5 Kbps

  • H.261 Video - Used over ISDN lines with resolution of 352x288

  • H.263 Video - Low-bit rate encoding solution for video conferencing

  • H.263+ Video - Extension of H.263 that provides additional features that improve compression over packet switched networks.

 Check box


PSTN

Table 4.10. PSTN

Field Description Example Field Type

Name:

Trunk name/number

 032445231 for example [a-z][0-9]

Emergency trunk:

Should emergency services (Police, Ambulance etc) be called over this trunk

Select 'Yes' in order to dial emergency services over this trunk

 Option buttons

Channel(s):

Which card channels are used

If channel 2 and 4 are used on your card, set '2,4' here. If all four channels are used set '1-4' here

 [0-9], [,-]

Group:

Every ZAPTEL trunk has to belong to a group. Selecting any group will enable the trunk

With most of the cards this option is auto detected and set. If that is the case with your card - do not change this field

 Select box

FXS Kewlstarts:

Signaling protocol for analog circuits that better detects far-end disconnects

Select card channels to be monitored with it. For example '1,4' or '1-4'. These numbers should match the 'Channel(s)' field

 [0-9], [,-]

Country:

Destination of the trunk connection

If your system is located in USA, select USA here

 Select box

E164 Accepted:

Does the trunk support dialing destinations in E164 format

Enabling this option will reformat any dialled number into following form COUNTRY_CODE+AREA_CODE+DIALED_NUMBER. For example, if you dial 55510205, system will dial 121255510205

 Option buttons  

International Dialing Code:

International dialing code at the trunk destination

For USA 011, United Kingdom, Germany 00

 [0-9]


Advanced

Advanced options section contains all fields which relate to zapata and zaptel configuration files:

  • Zapata - Configuration of your hardware interface(s)

  • Zaptel - Configuration to use your hardware interface(s)

Zapata

In this chapter we will cover:

General

Table 4.11. General

Field Description Example Field Type

Language:

Default language

 us Select box

Context:

Contexts define a scope within the PBXware.

 default [a-z][0-9]

Status:

Trunk status

  • Active

  • Not Activated

 Select box

Signalling:

Signalling method

default

  • FXS Loopstart

  • FXS Groundstart

  • FXS Kewlstart

  • FXO Loopstart

  • FXO Groundstart

  • FXO Kewlstart

  • PRI CPE side

  • PRI Network side

  • BRI CPE side

  • BRI Network side

  • BRI CPE PTMP

  • BRI Network PTMP

 Select box

Music On Hold:

Select which class of music to use for music on hold. If not specified then the 'default' will be used

 default Select box

Mailbox:

Define a voicemail context

1234, 1234@context

 [a-z][0-9]

Group Method:

   [a-z][0-9]


RX/TX

Table 4.12. RX/TX

Field Description Example Field Type

RX Wink:

Set timing parameters

  • Pre-wink (50ms)

  • Pre-flash (50ms)

  • Wink (150ms)

  • Receiver flashtime (250ms)

  • Receiver wink (300ms)

  • Debounce timing (600ms)

 Select box

RX Gain:

Receive signal decibel

In case that incoming sound is low and you cannot hear other party well, set this option to 2. That should increase incoming sound by 2 decibels

 [0-9]

TX Gain:

Transmit signal decibel

In case that outgoing sound is low and other party cannot hear you well, set this option to 2. That should increase outgoing sound by 2 decibels

 [0-9]


PRI

Table 4.13. PRI

Field Description Example Field Type

Switchtype:

Set switch type

  • National ISDN 2

  • Nortel DMS100

  • AT&T 4ESS

  • Lucent 5ESS

  • EuroISDN

  • Old National ISDN 1

 Select box

PRI Dial Plan:

Set dial plan used by some switches

  • Unknown

  • Private ISDN

  • Local ISDN

  • National ISDN

  • International ISDN

 Select box

PRI Local Dial Plan:

Set numbering dial plan for destinations called locally

  • Unknown

  • Private ISDN

  • Local ISDN

  • National ISDN

  • International ISDN

 Select box

PRI Trust CID:

Trust provided caller id information

 Yes, No, N/A Option buttons

PRI Indication:

How to report 'busy' and 'congestion' on a PRI

  • outofband - Signal Busy/Congestion out of band with RELEASE/DISCONNECT

  • inband - Signal Busy/Congestion using in-band tones

 Select box

Network Specific Facility:

If required by switch, select network specific facility

  • none

  • sdn

  • megacom

  • accunet

 Select box


Caller ID

Table 4.14. Caller ID

Field Description Example Field Type

Outbound Caller ID:

Caller ID set for all outbound calls where Caller ID is not set or supported by a device

 [email protected] [0-9]

Allow ES Caller ID:

Should ES (Enhanced Services) Caller ID be allowed over this trunk

Any extension can set custom Caller ID for each system trunk. With this option enabled, that Caller ID will be used instead of the Trunk Outbound Caller ID

 [0-9]

Caller ID (for analog or inbound):

CallerID can be set to 'asreceived' or a specific number if you want to override it

NOTE: Caller ID can only be transmitted to the public phone network with supported hardware, such as a PRI. It is not possible to set external caller ID on analog lines

 'asreceived', 555648788 [a-z][0-9]

Use Caller ID:

Whether or not to use caller id

 Yes, No, N/A Option buttons

Hide Caller ID:

Whether or not to hide outgoing caller ID

 Yes, No, N/A Options buttons

Restrict CID:

Whether or not to use the caller ID presentation for the outgoing call that the calling switch is sending

 Yes, No, N/A Option buttons

Use CallerID Presentation:

Whether or not use the caller ID presentation for the outgoing call that the calling switch is sending

   Option buttons

CID Signalling:

Set the type of caller ID signalling

  • bell - US

  • v23 - UK

  • dtmf - Denmark, Sweden and Netherlands

 Select box

CID Start:

What signals the start of caller ID

  • ring = a ring signals the start

  • polarity = polarity reversal signals the start

 Select box

Call Waiting CID:

Whether or not to enable call waiting on FXO lines

 Yes, No, N/A Option buttons

Send CallerID After:

Some countries, like UK, have different ring tones (ring-ring), which means the caller id needs to be set later on, and not just after the first ring, as per the default.

 Yes Select box


Echo Canceller

Table 4.15. Echo Canceller

Field Description Example Field Type

Echo Cancel:

Enable echo cancellation

 Yes, No, N/A Select box

Echo Training:

Mute the channel briefly, for 400ms, at the beginning of conversation, cancelling the echo. (Use this only if 'Echo Cancel' doesn't work as expected)

 Yes, No, N/A Option buttons

Echo Cancel When Bridged:

Enable echo cancellation when bridged. Generally not necessary, and in fact undesirable, to echo cancel when the circuit path is entirely TDM

 Yes, No, N/A Option buttons


Call Features

Table 4.16. Call Features

Field Description Example Field Type

Call Waiting:

Whether or not to enable call waiting on FXO lines

 Yes, No, N/A Option buttons

Use Calling Pres:

Whether or not use the caller ID presentation for the outgoing call that the calling switch is sending

 Yes, No, N/A Option buttons

Three Way Calling:

Support three-way calling. If enabled, call can be put on hold and one is able to make another call

 Yes, No, N/A Option buttons

Transfer:

Support call transfer and also enables call parking (overrides the 'canpark' parameter). Requires 'Three Way Calling' = 'Yes'.

 Yes, No, N/A Option buttons

Can Call Forward:

Support call forwarding

 Yes, No, N/A Option buttons

Call Return:

Whether or not to support Call Return '*69'. Dials last caller extension number

 Yes, No, N/A Option buttons

Overlap Dial:

Enable overlap dialing mode (sends overlap digits)

 Yes, No, N/A Option buttons

Pulse Dial:

Use pulse dial instead of DTMF. Used by FXO (FXS signalling) devices

 Yes, No, N/A Option buttons


Call Indications

Table 4.17. Call Indications

Field Description Example Field Type

Distinctive Ring Detection:

Whether or not to do distinctive ring detection on FXO lines

 Yes, No, N/A Option buttons

Busy Detect:

Enable listening for the beep-beep busy pattern

 Yes, No, N/A Option buttons

Busy Count:

How many busy tones to wait before hanging up. Bigger settings lower probability of random hangups. 'Busy Detect' has to be enabled

  • 4

  • 6

  • 8

 Select box

Call Progress:

Easily detect false hangups

 Yes, No, N/A Option buttons

Immediate:

Should channel be answered immediately or the simple switch should provide dialtone, read digits, etc

 Yes, No, N/A Option buttons


Call Groups

Table 4.18. Call Groups

Field Description Example Field Type

Call Group:

Which group is allowed to pickup incoming calls by dialing *8. The default value is empty.

 1, 1-4 [0-9]

Pickup Group:

Which groups are allowed to pickup calls by dialing *8. The default value is empty.

 1, 1-4 [0-9]


FXS Channels

Table 4.19. FXS Channels

Field Description Example Field Type

FXS Loopstart:

Signals the far end that it wants the dial tone by shorting the leads

 default [a-z][0-9]

FXS Groundstart:

Signals the far end that it wants the dial tone by grounding one of the leads

 default [a-z][0-9]


Locality

Table 4.20. Locality

Field Description Example Field Type

Country:

Destination of the trunk connection

 USA Select box

E164 Accepted:

Does the trunk support dialing destinations in E164 format

Enabling this option will reformat any dialled number into following form COUNTRY_CODE+AREA_CODE+DIALED_NUMBER. For example, if you dial 55510205, system will dial 121255510205

 Option buttons

National Dialing Code:

National dialing code at the trunk destination

 For USA 1, United Kingdom, Germany 0 [0-9]

Leave National Code:

In some countries, national code is stripped automatically. If set to 'Yes', national code will not be stripped from the dialed number. NOTE: Before settings this option to 'Yes', go to 'Settings: Servers' and enable this options as well.

 John dials 121255510205. With this option enabled [0-9]

International Dialing Code:

International dialing code at the trunk destination

For USA 011, United Kingdom, Germany 00

 [0-9]

Local Area Code:

Add local area code to dialed number, if required by service provider. (By default, local area code is stripped when dialing)

User dials 55510205, local area code is 212. If call goes through this trunk PBXware will dial 21210205

 [0-9]

Write dialing code:

Should National and International prefix be written into configuration files

Enable this option if required by provider

 [0-9]

Prefix:

Value added to all dialed numbers going over the trunk

 Prefix 5, Dialed number 123, System dials 5123 [0-9]


Other Zapata Options

Table 4.21. Other Zapata Options

Field Description Example Field Type

ADSI (Analog Display Services Interface):

Enable remotely controlling of screen phone with softkeys. (Only if you have ADSI compatible CPE equipment)

 Yes, No, N/A Option buttons

Jitter Buffers:

Configure jitter buffers. Each one is 20ms long

 4 [0-9]

Relax DTMF:

If you are having trouble with DTMF detection, you can relax the DTMF detection parameters

 Yes, No, N/A Option buttons

Fax Detect:

Enable fax detection

  • both

  • incoming

  • outgoing

  • no

 Select box


Span

Table 4.22. Span

Field Description Example Field Type

Span number:

Number of the span

 1 [0-9]

Span timing:

How to synchronize the timing devices

  • 0 - do not use this span as sync source

  • 1 - use as primary sync source

  • 2 - set as secondary and so forth

 [a-z]

Line build out:

  

  • 0 db (CSU) / 0-133 feet (DSX-1)

  • 133-266 feet (DSX-1)

  • 266-399 feet (DSX-1)

  • 399-533 feet (DSX-1)

  • 533-655 feet (DSX-1)

  • -7.5db (CSU)

  • -15db (CSU)

  • -22.5db (CSU)

 Select box

Framing:

How to communicate with the hardware at the other end of the line

  • For T1: Framing is one of d4 or esf.

  • For E1: Framing in one of cas or ccs.

 Select box  

Coding:

How to encode the communication with the other end of line hardware.

  • For T1: coding is one of ami or b8zs

  • For E1: coding is one of ami or hdb3 (E1 may also need crc)

 Select box

Yellow:

Whether yellow alarm is transmitted when no channels are open.

 Yes, No, N/A Option buttons


Dynamic Span

Table 4.23. Dynamic Span

Field Description Field Type

Dynamic span driver:

The name of the driver (e.g. eth)

  

Dynamic span address:

Driver specific address (like a MAC for eth).

  

Dynamic span channels:

Number of channels.

  

Dynamic span timing:

Sets timing priority, like for a normal span. Use "0" in order not to use this as a timing source, or prioritize them as primary, secondary, etc.

  


FXO Channels

Table 4.24. FXO Channels

Field Description Field Type

FXO Loopstart:

Channel(s) are signalled using FXO Loopstart protocol

  

FXO Groundstart:

Channel(s) are signalled using FXO Groundstart protocol

  

FXO Kewlstart:

Channel(s) are signalled using FXO Kewlstart protocol

  


PRI Channels

Table 4.25. PRI Channels

Field Description Example Field Type

D-Channel(s):

For example, every ISDN BRI card has 1 D- (control) channel

 1 [0-9]

B-Channels(s):

For example, every ISDN BRI card has 2 B- (data) channels

 2 [0-9]


Other Zaptel Channels

Table 4.26. Other Zaptel Channels

Field Description Field Type

Unused:

   [0-9]

Clear:

   [0-9]


Zaptel

The zaptel.conf file is where the TDM-specific interface parameters required for ZAPTEL card(s) can be configured.

Span number

Span number set which span this trunk is to use.

Span timing

Span timing sets where is zaptel going to obtain its timing from. Choices are: 0 (Telco), 1 (System) , 2 (?)

Line Build Out

Line build out sets the distance between service hardware equipment.

Framing

Framing used on this trunk.

Coding

Coding used on this trunk

Yellow

Yellow field can be set to "Yes" or "No"

Signalling, D and B Channels

fields: "e&m, fxsls, fxsgs, fxsks, fxols, fxogs, fxoks, sf, unused, clear, indclear, rawhdlc, dchan, bchan, fcshdlc, nethdlc, dacs" are used to set signalling and operation mode for one or range of channels

Zones

Choose zone your interface card will be loaded with indication tones of.

defaultzone=us

loadzone=$VALUE (For Example: us)

Available zones are: us, au, fr, nl, uk, fi, es, jp, no, at, nz, it, us-old, gr, tw, cl