Solwise Elite ITG,FXO,FXS2,FXS1 Extera Set-up Instructions

Solwise
Ltd
.
Extra Set-up instructions for
Solwise Elite ITG
VoIP Gateways
The Solwise Forum is designed to be the first port-of-call for technical support and sales advice for the whole Solwise product range.
Please check the forum for coverage on any technical problems you have. Many people have trodden your path before you, and a quick check on the forum will reduce the pressure on our support staff.
Oct 10, 2003
Solwise Elite VoIP Gateway User’s Guide
Notification is hereby given that Solwise Ltd. reserves the right to modify, change, update or revise this document from time to time as required without the prior obligation to notify any person, company or organization. Further, Solwise makes no warranty or representation, either express or implied, with respect to merchantability, or fitness of its products for a particular purpose.
Solwise Ltd.
13/15 Springfield Way Anlaby Hull HU10 6RJ UK
Tel 0845 458 4558 (local rate) Fax 0845 458 4559 Email sales@solwise.co.uk Http www.solwise.co.uk
Copyright
All rights reserved. No part of this document may be reproduced in any form or by any means without written permission from the product manufacturer.
Changes are periodically made to the information in this document. They will be incorporated in subsequent editions. The product manufacturer may take improvement and/or changes in the product described in this document at any time.
FCC compliance
This equipment complies with Part 68 of the FCC Rules. On this equipment is a label that contains, among other information, the FCC registration number and Ringer Equivalence Number (REN) for this equipment. You must, upon request, provide this information to your telephone company.
If your telephone equipment causes harm to the telephone network, the Telephone Company may discontinue your service temporarily. If possible, they will notify in advance. But, if advance notice isn’t practical, you will be notified as soon as possible. You will be informed of your right to file a complaint with the FCC.
Your telephone company may make changes in its facilities, equipment, operations, or procedures that could affect proper operation of your equipment. If they do, you will be notified in advance to give you an opportunity to maintain uninterrupted telephone service. The FCC prohibits this equipment to be connected to party lines or coin-telephone service.
In the event that this equipment should fail to operate properly, disconnect the equipment from the phone line to determine if it is causing the problem. If the problem is with the equipment, discontinue use and contact your dealer or vendor.
Before installing this equipment, users ensure that it is permissible to be connected to the facilities of the local Telecommunications Company. The equipment must also be installed using an acceptable method of connection. The customer should be aware that compliance with the above conditions might not prevent degradation of service in some situations.
2
Solwise Elite VoIP Gateway User’s Guide
Repairs to certified equipment should be made by an authorized Canadian maintenance facility designated by the supplier. Any repairs or alterations made by the user to this equipment, or equipment malfunctions, may give the telecommunications company cause to request the user to disconnect the equipment.
Users should ensure for their own protection that the electrical ground connections of the power utility, telephone lines and internal metallic water pipe system, if present, are connected together. This precaution may be particularly important in rural areas.
CAUTION: Users should not attempt to make such connections themselves, but should contact the appropriate electric inspection authority, or electrician, as appropriate.
European CTR 21 compliance
The equipment has been approved in accordance with Council Decision 98/482/EC for pan-European single terminal connection to the public switched telephone network (PSTN). However, due to differences between the individual PSTNs provided in different countries, the approval does not, of itself, give an unconditional assurance of successful operation on every PSTN network termination point. In the event of problem, you should contact your equipment supplier in the first instance.
3
Table of Contents
1 Extra set-up notes for the Elite series
VoIP gateways ...............................................11
1.1 Using a ‘Wildcard’ phone number............................11
1.2 Clearing to defaults...................................................12
1.3 How can I set-up a ‘hotline’?....................................12
1.3.1 Lets give an example:.....................................12
1.4 How can I stop the gateways ‘playing’ the
DTMF tones when a call is received?.............................14
1.5 How can I configure the gateway to handle
the clear forward signal (caller disconnect) ....................14
1.5.1 So what does this mean? ...............................14
1.5.2 So what’s this got to do with VoIP
gateways?.................................................................15
1.5.3 So how do you configure the gateway
to handle the polarity reversal then?........................15
1.5.4 So how do you configure the gateway
to a disconnect tone correctly then?.......................16
2 Integration Examples for 2 & 4 Port
Desktop Version .............................................24
2.1 Application A: FXS ...................................................24
2.2 Application B: FXS / FXO combination....................24
3 Integration Examples for 4 & 8 Port Rack
Mount Version ................................................26
3.1 Application A: FXS ...................................................26
3.2 Application B: FXS/FXO Combination.....................26
3.3 Application C: FXS/FXO Extended
Combination ....................................................................27
3.4 Configuration Examples...........................................28
3.4.1 Scenario 1 .......................................................28
3.4.2 Scenario 2 .......................................................32
4 Upgrading Software ..........................................38
5 CLI Documentation ...........................................40
5.1 Using The Command Line Interface (CLI) ..............40
5.2 Utility Commands .....................................................48
5.2.1 clrscr ................................................................48
5.2.2 download .........................................................49
5.2.3 help..................................................................49
5
Solwise Elite VoIP Gateway User’s Guide
5.2.4 ping..................................................................49
5.2.5 tel erase_ivr.....................................................49
5.2.6 tel set pcm_gain_level ....................................50
5.2.7 tel set ring_freq................................................50
5.2.8 tel show pcm_gain_level.................................51
5.2.9 tel show port ....................................................51
5.2.10 tel show ring_freq..........................................51
5.3 3. IP Configuration Commands................................52
5.3.1 arp....................................................................52
5.3.2 net reset...........................................................52
5.3.3 net set gateway ...............................................52
5.3.4 net set http.......................................................53
5.3.5 net set ip ..........................................................53
5.3.6 net set ip_preced.............................................54
5.3.7 net set mask....................................................54
5.3.8 net set speed...................................................55
5.3.9 net set telnet....................................................55
5.3.10 net set http.....................................................56
5.3.11 net set user_pw.............................................56
5.3.12 net show ........................................................57
5.3.13 net show hwstat ............................................57
5.4 Telephony Interface Port Configuration
Commands ......................................................................58
5.5 Common Telephony Port Configuration
Commands ......................................................................58
5.5.1 set port port ans_wait......................................58
5.5.2 set port port call_limit ......................................59
5.5.3 set port port cid name .....................................59
5.5.4 set port port cid number..................................59
5.5.5 set port port copyof .........................................60
5.5.6 set port port cp_tone_det_cfg.........................60
5.5.7 set port port cp_tone_det_ctrl.........................61
5.5.8 set port port dial_in plar...................................62
5.5.9 set port port fax_holdover ...............................62
5.5.10 set port port fax_tone_det_ctrl......................62
5.5.11 set port port fax_prof.....................................63
5.5.12 set port port hangup_wait .............................63
5.5.13 set port port out_type....................................64
6
Solwise Elite VoIP Gateway User’s Guide
5.5.14 set port port out_wait ....................................64
5.5.15 set port port prof_bit......................................64
5.5.16 set port port proto..........................................65
5.5.17 set port port rxgain ........................................65
5.5.18 set port port tone_out_off..............................66
5.5.19 set port port tone_out_on..............................66
5.5.20 set port port tone_out_pwr............................67
5.5.21 set port port tone_table.................................67
5.5.22 set port port txgain ........................................67
5.5.23 set port port voice_prof .................................68
5.6 E&M Common Signaling Configuration
Commands ......................................................................68
5.6.1 set port port em clear_conf_detect.................68
5.6.2 set port port em clear_conf_wait_max ...........69
5.6.3 set port port em clear_detect..........................69
5.6.4 set port port em connected_min.....................69
5.6.5 set port port em dial_tone...............................70
5.6.6 set port port em disable_hangup....................70
5.6.7 set port port em guard_all...............................70
5.6.8 set port port em guard_out .............................71
5.6.9 set port port em offhook_db............................71
5.6.10 set port port em onhook_db..........................71
5.6.11 set port port em size_detect .........................72
5.7 E&M Immediate Start Signaling
Configuration Commands ...............................................72
5.7.1 set port port emi glare_report .........................72
5.7.2 set port port emi wait_dsp_ready ...................72
5.8 E&M Delay Start Signaling Configuration
Commands ......................................................................73
5.8.1 set port port emd in_delay_max.....................73
5.8.2 set port port emd in_delay_min ......................73
5.8.3 set port port emd in_digit_ign .........................73
5.8.4 set port port emd out_delay_check ................74
5.8.5 set port port emd out_delay_dur_max ...........74
5.8.6 set port port emd out_delay_dur_min ............74
5.8.7 set port port emd out_intg_check...................75
5.9 E&M Wink Start Signaling Configuration
Commands ......................................................................75
7
Solwise Elite VoIP Gateway User’s Guide
5.9.1 set port port emw in_wink_digit_ignore..........75
5.9.2 set port port emw in_wink_dur........................76
5.9.3 set port port emw in_wink_wait_max .............76
5.9.4 set port port emw in_wink_wait_min ..............76
5.9.5 set port port emw out_wink_dur_max ............77
5.9.6 set port port emw out_wink_dur_min .............77
5.9.7 set port port emw out_wink_wait_max...........77
5.10 FXO Signaling Configuration Commands..............78
5.10.1 set port port fxo answer_after.......................78
5.10.2 set port port fxo batt_rev_times....................78
5.10.3 set port port fxo caller_id...............................79
5.10.4 set port port fxo cpc_detect ..........................79
5.10.5 set port port fxo guard_out............................79
5.10.6 set port port fxo loop_det_db........................80
5.10.7 set port port fxo ringing_db...........................80
5.10.8 set port port fxo ringing_inter_cycle .............81
5.10.9 set port port fxo ringing_inter_pulse.............81
5.11 FXS Signaling Configuration Commands ..............82
5.11.1 set port port fxs answ_clear_detect..............83
5.11.2 set port port fxs caller_id...............................83
5.11.3 set port port fxs cpc_dur ...............................83
5.11.4 set port port fxs cpc_wait..............................84
5.11.5 set port port fxs offhook_db ..........................84
5.11.6 set port port fxs offhook_detect ....................84
5.11.7 set port port fxs onhook_db..........................85
5.11.8 set port port fxs onhook_detect ....................85
5.11.9 set port port fxs ring_id .................................86
5.12 Voice and Fax Coder Configuration
Commands ......................................................................86
5.12.1 Common Coding Profile
Configuration Commands ........................................87
5.12.2 Voice Coding Profile Configuration
Commands ...............................................................89
5.12.3 Fax Coding Profile Configuration
Commands ...............................................................93
5.13 Call Progress Tone Configuration
Commands ......................................................................96
5.13.1 Configuring CP Tones ..................................96
5.13.2 Configuring CP Tone Detector .....................98
8
Solwise Elite VoIP Gateway User’s Guide
5.14 H323 Configuration Commands...........................101
5.14.1 set h323 alias ..............................................101
5.14.2 set h323 allow_calls_wo_gk.......................101
5.14.3 set h323 alt_dtmf.........................................102
5.14.4 set h323 auto_answer ................................102
5.14.5 set h323 call_name.....................................103
5.14.6 set h323 cisco_t38......................................103
5.14.7 set h323 default_dtmf .................................103
5.14.8 set h323 display_name...............................104
5.14.9 set h323 dns_ip...........................................104
5.14.10 set h323 dtmf_duration.............................105
5.14.11 set h323 endpoint_prefix ..........................105
5.14.12 set h323 endpoint_reg_type.....................105
5.14.13 set h323 g723_frame_rate .......................106
5.14.14 set h323 gk_addr ......................................106
5.14.15 set h323 gk_id...........................................106
5.14.16 set h323 gk_max_tries..............................107
5.14.17 set h323 gk_mode ....................................107
5.14.18 set h323 h245_term_type.........................107
5.14.19 set h323 h245_timeout.............................108
5.14.20 set h323 h245_tunneling ..........................108
5.14.21 set h323 in_fast_start................................108
5.14.22 set h323 master_delay .............................109
5.14.23 set h323 nat_call.......................................109
5.14.24 set h323 out_fast_start .............................110
5.14.25 set h323 rtp_port_base.............................110
5.14.26 set h323 term_id .......................................110
5.14.27 set h323 time_to_live................................111
5.15 Configuration Management Command................111
5.15.1 config ...........................................................112
5.16 The Show Command............................................112
5.16.1 show call_record .........................................112
5.16.2 show coding ................................................113
5.16.3 show cp_tone_det.......................................113
5.16.4 show cp_tone_det_cfg................................114
5.16.5 show h323...................................................114
5.16.6 show port.....................................................115
9
Solwise Elite VoIP Gateway User’s Guide
5.16.7 show rxtxstat ...............................................115
5.16.8 show tlevels.................................................116
5.16.9 show tone....................................................116
5.16.10 show tstat ..................................................117
5.16.11 show version .............................................117
5.16.12 show vpstat ...............................................118
5.17 Dial Plan Management Commands .....................118
5.17.1 Database Update Control
Commands .............................................................118
5.17.2 Destination Table Management
Commands .............................................................121
5.17.3 Hunt Group Table Management
Commands .............................................................122
5.17.4 Address Table Management
Commands .............................................................124
5.17.5 Dialing Control Commands ........................126
5.18 The Trace Utility ....................................................127
5.18.1 spy [ key ] [level]..........................................128
5.18.2 spy dump.....................................................129
5.18.3 spy flush ......................................................129
5.19 Software Upgrade Utility Commands...................129
5.19.1 help..............................................................129
5.19.2 ping..............................................................129
5.19.3 quit...............................................................130
5.19.4 set gateway .................................................130
5.19.5 set ip ............................................................130
5.19.6 set mask ......................................................131
5.19.7 show ............................................................131
5.19.8 start..............................................................131
10
Solwise Elite VoIP Gateway User’s Guide
1 Extra set-up notes for the Elite series VoIP
gateways
1.1 Using a ‘Wildcard’ phone number
In order to accept incoming calls on your Elite gateway you must first of all create a dial plan which has entries for each number that your callers will use to contact you.
e.g. Consider a simple set-up consisting of two FXS gateways.
FXS1 end FXS2 end
Local Dial Plan Set-up
Phone Number 501 401
Hunt group 5 5
Destination ID 5 5
Local Destination Channel 0 0
Remote Dial Plan Set-up
Phone Number 401 501
Hunt Group 6 6
Destination ID 6 6
Remote Destination IP IP address of FXS2 gateway IP address of FXS1 gateway
Now in order for FXS gateway 1 to call FXS gateway 2 then it uses the dial plan tel. Number 401. But this means that BOTH gateways must have a defined dial plan entry for 401 (i.e. on for FXS1 which tells it how to connect to FXS2 but also one for FXS2 to accept the call to 401). This is fine if the calling party know that they have to dial 401 to connect the FXS2 but what if you want to accept calls from callers who don’t know that they have to use 401? The way round this is to create a dial plan entry which uses “.” (i.e. ‘dot’) i.e.
FXS2 end
Local Dial Plan Set-up
Phone Number .
Hunt group 5
Destination ID 5
Local Destination Channel 0
Then FXS gateway 2 will accept ANY calls.
11
Solwise Elite VoIP Gateway User’s Guide
1.2 Clearing to defaults
In the GW's memory, there are 3 portions to record the different setting values: network setting, atpm setting and configuration (port,coding,h323 etc.).
You need to reset (erase) each section separately. After you’ve erased it all you then re-boot the system and the defaults are loaded.
Following are the commands:
for dialplan: 'atpm req', 'atpm erase'
for configuration: 'config erase' 'y'
for network: 'net set fac_default' 'y'
re-boot system
1.3 How can I set-up a ‘hotline’?
1.3.1 Lets give an example:
A hotline means that when an FXS or FXO port is picked up (i.e. a handset connected to an FXS port is picked up or a PSTN call is made to an FXO port) then the gateway will autodial to another VoIP device.
To set this feature up you need to use the CLI command
set port <port> dial_in plar [plar number]
where [plar number] is a predefined dial plan phone number.
You have one site with an FXO device connected to four phone lines.
At the other site you have a four port FXS device with handsets plugged into each port.
So first of all, at each end, you need to create two dial plans: One is a dial plan entry which pertains to the local port on the gateway. The second dial plan entry is to connect to the gateway at the other end (so, this remote destination is to connect to the local destination of the other gateway).
12
e.g. (remember this is just an example, the actual numbers will differ in your set-up)
Solwise Elite VoIP Gateway User’s Guide
FXO end FXS end
Local Dial Plan Set-up
Phone Number 501 401
Hunt group 5 5
Destination ID 5 5
Local Destination Channel 0 0
Remote Dial Plan Set-up
Phone Number 401 501
Hunt Group 6 6
Destination ID 6 6
Remote Destination IP IP address of FXS gateway IP address of FXO gateway
To test the dial plan pick up the handset on FXS port 1 and dial 501; the call should connect to the first port of the FXO (so you should hear the dial tone from the PSTN line connected to the first port of the FXO). To test a call the other way make a call to the PSTN line on the first port of the FXO gateway. When the call comes in the FXO gateway will pickup the call and present a second dial tone. You should then dial 401. This should make the call forward to the phone on the first FXS port.
Now to make it do this automatically you need to use the CLI command (connect via the serial port using a terminal application)
set port <port> dial_in plar [plar number]
So… at the CLI prompt for the FXO gateway you need to enter the command
set port 0 dial_in plar 401
Then do
config activate
config store
to activate and store the settings.
Then, at the CLI prompt for the FXS gateway you need to enter the command
13
Solwise Elite VoIP Gateway User’s Guide
set port 0 dial_in plar 501
Then do
config activate
config store
to activate and store the settings.
Now do the tests again but this time you shouldn’t have to do the dialling; the gateways should auto-dial as expected.
1.4 How can I stop the gateways ‘playing’ the DTMF tones when a call is received?
For example, when you make a call to an FXS device on let’s say local telephone number 203 then, after you pick the ringing handset up at the FXS end you hear the phone number ‘203’ DTMF tones played. If you don’t want to hear these tones (they are sent because some caller ID devices use the DTMF tones) then you need to instruct the dialling end device to strip the sent numbers (in this case it would be the first 3 digits). To do this go to the Telephone number set-up at the dialling gateway and , on the screen you use to configure the Telephone number enter 3 (in this example) in the field called ‘Strip Length’.
1.5 How can I configure the gateway to handle the clear forward signal (caller disconnect)
1.5.1 So what does this mean?
When you make a PSTN call from one site to another then, when one party hangs up a signal sent to the other parties end to indicate to the other party that the phone call is finished. This signal is called the ‘clear forward signal’ or sometimes the ‘call disconnect signal’. It’s used so that devices can tell when the call is finished e.g. answering machines. In the UK the standard signal (as used by BT) is to reverse the polarity of the phone lines. This is different from other countries e.g. if you are in the States and the other party hangs up then you get sent a tone. However, in the UK being different we use a polarity reversal / Private telephone systems as used by UK buisnesses may use polarity reversal or the tone method. The particular method used will depend upon PBX system used. To test which method your PBX uses make a call from one extension to the other and then get the calling party to hangup. Then listen to what you hear. Do you hear a tone?
14
Solwise Elite VoIP Gateway User’s Guide
1.5.2 So what’s this got to do with VoIP gateways?
Imagine you have a site-to-site set-up of an FXO gateway talking to an FXS gateway. So there is a call in progress from a PSTN phone line which is connected to the first port of the FXO gateway and then across to the FXS gateway to a phone on the first FXS port. Now, if the call to the FXO port hangs up then the FXO gateway needs to know this. If it doesn’t know that the PSTN call is ended then it keeps the VoIP call to the FXS gateway open! On the other hand. If the call to the FXS port (lets say from a remote FXO or FXS gateway) is ended the FXS gateway needs to send a ‘clear forward’ signal to the device on the FXS port to indicate the call is ended e.g. this might me an answering machine. So, an FXO port needs to be able to detect a correct clear forward’ from the PSTN line and an FXS device needs to make the correct ‘clear forward’ signal for the handset device (e.g. this might be an answering machine). This could be either polarity reversal or disconnect tone.
1.5.3 So how do you configure the gateway to handle the polarity reversal then?
So, let’s assume that you need to configure the gateways to handle the UK standard polarity reversal signal.
You need to use CLI commands to configure the ports.
For an FXS gateway key-in the command…
set port <port> fxs ff_batt_rev on
where <port> is port no (0-7) and the setting should be on.
For an FXO port device the commands are
set port <port> fxo cpc_detect <value in msec>
where <port> is port no (0-7) and <value in msec> is the time taken for the polarity reversal. A typical value would be 30 i.e. it takes 30mS for the polarity reversal event.
You also need to key-in…
set port <port> fxo batt_rev_times <number of times>
this command is to define how many line reversals the FXO port needs to receive before accepting the ‘clear forward’: In the UK this value should be ‘2’.
Also,
set port <port> fxo loop_det_db <value in msec>
15
Solwise Elite VoIP Gateway User’s Guide
This is a value to ensure that false polarity reversals are not detected. A good value is 20 (10 less then the cpc_detect value).
After entering the commands you need to do
config activate
config store
to activate and store the settings.
1.5.4 So how do you configure the gateway to a disconnect tone correctly then?
So, let’s assume that you need to configure the FXO gateways to handle the US style tone disconnect signal.
By default your gateway automatically detects the disconnect tone however it may need to be ‘tuned’ to correctly detect the specific tone your system produces. I.e. the cadence (the tone might go ‘beep-pause-beep-pause’ so you need to tell the gateway the duration of the ‘beep’ and the duration of the ‘pause’) and power level (how loud it is).
The first stage is to tell your FXO gateway to analyse the disconnect tone it receives on it’s FXO port.
The basic method it to set the gateway into debug mode (to display the tone analysis) then make a call to the FXO gateway and then, after the gateway has answered make a call from the gateway to another port on the same gateway. After the forwarded call is connected then you hang up. The gateway will then print out the tones it detects. You then take these figures and enter them into the gateway configuration.
1.5.4.1 Entering debug mode on the gateway
In console mode enter the following commands:
16
Solwise Elite VoIP Gateway User’s Guide
1.5.4.2 Wiring Up to do the test with an FXO/FXS gateway
In the example above the test procedure is going to be make a call from phone 1234, through the PBX to the FXO port (number 1233). If you are connecting the FXO port directly to a phone line then just dial the phone line that the FXO port is connected to. Then, after the FXO port has answered the call, dial number 101 which is the phone connected to the FXS port. Thus you have a call from 1234 to 1233 and then to 101. Then, after the call is routed hang up
1234. You should then see tone detection results appear on the PC terminal.
i.e.
17
Solwise Elite VoIP Gateway User’s Guide
18
Solwise Elite VoIP Gateway User’s Guide
1.5.4.3 Wiring Up to do the test with an FXO only gateway
In the example above the test procedure is going to be make a call from phone 1234, through the PBX to the FXO port (number 1233). If you are connecting the FXO port directly to a phone line then just dial the phone line that the FXO port is connected to. Then, after the FXO 102 port has answered the call, dial number 101 which is a second FXO port. You should then here the dial tone from the PBX on line 1236. (Yet again if you are connecting the FXO ports directly to phone lines you should here the phone line dial tone from the second line.) Now make a third call to phone 1235. Thus you now have a call from 1234 to 1233, then to 101 and then to 1236 and finally to 1235! Then, after the call is routed hang up 1234. You should then see tone detection results appear on the PC terminal.
i.e.
19
Solwise Elite VoIP Gateway User’s Guide
1.5.4.4 Tone detection
When the call is disconnected you should see messages similar to the following on the console screen:
20
Solwise Elite VoIP Gateway User’s Guide
1.5.4.5 Entering the detected Tone cadence values
So, once your gateway has displayed the detected tone values for the disconnected call you can now enter these into the gateway configuration.
At the console prompt use the command show_cp_tone_det to display the current settings:
21
Solwise Elite VoIP Gateway User’s Guide
Now use the command cp_tone_det disconnect to enter the new, detected tone values.
22
Solwise Elite VoIP Gateway User’s Guide
Done!
23
Solwise Elite VoIP Gateway User’s Guide
2 Integration Examples for 2 & 4 Port Desktop
Version
This section discusses the various environments and situations where you can use the Elite Gateway* Desktop Version
2.1 Application A: FXS
Application A has two possible connections. The A-1 shows the connection between the gateway and telephone set (POTS) or FAX machine. The FXS module is used in the A-1 connection. The A-2 connection is used to connect the gateway and PBX that has the CO trunk interface. FXS is also used in this connection. The telephone sets connected to PBX can be either POTS or digital telephone depending upon the PBX capability.
2.2 Application B: FXS / FXO combination
Application B has three possible connections. The B-1 connection is a normal trunk connection between the CO switch and PBX. The B­2 connection is identical to the A-1 connection mentioned in Application A. The B-3 connection is used to connect the PBX and gateway through the internal analog lines provided by the PBX. In this case, the FXO module has to be used, and the FXO ports will serve the same roles as the analog telephone sets.
Note: If the PBX used in the B-3 connection is a digital type, an analog terminal adapter is needed to provide an analog interface to the FXO module.
In this application, the caller on the B-2 connection can use the Gateway through its FXS module to communicate with the party on the other end in the B-3 connection. The phone call is forwarded through the FXS module in the B-2 Gateway and is received by the FXO module in the B-3 gateway, which is connected to the PBX, which will then switch to the dedicated terminal.
The same caller can also use the feature that the Gateway provides to redial the local number through the PBX, to the public switch, in order to reach the person inside the region that the public switch serves.
24
Solwise Elite VoIP Gateway User’s Guide
25
Solwise Elite VoIP Gateway User’s Guide
3 Integration Examples for 4 & 8 Port Rack Mount
Version
There are three basic environments that the Elite Gateway* can be applied to. They are described in the following sections.
3.1 Application A: FXS
Application A has two possible connections. The A-1 connection shows the connection between the gateway and telephone set (POTS) or FAX machine. The FXS module is used in the A-1 connection. The A-2 connection on the right hand side is used to connect the gateway and PBX that has the Central Office (CO) trunk interface. FXS is also used in this connection. The telephone sets connected to the PBX can be either POTS or digital telephone depending upon the PBX capability.
3.2 Application B: FXS/FXO Combination
Application B has three possible connections. The B-1 connection is a normal trunk connection between the CO switch and a PBX. The B-2 connection is identical to the A-1 connection mentioned in Application A. The B-3 connection is used to connect the PBX and gateway through the internal analog lines provided by the PBX. In this case, the FXO module has to be used and the FXO ports will serve the same roles as the analog telephone sets.
Note: If the PBX used in the B-3 connection is a digital type an analog terminal adapter is needed to provide an analog interface to the FXO module.
In this application the caller in the B-2 connection can use the gateway through its FXS module to communicate with the party on the other end of the B-3 connection. The phone call is forwarded through the FXS module in the B-2 Gateway and is received by the FXO module in the B-3 gateway, which is connected to the PBX, which will then switch to the dedicated terminal.
The same caller can also use the feature that the Gateway provides to redial the local number through the PBX to the public switch in
26
Solwise Elite VoIP Gateway User’s Guide
order to reach the person inside the region that the public switch serves.
3.3 Application C: FXS/FXO Extended Combination
Application C has four possible connections. The C-1 connection is a normal trunk connection between the CO switch and PBX (identical to connection B-1 in the previous application) The C-2 connection is identical to the A-1 connection mentioned in Application A. The C-3 connection connects the PBX and gateway through the internal analog line provided by the PBX (identical to the B-3 connection). The C-4 connection connects the CO switch to the gateway using the FXO module (similar to the C-3 connection).
The C-2 connection can be replaced by the C-3 connection, but it must then use an FXO module instead of an FXS module. In this application, the user can benefit from the VoIP application even when not in the office. With a properly configured dial plan, the user can make a phone call through a public switch back to the office, and the PBX will relay the phone call to the other end which may be located in another city, state, or even country.
27
Solwise Elite VoIP Gateway User’s Guide
3.4 Configuration Examples
3.4.1 Scenario 1
3 sets of Elite Gateways are connected to Internet. One of Elite Gateways has an FXO module and the other two are equipped with an FXS module.
Telephone address description
Elite Gateway A: 408 and 415 are address specific PSTN connections on PBX CO trunk, and 90 are address specific connections on PBX internal lines on Elite Gateway A FXO ports
Elite Gateway B: 0900, 0901, 0902, 0903 are specific telephone address on Elite Gateway B FXS ports
Elite Gateway C: 0800, 0801, 0802, 0803 are specific telephone address on Elite Gateway C FXS ports
Elite Gateway A address translation table
Address Entry Hunt Grp_Id Min. Digits Max. Digits Prefix strip Prefix Address
90 1 0 6 2 None
408 1 0 10 3 "0"
28
Solwise Elite VoIP Gateway User’s Guide
415 1 0 10 0 "0"
09 11 4 4 0 None
08 12 4 4 0 None
Elite Gateway A hunt group table
Group id Type #Members
Member ids
1 2 4 1 2 3 4
11 2 1 11
12 2 1 12
Elite Gateway A destination table
Dest id Mode Destination
1 Local PORT = 0
2 Local PORT = 1
3 Local PORT = 2
4 Local PORT = 3
11 H.323 Dest = 210.243.230.20/1720 TCP
12 H.323 Dest = 210.243.230.30/1720 TCP
Elite Gateway B address translation table
Address Entry Hunt Grp_Id Min. Digits Max. Digits Prefix strip Prefix Address
0900 1 4 4 0 None
0901 2 4 4 0 None
0902 3 4 4 0 None
90 11 0 6 0 None
29
Solwise Elite VoIP Gateway User’s Guide
90 11 0 6 0 None
408 11 0 10 0 None
415 11 0 10 0 None
08 12 4 4 0 None
Elite Gateway B hunt group table
Group id Type #Members
Member ids
1 2 1 1
2 2 1 2
3 2 1 3
4 2 1 4
11 2 1 11
12 2 1 12
Elite Gateway B destination table
Dest id Mode Destination
1 Local PORT = 0
2 Local PORT = 1
3 Local PORT = 2
4 Local PORT = 3
11 H.323 Dest = 210.243.230.10/1720 TCP
12 H.323 Dest = 210.243.230.30/1720 TCP
Elite Gateway C address translation table
30
Solwise Elite VoIP Gateway User’s Guide
Address Entry Hunt Grp_Id Min. Digits Max. Digits Prefix strip
Prefix Address
0800 1 4 4 0 None
0801 2 4 4 0 None
0802 3 4 4 0 None
0803 4 4 4 0 None
90 11 0 6 0 None
408 11 0 10 0 None
415 11 0 10 0 None
09 12 4 4 0 None
Elite Gateway C hunt group table
Group id Type #Members
Member ids
1 2 1 1
2 2 1 2
3 2 1 3
4 2 1 4
11 2 1 11
12 2 1 12
Elite Gateway C destination table
Dest id Mode Destination
1 Local PORT = 0
2 Local PORT = 1
31
Solwise Elite VoIP Gateway User’s Guide
3 Local PORT = 2
4 Local PORT = 3
11 H.323 Dest = 210.243.230.10/1720 TCP
12 H.323 Dest = 210.243.230.20/1720 TCP
Note: An FXO module was added to both Elite Gateway B and Elite Gateway C.
3.4.2 Scenario 2
3 sets of Elite Gateways were connected to Internet and all of Elite Gateways are built-in FXO and FXS modules.
Telephone address description:
Elite Gateway A: 408 and 415 are address specific PSTN connections on PBX CO trunk, and 90 are address specific connections on PBX internal lines on Elite Gateway A FXO ports
Elite Gateway B: 0900, 0901, 0902, 0903 are address specific telephone on Elite Gateway B FXS ports and 932 and 934 are address specific PSTN connections on Elite Gateway B FXO ports
Elite Gateway C: 0800, 0801, 0802, 0803 are address specific telephone on Elite Gateway C FXS ports and 712 are address specific PSTN connections on Elite Gateway C FXO ports
32
Elite Gateway A address translation table
Solwise Elite VoIP Gateway User’s Guide
Address Entry Hunt Grp_Id Min. Digits Max. Digits Prefix strip Prefix Address
90 1 0 6 2 None
408 1 0 10 3 "0"
415 1 0 10 0 "0"
09 11 4 4 0 None
08 12 4 4 0 None
932 11 10 10 0 None
934 11 10 10 0 None
712 12 10 10 0 None
Elite Gateway A hunt group table
Group id Type #Members
Member ids
1 2 4 1 2 3 4
11 2 1 11
12 2 1 12
Elite Gateway A destination table
Dest id Mode Destination
1 Local PORT = 0
2 Local PORT = 1
3 Local PORT = 2
4 Local PORT = 3
11 H.323 Dest = 210.243.230.20/1720 TCP
33
Solwise Elite VoIP Gateway User’s Guide
12 H.323 Dest = 210.243.230.30/1720 TCP
Elite Gateway B address translation table
Address Entry Hunt Grp_Id Min. Digits Max. Digits Prefix strip Prefix Address
0900 1 4 4 0 None
0901 2 4 4 0 None
0902 3 4 4 0 None
0903 4 4 4 0 None
90 11 0 6 0 None
408 11 0 10 0 None
415 11 0 10 0 None
08 12 4 4 0 None
932 5 10 10 3 None
934 5 10 10 0 None
712 12 10 10 0 None
Elite Gateway B hunt group table
Group id Type #Members Member ids
1 2 1 1
2 2 1 2
3 2 1 3
4 2 1 4
5 2 4 5 6 7 8
11 2 1 11
34
Solwise Elite VoIP Gateway User’s Guide
11 2 1 11
12 2 1 12
Elite Gateway B destination table
Dest id Mode Destination
1 Local PORT = 0
2 Local PORT = 1
3 Local PORT = 2
4 Local PORT = 3
5 Local PORT = 4
6 Local PORT = 5
7 Local PORT = 6
8 Local PORT = 7
11 H.323 Dest = 210.243.230.10/1720 TCP
12 H.323 Dest = 210.243.230.30/1720 TCP
Elite Gateway C address translation table
Address Entry Hunt Grp_Id Min. Digits Max. Digits Prefix strip Prefix Address
0800 1 4 4 0 None
0801 2 4 4 0 None
0802 3 4 4 0 None
0803 4 4 4 0 None
90 11 0 6 0 None
408 11 0 10 0 None
35
Solwise Elite VoIP Gateway User’s Guide
408 11 0 10 0 None
415 11 0 10 0 None
09 12 4 4 0 None
712 5 10 10 3 None
932 12 10 10 0 None
934 12 10 10 0 None
Elite Gateway C hunt group table
Group id Type #Members
Member ids
1 2 1 1
2 2 1 2
3 2 1 3
4 2 1 4
5 2 4 5 6 7 8
11 2 1 11
12 2 1 12
Elite Gateway C destination table
Dest id Mode Destination
1 Local PORT = 0
2 Local PORT = 1
3 Local PORT = 2
4 Local PORT = 3
5 Local PORT = 4
36
Solwise Elite VoIP Gateway User’s Guide
5 Local PORT = 4
6 Local PORT = 5
7 Local PORT = 6
8 Local PORT = 7
11 H.323 Dest = 210.243.230.10/1720 TCP
12 H.323 Dest = 210.243.230.20/1720 TCP
37
Solwise Elite VoIP Gateway User’s Guide
4 Upgrading Software
This section explains how to upgrade your Elite Gateway* when new software revisions become available. Upgrades may improve system functionality or add new features to your Elite Gateway.
The Elite Gateway offers two operation modes. Under normal conditions, the Elite Gateway operates in regular operational mode. When a software upgrade is required, the Elite Gateway is operated in download mode. In download mode, the CLI will support limited commands allowing users to load new software from a remote TFTP server and write it to the built-in flash non-volatile storage.
Entering Download Mode To switch from normal operation mode to download mode, use the download CLI command.
Console> download <Enter>
Note: To be able to switch to download mode from Telnet session, the TFTP loader on the Elite Gateway must be version 3.00 or higher.
The Elite Gateway will terminate all on-going calls, shut itself down, reset and enter download mode. If you enter download mode from Telnet session, the Telnet session will be terminated. You need to reconnect to the Elite Gateway from Telnet client again to be able to access the CLI commands.
Upon entering the download mode, the CLI will show the following prompt.
EITGLoader>
CLI Commands in Download Mode The CLI in download mode differs from normal in the console prompt in that only specific software update commands are supported. In download mode, the CLI supports the following commands:
Command Description
help Display help screen.
quit Terminate download mode, switch to normal operation mode.
set Change IP parameter.
start Start downloading code from TFTP server.
The following section describes each of the commands:
help
The help command lists the top-level commands.
38
Solwise Elite VoIP Gateway User’s Guide
Syntax Description This command has no arguments or keywords.
quit
The quit command is used to terminate the download mode and return to normal operation mode.
Syntax Description This command has no arguments or keywords.
Note: Switching modes from a Telnet session will terminate the current active session. You'll need to connect to the Elite Gateway again to be able to access the CLI.
set ip ip_addr
Use the set ip command to assign a static IP address to the Elite Gateway.
Syntax description
ip_addr The IP address of the Elite Gateway.
Note: The new IP address will not take effect until the Elite Gateway is reset.
set mask ip_mask
start
Use the set mask command to set the IP subnet mask for the Elite Gateway.
Syntax description
ip_mask The subnet mask of your network.
Note: The new setting will not take effect until the Elite Gateway is reset.
Use the start command to start downloading code from TFTP server. The Elite Gateway will prompt you for the IP address of the TFTP server and the file name to download.
Syntax description This command has no arguments or keywords.
39
Solwise Elite VoIP Gateway User’s Guide
5 CLI Documentation
5.1 Using The Command Line Interface (CLI)
The Elite Gateway* has a built-in command line interpreter and provides users with a Command Line Interface (CLI). The Elite Gateway can be configured by entering commands from the CLI.
The CLI can be accessed from a VT-100 terminal or terminal emulator connected to the RS-232 port on the front panel or through a Telnet session.
Connection through Serial Port
The serial port of the Elite Gateway is fixed at the following settings:
Baud rate 19,200
Number of data bit 8
Parity check None
Number of stop bit 1
Flow control None
To access the Elite Gateway through the RS-232 serial port, follow these steps:
1. Insert one end of the serial cable that came with the Elite Gateway into the 9-pin RS-232 port (labeled User Console) on the front panel.
2. Insert the other end of the cable into your terminal's serial port.
3. Configure the terminal so that settings for baud rate, number of data bit, parity check, number of stop bit and flow control capability exactly match Elite Gateway's serial interface. (Refer to your terminal documentation for more information about setting up these features).
4. Press <Return> from the terminal.
5. The Elite Gateway displays the following prompts on the terminal and you are ready to access the CLI.
Console>
Connection through Telnet
To use Telnet, the IP address must have been previously set using the
net set ip command for the Elite Gateway. Up to two sessions
through Telnet are possible.
40
To access the Elite Gateway from a remote host with Telnet, perform the following tasks:
Solwise Elite VoIP Gateway User’s Guide
Task Prompt Type
From the remote host, enter the telnet command followed by the IP address of the Elite Gateway you want to access.
None
telnet
ip_addr
When the Elite Gateway prompts "Login:", enter the user name "adm" Login: Adm
When the Elite Gateway prompts "Password:", enter the password. The default password is "123" unless a password was previously established using the net set user_pw command (Refer to the section describing net set
user_pw command later in this section for details about the setting
Password: 123
password).
After successfully entering the password, the Elite Gateway displays a greeting message along with the following prompts. The CLI commands are then ready to be accessed.
Console>
Command Help
Help for commands is provided by the CLI. Type help to see a listing of the top-level commands. In most cases, if a command is entered using the wrong number of arguments or inappropriate arguments, the CLI will give further usage.
Designating IP Address
Some commands require an IP address, which must be designated in a standard format. The IP address format is 32 bits, written as four octets separated by periods (dotted decimal format) that are made up of a network section, an optional subnet section, and a host section, as shown in the following example:
192.168.0.1
Designating Port Number
Some commands require a telephony port number. The Elite Gateway designates the first port on telephone interface module (TIM) slot A as port number 0, the 2nd port as port number 1 and so on. When a TIM is installed in slot B, the first port is designated as port number 4, the 2nd one is designated as port number 5 and so on.
Note: If you have only a single TIM, be certain to install it in slot A, otherwise, the Elite Gateway won't function.
CLI Commands
The ITG offers two operation modes. Under normal conditions, the ITG operates in Gateway Mode. When software upgrade is required, the ITG may be operated in Software Upgrade Mode. Under Software Upgrade Mode, the CLI supports limited commands allowing users to read new revision codes from a remote TFTP server and write it to the built-in flash non-volatile storage.
41
Solwise Elite VoIP Gateway User’s Guide
This section provides two tables (Table 1 and Table 2) that list all CLI commands supported by the ITG in alphabetical order, and provides for each command a one-line description, and the page number where you can find detailed information. Table 1 lists CLI commands supported under Gateway Mode. Table 2 lists CLI commands supported under Software Upgrade Mode. The port in the set port command and profile_id in the set coding command in table below stands for port ID and coding profile ID respectively.
Gateway Mode Commands
Command Description
arp Manages ARP table
clrscr Clears the screen
config Manages configuration parameters
download Enters software upgrade mode
help Displays top level commands
net
reset Resets the ITG
set gateway Sets default gateway’ address
set http Enables/Disables HTTP server
set ip Sets IP address
set ip_preced Sets IP Service Type
set mask Sets subnet mask
set speed Sets link speed for Ethernet interface
set telnet Enables/Disables Telnet server
set http Enables/Disables HTTP server
set user_pw Sets password for Telnet and HTTP server
show Displays network parameters
show hwstat Displays hardware configuration
ping Pings a remote IP host
set coding profile_id Configures coding profile
adaptive_playout Enables/Disables adaptive voice playback
coding_type Sets coder type
copyof Copies parameters for a coding profile to
cp_tone_detect Enables/Disables CP tone detection for a
dtmf_relay Enables/Disables DTMF relay
fax_hs_pkt_rate Sets the rate at which high-speed data will be
Configure IP LAN settings
login
another
coding profile
sent for a fax coding profile
42
Solwise Elite VoIP Gateway User’s Guide
fax_hs_redundancy Specifies the packet-level redundancy for
high-speed data transmissions for a fax coding profile
fax_ls_redundancy Specifies the packet-level redundancy for low-
speed data transmissions for a fax coding profile.
fax_relay_features Enables/Disables specific fax processing
capabilities for a fax coder
fax_t30_features Enables/Disables the use of specific fax
capabilities.
fax_tcf_method Sets the T.38 TCF method
fax_tone_detect Enables/Disables V.21 fax tone detection
fax_tx_net_timeout Sets the timeout period for declaring fax
cleardown
max_delay Sets the size of jitter buffer for a voice coding
profile
min_delay Sets the minimum time each voice packet
stays in jitter buffer
nom_delay Sets the average delay each voice packet stays
in jitter buffer
usage Sets allowed usage for a coding profile
vad Enables/Disables voice activity detection
vad_thresh Sets the threshold level for voice activity
detection
vif Set the size of the voice packet
set cp_tone_det Enables/Disables CP tone detection
set cp_tone_det_cfg Configures the CP tone detection filter
set h323 Configures H.323 parameters
alias Adds/Deletes H.323 alias
allow_calls_wo_gk Enables/Disables call establishment if ITG
failed registering to a H.323 gatekeeper
alt_dtmf Maintains the list of remote gateways to
which the ITG conveys the DTMF tones using the alternate DTMF relay technique.
auto_answer Enables/Disables H.323 auto answer mode.
call_name Specifies the string ITG encapsulates in the
H.323 Setup message it sends to a remote gateway when initiating a call.
cisco_t38 Enables/Disables interoperability with Cisco
T.38 fax
default_dtmf Selects the default DTMF relay technique
display_name Sets the display name information that is
carried in the H.323 Setup messages
dns_ip Specifies the DNS server and default domain
name
43
Solwise Elite VoIP Gateway User’s Guide
dtmf_duration Specifies the duration the gateway plays out a
DTMF tone
endpoint_prefix Specifies the H.323 prefix that the ITG uses
when registering to an H.323 gatekeeper.
endpoint_reg_type Sets the H.323 registration type
g723_frame_rate
gk_addr Specifies the gatekeeper
gk_id
gk_max_tries Sets the number of times ITG attempts to
register to gatekeeper
gk_mode Specifies the H.323 gatekeeper mode
h245_term_type Specifies the H.323 terminal type.
h245_timeout Sets the H.245 timeout value
h245_tunneling Enables/Disables H.245 tunneling
in_fast_start Enables/Disables accepting incoming H.323
fast start calls
master_delay Specifies if the ITG should delay sending the
H.323 open logical channel message to remote gateway after completing master/slave determination
nat_call Enables/Disables the ITG to connect to remote
gateways connecting to WAN via NAT capable router
out_fast_start Select the H.323 Faststart mode for outgoing
calls.
rtp_port_base Selects the starting port number for
assignment of RTP ports
term_id
time_to_live
set port port Configures a telephony interface port
ans_wait Sets a wait-for-answer time limit
call_limit Sets a call length limit for calls
cid name Sets the Caller ID Name
cid number Sets the Caller ID Number
copyof Copy the configuration parameters for a port
to another port
cp_tone_det_cfg Selects the call progress tone detection
configuration
cp_tone_det_ctrl Controls the detection of call progress tone
dial_in_plar Configures the number to be dialed in
automatically when a telephony port goes off­hook
em clear_conf_detect Sets the minimum duration of on-hook
response on the M-lead that is required for clear confirm to be detected
44
Solwise Elite VoIP Gateway User’s Guide
g
em clear_conf_wait_max Sets the maximum duration to wait for an on-
hook response on the M-lead after going on­hook on the E-lead
em clear_detect Specifies the period of time M-lead needs to
be on-hook before call clearing is declared
em connected_min Specifies the minimum period of time that a
connection will be maintained
em dial_tone Specifies if dial tone should be generated on
incoming calls
em disable_hangup Specifies the time period a port will wait after
hanging up a call before signaling that it is in a disabled state
em guard_all Sets the period after an aborted call when no
incoming/outgoing calls will be accepted/initiated
em guard_out Sets an additional period of time after
guard_all when incoming calls will be accepted.
em offhook_db Sets the off-hook debounce interval
em onhook_db Sets the on-hook debounce interval
em size_detect Specifies the period of time the M-lead needs
to be off-hook before an incoming call is declared
emd in_delay_max Sets the maximum duration of the delay signal
response to the Seize Detect on the M-lead
emd in_delay_min Sets the minimum duration of the delay signal
response to the seize detect on the M-lead
emd in_digit_ign Sets the period of time, after completing the
delay signal, before the digits will be accepted on incoming calls
emd out_delay_check Sets the period of time after going off-hook on
the E-lead before checking the M-lead for the delay signal response
emd out_delay_dur_max Set the maximum duration of the delay signal
response on the M-lead for it to be detected on outgoing calls
emd out_delay_dur_min Sets the minimum duration of the delay signal
response on the M-lead for it to be detected on outgoing calls
emd out_intg_check Sets the Integrity Check mode.
emi glare_report Sets a time period during which, if glare is
detected, the interface will stay off-hook and generate congestion tone
emi wait_dsp_ready Sets a time period to wait for the DSP
software to be ready before digit collection can be enabled
emw in_wink_digit_ignore Specifies the period of time that will be
i
nored after completing the wink and before
45
Solwise Elite VoIP Gateway User’s Guide
digits will be accepted for incoming calls
emw in_wink_dur Specifies the duration of the wink signal on
the E-lead for incoming calls
emw in_wink_wait_max Sets the maximum delay before beginning the
wink on the E-lead after detecting a line seizure on the M-lead for an incoming call
emw in_wink_wait_min Sets the minimum delay before beginning the
wink on the E-lead after detecting a line seizure on the M-lead for an incoming call
emw out_wink_dur_max Sets the maximum duration of the wink
response on the M-lead for it to be detected
emw out_wink_dur_min Sets the minimum duration of the wink
response on the M-lead for it to be detected
emw out_wink_wait_max Specifies the maximum time to wait for a
wink response on the M-lead after going offhook on the E-lead
enable_user_cid Selects which Caller ID information the ITG
should be conveyed to the called party
fax_holdover Sets the fax holdover delay
fax_prof Selects the preferred fax coder
fax_tone_det_ctrl Specifies if V.21 fax tone should be detected
fxo answer_after Specifies the number of rings to elapse before
a FXO port answering an incoming call
fxo batt_rev_times Specifies the number of times the battery
reversal signal must be detected before shutting down a FXO port
fxo caller_id Enable/Disble Caller ID detection on a FXO
port
fxo cpc_detect Specifies the expected duration of the loss of
loop current before shutting down a FXO port
fxo guard_out Specifies the time, after completing a call over
a FXO port and before another call can be originated.
fxo loop_det_db Specifies the time for debouncing the loop
current detector
fxo ringing_db Specifies the time for debouncing the ring-on
signal
fxo ringing_inter_cycle Specifies the duration of ring-off signal
fxo ringing_inter_pulse Specifies the time between consecutive ring
pulses in the same ring-on signal
fxs answ_clear_detect Sets the minimum time to wait, when the
answering party drops the line before declaring on-hook
fxs caller_id Specifies if Caller ID will be generated on a
FXS port
fxs cpc_dur Sets the duration, of the loop current
46
Solwise Elite VoIP Gateway User’s Guide
shutdown
fxs cpc_wait Sets the time to wait, after a FXS port shutting
down loop current and before checking for on­hook
fxs offhook_db Specifies the time for debouncing the off-hook
signal
fxs offhook_detect Sets the time to wait, before an off-hook
condition is declared
fxs onhook_db Specifies the time for debouncing the on-hook
signal
fxs onhook_detect Sets the time to wait, before an on-hook
condition is declared.
fxs ring_id Selects the ringing signal
hangup_wait Sets the wait-for-hangup time limit for a
telephony port
out_type Selects tone-dial or pulse-dial
out_wait Specifies the time to delay after going off-
hook before generating outbound dial digits.
prof_bit Selects which coding profiles will be available
to a telephony port
proto Select the signaling protocol
rxgain Adjusts gain level of PCM signal received
from a telephony port
tone_out_off Sets off duration for DTMF tones
tone_out_on Sets the on duration for DTMF tones
tone_out_pwr Sets power level for DTMF tones
tone_table Select the tone table for a telephony port
txgain Adjusts gain level of signal ITG sends to a
telephony port
voice_prof Selects the preferred coding profile for voice
set tone Configures on/off cadence for a CP tone
show
call_record Displays information about the current call or
latest call
coding Displays configuration of a coding profile
cp_tone_det Displays the on/off cadence for a CP tone
cp_tone_det_cfg Displays parameters for the CP tone detection
filter
h323 Displays H.323 configuration
port Displays the configuration of a telephony port
rxtsstat Displays the statistic information about the
voice packets a telephony port has received/transmitted
tlevels Displays the power level of signals for a
telephony port
47
Solwise Elite VoIP Gateway User’s Guide
tone Displays each element of a CP tone
tstat Displays the telephony interface statistics for a
telephony port
version Displays information that identifies the
versions of various software components
vpstat Displays the statistic information about the
voice packets played out by a telephony port
spy Sets filtering level for a specific spy key
spy dump Display trace buffer
spy flush Flush trace buffer
tel erase_ivr Erases greeting message
tel set pcm_gain_level Adjust gain level of signal ITG sends to FXO
ports
tel set ring_freq Set the frequency of ringing that the ITG
generates
tel show pcm_gain_level Displays the setting of gain level for FXO
ports.
tel show port Displays status of a telephony port
tel show ring_freq Displays frequency of ringing signal that ITG
generates
Software Upgrade Mode Commands
Command Description
help Displays commands
ping Pings a remote IP host
quit Quits Software Upgrade mode
set gateway Sets default gateway’ address
set ip Sets IP address
set mask Sets subnet mask
show Displays network parameters
start Starts downloading code image from TFTP
server
5.2 Utility Commands
This section describes the general-purpose utility commands.
5.2.1 clrscr
This command clears the screen
clrscr
48
Solwise Elite VoIP Gateway User’s Guide
Syntax Description
This command has no arguments or keywords
5.2.2 download
Use the download command to enter download mode for reading code image from a TFTP server and program it to flash NVS. Refer to Software Upgrade Utility Commands on page 99 for detailed information on how to upgrade the system software.
download
Syntax Description
This command has no arguments or keywords
5.2.3 help
The help command lists the top-level commands.
help
Syntax Description
This command has no arguments or keywords
5.2.4 ping
The ping command sends ICMP echo request packets to another host on the network.
Syntax description
-s
host_ip_addr
count
timeout
ping host_ip_address ping –s host_ip_address [count/timeout]
Causes ping to send one datagram per second, printing one line of output for every response received.
The IP address or IP alias of the host.
Number of echo request packets to send. This option takes effect only if option –s is specified.
Timeout value for the ping in millisecond
5.2.5 tel erase_ivr
This command erases the greeting message that was recorded previously.
tel erase_ivr
49
Solwise Elite VoIP Gateway User’s Guide
Syntax Description
This command has no arguments or keywords
5.2.6 tel set pcm_gain_level
The gain control circuitry of the FXO interface ports my adjust the power level of the analog signal the ITG send to all FXO ports and the gain level is configurable. This command is for setting this gain level for all FXO ports.
tel set pcm_gain_level {1 | 2 | 3 | 4 | 5}
Syntax description
1
2
3
4
5
Setting gain level to
-1 dB
Setting gain level to 0 dB
Setting gain level to 1 dB
Setting gain level to 2 dB
Setting gain level to 3 dB
Default
1- -1 dB
Notes
The setting apply to all FXO ports.
Related Command
tel show pcm_gain_level
5.2.7 tel set ring_freq
The ITG rings FXS port for signaling an incoming call, and provide 4 types of ringing signal, each having a unique frequency. This command is for selecting the frequency of the ringing signal that the ITG sends to FXS ports.
tel set ring_freq {1 | 2 | 3 | 4}
Syntax description
1
50
Setting ring frequency
Solwise Elite VoIP Gateway User’s Guide
to 17 Hz
2
3
4
Default
1- 17 Hz
Related Command
tel show ring_freq
5.2.8 tel show pcm_gain_level
The command displays the gain level, which was set by command tel set pcm_gain_level.
tel show pcm_gain_level
Setting ring frequency to 20 Hz
Setting ring frequency to 25 Hz
Setting ring frequency to 50 Hz
Syntax description
This command has no arguments or keywords
Related Command
tel set pcm_gain_level
5.2.9 tel show port
This command displays the hook status of a telephony port.
tel show port [port]
Syntax description
port
5.2.10 tel show ring_freq
This command displays the ringing frequency that was configured by the tel set ring_freq command.
ID of the telephony port. If not specified, hook status for all telephony ports available will be displayed.
tel show ring_freq
51
Solwise Elite VoIP Gateway User’s Guide
Syntax description
This command has no arguments or keywords
Related Command
tel set ring_freq
5.3 3. IP Configuration Commands
This section describes the commands to configure and monitor the LAN and IP interface for the ITG.
5.3.1 arp
Use the arp -a command to display contents of the ARP cache.
arp -a arp –d ip_addr
Syntax description
-a
-d
ip_addr
5.3.2 net reset
Use the net reset command to reset the ITG. The CLI will prompt you to confirm the command before resetting the ITG.
net reset
Syntax Description
This command has no arguments or keywords
5.3.3 net set gateway
Use the net set gateway command to assign a default gateway (router) for the ITG. The default gateway routes packet data outside of the IP subnet that the ITG resides.
Display contents of ARP cache
Delete an entry from the ARP cache
IP address of the ARP entry to be deleted.
52
net set gateway ip_addr
Syntax description
Solwise Elite VoIP Gateway User’s Guide
ip_addr
Default
0.0.0.0
Note
The new setting will not take effect until the ITG is reset.
Related Commands
net set ip
net set mask
5.3.4 net set http
The ITG allows you to enable or disable its built-in HTTP server. This command is used to enable or disable the HTTP server.
net set http {on | off}
The IP address of the default gateway. IP address of 0.0.0.0 stands for no default gateway.
Syntax description
on
off
Default
on
Notes
The new setting will not take effect until the ITG is reset.
5.3.5 net set ip
This command is used to assign a static IP address to the ITG.
net set ip ip_addr
Syntax description
ip_addr
The IP address of the ITG.
Enable HTTP server. This allows users to manage the ITG from web browser.
Disable HTTP server.
53
Solwise Elite VoIP Gateway User’s Guide
Default
192.168.0.1
Notes
The new IP address will not take effect until the ITG is reset.
Related Commands
net set gateway
net set mask
5.3.6 net set ip_preced
The ITG allows you to set the 8-bit Service Type field in the IP header for all the voice packets it sends out. The Service Type field is broken down into five subfields, among which four subfileds are user configurable. This command is used to set these subfields.
net set ip_preced ip_preced [d] [t] [r]
Syntax description
ip_preced
d
t
r
The 3-bit PRECEDENCE subfiled ranging from 0 through 7.
The D bit subfield, either 0 or 1.
The T bit subfield, either 0 or 1.
The R bit subfield, either 0 or 1.
Default
ip_preced: 0 d: 0 t: 0 r: 0
Notes
The new setting will not take effect until the ITG is reset.
5.3.7 net set mask
This command is used to set the IP subnet mask for the ITG.
net set mask ip_mask
54
Solwise Elite VoIP Gateway User’s Guide
Syntax description
ip_mask
Default
255.255.255.0
Notes
The new setting will not take effect until the ITG is reset.
Related Commands
net set gateway
net set mask
5.3.8 net set speed
The ITG allows you set the link speed for its Ethernet interface. This command is used to set the Ethernet link speed.
net set mask {10 | 100 | auto}
The subnet mask of your network.
Syntax description
10
100
Auto
Default
auto
5.3.9 net set telnet
The ITG allows you enable or disable its built-in Telnet server. This command is used to enable or disable the Telnet server.
net set telnet {on | off}
Syntax description
on
Fixed the Ethernet speed at 10 Mbps
Fixed the Ethernet speed at 100 Mbps
Enable the 10/100 Mbps auto­negotiation capability.
Enable Telnet server. This allows users to
55
Solwise Elite VoIP Gateway User’s Guide
access the ITG from Telnet client.
off
Default
on
Notes
The new setting will not take effect until the ITG is reset.
5.3.10 net set http
The ITG allows you enable or disable its built-in HTTP server. This command is used to enable or disable the HTTP server.
net set http {on | off}
Syntax description
on
Disable Telnet server.
Enable HTTP server. This allows users to access the ITG from HTTP client.
off
Default
on
Notes
The new setting will not take effect until the ITG is reset.
5.3.11 net set user_pw
This command is used to change the password for Telnet client and web browser login.
net set user_pw password password
Syntax description
password
Disable HTTP server.
The new password. The password must be equal to or less than 7 alphanumeric characters. It must be identically typed twice for the ITG to be certain about the new password.
56
Solwise Elite VoIP Gateway User’s Guide
Default
123
5.3.12 net show
This command displays all the network settings.
net show
Syntax Description
This command has no arguments or keywords
Example
The following example shows how to display network settings:
Console>net show <Enter> ******************* Net Parameters ******************* Configured IP address = 172.16.3.252. Configured IP subnet mask = 255.255.0.0. Default gateway IP address = 0.0.0.0. Current active IP address = 172.16.3.252. Current active subnet mask = 255.255.0.0. IP precedence = 0 0 0 0 Ethernet MAC address = 00-50-2d-00-04-56 Ethernet speed setting = 10/100 Mbps auto-negotiation USER password = 123 HTTP server = enabled Telnet server = enabled ****************************************************** Console>
5.3.13 net show hwstat
This command displays the hardware configuration of the ITG.
net show hwstat
Syntax Description
This command has no arguments or keywords
Example
The following example shows how to display hardware configuration:
Console>net show hwstat <Enter> ****************** Hardware Configuration ****************** Flash: type-MX29L1611 64 sectors 64 KB/sector RAM: 8 MB 256K x 32 LAN: auto-netotiation on-going. Link DOWN TIM slot A: type-FXS4 DSP-C549 codec-NW1034 Diag-OK TIM slot B: type-FXO4 DSP-C549 codec-NW1034 Diag-OK *********************************************************** Console>
57
Solwise Elite VoIP Gateway User’s Guide
5.4 Telephony Interface Port Configuration Commands
This section describes commands for configuring the telephony interface ports of the ITG. All command in this section share the same syntax as follows:
set port {port | all} option [option] . . .
Syntax for the port is as follows:
port
ID of the telephony port to which the command applies.
all
The command apply to all the telephony ports
This section is organized as follows:
Common telephony port configuration commands
E&M common signaling configuration commands
E&M immediate start configuration commands
E&M delay start signaling configuration commands
E&M wink start signaling configuration commands
FXO signaling configuration commands
FXS signaling configuration commands
5.5 Common Telephony Port Configuration Commands
The following sections describe commands that apply to all types of telephony interface port.
5.5.1 set port port ans_wait
This command is used to set a wait-for-answer time limit on a telephony port. If the call destination does not answer within this period, the call is automatically terminated.
set port port ans_wait seconds
Syntax description
seconds
Default
-1
58
Value in seconds, ranging from 0 to 65534, or –1 or 65535 for forever.
Solwise Elite VoIP Gateway User’s Guide
5.5.2 set port port call_limit
This command is used to set a call length limit for calls on a telephony port. If the call length is exceeded, the call is automatically terminated.
set port port call_limit seconds
Syntax description
seconds
Default
-1
5.5.3 set port port cid name
This command is used to set the Caller ID Name for a telephony port.
set port port cid name {name | O}
Syntax description
name
O
Default
No caller ID name
Value in seconds, ranging from 0 to 65534, or –1 or 65535 for forever.
Caller ID name, 1 to 10 characters. Use ‘-‘to represent spaces in the name.
Caller ID is name is not available
Related Commands
set port port enable_user_cid
set port port fxo_caller_id
set port port fxs caller_id
5.5.4 set port port cid number
This command is used to set the Caller ID Number for a telephony port.
set port port cid number {name | O}
Syntax description
name
59
Caller ID number, 1 to 15 digits. Use ‘-‘to represent spaces in the name.
Solwise Elite VoIP Gateway User’s Guide
O
Default
No caller ID number
Related Commands
set port port enable_user_cid
set port port fxo_caller_id
set port port fxs caller_id
5.5.5 set port port copyof
This command is used to copy the settings of a telephony port to another telephony port.
set port port copyof src_port
Syntax description
src_port
Call ID is number is not available
ID of the telephony port which the settings will be copied from.
5.5.6 set port port cp_tone_det_cfg
The gateway implements two call progress tone detection configurations, default and alternate, and allows users to specify which configuration will be used for call progress tone detection. A configuration includes filter information, and a table containing cadence information of all the call progress tones that are to be detected. The default configuration allows for the detection of the following tones
busy
ringback
congestion
disconnect
disc1
disc2
disc3
disc4
disc5
The alternate configuration allows for the detection of the following tones
busy
60
ringback
Solwise Elite VoIP Gateway User’s Guide
congestion
disconnect
This commands allows the selection of which configuration for call progress tone detection.
set port port cp_tone_det_cfg {default | alternate}
Syntax description
default
alternate
Default
default
Related Commands
set cp_tone_det
set cp_tone_det_cfg
set coding profile_id cp_tone_detect
set port port cp_tone_det_ctrl
5.5.7 set port port cp_tone_det_ctrl
This command is used to control the detection of call progress tones.
set port port cp_tone_det_ctrl {0 | 1 | 2}
Select the default call progress tone detection configuration
Select the alternate call progress tone detection configuration
Syntax description
0
1
2
61
Disable call progress tone detection.
Enable call progress tone detection.
Enable/Disable call progress detection according to the cp_tone_detect parameter in the coding profile that is currently loaded. Refer to command “set coding profile_id cp_tone_detect” on page 52 for details about setting the call progress tone detection option for a coding profile.
Solwise Elite VoIP Gateway User’s Guide
Default
1
Related Commands
set cp_tone_det
set cp_tone_det_cfg
set coding profile_id cp_tone_detect
5.5.8 set port port dial_in plar
This command is used to configure the number to be dialed in automatically (automatic ring-down) when a telephony port goes off-hook. If no number is entered, operation will be as normal.
set port port dial_in plar number
Syntax description
number
Default
None
5.5.9 set port port fax_holdover
This command is used to set the fax holdover delay for a telephony port. This is the time the ITG will delay after detecting on-hook during fax mode operation before generating a call clear.
set port port fax_holdover milliseconds
Syntax description
milliseconds
Default
2000
The phone number to be dialed automatically upon detecting off-hook.
Value in milliseconds, ranging from 0 to 65535.
5.5.10 set port port fax_tone_det_ctrl
This command is used to control the detection of the V.21 fax tones.
set port port fax_tone_det_ctrl {0 | 1 | 2}
62
Solwise Elite VoIP Gateway User’s Guide
Syntax description
0
1
2
Default
1
Related Command
set coding profile_id fax_tone_detect
5.5.11 set port port fax_prof
This command is used to select the preferred fax coding profile for a telephony port.
Disable fax tone detection.
Enable fax tone detection.
Enable/Disable fax tone detection according to the fax_tone_detect parameter in the coding profile that is currently loaded. Refer to command “set coding profile_id fax_tone_detect” on page 53 for details about setting the fax tone detection option for a coding profile.
set port port fax_prof prof#
Syntax description
prof#
Default
The factory default preferred fax coding profile for all the telephony ports is coding profile number 5, which is the coder for proprietary T.38 fax relay protocol.
5.5.12 set port port hangup_wait
This command is used to set a wait-for-hangup time limit on a telephony port. If the call originator does not hang up within this time period after the destination has hung up, the call is automatically terminated.
set port port hangup_wait seconds
Syntax description
seconds
Preferred coding profile ID for fax
Value in seconds, ranging from 0 to 65534, or –1 or 65535 for forever.
63
Solwise Elite VoIP Gateway User’s Guide
Default
5
5.5.13 set port port out_type
The ITG supports tone-dial and pulse-dial. This command is used to select the dial­out characteristic of a telephony port.
set port port out_type {tone | pulse}
Syntax description
tone
pulse
Tone dial
Pulse dial
Default
tone
5.5.14 set port port out_wait
This command is used to specify the time to delay after going off-hook before generating outbound dial digits.
set port port out_wait milliseconds
Syntax description
milliseconds
Default
400
Value is milliseconds, ranging from 0 to 65535.
5.5.15 set port port prof_bit
This command is used to select which coding profiles will be available to the telephony port.
set port port prof_bit {prof_num | all} {0 | 1}
Syntax description
prof_num
all All coding profiles
0 Coding profile number prof_num is not
64
The ID of the coding profile.
available to the telephony port designated by
port
Solwise Elite VoIP Gateway User’s Guide
1 Coding profile number prof_num is available
to the telephony port designated by port
Default
By factory default, all available coding profiles are available to all telephony ports.
5.5.16 set port port proto
This command is used to select the signaling protocol for a telephony port. The ITG detects its hardware and configure the signaling protocol for all the telephony ports automatically. You may change the signaling protocol for a port using this command.
set port port proto {fxs | fxo | emi | emd | emw}
Syntax description
fxs Loop start FXS
protocol
fxo Loop start FXO
emi E&M immediate
emd E&M delay start
emw E&M wink start
Default
The ITG detects the hardware of all the telephony ports and automatically sets the signaling protocol for each port according to the type of telephony interface port as shown in the following table:
Type of Telephony Interface Port Signaling Protocol
FXS fxs
FXO fxo
E&M emi
5.5.17 set port port rxgain
protocol
start
The ITG adjust the power level of the PCM signal coming in from the telephony ports before feeding it to the voice processor for further processing. This command allows user to specify the gain level for PCM signal received from the telephony port.
set port port rxgain db
65
Solwise Elite VoIP Gateway User’s Guide
Syntax description
db
Default
0
Related Command
set port port txgain
5.5.18 set port port tone_out_off
This command is used to set the off time for DTMF dial tones from a telephony port.
set port port tone_out_off milliseconds
Syntax description
milliseconds
Gain level in dB, ranging from –14 to 14.
Value is milliseconds, ranging from 0 to 65535.
Default
200 ms
Related Commands
set port port tone_out_on
set port port tone_out_pwr
5.5.19 set port port tone_out_on
This command is used to set the on time for DTMF dial tones from a telephony port.
set port port tone_out_on milliseconds
Syntax description
milliseconds
Default
200 ms
Value is milliseconds, ranging from 0 to 65535.
66
Solwise Elite VoIP Gateway User’s Guide
Related Commands
set port port tone_out_off
set port port tone_out_pwr
5.5.20 set port port tone_out_pwr
This command is used to set the power level for DTMF dial tones generated by the ITG.
set port port tone_out_pwr power
Syntax description
power
Default
-60. The factory setting for DTMF tone power for all telephony ports is –6.0 dBm.
Related Commands
set port port tone_out_on
set port port tone_out_off
5.5.21 set port port tone_table
The ITG has two built-in tone tables. This command is used to select the tone table for a telephony port.
set port port tone_table {default | alternate}
Syntax description
default
Power level of DTMF tones in 0.1 dBm.
Select the default tone table
alternate
Select the alternate tone table
Default
default
5.5.22 set port port txgain
After decompressing a voice packet, the ITG adjusts the signal level of the voice stream before sending the signal toward the telephony port. This command allows user to specify the gain level for PCM signal before feeding the signal to a telephony port.
67
Solwise Elite VoIP Gateway User’s Guide
set port port txgain db
Syntax description
db
Default
0
Related Commands
set port port rxgain
5.5.23 set port port voice_prof
This command is used to set the preferred voice coding profile for a telephony port.
set port port voice_prof prof#
Syntax description
prof#
Gain level in dB, ranging from –14 to 14.
Preferred coding profile ID for voice
Default
The factory default preferred voice coding profile for all the telephony ports is coding profile number 0, which is the coder for G.723 6.3 kbps.
5.6 E&M Common Signaling Configuration Commands
The E&M common signaling configuration commands are used to define common parameters used on all E&M interfaces, regardless of their mode of operation (Wink Start, Delay Start, or Immediate Start).
5.6.1 set port port em clear_conf_detect
This command is used to set the minimum duration of on-hook response on the M­lead that is required for clear confirm to be detected.
set port port em clear_conf_detect milliseconds
Syntax description
milliseconds
Time in milliseconds, ranging from 0 to 65535.
68
Solwise Elite VoIP Gateway User’s Guide
Default
5000
5.6.2 set port port em clear_conf_wait_max
This command is used to set the maximum duration to wait for an on-hook response on the M-lead after going on-hook on the E-lead.
set port port em clear_conf_wait_max milliseconds
Syntax description
milliseconds
Default
10000
5.6.3 set port port em clear_detect
This command is used to specify the period of time M-lead needs to be on-hook before call clearing is declared.
set port port em clear_detect milliseconds
Syntax description
milliseconds
Default
400
Time in milliseconds, ranging from 0 to 65535.
Time in milliseconds, ranging from 0 to 65535.
5.6.4 set port port em connected_min
This command is used to determine the minimum period of time (in milliseconds) that a connection will be maintained. If the remote end disconnects during this interval, it will be acknowledged only at the end of this interval.
set port port em connected_min milliseconds
Syntax description
milliseconds
69
Time in milliseconds, ranging from 0 to 65535.
Solwise Elite VoIP Gateway User’s Guide
Default
2000
5.6.5 set port port em dial_tone
This command is used to determine if dial tone should be generated on incoming calls.
set port port em dial_tone [on | off]
Syntax description
on
off
Generate dial tone.
Do not generate dial tone
Default
on
5.6.6 set port port em disable_hangup
This command is used to determine the time period (in milliseconds) a port will wait after hanging up a call before signaling that it is in a disabled state.
set port port em disable_hangup milliseconds
Syntax description
milliseconds
Default
2000
Time in milliseconds, ranging from 0 to 65535.
5.6.7 set port port em guard_all
This command is used to set the period after an aborted call when no incoming calls will be accepted nor outgoing calls initiated.
set port port em guard_all milliseconds
Syntax description
milliseconds
70
Time in milliseconds, ranging from 0 to 65535.
Solwise Elite VoIP Gateway User’s Guide
Default
400
5.6.8 set port port em guard_out
This command is used to set an additional period of time after guard_all when incoming calls will be accepted but outgoing calls will not be initiated for aborted call.
set port port em guard_all milliseconds
Syntax description
milliseconds
Default
400
5.6.9 set port port em offhook_db
This command is used to set the off-hook debounce interval, in milliseconds.
set port port em offhook_db milliseconds
Syntax description
milliseconds
Default
50
Time in milliseconds, ranging from 0 to 65535.
Time in milliseconds, ranging from 0 to 65535.
5.6.10 set port port em onhook_db
This command is used to set the on-hook debounce interval, in milliseconds.
set port port em onhook_db milliseconds
Syntax description
milliseconds
Time in milliseconds, ranging from 0 to 65535.
Default
50
71
Solwise Elite VoIP Gateway User’s Guide
5.6.11 set port port em size_detect
This command is used to specify the period of time the M-lead needs to be off-hook before an incoming call is declared.
set port port em size_detect milliseconds
Syntax description
milliseconds
Time in milliseconds, ranging from 0 to 65535.
Default
150
5.7 E&M Immediate Start Signaling Configuration Commands
The E&M immediate start signaling configuration commands are used to define parameters specific to E&M immediate start interface. These commands apply to E&M Immediate Start signaling protocol only.
5.7.1 set port port emi glare_report
This command is used to set a time period during which, if glare is detected, the interface will stay off-hook and generate congestion tone.
set port port emi glare_report milliseconds
Syntax description
milliseconds
Default
5000
5.7.2 set port port emi wait_dsp_ready
This command is used to set a time period (in milliseconds) to wait for the DSP software to be ready before digit collection can be enabled. If glare is detected during this period, the interface will stay offhook and generate congestion tone.
Time in milliseconds, ranging from 0 to 65535.
72
set port port emi glare_report milliseconds
Syntax description
milliseconds
Time in milliseconds, ranging
Solwise Elite VoIP Gateway User’s Guide
from 0 to 65535.
Default
200
5.8 E&M Delay Start Signaling Configuration Commands
The E&M delay start signaling configuration commands are used to define parameters specific to E&M delay start interface. These commands apply to E&M Delay Start signaling protocol only.
5.8.1 set port port emd in_delay_max
This command is used to set the maximum duration of the delay signal response to the Seize Detect (of incoming calls) on the M-lead.
set port port emd in_delay_max milliseconds
Syntax description
milliseconds
Default
2500
5.8.2 set port port emd in_delay_min
This command is used to set the minimum duration of the delay signal response to the seize detect (of incoming calls) on the M-lead.
set port port emd in_delay_min milliseconds
Syntax description
milliseconds
Default
200
Time in milliseconds, ranging from 0 to 65535.
Time in milliseconds, ranging from 0 to 65535.
5.8.3 set port port emd in_digit_ign
This command is used to set the period of time, after completing the delay signal, before the digits will be accepted on incoming calls.
set port port emd in_digit_ign milliseconds
73
Solwise Elite VoIP Gateway User’s Guide
Syntax description
milliseconds
Default
30
5.8.4 set port port emd out_delay_check
This command is used to set the period of time after going off-hook on the E-lead before checking the M-lead for the delay signal response. If the response is not seen at this time, the call setup process will continue immediately.
set port port emd out_delay_check milliseconds
Syntax description
milliseconds
Time in milliseconds, ranging from 0 to 65535.
Time in milliseconds, ranging from 0 to 65535.
Default
170
5.8.5 set port port emd out_delay_dur_max
This command is used to set the maximum duration of the delay signal response on the M-lead for it to be detected on outgoing calls.
set port port emd out_delay_dur_max milliseconds
Syntax description
milliseconds
Default
8000
5.8.6 set port port emd out_delay_dur_min
This command is used to set the minimum duration of the delay signal response on the M-lead for it to be detected on outgoing calls.
Time in milliseconds, ranging from 0 to 65535.
74
set port port emd out_delay_dur_min milliseconds
Solwise Elite VoIP Gateway User’s Guide
Syntax description
milliseconds
Default
100
5.8.7 set port port emd out_intg_check
This command is used to set the Integrity Check mode. If On, the delay signal response is required from the PBX for outgoing calls. If Off, no Integrity Check is performed.
set port port emd in_digit_ign [on | off]
Syntax description
on
off
Perform Integrity Check
No Integrity Check is performed
Time in milliseconds, ranging from 0 to 65535.
Default
off
5.9 E&M Wink Start Signaling Configuration Commands
The E&M wink start signaling configuration commands are used to define parameters specific to E&M wink start interface. These commands apply to E&M Wink Start signaling protocol only.
5.9.1 set port port emw in_wink_digit_ignore
This command is used to specify the period of time that will be ignored after completing the wink and before digits will be accepted for incoming calls.
set port port emw in_wink_digit_ignore milliseconds
Syntax description
milliseconds
Time in milliseconds, ranging from 0 to 65535.
75
Solwise Elite VoIP Gateway User’s Guide
Default
30
5.9.2 set port port emw in_wink_dur
This command is used to specify the duration of the wink signal on the E-lead for incoming calls.
set port port emw in_wink_dur milliseconds
Syntax description
milliseconds
Default
200
5.9.3 set port port emw in_wink_wait_max
This command is used to set the maximum delay before beginning the wink on the E-lead after detecting a line seizure on the M-lead for an incoming call.
set port port emw in_wink_wait_max milliseconds
Syntax description
milliseconds
Default
3000
Time in milliseconds, ranging from 0 to 65535.
Time in milliseconds, ranging from 0 to 65535.
5.9.4 set port port emw in_wink_wait_min
This command is used to set the minimum delay before beginning the wink on the E­lead after detecting a line seizure on the M-lead for an incoming call.
set port port emw in_wink_wait_min milliseconds
Syntax description
milliseconds
Default
150
76
Time in milliseconds, ranging from 0 to 65535.
Solwise Elite VoIP Gateway User’s Guide
5.9.5 set port port emw out_wink_dur_max
This command is used to set the maximum duration of the wink response on the M­lead for it to be detected.
set port port emw out_wink_dur_max milliseconds
Syntax description
milliseconds
Default
800
5.9.6 set port port emw out_wink_dur_min
This command is used to set the minimum duration of the wink response on the M­lead for it to be detected.
set port port emw out_wink_dur_min milliseconds
Syntax description
milliseconds
Default
100
Time in milliseconds, ranging from 0 to 65535.
Time in milliseconds, ranging from 0 to 65535.
5.9.7 set port port emw out_wink_wait_max
This command is used to specify the maximum time to wait for a wink response on the M-lead after going offhook on the E-lead. If the period is exceeded, the interface will declare an error condition and abort the (outgoing) call attempt.
set port port emw out_wink_wait_max milliseconds
Syntax description
milliseconds
Time in milliseconds, ranging from 0 to 65535.
Default
8000
77
Solwise Elite VoIP Gateway User’s Guide
5.10 FXO Signaling Configuration Commands
The FXO Signaling Configuration Commands are used to define parameters specific to FXO interface. These command apply to Loop Start FXO signaling protocol only.
5.10.1 set port port fxo answer_after
This command specifies the number of rings to elapse before a FXO port answering an incoming call.
set port port fxo answer_after rings
Syntax description
Rings
Number of rings.
Default
2
5.10.2 set port port fxo batt_rev_times
The ITG incorporates battery reversal detector on the FXO interface. After detecting battery reversal signal on a FXO port for certain times, the ITG shuts down the port. This command is used to specify the number of times the battery reversal signal must be detected before the ITG shutting down a FXO port.
set port port fxo batt_rev_times count
Syntax description
Counts
Number of time of battery reversal signal before shutting down the port, ranging from 0 to 65535.
78
Default
2
Notes
The battery reversal detector functions only under the condition that the CPC detector is enabled. Refer to command “set port port fxo cpc_detect” on page 42 for information about enabling/disabling the CPC detector.
Related Commands
set port port fxo cpc_detect
Solwise Elite VoIP Gateway User’s Guide
5.10.3 set port port fxo caller_id
This command selects if Caller ID will be detected on the FXO port.
set port port fxo caller_id {on | off}
Syntax description
on
off
Default
on
Related Command
set port port enable_user_cid
5.10.4 set port port fxo cpc_detect
The ITG incorporates loop current and battery reversal detectors on the FXO interface. Upon detecting loss of loop current on a FXO port for a specific duration, the ITG shuts down the port. This command is used to specify the expected duration of the loss of loop current (CPC supervisory disconnect signal) in milliseconds. If the loop current on a FXO port drops for a time period greater than this duration, it is regarded as a supervisory disconnect and the ITG shuts down the port.
set port port fxo cpc_detect milliseconds
Enable Caller ID detection
Disable Caller ID detection
Syntax description
milliseconds
Time in milliseconds, ranging from 1 to
60000. –1 stands for no loop current and battery reversal detection
Default
-1. Do not detect loop current loss and battery reversal.
Related Command
set port port fxo loop_det_db
5.10.5 set port port fxo guard_out
After completing a call over a FXO port, there a short time interval the ITG does not allow originating outgoing calls, however, incoming calls will be received. This
79
Solwise Elite VoIP Gateway User’s Guide
command is used to set this time interval in milliseconds.
set port port fxo guard_out milliseconds
Syntax description
milliseconds
Default
2000
5.10.6 set port port fxo loop_det_db
The ITG incorporate loop current detector on the FXO interface. This command specifies the time in milliseconds to use as a debouncer interval for debouncing the loop current detector. When the ITG detects loss of loop current on a FXO port, the duration of the loss must be greater then this debouncer interval, otherwise it is not regarded as loss of loop current.
set port port fxo loop_det_db milliseconds
Syntax description
milliseconds
Time in milliseconds, ranging from 1 to 60000.
Time in milliseconds, ranging from 1 to 1000.
Default
20
Related Command
set port port fxo cpc_detect
5.10.7 set port port fxo ringing_db
This command specifies the time in milliseconds to use as a debouncer interval for debouncing the ring-on signal. For preventing from mistakenly interpreting noise signal as ring-on, the ITG incorporates this debouncer. When the ITG detect ring on signal on a FXO port, the signal must sustain for at least the debouncer time, otherwise it is not regarded as a ring-on.
set port port fxo ringing_db milliseconds
Syntax description
milliseconds
80
Time in milliseconds, ranging
Solwise Elite VoIP Gateway User’s Guide
from 1 to 1000.
Default
50
Related Command
set port port fxo ringing_inter_cycle
set port port fxo ringing_inter_pulse
5.10.8 set port port fxo ringing_inter_cycle
The FXO port detects ringing for signifying an incoming call. A ring is a cycle of ring-on and ring-off signals. This command is used to specify the time between consecutive ring-on signals, that is, the duration of the ring-off signal, in milliseconds. It is used to detect ringing.
set port port fxo ringing_inter_cycle milliseconds
Syntax description
milliseconds
Default
4000
Related Command
set port port fxo ringing_db
set port port fxo ringing_inter_pulse
5.10.9 set port port fxo ringing_inter_pulse
The FXO port detects ringing for signifying an incoming call. A ring is a cycle of ring-on and ring-off signals. The ring-on signal is comprised of a sequence of pulses. This command is used to specify the time between consecutive ring pulses in the same ring-on signal in milliseconds (that is, one half the inverse of ring frequency). For instance, if the ring frequency is 25 Hz, then the period of a ring-on signal is 40 ms, and the ringing_inter_pulse is 20 ms. It is used to detect ring-on.
set port port fxo ringing_inter_pulse milliseconds
Time in milliseconds, ranging from 1 to 6000.
Syntax description
81
Solwise Elite VoIP Gateway User’s Guide
milliseconds
Default
20
Related Command
set port port fxo ringing_db
set port port fxo ringing_inter_cycle
set port port enable_user_cid
Though FXO ports can detect Caller ID and convey the detected Caller ID information to the called party. The ITG allows conveying the Caller ID information users configured to a FXO port, instead of conveying Caller ID information detected from the port. This command is used to select which Caller ID information the ITG should convey to the called party.
set port port enable_user_cid {on | off}
Time in milliseconds, ranging from 1 to 6000.
Syntax description
on
off
Conveying Caller ID information user configured.
Conveying Caller ID information the port detected.
Default
off
Related Command
set port port cid name
set port port cid number
set port port fxo_caller_id
5.11 FXS Signaling Configuration Commands
The FXS Signaling Configuration Commands are used to define parameters specific to FXS interface. These commands apply to Loop Start FXS signaling protocol only.
82
Solwise Elite VoIP Gateway User’s Guide
5.11.1 set port port fxs answ_clear_detect
This command is used to set the minimum time to wait, in milliseconds, when the answering party drops the line before declaring on-hook.
set port port fxs answ_clear milliseconds
Syntax description
milliseconds
Default
2000
5.11.2 set port port fxs caller_id
This command selects if Caller ID will be generated on a FXS port.
set port port fxs caller_id {on | off}
Syntax description
on
off
Default
on
Time in milliseconds, ranging from 1 to 60000.
Enable Caller ID generation
Disable Caller ID generation
Related Commands
set port port cid name
set port port cid number
5.11.3 set port port fxs cpc_dur
The ITG implements loop current shutdown feature on FXS port. It shuts down the current feeding toward a FXS port upon detecting a call is being terminated by the other party participated in the call. This command is used to set the duration, in milliseconds, of the loop current shutdown (CPC supervisory disconnect).
set port port fxs cpc_dur milliseconds
Syntax description
83
Solwise Elite VoIP Gateway User’s Guide
milliseconds
Default
0
5.11.4 set port port fxs cpc_wait
This command is used to set the time to wait, in milliseconds, after a FXS port shutting down loop current and before checking for on-hook.
set port port fxs cpc_wait milliseconds
Syntax description
milliseconds
Default
20
Time in milliseconds, ranging from 1 to
60000. 0 stands for never shutting down loop current
Time in milliseconds, ranging from 1 to 60000.
5.11.5 set port port fxs offhook_db
This command specifies the time in milliseconds to use as a debouncer interval for debouncing the off-hook signal. For preventing from mistakenly interpreting noise signal as off-hook, the ITG incorporates this debouncer. When the ITG detect off­hook signal on a FXS port, the signal must sustain for at least the debouncer time, otherwise it no regarded as a off-hook.
set port port fxs offhook_db milliseconds
Syntax description
milliseconds
Default
50
Related Command
set port port fxs offhook_detect
Time in milliseconds, ranging from 1 to 1000.
5.11.6 set port port fxs offhook_detect
This command is used to set the time to wait, in milliseconds, before an off-hook
84
Solwise Elite VoIP Gateway User’s Guide
condition is declared.
set port port fxs offhook_detect milliseconds
Syntax description
milliseconds
Default
150
Related Command
set port port fxs offhook_db
5.11.7 set port port fxs onhook_db
This command specifies the time in milliseconds to use as a debouncer interval for debouncing the on-hook signal. When the ITG detect on-hook signal on a FXS port, the signal must sustain for at least the debouncer time, otherwise it no regarded as a on-hook.
set port port fxs onhook_db milliseconds
Syntax description
Time in milliseconds, ranging from 1 to 1000.
milliseconds
Default
50
Related Command
set port port fxs onhook_detect
5.11.8 set port port fxs onhook_detect
This command is used to set the time to wait, in milliseconds, before an on-hook condition is declared.
set port port fxs onhook_detect milliseconds
Syntax description
Time in milliseconds, ranging from 1 to 1000.
85
Solwise Elite VoIP Gateway User’s Guide
milliseconds
Default
800
Related Command
set port port fxs onhook_db
5.11.9 set port port fxs ring_id
A ringing signal is a repetition of ring-on and ring-off cycles (the so-called cadence). The ITG can generate 11 types of ring cadence, each having a unique ID, on/off cadence and total ringing duration. Types of ringing cadence and their IDs are shown in the following table.
ID On Off On Off On Off Duration 0 1 2 0.8 0.4 0.8 4.0 3 0.4 0.2 0.4 0.2 0.8 4.0 3 minutes 4 0.3 0.2 1.0 0.2 0.3 4.0 3 minutes 5 6 0.5 0.2 0.3 0.2 0.5 3.0 3 minutes 7 8 9 10
This command is used to select which ring ID is to use on a FXS port.
Ring-On/Off Cycle Ringing
2.0
1.0
0.5
2.0
3.0
0.5
1.0
Time in milliseconds, ranging from 1 to 1000.
4.0
3.0
0.1
4.0
5.0
1.
3.0
Forever 3 minutes 3 minutes
0.6 seconds
3 minutes 3 minutes
0.6 seconds 3 minutes
set port port fxs ring_id ring_id
Syntax description
ring_id
Ring ID, ranging from 0 to 10.
Default
0
5.12 Voice and Fax Coder Configuration Commands
The coding profile is used to store coding parameters for voice and fax coders that
86
Solwise Elite VoIP Gateway User’s Guide
can be used by any telephony port on the ITG. The ITG has 11 built-in coding profiles, each having a unique profile ID and parameters for a specific voice, fax or modem coder. Among these 11 coding profiles, 5 may be used for voice or fax applications. The following table summarizes coding profiles available for voice and fax applications.
Coding profile ID Coder
0
1 G.729AB voice coder
2
5 Proprietary fax coder
6
10 Standard T.38 fax coder
G.723 6.3 kbps voice coder
G723 5.3 kbps voice coder
G.711 µ-law voice coder
This section describes the commands for setting the parameters for a particular coding profile. All the commands in this section are of the same syntax as follows:
set coding profile_id option [option] . . .
Syntax for the profile_id is as follows:
profile_id
This section is organized as follows:
Common coding profile configuration commands
Voice coding profile configuration commands
Fax coding profile configuration commands
5.12.1 Common Coding Profile Configuration Commands
The following sections describe commands that apply to all types of coding profiles.
5.12.1.1 set coding profile_id coding_type
This command is used to define the codec type for a coding profile.
ID of the coding profile to be modified.
set coding profile_id coding_type coding_type
Syntax description
coding_type
Type of the codcc as defined in the following table.
Parameter Description
g711_mu G.711 PCM u-law coding
87
Solwise Elite VoIP Gateway User’s Guide
g723_53 G.723.1 5.3 kbps coding
g723_63 G.723.1 6.3 kbps coding
g729ab
fax_t38 Fax Relay in T.38 mode
G.729 annex A, annex B 8kbps coding
Related Command
set coding profile_id usage
5.12.1.2 set coding profile_id cp_tone_detect
This command is used to specify a secondary level of control of call progress tone detection. If the call progress detection control for a telephony port is set to "As per coding profile" (refer to command “set port port cp_tone_det_ctrl” on page 24), this parameter determines if detection is to be enabled or not.
set coding profile_id cp_tone_detect {on | off}
Syntax description
on
off
Related Command
set cp_tone_det
set cp_tone_det_cfg
set port port cp_tone_det_cfg
set port port cp_tone_det_ctrl
5.12.1.3 set coding profile_id copyof
This command is used to copy the settings of the coding profile to another coding profile.
set coding profile_id copyof src_profile_id
Enable call progress tone detection.
Disable call progress tone detection.
88
Syntax description
src_profile_id
ID of the coding profile which the setting will be copied from
Solwise Elite VoIP Gateway User’s Guide
5.12.1.4 set coding profile_id fax_tone_detect
This command is used to specify a secondary level of control of V.21 fax tone detection. If the fax tone detection control for a telephony port is set to "As per coding profile" (refer to command “set port port fax_tone_det_ctrl” on page 25), this parameter determines if detection is to be enabled or not. For a voice coder, fax tone detection has to be enabled, otherwise, s telephony port never switches to fax mode while the voice coder is active. For a fax profile it does not matter if the fax tone detection is enabled or disabled.
set coding profile_id fax_tone_detect {on | off}
Syntax description
on
Disable V.21 fax tone detection.
Related Command
set port port fax_tone_det_ctrl
5.12.1.5 set coding profile_id usage
This command is used to set allowed usage for a coding profile.
set coding profile_id usage {voice | fax} {on | off}
Syntax description
Voice
Enable V.21 fax tone detection. off
The coding profile is allowed, if the parameter that follows is “on”, for being used as voice coder.
The coding profile is not allowed, if the parameter that follows is “off”, for being used as voice coder.
Fax
The coding profile is allowed, if the parameter that follows is “on”, for being used as fax coder.
The coding profile is not allowed, if the parameter that follows is “off”, for being used as fax coder.
5.12.2 Voice Coding Profile Configuration Commands
The following sections describe commands that apply to coding profiles for voice coder.
89
Solwise Elite VoIP Gateway User’s Guide
5.12.2.1 set coding profile_id adaptive_playout
The ITG has a built-in voice packet buffer, which allows the ITG to remove the packet jitter from the incoming packet stream. The ITG also implements an adaptive voice packet playback
algorithm, which automatically adjust the time each voice packet is buffered in the voice packet buffer before being played out. This command is used to enable/disable the adaptive playback function for a voice coding profile.
set coding profile_id adaptive_playout {on | off}
Syntax description
on
Enable adaptive playback.
off
Disable adaptive playback.
Related Commands
set coding profile_id max_delay
set coding profile_id min_delay
set coding profile_id nom_delay
5.12.2.2 set coding profile_id dtmf_relay
The ITG supports DTMF Relay, in which DTMF tones are detected during voice processing, encoded into H323-UserInformation packets and conveyed to the remote ITG via the H.323 call control band. This command is used to enable or disable the DTMF Relay feature.
set coding profile_id dtmf_relay {on | off}
Syntax description
on
off
5.12.2.3 set coding profile_id max_delay
The ITG has a built-in voice packet buffer, which stores voice packets received from the network. Voice packets from network may have traversed variable path and each packets have experienced different propagation delay. The effect of non-uniform
90
Detect DTMF tones while voice session is on­going, and send detected DTMF digits to remote gateway via the H.323 call control band.
Do not detect DTMF tones. DTMF tones are compressed and send to remote gateway the same as regular voice frame.
Solwise Elite VoIP Gateway User’s Guide
delay among packets is known as jitter. The voice buffer allows the ITG to remove the packet jitter from the incoming packet stream before decompressing and sending the packet to telephony port for playing out. This command is used to set the size of the voice buffer.
set coding profile_id max_delay delay
Syntax description
delay
Value in milliseconds.
Notes
1. The maximum delay should be at least 2 packet times greater than the nominal delay. Refer to command “set coding profile_id nom_delay” on page 55 for details about setting nominal delay.
2. The maximum delay for each coder is shown in the following table:
Coding Type Maximum Delay
G.711 µ-law
G.723 500 ms
G.729AB 500 ms
145 ms
Related Commands
set coding profile_id adaptive_playout
set coding profile_id nom_delay
5.12.2.4 set coding profile_id min_delay
This command is used to set the time each voice packet is stored in the voice packet buffer before the ITG playing out the packet. It is only meaningful when the adaptive playback feature is disabled. Refer to command “set coding profile_id adaptive_playout” on page 53 for details about adaptive playback feature.
set coding profile_id max_delay delay
Syntax description
delay
Value in milliseconds.
Related Commands
91
Solwise Elite VoIP Gateway User’s Guide
set coding profile_id adaptive_playout
5.12.2.5 set coding profile_id nom_delay
While the “set coding profile_id max_delay” command sets the size of the voice packet buffer, this command sets the average time in milliseconds each voice packet is stored in the buffer.
set coding profile_id nom_delay delay
Syntax description
Delay
Value in milliseconds.
Note
The nominal delay should be at least twice the packet time. Refer to command “set coding profile_id vif” on page 57 for details about setting the packet time.
Related Commands
set coding profile_id adaptive_playout
set coding profile_id max_delay
set coding profile_id vif
5.12.2.6 set coding profile_id vad
This command is used to enable/disable the Voice Activity Detector (VAD) for a coding profile.
set coding profile_id vad {on | off}
Syntax description
On
Off
Enable VAD.
Disable VAD.
Related Commands
set coding profile_id vad_thresh
5.12.2.7 set coding profile_id vad_thresh
This command is used to set threshold level for the VAD for a coding profile.
set coding profile_id vad_thresh threshold
Syntax description
92
Solwise Elite VoIP Gateway User’s Guide
threshold
Related Commands
set coding profile_id vad
5.12.2.8 set coding profile_id vif
This command is used to set the size of the Voice Information Field (VIF), in bits, for a voice coder.
set coding profile_id vif no_of_bits
Syntax description
no_of_bits
Size of the Voice Information Field (VIF), in bits, for a voice coder. The appropriate VIF sizes to use are related to the coding type and the rate the voice coder samples a voice frame (the packet time), as shown in the following table. VIF sizes of a coder of values other than those shown in the table are not valid.
Coding type Sampling time VIF
Value in dBm, ranging from –20 to +10.
G.711 µ-law
G.723 30 ms 192
G.729AB 10 ms 80
10 ms 640
20 ms 1,280
30 ms 1,920
60 ms 384
20 ms 160
30 ms 240
40 ms 320
50 ms 400
60 ms 480
Related Commands
set coding profile_id nom_delay
5.12.3 Fax Coding Profile Configuration Commands
The following sections describe commands that apply to coding profiles for fax.
5.12.3.1 set coding profile_id fax_hs_pkt_rate
This T-38 mode command is used to set the rate at which high-speed data will be
93
Solwise Elite VoIP Gateway User’s Guide
sent across the network, for a fax coder (i.e., determines the size of the high-speed IFPs).
set coding profile_id fax_hs_pkt_rate milliseconds
Syntax description
milliseconds
5.12.3.2 set coding profile_id fax_hs_redundancy
Value in milliseconds
The T-38 mode command is used to specify the packet-level redundancy for high­speed data transmissions (i.e., T.4 image data) for a fax coder profile.
set coding profile_id fax_hs_redundancy pkt
Syntax description
pkt
Related Commands
set coding profile_id fax_ls_redundancy
5.12.3.3 set coding profile_id fax_ls_redundancy
This T-38 mode command is used to specify the packet-level redundancy for low­speed data transmissions (i.e., T.30 handshaking information), for a fax coder.
Number of prior primary packets to be encapsulated in each fax payload, ranging from 0 to 2.
set coding profile_id fax_ls_redundancy pkt
Syntax description
pkt
Related Commands
set coding profile_id fax_hs_redundancy
5.12.3.4 set coding profile_id fax_relay_features
This command is used to enable or disable specific fax processing capabilities for a fax coder.
set coding profile_id fax_relay_features {scanlon | scanloff} {fdison | fdisoff} {nfson | nfsoff}
94
Number of prior primary packets to be encapsulated in each fax payload, ranging from 0 to 5.
Solwise Elite VoIP Gateway User’s Guide
Syntax description
scanlon
scanloff
fdison
fdisoff
nfson
nfsoff
5.12.3.5 set coding profile_id fax_t30_features
This command is used to enable or disable the use of specific fax capabilities between two end fax devices.
set coding profile_id fax_t30_features {ecmon | ecmoff}
Enable concealment of page data errors due to network packet loss.
Disable concealment of page data errors due to network packet loss.
Enable prolonging of the second Digital Identification Signal (DIS) retransmission.
Disable prolonging of the second DIS retransmission.
Enable overriding of Non-standard Facility (NSF) data and prevent end fax devices from employing proprietary capabilities.
Disable overriding of NSF data.
Syntax description
ecmon
ecmoff
5.12.3.6 set coding profile_id fax_tcf_method
This T-38 mode command is used to control the method with which data is handled over the network, for a fax coding profile. Method 1 (Local) requires that the TCF training signal be generated and checked locally by the gateway and is not forwarded over the network. In Method 2 (Network), TCF data is sent over the network. These correspond to Data Management methods 1 and 2 in specification T.38.
set coding profile_id fax_tcf_method {1 | 2}
Syntax description
1
2
TCF method 1
TCF data is sent over the network.
Enable Error Correction Mode (ECM).
Disable ECM. Disabling ECM improves call success rates
95
Solwise Elite VoIP Gateway User’s Guide
5.12.3.7 set coding profile_id fax_tx_net_timeout
This command sets the timeout period after which the ITG will declare a fax cleardown event, if no data is received from the IP network while the gateway is in a local transmit state. It is safeguard to ensure the channel is not left in a fax relay state in a transparent signaling environment.
set coding profile_id fax_tx_net_timeout seconds
Syntax description
seconds
Value in seconds, ranging from 10 to 32000.
5.13 Call Progress Tone Configuration Commands
Cal Progress (CP) tones such as ring-back, busy, congestion and disconnect tone are signaling tones PBXs and CO switches present at various stage of a call. Telephony device, or user operating it, must act upon the CP tones generated by device connected to it for completing a call. The ITG implements a CP generator for generating CP tones and a detector for detecting CP tones. Since the frequency specifications and on/off cadence of CP tones are not uniform over all telephone administrations globally, the ITG implements user configurable CP tone generator/detector allowing user to customize the CP tone generator and detector. This section describes commands for configuring the CP tone generator and detector.
5.13.1 Configuring CP Tones
A CP tone is a sequence of tones of up to 6 elements, and each tone element is characterized by a composition of up to 4 mono-frequency tones and a duration that the tone generator plays out these tones. Once configured, the CP tone generator plays these tone elements, in sequence, repeatedly. The ITG allows users to define the tone elements and duration for the following CP tones:
Dial tone
Busy tone
Congestion tone
Disconnect tone
This section describes the command for configuring these tones.
5.13.1.1 set tone
This interactive command is used to configure the each of the element of the CP tones that the ITG generates.
set tone {dial | busy | congest | disconnect}
Syntax description
dial
96
Dial tone
Solwise Elite VoIP Gateway User’s Guide
busy
congest
disconnect
Busy tone
Congestion tone
Disconnect tone
After entering the command, the CLI first prompts you to enter the number of tone elements, then prompts you to enter each tone element in sequence. For each tone element, you’ll need to specify the following parameters:
Number of mono-frequency tone components, up to 4, that comprise the tone.
Frequency (in Hz) and power level (in unit of 0.1 dBm) for all the mono-frequency
tone components. Since a tone may be comprised of up to 4 mono-frequency tone components, you need to provide the frequency and power level of all the 4 tone components. If a tone element is comprised of less than 4 mono-frequency tone components, you need to specify frequency of 0 Hz and power level of 0 dBm to the components that do not exist.
Duration (in milliseconds) of the tone. The duration of –1 specifies playing out the tone forever.
Example
Assuming you want to define a congestion tone, which is a repetition of two tone elements as shown in the following table:
Tone No. of Tone 1 Tone 2 Dura- Element mono-
1 2 480 -24.0 620 -24.0 250
2 0
Tone Composition
freq. tones
Freq (Hz)
Power (dBm)
Freq (Hz)
Power (dBm)
tion (ms)
Remark
The first tone element is a compositio n of a 420 Hz tone of power level –24.0 dBm and a 620 Hz tone of power level –24.0 dBm of duration 250 millisecond s.
The 2nd tone element is a silence of duration 250 ms.
The following example explains how this interactive command is used to define this tone. Command and keywords user entered are designated in boldface.
Console>set tone congest <Enter>
97
Solwise Elite VoIP Gateway User’s Guide
How many sets of tone do you want the whole tone to be? (1~6) 2 <Enter> Please enter set 1 parameters in the following order: num_freq freq1 amp1 freq2 amp2 freq3 amp3 freq4 amp4 duration (-1:
forever) 2 480 –240 620 –240 0 0 0 0 250 <Enter> Please enter set 2 parameters in the following order: num_freq freq1 amp1 freq2 amp2 freq3 amp3 freq4 amp4 duration (-1:
forever) 0 0 0 0 0 0 0 0 0 250 <Enter> OK Use 'config store' cmd to save all the tone generation settings
you've made. Console>
The following example explains how to define a dial tone, which is a continuous playing out of a 400 Hz tone of power level –20 dBm.
Console>set tone dial <Enter> How many sets of tone do you want the whole tone to be? (1~6)
1 <Enter> Please enter set 1 parameters in the following order: num_freq freq1 amp1 freq2 amp2 freq3 amp3 freq4 amp4 duration (-1:
forever) 1 400 –200 0 0 0 0 0 0 -1 <Enter> OK Use 'config store' cmd to save all the tone generation settings
you've made. Console>
Related Commands
show tone
5.13.2 Configuring CP Tone Detector
The CP tones that the ITG can detect include busy, ring-back, congestion and 6 types of disconnect tones. The ITG allows user to configure its CP tone detection configuration. The CP tone detection configuration includes tone filter information, and a table containing cadence information of all the CP tones that are to be detected. The CP tone filter is a band-pass filter, which filters all the tones present on the telephony ports. After filtering, if a tone is regarded as a CP tone, the ITG matches the on/off cadence of the tone against the cadence table users configured. If a match is found, the ITG regards it as a specific tone. This section describes command for configuring the tone detection filter and the tone on/off cadence for all the CP tone the ITG can detect.
5.13.2.1 set cp_tone_det
This command is used to configure the on/off cadence for all the CP tones the ITG can detect.
set cp_tone_det {busy | ringback | congestion |
98
Solwise Elite VoIP Gateway User’s Guide
disconnect | disc1 | disc2 | disc2 | disc4 | disc5}
Syntax description
busy
ringback
congestion
disconnect
disc1
disc2
disc3
disc4
disc5
Busy tone
Ring-back tone
Congestion tone
Disconnect tone type 1
Disconnect tone type 2
Disconnect tone type 3
Disconnect tone type 4
Disconnect tone type 5
Disconnect tone type 6
The cadence of a CP tone that user may configure include a sequence of tone-on and tone-off duration and the number or repetition of the sequence. For each CP tone, user may define up t 8 tone-on and tone-off duration, each is defined by a minimum and maximum duration.
After entering the command, the CLI first prompts you to enter the number of on/off cadence elements, then prompts you to enter each cadence element in sequence. For each cadence element, you’ll need to specify the following parameters:
Tone on or tone off.
Minimum duration (in milliseconds) of the tone.
Maximum duration (in milliseconds) of the tone.
Example
Assuming you want to define a busy tone, which is a sequence of the following tone­on and tone-off:
Tone Minimum
On 450 ms 550 ms Off 350 ms 450 ms On 450 ms 550 ms Off 350 ms 450 ms
The following example explains how this interactive command is used to define the cadence. Command and keywords user entered are designated in boldface.
Duration
Maximum Duration
99
Solwise Elite VoIP Gateway User’s Guide
Console>set cp_tone_det busy <Enter> How many sets of elements do you want the whole CP tone to be detected? (1~8)
2 <Enter> Please enter set 1 parameters in the following order: on/off min.-duration max.-duration on 450 550 <Enter> Please enter set 2 parameters in the following order: on/off min.-duration max.-duration off 350 450 <Enter> Please enter the repeat count now (1~10): 2 <Enter> OK Use 'config store' cmd to save all the CPtone detection settings
you've made. Console>
Related Commands
set cp_tone_det_cfg
set coding profile_id cp_tone_detect
set port port cp_tone_det_cfg
set port port cp_tone_det_ctrl
show cp_tone_det
5.13.2.2 set cp_tone_det_cfg
This command is used to configure the CP tone detection filter for the default CP tone detection configuration.
set cp_tone_det_dfg on_frac [threshold|0|-] [hold_over_time|0|-] [low_freq|0|-] [high_freq|0|-]
Syntax description
on_frac
threshold
Percentage of tone on fraction ranging from 10 to 95. If the ratio between the tone energy and total energy is below this fraction, the call progress tone is ignored. “0” specifies the default of 50%. “-“ specifies using the original setting.
Tone detection threshold, in dBm, ranging from –35 to –20. “0” specifies the default of –37 dBm. “-“ specifies using the original setting.
100
hold_over_time
Minimum time duration in millisecond, ranging from 5 to 32767 for the call progress tone to be detected. “0” specifies the default of 200 ms. “­“ specifies using the original setting.
Loading...