Page 1
GSM/3G Gateway User Manual Address: 10/F, Building 6-A, Baoneng Science and Technology Industrial Park, Longhua New 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 1 | 82...
Page 2
GSM/3G User Manual Version1.0 (2016-05-12) Full text The overall layout adjustment 2 | 82...
Page 3
Information contained herein is of a highly sensitive nature and is confidential and proprietary to OpenVox Inc. No part may be distributed, reproduced or disclosed orally or in written form to any party other than the direct recipients without the express written consent of OpenVox Inc.
GSM/3G User Manual Contents 1. Overview ........................6 What is GSM/3G Gateway? ..................6 Sample Application ....................7 Main Features ...................... 9 Physical Information..................... 10 Software ....................... 10 How to do Cluster?....................10 2. System ........................13 Status........................13 Time ........................15 Login Settings .......................
Page 5
GSM/3G User Manual Groups ........................56 MNP Settings ......................57 6. SMS .......................... 58 General ......................... 58 Sender Options .................... 58 SMS to Email ....................58 SMS Control....................60 HTTP to SMS ....................62 SMS to HTTP ....................62 SMS Sender ......................62 SMS Inbox ......................
Gateway. Also secondary development can be completed through AMI (Asterisk Management Interface). OpenVox GSM/3G Gateways have 4 models: WGW1002G, VS-GW1202, VS-GW1600 and VS-GW2120. VS-GW1002 suports 2 GSM Channels. VS-GW1202 supports 4/8 GSM/3G channels. VS-GW1600 support up to 20 GSM/3G channels. VS-GW2120 supports up to 44 GSM/3G channels.
GSM/3G User Manual Sample Application Figure 1-1 TopologicalGraph Product Appearance Figure 1-2 Product Appearance of GSM Figure 1-3 Front Panel of GSM Network Data Switch Board: ETH1, ETH2. ETH1: Access Board 1 only, provide proxy access to other boards with different port numbers which can avoid IP conflict.
Page 8
GSM/3G User Manual Figure 1-5 Front Panel of 3G Network Data Switch Board: ETH1, ETH2, ETH3. ETH1: Access Board 1 only, provide proxy access to other boards with different port numbers which can avoid IP conflict. ETH2: Access different Boards with different IP address. ...
GSM/3G User Manual Cluster: A single IP address manages up to 5 GSM modules (up to 20 ports). Default IP: 172.16.99.1 Figure 1-6 Front Panel Figure 1-5 LED Indicator Main Features Modular and VoxStack design Based on Asterisk® ...
Default IP: 172.16.99.1 Username: admin Password: admin For first time, you can access WGW1002G using default IP 172.16.99.1. Then configure the module as you want. For VS-GW2102, VS-GW1600, VS-GW2120 series of GSM/3G gateway, every VS- GWM400G/W is independent with each other. There are two RJ45 Network ports: ETH1 and ETH2.
Page 11
GSM/3G User Manual Figure 1-7 Automatic Cluster If you want to choose Manual Cluster, you should switch Detail on first. There are 3 kinds of cluster mode: stand-alone, Master and Slave. Stand-alone Mode: Run alone, total 4 ports. Master Mode: Run as master with two different IP, controlling up to 10 slaves.
Page 12
GSM/3G User Manual Notice: Log in Figure 1-8 LOG Interface 12 | 82...
GSM/3G User Manual 2. System Status On the “Status” page, you will find all GSM, SIP, IAX2, Routing, Network information and status. Figure 2-1 System Status 13 | 82...
Page 14
GSM/3G User Manual Table 2-1 Description of System Status Options Definition Port Number of GSM ports. GSM ports begin with "gsm-", such as gsm- 1.1; 3G ports begin with "umts-", such as umts-2.1. Signal Display the signal strength of in each channels of GSM. Bit Error Rate.
GSM/3G User Manual Time Table 2-2 Description of Time Settings: Options Definition 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.
GSM/3G User Manual Figure 2-2 Time Settings You can set your gateway time Sync from NTP or Sync from Client by pressing different buttons. 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.
GSM/3G User Manual Port Specify the web server port number. Figure 2-3 Login Settings Notice: Whenever you do some changes, do not forget to save your configuration. General Language Settings You can choose different languages for your system. If you want to change language, you can switch “Advanced”...
GSM/3G User Manual 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-5 Reboot Types If use your system frequently, you can set this enable, it can helps system work more efficient.
GSM/3G User Manual Figure 2-7 Reboot Tools If you press "OK", your system will reboot and all current calls will be dropped. Asterisk Reboot is the same. Update Firmware We offer 2 kinds of update types for you, you can choose System Update or System Online Update.
GSM/3G User Manual Restore Configuration 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-11 Restore Configuration Information On the “Information”...
GSM/3G User Manual 3. MODULE You can see much information about your SIM cards on this page. MODULE Settings Figure 3-1 GSM/UTMS Settings On this page, you can see your GSM module status and click action button to configure the port. 21 | 82...
Page 22
GSM/3G User Manual Figure 3-2 Port Configuration As you see, we have offered “Band” option, you can select different bands easily and you have many options. Figure 3-3 Band Binding If you have set your Pin Code, you can check on like this: Figure 3-4 PIN Code Application Then input your password, system will identify numbers of SIM cards.
GSM/3G User Manual OpenVox GSM/3G gateway support optional GSM Voice Codec. See picture below. Figure 3-6 GSM Voice Codec IMEI Modification One more feature, we offer you IMEI automatically modification Figure 3-7 Automatically IMEI Modify We have offered you IMEI modification function. If you want to modify your IMEI number, please do as follows.
Page 24
GSM/3G User Manual Then you will see the following picture. Don’t forget to switch “Enable” to “ON”, or you can’t change your IMEI numbers. Figure 3-8 IMEI Modification Also you can choose to modify one or more certain ports or all ports. You can set automatic modification interval by filling in the time you want.
Page 25
GSM/3G User Manual Figure 3-10 Manual After configuration, you can press “Back Home” to return your gateway interface. Table 3-1 Definition of GSM Settings Options Definition Name The alias of the GSM port. Input name without space here. Allowed characters "-_+.<>&0-9a-zA-Z".Length: 1-32 characters.
GSM/3G User Manual User custom AT commands when start system, use “|” to split Custom AT commads when AT command. start CLIR Caller ID restriction, this function is used to hidden caller ID of SIM card number. The gateway will add ‘#31#’ in front of mobile number.
Page 27
GSM/3G User Manual Figure 3-12 Call Duration Limitation Settings The same algorithm with single time limitation, the total calling time of this port can’t beyond the product of “Step” and “Call Duration Limitation”. If the duration of a call is less than “Minimum Charging Time”, it will be not included in “Call Duration”.
Page 28
GSM/3G User Manual This function is to limit the total call duration of GSM channel. Enable Call The max call duration is between 1 to 65535 minutes. Duration Limitation Call Duration The value of limitation single call, this value range is 1-65535. Limitation Step length multiplied by time of single call just said a single call duration time allowed.
GSM/3G User Manual Figure 3-15 GSM/UMTS Information Call Forwarding Sometimes it’s not convenient for you to answer a call, if you don’t want to lose some important calls, you can choose Call Forwarding. You can choose Call Forwarding Unconditional, Call Forwarding No Reply, Call Forwarding Busy or Call Forwarding on Not Reachable.
GSM/3G User Manual Call Waiting You can turn on/off the call waiting function of the sim cards in the ports on this page. Description of Table3-3 Call Waiting Options Definition Turn on call choose the ports you want to set, select "On", then click waiting "Settings"...
Page 31
GSM/3G User Manual Figure 3-18 DTMF Detection Settings If you don’t have special need, you don’t have to modify these settings. You can Notice: just choose “Default”. Description of Table3-4 DTMF Detection Settings Options Definition It is the difference in power between the row and column DTMF Normal energies.
GSM/3G User Manual BCCH Figure 3-19 BCCH setting You can click button, and you can change the BCCH Mode as bellow. Figure 3-20 BCCH Mode Toolkit You can get USSD information, send AT command and check number with this module. When you have a debug of the GSM module, AT command is useful.
Page 33
GSM/3G User Manual Figure 3-21 Function Options Description of Table3-5 Definition of Functions Options Definition Enter a known number (like your mobile phone) to check what Check Number number it is of the SIM card. Click "Execute", then the gateway will dial to the number you already input.
Page 34
GSM/3G User Manual Figure 3-22 AT Command Example 34 | 82...
GSM/3G User Manual 4. VOIP VOIP Endpoints This page shows everything about your SIP&IAX2, you can see status of each SIP&IAX2. Figure 4-1 SIP&IAX2 Endpoints Add New SIP Endpoint Main SIP Endpoint Settings You can click button to add a new SIP endpoint, and if you want to modify existed endpoints, you can click button.
Page 36
GSM/3G User Manual Figure 4-2 None Registration For convenience, we have designed a method that you can register your SIP endpoint to your gateway, thus your gateway just work as a server. Figure 4-3 Sever Also you can choose registration by “This gateway registers with the endpoint”, it’s the same with “None”, except name and password.
Page 37
GSM/3G User Manual Figure 4-4 Client table 4-1 Definition of SIP Options Options Definition Name Display name Username Register name in your SIP server Password Authenticating with the gateway and characters are allowed. Registration None --- Not registering; Endpoint registers with this gateway --- When register as this type, it means the GSM gateway acts as a SIP server, and SIP endpoints register to the gateway;...
Page 38
GSM/3G User Manual TLS. The first enabled transport type is only used for outbound messages until a Registration takes place. During the peer Registration, the transport type may change to another supported type if the peer requests so. No --- Use Rport if the remote side says to use it. Traversal Force Rport on --- Force Rport to always be on.
Page 39
GSM/3G User Manual DTMF Mode Set default DTMF Mode for sending DTMF. Default: rfc2833. Other options: 'info', SIP INFO message (application/dtmf-relay); 'Inband', Inband audio (require 64kbit codec -alaw, ulaw). Trust Remote- Whether or not the Remote-Party-ID header should be trusted. Party-ID Send Remote- Whether or not to send the Remote-Party-ID header.
Page 40
GSM/3G User Manual Allow Whether or not to allow 302 or REDIR to non-local SIP address. Promiscuous Note that promiscredir when redirects are made to the local Redirects system will cause loops since this gateway is incapable of performing a "hairpin" call. ...
GSM/3G User Manual Main IAX2 Endpoint Settings You can click button to add a new IAX2 endpoint, and if you want to modify existed endpoints, you can click button. There are 3 kinds of registration types for choose. You can choose None, Endpoint registers with this gateway(work as a Server) or This gateway registers with the endpoint(work as a Client).
Page 42
GSM/3G User Manual Figure 4-6 Endpoint Register With this Gateway Also you can choose registration by “This gateway registers with the endpoint”, it will work as a Client. Figure 4-7 This Gateway Register With the Endpoint 42 | 82...
Page 43
GSM/3G User Manual Table 4-6 Definition of IAX2 Options Options Definition Name Display name Username Authenication name in your IAX2 server Password Authenticating with the gateway and characters are allowed. Registration None --- Not registering; Endpoint registers with this gateway --- When register as this type, it means the GSM/3G gateway acts as a IAX2 server, and IAX2 endpoints register to the gateway;...
Page 44
GSM/3G User Manual Advanced:Registration Options Table 4-7 Definition of Registration Options Options Definition Qualify, Qualify The qualify, qualifyfreqok and qualifyfreqnotok settings are used Freq Ok, Qualify to determine the status availability of an IAX peer. If a peer is Freq Not Ok consdered to be in a reachable (OK or LAGGED) state, it is queried for availability every "qualifyfreqok"...
GSM/3G User Manual Defaults to 128000 bytes, which supports up to 800; calls of Trunk Max Size ulaw at 20ms a frame. With a large amount of traffic on IAX2 trunk, there is a risk of Trunk MTU bad voice quality when allowing the Linux system to handle fragmentation of UDP packets.
Page 46
GSM/3G User Manual The maximum number of seconds a client has to Authentication Timeout authenticate. If the client does not authenticate before this timeout expires, the client will be disconnected.(default value is: 30 seconds). The maximum number of unauthenticated sessions that will be allowed to connect at any given time (default is: 50).
GSM/3G User Manual Match Only substitute the externaddr or externhost setting if it External Address matches. Locally Disallow all dynamic hosts from registering as any IP Dynamic address used for statically defined hosts. This helps avoid the Exclude Static configuration error of allowing your users to register at the same address as a SIP provider.
GSM/3G User Manual 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 Maximum allowed time of incoming registrations and Expiry...
GSM/3G User Manual instead of 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. ...
GSM/3G User Manual Codec Settings Select codecs from the list below. Figure 4-8 Codec Settings Advanced IAX2 Settings Table 4-16 Instruction of General Options Definition Bind Port Bind port and bindaddr may be specified Enable IAXCompat More than once to bind to multiple addresses, but the first will be the default.
Page 51
GSM/3G User Manual yes, then we cancel the whole thing(that’s enough time for one retransmission only ).This is used to keep things from stalling for a long time for a host that is not available for bad connections. Language You may specify a global default language for users. This can be specified also on a per-user basis.
Page 52
GSM/3G User Manual continue over a few frames, it will resync, assuming that the change in delay was caused by a timestamping mix-up. The threshold for noticing a change in delay is measured as twice the measured jitter plus this resync threshold. Max Jitter Interps The maximum number of interpolation frames the jitter buffer should return in a row.
GSM/3G User Manual 5. Routing Figure 5-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, click button to edit the routing and to delete it.
Page 54
GSM/3G User Manual Figure 5-2 Example of Set up Routing Rule The figure above realizes that calls from “1001” SIP endpoint switch you have registered will be transferred to Port-1. When “Call Comes in From” is T1/E1 Port, “prepend”, “prefix” and “match pattern” in “Advanced Routing Rule” are ineffective, and just “CallerID”...
Page 55
GSM/3G User Manual Table5-1 Definition of Routing Options Options Definition The name of this route. Should be used to describe what Routing Name types of calls this route matches (for example, 'SIP2GSM' or 'GSM2SIP'). The launching point of incoming calls. Call Comes in From Send Call Through The destination to receive the incoming calls.
GSM/3G User Manual The above special matching sequences can be used for CallerID matching similar to other number matches. Set the Caller What caller ID name would you like to set before sending this ID Name to call to the endpoint. ...
GSM/3G User Manual product, you don’t need to worry about it. You can combine many GSM or SIP to groups. Then if you want to make a call, it will find available port automatically. Figure 5-5 Routing Group MNP Settings Mobile Number Portability allows switching between mobile phone operators without changing the mobile number.
SMS to Email This is a tool that makes it available for you to email account to transmit the SMS to other email boxes. The following settings realize that received SMS through openvpnvoip@gmail.com transmit to openvpnvoip@yahoo.com.cn, openvpnvoip@hotmail.com support@openvox.cn 58 | 82...
Page 59
GSM/3G User Manual Figure 6-3 SMS to Email Table6-2 Types of E-mail Box E-mail Box SMTP Server SMTP SMTP Security Type Port Connectivity √ Gmail smtp.gmail.com √ HotMail smtp.live.com Yahoo! smtp.mail.yahoo.co.in × e-mail smtp.163.com × Table6-3 Definition of SMS to E-mail Options Definition Enable...
Password TLS Enable When you choose Yahoo and 163 free e-mails, this option is not available. SMTP Server To set outgoing mail server. e.g. mail.openvox.cn. Destination The first email address to receive the inbox message. Email Address1 Destination The second email address to receive the inbox message.
Page 61
GSM/3G User Manual Figure 6-4 SMS Control For example, SMS control password is 123456789 which has nothing to do with the login password, you can send “get info 123456789” to the GSM module’s phone number to get your gateway’s IP information. Table6-4 Definition of SMS Control Options Definition...
GSM/3G User Manual HTTP to SMS Figure 6-5 HTTP to SMS SMS to HTTP Figure 6-6 SMS to HTTP setting SMS Sender You can choose one or more ports to send SMS to the destination number, different numbers should be separated by symbols: '\r', '\n', space character, semicolon and comma.
GSM/3G User Manual Figure 6-7 SMS Sender SMS Inbox On this page, you are allowed to scan, delete, clean up, and export each port’s received SMS. Also you are allowed to check messages by port, phone number, time order and message keywords.
GSM/3G User Manual SMS Outbox On this page, you are allowed to scan, delete, clean up, and export each port’s received SMS. Also you are allowed to check messages by port, phone number, time order and message keywords. Figure 6-9 SMS Outbox SMS Forwarding Using this feature, you can forward incoming sms to your mobile.
Page 65
GSM/3G User Manual Figure 6-10 Create a routing For "ascending" Policy, if you choose 2 or more ports members, it will use first available port to transfer sms. For this case, if umts-2.1 is availble, it will always use umts-2.1 to trnasfer sms;...
GSM/3G User Manual 7. Network On “Network” page, there are three sub-pages: “LAN Settings”, “DDNS Settings”, and “Toolkit”. Network Settings There are three types of WAN/LAN port 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.
GSM/3G User Manual Table7-1 Definition of LAN Settings Options Definition Interface The name of network interface. The method to get IP. Factory: Getting IP address by Slot Type Number (System information to check slot number). Static: manually set up your gateway IP.
GSM/3G User Manual Table7-2 Definition of DDNS Settings Options Definition Enable/Disable DDNS(dynamic domain name server) DDNS Type Set the type of DDNS server. Your DDNS account’s login name. Username Your DDNS account’s password. Password Your domain The domain to which your web server will belong. Toolkit It is used to check network connectivity.
GSM/3G User Manual To disable ping or not. OFF: disable ping. This gateway will Ping Enable not allow to ping. Figure 7-4 Firewall Setting White List Settings White List Enbale: To enable white list or not. List IP Settings: IPs are separated only by "," character. Click "Save"...
Page 70
GSM/3G User Manual Figure 7-5 Firewall Rules Apply If you see windows like below. It means your configuration has been applied successfully. Figure 7-6 Firewall Rules Apply 70 | 82...
GSM/3G User Manual Security Rules Figure 7-7 Security Rules Click "submit" button to submit and apply configuration. If "List IP Settings" has no problem, you will see popup window like below. Please read the warning and tips carefully. And Click "Apply" button in 1 minute. If time runs out, this window will close automatically.
GSM/3G User Manual 8. Advanced Asterisk API When you make “Enable” switch to “ON”, this page is available. Figure 8-1 Asterisk API Interface Table8-1 Definition of Asterisk API Options Definition 72 | 82...
Page 73
GSM/3G User Manual Port Network port number Name of the manager without space Manager Name Password for the manager. Characters: Allowed characters Manager secret “-_+.<>&0-9a-zA-Z”. Length:4-32 characters. If you want to deny many hosts or networks, use char & Deny as separator.
GSM/3G User Manual Once you set like the above figure, the host 172.16.100.110/255.255.0.0 is allowed to access the gateway API. Please refer to the following figure to access the gateway API by putty. 172.16.179.1 is the gateway’s IP, and 5038 is its API port. Figure 8-2 Putty Access Gateway API Asterisk CLI In this page, you are allowed to run Asterisk commands.
Page 75
GSM/3G User Manual Figure 8-4 Asterisk File Editor Click “New Configuration File” to create a new configuration file. After editing or creating, please reload Asterisk. 75 | 82...
GSM/3G User Manual 9. Logs On the “Log Settings” page, you should 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 is unavailable. And the same with other log pages.
Page 77
GSM/3G User Manual You can choose one specific board to see it related logs. Figure 9-3 Choose One Board You can scan your CDR easily on web GUI, and also you can delete, clean up or export your CDR information. Figure 9-4 CDR Output Recently we have made our LOGS display richer, you can see your GSM Outbound of every port clearly.
Page 78
GSM/3G User Manual Asterisk console notice message switch. Notice Asterisk console warning message switch. Warning Asterisk console debug message switch. Debug Error Asterisk console error message switch. DTMF Asterisk console DTMF info switch. switch on : when the size of log file reaches the max size, the Auto clean (asterisk system will cut a half of the file.
GSM/3G User Manual Appendix Feature List General Info Size: VS -GW21(GSM) 48.3cm*33.1cm*8.8cm VS-GW1600(GSM) 44cm*4.5cm*30cm VS-GW1202(GSM) 15cm*19cm*4.5cm WGW1002G 16cm*10.1cm*3.1cm VS-GW2120(3G) 44cm*34cm*9cm VS-GW1600(3G) 44cm*4.5cm*30cm VS-GW1202(3G) 15cm*19cm*4.5cm VS-GW1002: 2 GSM channels VS-GW1202: 4/8 GSM/UMTS channels VS-GW1600: up to 20 GSM/UMTS channels VS-GW2120: up to 44 GSM/UMTS channels ...
Page 80
GSM/3G User Manual PIN Identification IMEI Number Automatically Modify Band Binding Bind Carrier Optional GSM/UMTS Voice Codec Call Waiting Call Forwarding (unconditional, no reply, busy, not reachable) GSM/UMTS Ports Group Management SMS Bulk Transceiver, Sent to Email and Automatically Resend ...
Page 81
GSM/3G User Manual System Features Abundant Codecs:G.711A, G.711U, G.729, G.722, G.723, G.726, GSM Simple and convenient configuration via Web GUI Firmware Update by HTTP Automatically Reboot Extensible Automatic Callback and Speed Dial TTL Serial Port and Virtual Serial via TCP/IP Protocol ...