XONTEL XT-400FXO, User Manual

Page 1: ...XT 400FXO Analog Gateway User Manual ...

Page 2: ...ent of XonTel Disclaimer XonTel reserves the right to modify the design characteristics and products at any time without notification or obligation and shall not be held liable for any error or damage of any kind resulting from the use of this document XonTel has made every effort to ensure that the information contained in this document is accurate and complete however the contents of this docume...

Page 3: ... 9 2 System 10 Status 10 Time 11 Login Settings 12 General 13 Language Settings 13 Scheduled Reboot 13 Tools 14 Information 16 3 Analog 17 Channel Settings 17 Pickup Settings 20 Advanced Settings 21 FXO 23 Driver 25 4 SIP 26 SIP Endpoints 26 Main Endpoint Settings 26 Advanced Registration Options 29 Call Settings 30 Advanced Signaling Settings 31 ...

Page 4: ...d Compatibility 39 Caller ID and Callee ID 40 Timer Configuration 41 Outbound Registrations 41 Security 42 Media 43 Sip Account Security 44 5 Routing 45 Call Routing Rules 45 Groups 50 Batch Create Rules 52 Advanced 53 6 Network 54 Network Settings 54 VPN Settings 56 DDNS Settings 56 Toolkit 57 Security Settings 59 Security Rules 60 7 Advanced 61 Asterisk API 61 ...

Page 5: ...Asterisk CLI 64 Asterisk File Editor 65 TR069 66 Auto Provision 67 8 Logs 68 Log Settings 68 System 70 Asterisk 70 SIP 71 DAHDI 71 CDR 72 ...

Page 6: ...evelopment can be completed through AMI Asterisk Management Interface The XT 400FXO Gateway is with 4 FXO ports for 4 PSTN lines The XT 400FXO Analog Gateway are developed for interconnecting a wide selection of codecs including G 711A G 711U G 729A G 722 G 726 iLBC XT 400FXO Gateway use standard SIP protocol and compatible with Leading VoIP platform IPPBX and SIP servers Such as Asterisk Issabel ...

Page 7: ... appearance of XonTel XT 400FXO Analog Gateway 1 Power Indicator 2 System LED 3 Analog Telephone Interfaces and corresponding Channels State Indicators Figure 1 3 3 Back Panel 1 Power interface 2 Reset button 3 Ethernet ports and indicators ...

Page 8: ... Call transfer Dial up matching table Support T 38 fax relay and T 30 fax transparent FSK and DTMF signaling Support Echo cancellation Jitter buffer SIP Features Support add modify delete SIP Accounts batch add modify delete SIP Accounts Support multiple SIP registrations Anonymous Endpoint registers with this gateway This gateway registers with the endpoint SIP accounts can be registered to multi...

Page 9: ...90 non condensing Power source 12V DC 2A Max power 12W Software LAN2 Default IP 172 16 99 1 Username admin Password xontel Please enter the default IP in your browser to scan and configure the module you want Login Interface ...

Page 10: ...2 System Status On the Status page you will see Port SIP Routing Network information and status Figure 2 1 1 System Status ...

Page 11: ...trings NTP Server 1 Time server domain or hostname For example time asia apple com NTP Server 2 The first reserved NTP server For example time windows com NTP Server 3 The second reserved NTP server For example time nist gov Auto Sync from NTP Whether enable automatically synchronize from NTP server or not ON is enable OFF is disable this function Sync from NTP Sync time from NTP server Sync from ...

Page 12: ... user name and password will be OK Table 2 3 1 Description of Login Settings Options Definition User Name Define your username and password to manage your gateway without space here Allowed characters is _ 0 9a zA Z Length 1 32 characters Password Allowed characters _ 0 9a zA Z Length 4 32 characters Confirm Password Please input the same password as Password above Login Mode Select the mode of lo...

Page 13: ...After that you can modify the package with the language you need Then upload your modified packages Choose File and Add those will be ok Figure 2 4 1 Language Settings Scheduled Reboot If switch it on you can manage your gateway to reboot automatically as you like There are four reboot types for you to choose By Day By Week By Month and By Running Time Figure 2 4 2 Reboot Types ...

Page 14: ...ls will be dropped Asterisk Reboot is the same Table 2 5 1 Instruction of reboots Options Definition System Reboot This will turn off your gateway and then turn it back on This will drop all current calls Asterisk Reboot This will restart Asterisk and drop all current calls To update your system click on File Upload to choose the XT 400FXO gateway firmware file from your PC then click on System Up...

Page 15: ...tice the version of backup and current firmware should be same otherwise it would not take effect Figure 2 5 3 Upload and Backup Sometimes there is something wrong with your gateway that you don t know how to solve it mostly you will select factory reset Then you just need to press a button your gateway will be reset to the factory status Figure 2 5 4 Factory Reset ...

Page 16: ... the Information page there shows some basic information about the XonTel analog gateway You can see software and hardware version storage usage memory usage and some help information Figure 2 6 1 System Information ...

Page 17: ... see much information about your ports on this page Channel Settings Figure 3 1 1 Channel System On this page you can see every port status and click action button to configure the port Figure 3 1 2 FXO Port Configure ...

Page 18: ... 0 1 dB increments Tx gain Set the tx gain in dB Range from 20 0dB to 6 0dB in 0 1 dB increments Ring timeout Set the ring timeout in seconds is sent out immediately When pressing the call will be sent immediately Callout Min interval Call out minimum interval Range from 400 10000ms Default is 2000ms Use calledid Use caller ID or not Hide callerid Whether or not to hide outgoing caller ID ...

Page 19: ... polarity switch In some countries polarity reversal is used to signal the disconnect of phone line If this option is selected the call will be considered hang up on a polarity reversal Polarity on answer delay Minimal time period ms between the answer polarity switch and hangup polarity switch Default is 600ms Delay reply 200 OK switch It is invalid when start polarity Default is Off On Delay tim...

Page 20: ...r separately for each port The feature is accessed by pressing a special sequence of numbers which you set as Number parameter on the telephone set when it is enabled this function Figure 3 2 1 Pickup Configure Table 3 2 1 Definition of Pickup Options Definition Enable ON enabled OFF disabled Time Out Set the timeout in milliseconds ms Note You can only enter numbers Number Pickup number ...

Page 21: ...Tone interval How long between tone and tone will be played on the channel in milliseconds Dial timeout Specifies the number of seconds we attempt to dial the specified devices Codec Set the global encoding mulaw alaw Echo Type Set the echo type Oslec or Aec Echo cancel tap length Hardware echo canceler tap length FXS signaling Set the FXS signaling Loop start or Kewlstart Figure 3 3 2 Fax Configu...

Page 22: ...rrection mode by default Figure 3 3 3 Country Configuration Table 3 3 3 Definition of Country Options Definition Country Configuration for location specific tone indications Ring cadence List of durations the physical bell rings Dial tone Set of tones to be played when one picks up the hook Ring tone Set of tones to be played when the receiving end is ringing ...

Page 23: ...kground Congestion tone Set of tones played when there is some congestion Dial recall tone Many phone systems play a recall dial tone after hook flash Record tone Set of tones played when call recording is in progress Info tone Set of tones played with special information messages e g number is out of service FXO Figure 3 4 1 FXO settings ...

Page 24: ...er the more sensitive Range 100ms to 500ms Default is 250ms Max silence How silence threshold of silence before hanging up Eg 16 is 250ms 16 4s Range 2 to 1020 200ms to 512s Rx threshold Rx threshold range 20dbm0 to 40dbm0 default 38 38dbm0 all values are understood to be negative Tx threshold Tx threshold range 20dbm0 to 40dbm0 default 38 38dbm0 all values are understood to be negative Polarityde...

Page 25: ...uration for impedance cidbeforering Switch to handle irregular CID function cidbuflen CID media stream length byte size cutcidbufheadlen CID media header length byte size fixedtimepolarity Transmit polarity line reversal signal delay time FXO RX gain Set FXO to IP gain Range from 150 to 120 the default is 0 FXO TX gain Set FXO to terminal gain Range from 150 to 120 the default is 0 ...

Page 26: ...y existed endpoints you can click button Main Endpoint Settings There are 3 kinds of registration types for choose You can choose Anonymous Server or Client You can configure as follows If you set up a SIP endpoint by registration None to a server then you can t register other SIP endpoints to this server If you add other SIP endpoints this will cause Out band Routes and Trunks confused ...

Page 27: ...ure 4 1 2 Anonymous Registration For convenience we have designed a method that you can register your SIP endpoint to your gateway thus your gateway just works as a server Figure 4 1 3 Register to Gateway ...

Page 28: ...nt will use to authenticate with the gateway Allowed characters Registration None Not registering Server When register as this type it means the FXO gateway acts as a SIP server and SIP endpoints register to the gateway Client When register as this type it means the FXO gateway acts as a client and the endpoint should be register to a SIP server Hostname or IP Address IP address or hostname of the...

Page 29: ...s so NAT Traversal Addresses NAT related issues in incoming SIP or media sessions No Use Rport if the remote side says to use it Force Rport on Force Rport to always be on Yes Force Rport to always be on and perform comedia RTP handling Rport if requested and comedia Use Rport if the remote sidesays to use it and perform comedia RTP handling SUBSCRIBE for MWI Enable or disable subscribe to receive...

Page 30: ...username to identify the gateway to this endpoint From Domain A domain to identify the gateway to this endpoint Quality Whether or not to check the endpoint s connection status Qualify Frequency How often in seconds to check the endpoint s connection status Outbound Proxy A proxy to which the gateway will send all outbound signaling instead of sending signaling directly to endpoints Custom Registe...

Page 31: ... call limit will cause calls above the limit not to be accepted Trust Remote Party ID Whether or not the Remote Party ID header should be trusted Send Remote Party ID Whether or not to send the Remote Party ID header Remote Party ID Format How to set the Remote Party ID header from Remote Party ID or from P Asserted Identity Caller ID Presentation Whether or not to display Caller ID Advanced Signa...

Page 32: ...n SDP packets and will only modify the SDP session if the version number change Turn this option off to force the gateway to ignore the SDP session version number and treat all SDP data as new data This is required for devices that send non standard SDP packets observed with Microsoft OCS By default this option is on Allow Transfers Whether or not to globally enable transfers Choosing no will disa...

Page 33: ... in this amount of time the call will auto congest Defaults to 64 times the default T1 timer Session Timers Session Timers feature operates in the following three modes originate Request and run session timers always accept run session timers only when requested by other UA refuse do not run session timers in any case Minimum Session Refresh Interval Minimum session refresh interval in seconds Def...

Page 34: ...dia Settings Figure 4 1 9 Media Settings Table 4 1 6 Definition of Media Settings Options Definition Media Settings Select codec from the drop down list Codecs should be different for each Codec Priority ...

Page 35: ...Create SIP If you want add batch Sip accounts you can configure this page You can choose all the register mode Figure 4 2 1 Batch SIP Endpoints Advanced SIP Settings Networking Figure 4 3 1 Networking Options ...

Page 36: ...s the client will be disconnected default value is 30 seconds TCP Authentication Limit The maximum number of unauthenticated sessions that will be allowed to connect at any given time default is 50 Enable Hostname Lookup Enable DNS SRV lookups on outbound calls Note the gateway only uses the first host in SRV records Disabling DNS SRV lookups disables the ability to place SIP calls based on domain...

Page 37: ...e the option below to disable this feature Match External Address Locally Only substitute the externaddr or externhost setting if it matches Dynamic Exclude Static Disallow all dynamic hosts from registering as any IP address Used for staticly defined hosts This helps avoid the configuration error of allowing your users to register at the same address as a SIP provider Externally Mapped TCP Port T...

Page 38: ... Interval Reflesh Request Interval of the STUN server Server IP Address Domain Name Address or domain of the STUN server RTP Settings Figure 4 3 4 RTP Settings Table 4 3 4 Definition of NAT Settings Options Options Definition Start of RTP Port Range Start of range of port numbers to be used for RTP End of RTP port Range End of range of port numbers to be used for RTP RTP Timeout RTP timeout ...

Page 39: ...s and multiline headers for strict SIP compatibility Send Compact Headers Send compact SIP headers SDP Owner Allows you to change the username filed in the SDP owner string This filed must not contain spaces Matching Priority Set matching priority for the gateway From Number Extern Number Disallowed SIP Methods The external hostname and optional TCP port of the NAT Hangup Cause Code Set FXO gatewa...

Page 40: ...5 becomes 5555555 when this option is enabled Disabling this option results in no modification of the caller id value which is necessary when the caller id represents something that must be preserved By default this option is on SIP From Set SIP from type Name or Number Callee ID Options Definition SIP To Callee ID transfer Tel Tel or Tel User Callee ID Default is EXTEN Eg When selecting SIP To Na...

Page 41: ... Registration Expiry Maximum allowed time in seconds of incoming registrations and subscriptions Minimum Registration Expiry Minimum lengeth of registration subscriptions in seconds Default Registration Expiry Default length of incoming outgoing registration in seconds Outbound Registrations Figure 4 3 8 Outbound Registrations Settings ...

Page 42: ...orever hammer the other server until it accepts the registration Security Figure 4 3 9 Security Settings Table 4 3 9 Definition of Secutity settings Options Definition Match Auth Username If available match user entry using the username field from the authentication line instead of the from field Realm Realm for digest authentication Realms MUST be globally unique according to RFC 3261 Set this to...

Page 43: ... letting the requester know whether there was a matching user or peer for their request This reduces the ability of an attacker to scan for valid SIP usernames This option is set to yes by default Authenticate Options Requests Enabling this option will authenticate OPTIONS requests just like INVITE requests are By default this option is disabled Allow Guest Calling Allow or reject guest calls defa...

Page 44: ...nfigured with progressinband never In order for noanswer applications to work you need to run the progress application in the priority before the app directmedia Redirect the RTP media stream to go directly from the caller to the callee or not TOS for SIP Packets Sets type of service for SIP packets TOS for RTP Packets Sets type of service for RTP packets Sip Account Security This analog gateway s...

Page 45: ... friendly routing settings for user It supports up to 512 routing rules and about 100 pairs of calleeID callerID manipulations can be set in a rule It supports DID function The gateway support trunk group and trunk priority management Call Routing Rules Figure 5 1 1 Routing Rules You are allowed to set up new routing rule by and after setting routing rules move rules order by pulling up and down c...

Page 46: ...form adds 086 as prefix and Change the last two number to 88 Figure 5 1 1 processing rules prepend prefix Match pattern SdfR StA RdfR Caller Name Calling Transformation 086 159 xxxxxxxx 4 0755 China telecom Called transformation 086 136 xxxxxxx 2 88 N A You can click button to set up your routings Figure 5 1 2 Example of Setup Routing Rule The figure above realizes that calls from support SIP endp...

Page 47: ...tination to receive the incoming calls Force Answer Enable or disable force answer option Figure 5 1 3 DISA Settings Table 5 1 3 Definition of DISA settings Options Definition Authentication Enable or disable password authentication Secondary Dialing Enable or disable secondary dialing DISA Timeout Select the timeout range from 1 second to 10 seconds Max Password Digits Restrict the max length pas...

Page 48: ...om 0 9 Z matches any digit from 1 9 N matches any digit from 2 9 1237 9 matches any digit in the brackets example 1 2 3 7 8 9 matches one or more dialed digits Prepend Digits to prepend to a successful match If the dialed number matches the patterns specified by the subsequent columns then this will be prepended before sending to the trunks Prefix Prefix to remove on a successful match The dialed ...

Page 49: ...verd StA Suffix to Add Designated information to be added to the right end of the current number Caller Name What caller name would you like to set before sending this call to the endpoint Disabled Caller Number Change Disable the caller number change and fixed caller number match pattern Time Patterns that will use this Route Time Patterns that will use this Route help Forward Number What destina...

Page 50: ...ould be troublesome But with our product you don t need to worry about it You can combine many Ports or SIP to groups Then if you want to make a call it will find available port automatically Figure 5 2 1 Group Rules You can click button to set new group and if you want to modify existed group you can click button Figure 5 2 2 Create a Group ...

Page 51: ...Group Name The mean of this route Should be used to describe what types of calls this route match for example sip1 TO port1 or port1 To sip2 Type Group type FXO or SIP Policy Policy type Ascending Aescending Roundrobin and Reverse roundrobin Members Select FXO ports members for this group ...

Page 52: ...If you bind telephone for each FXO port and want to establish separate call routings for them For convenience you can batch create call routing rules for each FXO port at once in this page Figure 5 3 1 Batch Create Rules ...

Page 53: ...nced settings Table 5 4 1 Definition of Routing advanced settings Options Definition Flexible Routing Switch If you enable this option you can enable Internal FXS Call option Enable Internal SIP Call Enable or disable internal SIP call ...

Page 54: ...rt IP Factory Static and DHCP Factory is the default type and it is 172 16 99 1 When you Choose LAN IPv4 type is Factory this page is not editable A reserved IP address to access in case your gateway IP is not available Remember to set a similar network segment with the following address of your local PC Figure 6 1 1 LAN Settings Interface ...

Page 55: ...get IP from your local LAN MAC Physical address of your network interface Address The IP address of your FXO gateway Netmask The subnet mask of your FXO gateway Default Gateway Default getaway IP address DNS Servers A list of DNS IP address Basically this info is from your local network service provider Reserved Access IP A reserved IP address to access in case your gateway IP is not available Rem...

Page 56: ... you can see a VPN virtual network card on SYSTEM status page About the configure format you can refer to the Notice and Sample configuration Figure 6 2 1 VPN Interface DDNS Settings You can enable or disable DDNS Dynamic Domain Name Server Figure 6 3 1 DDNS Interface ...

Page 57: ...e server Type Set the type of DDNS server Username Your DDNS account s login name Password Your DDNS account s password Your domain The domain to which your web server will belong Toolkit It is used to check network connectivity Support Ping command on web GUI Figure 6 4 1 Network Connectivity Checking ...

Page 58: ... Definition Interface The name of network interface Source host Capture the data of source host you specified Destination host Capture the data of destination host you specified Port Capture the data of port you specified Tcpdump Option Parameter The tool of tcpdump capture network data by parameter option specified ...

Page 59: ... option in the FXO gateway Disable Ping If you enable this option the FXO gateway will disable Ping response Whitelist Enable If you enable this option you can add approved list of IP addresses that have permission to access your FXO gateway Blacklist Enable If you enable this option you can add a list of IP addresses that will be blocked or cant access your FXO gateway ...

Page 60: ...in your FXO Gateway as shown below Figure 6 6 1 Security rules settings Figure 6 6 2 Create new security rule Table 6 5 1 Definition of security rules Options Definition Rule name Set a name for the created security rule Protocol Choose the protocol UDP TCP ICMP ...

Page 61: ...ask The format for IP is IP Mask Confirm the range by IP and mask Action Choose the action for the firewall rule Accept Drop 7 Advanced Asterisk API When you make Enabled switch to on this page is available Figure 7 1 1 API Interface ...

Page 62: ...ager secret Password for the manager Characters Allowed characters _ 0 9a zA Z Length 4 32 characters Deny If you want to deny many hosts or networks use as separator Example 0 0 0 0 0 0 0 0 or 192 168 1 0 255 255 255 0 10 0 0 0 255 0 0 0 Permit If you want to permit many hosts or network use as separator Example 0 0 0 0 0 0 0 0 or 192 168 1 0 255 255 255 0 10 0 0 0 255 0 0 0 ...

Page 63: ...mbers to a queue User Permission to send and receive UserEvent Config Ability to read and write configuration files DTMF Receive DTMF events Read only Reporting Ability to get information about the system CDR Output of cdr manager if loaded Read only Dialplan Receive NewExten and Varset events Read only Originate Permission to originate new calls Write only All Select all or deselect all Once you ...

Page 64: ...mmands Figure 7 2 1 Asterisk Command Interface Table 7 2 1 Definition of Asterisk API Options Definition Command Type your Asterisk CLI commands here to check or debug your gateway If you type help or and execute it the page will show you the executable commands ...

Page 65: ...age you are allowed to edit and create configuration files Click the file to edit Figure 7 3 1 Configuration Files List Click New Configuration File to create a new configuration file After editing or creating please reload Asterisk ...

Page 66: ...TR069 XonTel XT 400FXO Gateway can be managed remotely by service provider with TR069 management protocol and is interoperable with various ACS Figure 7 4 1 TR069 settings ...

Page 67: ... with various ACS Figure 7 5 1 Auto Provision settings Table 7 5 1 Definition of Auto Provision settings Options Definition Firmware Enable Enabe or disable firmware auto provision in FXO gateway Configuration Enable Enable or disable configuration auto provision in FXO gateway DHCP Option 66 Get asc server address from option 66 DHCP ...

Page 68: ...d set the related logs on to scan the responding logs page For example set System Logs on like the following then you can turn to System page for system logs otherwise system logs are unavailable And the same with other log pages Figure 8 1 1 Logs Settings ...

Page 69: ...able SIP log Auto clean SIP logs switch on when the size of log file reaches the max size the system will cut a half of the file New logs will be retained switch off logs will remain and the file size will increase gradually DAHDI Logs Whether enable or disable DAHDI log Auto clean DAHDI logs switch on when the size of log file reaches the max size the system will cut a half of the file New logs w...

Page 70: ...System For this page you check systems logs as shown below Figure 8 2 1 System Logs Output Asterisk For this page you check Asterisk logs as shown below Figure 8 3 1 Asterisk Logs ...

Page 71: ...SIP For this page you check SIP logs as shown below Figure 8 4 1 SIP Logs DAHDI For this page you check DAHDI logs as shown below Figure 8 5 1 DAHDI Logs ...

Page 72: ...CDR You can scan every call detail records in this page We also provide the filter for you to search some specific records Figure 8 6 1 Call Detail Record ...