background image

iAG200/400 Series Analog Gateway User Manual

60

OpenVox Communication Co. ,LTD.

URL: www.openvox.cn

7. Advanced

7.1 Asterisk API

When you make “Enable” switch to “on”, this page is available.

Figure 7-1-1 API Interface

Table 7-1-1 Definition of Asterisk API

Options

Definition

Port

Network port number.

Manager Name Name of the manager without space.

Manager 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 char & 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 char & as separator.

Summary of Contents for iAG Series

Page 1: ...iAG200 400 Series Analog Gateway User Manual 1 OpenVox Communication Co LTD URL www openvox cn OpenVox Communication Co Ltd iAG200 400 Series Analog Gateway User Manual Version 1 0 ...

Page 2: ... F Tsinghua Information Port Book Building Qingxiang Road Longhua Street Longhua District Shenzhen Guangdong China 518109 Tel 86 755 66630978 82535461 82535362 Business Contact sales openvox cn Technical Support support openvox cn Business Hours 09 00 18 00 GMT 8 from Monday to Friday URL www openvox cn Thank You for Choosing OpenVox Products ...

Page 3: ...er OpenVox Inc 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 OpenVox has made every effort to ensure that the information contained in this document is accurate and complete however the contents of this document are subject t...

Page 4: ...iAG200 400 Series Analog Gateway User Manual 4 OpenVox Communication Co LTD URL www openvox cn Revise History Version Release Date Description 1 0 11 04 2022 First Version ...

Page 5: ...ormation 10 1 6 Software 10 2 System 11 2 1 Status 11 2 2 Time 11 2 3 Login Settings 12 2 4 General 14 2 5 Tools 15 2 6 Information 17 3 Analog 18 3 1 Channel Settings 18 3 2 Pickup 20 3 3 Dial Matching Table 21 3 4 Advanced 22 3 5 Special Function Keys 24 3 6 FXS Settings 25 3 7 Driver 27 4 VoIP 29 4 1 SIP Endpoints 29 4 2 FXS Batch Binding SIP 37 4 3 Batch Create SIP 38 4 4 Advanced SIP Settings...

Page 6: ...reate Rules 53 6 Network 54 6 1 Network Settings 54 6 2 VPN Settings 56 6 3 DDNS Settings 56 6 4 Toolkit 57 6 5 Security Settings 59 6 6 Security Rules 59 7 Advanced 60 7 1 Asterisk API 60 7 2 Asterisk CLI 62 7 3 Asterisk File Editor 63 7 4 Cloud Management 63 7 5 TR069 64 7 6 SNMP 65 7 7 Auto Provision 65 8 Logs 66 8 1 Log Settings 66 8 2 CDR 69 ...

Page 7: ...ed through AMI Asterisk Management Interface The iAG200 400 Analog Gateways are comprised of four models iAG200 S with 2 FXS ports iAG200 O with 2 FXO ports iAG400 S with 4 FXS ports iAG400 O with 4 FXO ports The iAG200 400 Analog Gateways are developed for interconnecting a wide selection of codecs including G 711A G 711U G 729A G 722 G 726 iLBC iAG200 400 use standard SIP protocol and compatible...

Page 8: ...below is appearance of iAG200 400 Series Analog Gateway Figure 1 3 1 Product Appearance Figure 1 3 2 Front Panel 1 Reset Button 2 Running Indicator 2 Power Indicator 3 Analog Telephone Interfaces and corresponding Channels State Indicators Figure 1 3 3 Back Panel 1 Power Interface 2 Ethernet Ports and Indicators 3 Analog Interface ...

Page 9: ...ain adjustment call transfer call hold call waiting call forward Caller ID display Three way calling Call transfer Dial up matching table Support T 38 fax relay and T 30 fax transparent FSK and DTMF signaling Support Ring cadence and frequency setting WMI Message Waiting Indicator Support Echo cancellation Jitter buffer Support customizable DISA and other applications SIP Features Support add modi...

Page 10: ...200 iAG400 Weight 160g 176g Size 125mm 85mm 28 7mm 150mm 100mm 28 7mm Temperature 20 70 C Storage 0 50 C Operation Operation humidity 10 90 non condensing Power source 12V DC 2A Max power 6W 8W 1 6 Software Default IP 172 16 99 1 Username admin Password admin Please enter the default IP in your browser to scan and configure the module you want Figure 1 6 1 Login Interface ...

Page 11: ...inition System Time Your gateway system time Time Zone The world time zone Please select the one which is the same or the closest as your city POSIX TZ String Posix time zone strings 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...

Page 12: ...ings You can set your gateway time Sync from NTP or Sync from Client by pressing different buttons 2 3 Login Settings Your gateway doesn t have administration role All you can do here is to reset what new username and password to manage your gateway And it has all privileges to operate your gateway You can modify both your Web Login Settings and SSH Login Settings If you have changed these setting...

Page 13: ...e Allowed characters _ 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 login HTTP Port Specify the web server port number HTTPS Port Specify the web server port number Port SSH login port number Figure 2 3 1 Login Settings Notice Whenever you do some chang...

Page 14: ...ch Advanced on then Download your current language package 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 2 4 2 Scheduled Reboot You can enable the automatic restart function to make your gateway restart after working for a certain period of time to achieve higher work efficienc...

Page 15: ...firm the restart the system will automatically end all current calls Table 2 5 1 Instruction of reboots Options Definition System Reboot The option will restart your gateway and cut off all current sessions Asterisk Reboot The option will restart Asterisk and cut off all current sessions 2 The analog gateway provides two firmware upgrade methods you can choose System Update or System Online Update...

Page 16: ...sion of the configuration file and the current firmware version are the same Figure 2 5 3 Upload and Backup 4 If you want to record the voice of the gateway you can choose Voice Record Choose the port which you want to record and then select Start Recording Figure 2 5 4 Voice Record 5 Sometimes there is something wrong with your gateway that you don t know how to solve it mostly you will select Fa...

Page 17: ...unication Co LTD URL www openvox cn 2 6 Information On the Information page there shows some basic information about the analog gateway You can see software and hardware version storage usage memory usage and some help information Figure 2 6 1 System Information ...

Page 18: ... Communication Co LTD URL www openvox cn 3 Analog You can see much information about your ports on this page 3 1 Channel Settings Figure 3 1 1 Channel System Click the Edit button to modify the corresponding port information Figure 3 1 2 FXO Port Configure ...

Page 19: ...iAG200 400 Series Analog Gateway User Manual 19 OpenVox Communication Co LTD URL www openvox cn Figure 3 1 3 FXS Port Configure ...

Page 20: ...the Time Out and Number parameters either globally or separately for each port The function is accessed by dialing a series of specific numbers provided that you enable this function and set the number parameter correctly Figure 3 2 1 Pickup Settings 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 ente...

Page 21: ...openvox cn 3 3 Dial Matching Table The dial matching table is used to effectively judge whether the received number sequence is complete so that it can be sent in time The correct use of the dial matching table can help shorten the turn on time of phone call Figure 3 3 1 Port Configure ...

Page 22: ...umber of seconds we attempt to dial the specified devices Tone duration How long generated tones DTMF and MF will be played on the channel in milliseconds Tone interval How long between tone and tone will be played on the channel in milliseconds Echo cancel Choose enable echo cancellation or not FXS signaling Default Loop start busy tone is generated Kewlstart power is off no busy tone is generate...

Page 23: ...cation Co LTD URL www openvox cn Table 3 4 4 Definition of Fax Options Definition Mode Set the transmission mode Rate Set the rate of sending and receiving Ecm Enable disable T 30 ECM error correction mode by default 3 4 3 Country Figure 3 4 5 Country Configuration ...

Page 24: ...s to be played when the receiving end is ringing Busy tone Set of tones played when the receiving end is busy Call waiting tone Set of tones played when there is a call waiting in the background 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 prog...

Page 25: ... ring which means the caller ID needs to be set later on and not just after the first ring as per the default 1 Waiting time before sending CID How long we will waiting before sending the CID on the channel in milliseconds Flash Wink Turn on off Flash Wink Min flash time Min flash time in milliseconds Range 1 100 Max flash time Max flash time in milliseconds Range 100 3000 as Ending Dial Key Turn ...

Page 26: ...penvox cn Figure 3 6 2 Other Parameters Table 3 4 2 Definition of Other Parameters Options Definition Offhook antishake The anti jitter delay value when the gateway FXS port detects the off hook signal The setting value is from 32ms to 2048ms multiple of 32 and the default value is 64ms ...

Page 27: ...nication Co LTD URL www openvox cn 3 7 Driver 3 7 1 General Figure 3 7 1 General Table 3 7 1 Definition of General Options Definition Codec Set the global encoding ulaw alaw Impedance Configuration for impedance 3 7 2 CallerID Detect Figure 3 7 2 CallerID Detect ...

Page 28: ...ream header length byte size fixedtimepolarity Transmit polarity line reversal signal delay time 3 7 3 Hardware Gain Figure 3 7 3 Hardware Gain Table 3 7 3 Instruction of Hardware gain Options Definition 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 FXS Rx gain Set FXS to IP gain Range 35 0 or 35 th...

Page 29: ... and if you want to modify existed endpoints you can click Edit button 4 1 1 Main Endpoint Settings There are 3 kinds of registration types for choose You can choose None Client or Server You can configure as follows 1 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 Rout...

Page 30: ...able 4 1 1 Definition of Endpoint Settings Options Definition Name A name which is able to read And it s only used for user s reference Username Username for authentication between the endpoint and the gateway Allowed characters _ 0 9a zA Z Length 1 32 characters Password The password for authentication between the endpoint and the gateway allowing letters Registration None Anonymous registration ...

Page 31: ... TLS the transmission type enabled for the first time is only used for outgoing messages until registration occurs If the endpoint requires another transmission type during the registration process the first transmission type may be changed to another transmission type NAT Traversal Addresses NAT related issues in incoming SIP or media sessions No Use Rport if the remote side says to use it Force ...

Page 32: ...his local extension Register User The register username is the user in register user secret authuser host port extension From User A username to identify the gateway to this endpoint From Domain A domain to identify the gateway to this endpoint Qualify Whether or not to check the endpoint s connection status Qualify Frequency How often in seconds to check the endpoint s connection status Outbound ...

Page 33: ...fo SIP INFO message application dtmf relay Inband Inband audio require 64kbit codec alaw ulaw Call Limit Setting a 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 Rem...

Page 34: ...Overlap Dialing Whether or not to allow overlap dialing Disabled by default Append user phone to URI Whether or not to add user phone to URIs that contain a valid phone number Add Q 850 Reason Headers Whether or not to add Reason header and to use it if it is available Honor SDP Version By default the gateway will honor the session version number in SDP packets and will only modify the SDP session...

Page 35: ... in peers or users Default is enabled Allow Promiscuous Redirects Whether or not to allow 302 or REDIR to non local SIP address Note that promiscredir when redirects are made to the local system will cause loops since this gateway is incapable of performing a hairpin call Max Forwards Setting for the SIP Max Forwards header loop prevention Send TRYING on REGISTER Send a 100 Trying when the endpoin...

Page 36: ...all Setup Timer If a provisional response is not received 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...

Page 37: ...on of Media Settings Options Definition Media Settings Select codec from the drop down list Codecs should be different for each Codec Priority 4 2 FXS Batch Binding SIP If you want to bind sip accounts in batches on the FXS port you can configure this page Notice this is only used when Client work mode Figure 4 2 1 FXS Batch Binding SIP ...

Page 38: ...teway User Manual 38 OpenVox Communication Co LTD URL www openvox cn 4 3 Batch Create SIP On this interface users can create multiple SIP accounts at one time You can choose any registration mode Figure 4 3 1 Batch SIP Endpoints ...

Page 39: ...um number of seconds a client has to authenticate If the client does not authenticate before this timeout expires 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...

Page 40: ... of the test_stun_monitor module the gateway has the ability to detect when the perceived external network address has changed When the stun_monitor is installed and configured chan_sip will renew all outbound registrations when the monitor detects any sort of network change has occurred By default this option is enabled but only takes effect once res_stun_monitor is configured If res_stun_monitor...

Page 41: ... external hostname and optional TCP port of the NAT External Hostname hostname port is similar to External Address Examples External Hostname foo dyndns net Hostname Refresh Interval How often to perform a hostname lookup This can be useful when your NAT device lets you choose the port mapping but the IP address is dynamic Beware you might suffer from service disruption when the name server resolu...

Page 42: ...cn 4 4 4 RTP Settings Figure 4 4 4 Definition of RTP Settings Table 4 4 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 43: ...iAG200 400 Series Analog Gateway User Manual 43 OpenVox Communication Co LTD URL www openvox cn 4 4 5 Parsing and Compatibility Figure 4 4 5 Definition of Parsing and Compatibility ...

Page 44: ...rackets For example the caller id value 555 5555 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 Maximum Registration Expiry Maximum allowed time of incoming registrations and subscriptions seconds Minimum Registration Ex...

Page 45: ...globally unique according to RFC 3261 Set this to your host name or domain name Use Domain as Realm Use the domain from the SIP Domains setting as the realm In this case the realm will be based on the request to or from header and should match one of the domain Otherwise the configured realm value will be used Always Auth Reject When an incoming INVITE or REGISTER is to be rejected for any reason ...

Page 46: ...out there by enabling them in the default context Premature Media Some ISDN links send empty media frames before the call is in ringing or progress state The SIP channel will then send 183 indicating early media which will be empty thus users get no ring signal Setting this to yes will stop any media before we have call progress meaning the SIP channel will not send 183 Session Progress for early ...

Page 47: ...ecure connection On the other hand it also can be registered as a client upload the key files provied by the server Figure 4 5 1 TLS settings Table 4 5 1 Instruction of TLS Options Definition TLS Enable Enable or disable DTLS SRTP support TLS Verify Server Enable or disable tls verify server default is no Port Specify the port for remote connection TLS Client Method Values include tlsv1 sslv3 sslv...

Page 48: ...and each routing rule supports up to 100 pairs of calling called number filtering and conversion operations It support DID function The gateway supports trunk group and trunk priority management 5 1 Call Routing Rules Figure 5 1 1 Routing Rules Click Add you can set up a new routing rule Click Edit to modify the routing rule and click Delete to delete the routing rule Figure 5 1 2 Example of Setup...

Page 49: ...he type of match usually used to describe for example sip1 TO port or port1 TO sip1 Call Is From Source of the call Call Delivery The destination to receive the incoming calls DISA Timeout The specific setting time of DISA timeout Maximum Number of Digits In Password Set the maximum number of password digits Password Set a password within the specified range Figure 5 1 3 Advance Routing Rule ...

Page 50: ...added before being sent to the trunk Prefix Removed when the pattern is matched successfully The dialed number is matched with the pattern specified in the subsequent column Once the match is successful the prefix will be removed from the number before being sent to the trunk Match Pattern The dialed number will be compared with the number in the prefix this matching pattern Once the match is succ...

Page 51: ...n Co LTD URL www openvox cn that will use this Route Forward Number What destination number will you dial This is very useful when you have a transfer call Failover Call Through Number The gateway will attempt to send the call out each of these in the order you specify ...

Page 52: ...have to check which port is free That would 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 the Add button to set up a new group if you want to modify an existing group you can click the Edit button Figure 5 2 2 Create a G...

Page 53: ...n Group Name The name of this route Should be used to describe what types of calls this route matches for example sip1TOport1 or port1TOsip2 5 3 Batch Create Rules 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 54: ...Network Settings There are three types of LAN port IP to choose from Factory Static and DHCP The default type is factory the default IP is 172 16 99 1 If you forget the current IP you can connect the phone to any FXS port of the analog gateway and dial to query the current IP Figure 6 1 1 LAN Settings Interface ...

Page 55: ...obtain the gateway IP address Address The IP address of your gateway Netmask The subnet mask of your gateway Default Gateway Default getaway IP address Reserved Access IP List of domain name server IP addresses This information is mainly obtained from the local network service provider Enable Enable or disable the reserved IP address switch ON enabled OFF disabled Reserved Address The reserved IP ...

Page 56: ...ient configuration file or fill in PPTP VPN account information If successful you can see a VPN virtual network card on the system status page You can refer to the parameter hints and sample configuration Figure 6 2 1 VPN Interface 6 3 DDNS Settings You can enable or disable DDNS Dynamic Domain Name Server according to your needs Figure 6 3 1 DDNS Interface ...

Page 57: ...amic domain name 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 6 4 Toolkit This tool is used to detect the network connection you can execute the Ping command on the web interface Figure 6 4 1 Network Connectivity Checking Figure 6 4 2 Channel Recording ...

Page 58: ...ition Interface The name of network interface Source host Specify the source address of the data you want to get Destination host Specify the destination address you want to get data from Port Specify the port where you want to get data Channel Specify the channel number you want to get data Tcpdump Option Parameter The tool of tcpdump capture network data by parameter option specified ...

Page 59: ...400 Series Analog Gateway User Manual 59 OpenVox Communication Co LTD URL www openvox cn 6 5 Security Settings Figure 6 5 1 Security Settings Interface 6 6 Security Rules Figure 6 6 1 Security Rules Interface ...

Page 60: ...on of Asterisk API Options Definition Port Network port number Manager Name Name of the manager without space Manager 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 char 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 ...

Page 61: ...t yet used Command Permission to run CLI commands Write only Agent Information about queues and agents and ability to add queue members 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 Ne...

Page 62: ...owed to run Asterisk commands Figure 7 2 1 Asterisk Command Interface For example enter help or in the command bar after execution the page will prompt for executable commands as shown in the figure above Table 7 2 1 Definition of Asterisk CLI Options Definition Command Type your Asterisk CLI commands here to check or debug your gateway ...

Page 63: ...www openvox cn 7 3 Asterisk File Editor On this page you are allowed to edit and create configuration files Figure 7 3 1 Configuration Files List Notice After modifying the configuration file Asterisk needs to be reloaded 7 4 Cloud Management Figure 7 4 1 Cloud Management Interface ...

Page 64: ...iAG200 400 Series Analog Gateway User Manual 64 OpenVox Communication Co LTD URL www openvox cn 7 5 TR069 Figure 7 4 1 TR069 Interface ...

Page 65: ...iAG200 400 Series Analog Gateway User Manual 65 OpenVox Communication Co LTD URL www openvox cn 7 6 SNMP Figure 7 4 1 SNMP Interface 7 7 Auto Provision Figure 7 4 1 Auto Provision Interface ...

Page 66: ...n Co LTD URL www openvox cn 8 Logs 8 1 Log Settings On the log setting interface open the corresponding log option and you can view different logs in the corresponding interface Take the system log as an example Figure 8 1 1 Logs Settings Figure 8 1 2 System Logs Output ...

Page 67: ...ogs Whether to enable the system log Auto clean System 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 default on max size 1MB Verbose Asterisk console verbose message switch Notice Asterisk console notice message switch Warning Asterisk console warni...

Page 68: ...radually default on max size 100KB SIP Logs Whether to enable the 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 default on default size 100KB Call Detail Record Displaying Call Detail Records for each channel Auto clean Call D...

Page 69: ...er Manual 69 OpenVox Communication Co LTD URL www openvox cn 8 2 CDR You can browse the details of each call record on this page If you need to search for a specific record you can use the filter function Figure 8 3 1 Call Detail Record ...

Reviews: