ATCOM IPPBX IP04 User manual

www.atcom.cn
1/35
IP-04 User Manual

www.atcom.cn
2/35
Version
Date
Author
Description
1.0
2008-April-19
Edwin
Creation
1.1
2008-Jul-11
Edwin
Interlink, backup

www.atcom.cn
3/35
1. Introduce................................................................................................................5
1.1 Related Hardware and software ....................................................................................5
1.2 System set up ................................................................................................................6
2. Install IP04 and make internal calls....................................................................7
2.1 Install IP04....................................................................................................................7
2.2 Ways to Access IP04 .....................................................................................................7
2.3 Add extensions..............................................................................................................8
2.4 Register SIP device .......................................................................................................9
2.5 Add Zap extensions.....................................................................................................10
2.6 Voice Mail Box ...........................................................................................................11
2.7 Voice Mail to Email ....................................................................................................11
3. Make outbound call ............................................................................................12
3.1 Make call via PSTN trunk...........................................................................................12
3.2 Make call via VoIP trunk.............................................................................................14
4. Add Incoming Call operator..............................................................................15
4.1 Multiple FXO incoming calls to one extension...........................................................15
4.2 Ring another extension if operator doesn‟t answer .....................................................16
4.3 Time Base Rule...........................................................................................................17
5. IVR.......................................................................................................................17
5.1 Add Greeting Menu.....................................................................................................17
5.2 Route incoming route to greeting menu......................................................................19
5.3 Record your voice.......................................................................................................19
6. DISA.....................................................................................................................21
7. Ring Group..........................................................................................................22
8. Link two IP04 in different office........................................................................23
8.1 Link two IP04 in the same network. ...........................................................................23
8.2 Link two IP04 in different offices...............................................................................26
FAQ:............................................................................................................................28
HOWTO -- Do files transfer for IP04? ...................................................................................28
HOWTO -- Change SSH password?.......................................................................................28
HOWTO -- Custom your music on hold?...............................................................................28
HOWTO -- Upgrade the software packages of IP04?.............................................................28
HOWTO -- Set correct country setting for IP04? ...................................................................28
HOWTO -- Set system time?..................................................................................................29
HOWTO -- Change the IP address of IP04? ...........................................................................31
HOWTO -- Backup the files of IP04?.....................................................................................32
HOWTO -- Upgrade the kernel of IP04?................................................................................33

www.atcom.cn
4/35

www.atcom.cn
5/35
1. Introduce
This Article
This article is a guide to use IP04 and ATCOM products to build a simple application on small
office application. Through this article, we hope that readers can build the IP PBX solution via
IP04 for small enterprise
IP04
The IP04 is an open source embedded IP PBX system. It runs uClinux and Asterisk and has a big
advantage on its inherent open source and ultra low power consumption ( <5 watt in idle state,
environment friendly).
BAPS
BAPS stands for Blackfin Asterisk Package System. Software in Baps system is installed on run
time rather than build time. Basically we only need to maintain a kernel with basic functions
installed. Different applications (zaptel, asterisk, ntp .etc) are built in different packages and
maintain in a remote server. We only need to use some simple commands like:
root:~> ipkg install PACKAGE_NAME to install the needed package
root:~> ipkg remove PACKAGE_NAME to remove the useless package
root:~> ipkg update to check the up to date package list
1.1 Related Hardware and software
IP04 IP PBX: Open source IP PBX, support four interchangeable FXO/FXS ports.
AX-110S: FXS module of IP04
AX-110X: FXO module of IP04
AT-530: Stand along IP phone, can be configured as SIP/IAX2 extensions.
X-lite:Softphone run on the PC, can be configured as SIP extensions.
Normal phone: Connect to IP04, act as ZAP extensions.

www.atcom.cn
6/35
1.2 System set up
Following devices are used in the structure:
1: IP04 with 2 FXO 2 FXS port loaded: Port 1 and Port2 are configured to FXO ports. Port 3
and port 4 are configured as FXS port. The FXO port is used to connect to PSTN while FXS port
is used to connect to your normal phone.
2: Normal phone: connect to the IP04 FXS ports.
3: Working PC, x-lite runs on this computer act as a sip extension.
4: AT-530 IP phone, register to IP04 to act to as SIP or IAX2 extension.
We want to provide below function in our simple application.
1: free internal call.
2: Voice Mail.
3: make out bound call
4: IVR system.
We will implement these functions step by step.

www.atcom.cn
7/35
2. Install IP04 and make internal calls
2.1 Install IP04
Simply connect the power cable and Ethernet cable to IP04, make sure that the IP04 connects to
your local network. The port configuration of IP04 are fxo for port1,2 and fxs for port3,4 as show
below:
2.2 Ways to Access IP04
There are two ways to access the IP04 : Web or SSH.
Web:
Use Web browser to open the GUI of IP04.
Default IP address: 192.168.1.100
Default username/password: admin/mysecret
IP04 doesn‟t support IE well. You need to use Firefox version 2 to configure
it.
SSH:
Use the SSH tool to access the IP04.
Default IP address: 192.168.1.100
Default username/password: root/uClinux or root/12xerXes06
Most of our configure job will be done in the web interface. And we will do some advance
configure via SSH tool. Default http of IP04 is 80 port, you can change this port in the file
/etc/asterisk/http.conf

www.atcom.cn
8/35
2.3 Add extensions
At first, we need to add some extensions to make internal calls. Each extension acts as an internal
number. There are many types of extensions, we will use SIP, IAX2 and ZAP extensions on this
article.
Before setting the extensions, we need to go to the option page and set the numbers of digit of
each extension. Go to
Option -> Admin Settings
Here we set the number to 4, so each extension will be a four digits number.
Add SIP extensions:
Sip extensions is an SIP account allows you to log on the IP04 via an SIP terminal such as IP
phone AT-530 or softphone x-lite.
Go to User Page
Add New Exenions:
Extension: 8806 ; Phone number of this extension
Name: Edwin ; Caller ID Name
Password: 8806 ; SIP Log on password
Caller ID: 8806 ; Caller ID
VM password: 8806 ; password of your mailbox
Users-> User and Phone Configuration:

www.atcom.cn
9/35
Use the same method add two other extensions
Extension: 8047 ; Phone number of this extension
Name: Alice ; Caller ID Name
Password: 8047 ; SIP Log on password
Caller ID: 8047 ; Caller ID
VM password: 8047 ; password of your mailbox
Extension: 8469 ; Phone number of this extension
Name: Crystal ; Caller ID Name
Password: 8469 ; SIP Log on password
Caller ID: 8469 ; Caller ID
VM password: 8469 ; password of your mailbox
So far we have created three SIP extensions. Remember to click active change on the right top of
the page to active the extensions in Asterisk. Now we can use SIP devices to log on the IP04 use
these extensions.
Note: if your IP04 and sip devices is not in the same network, for example, your IP04 uses public
ip and sip devices is behind router, you may need to enable “NAT” when set up the extensions.
2.4 Register SIP device
1. Register SIP softphone
Download the x-lite softphone phone from couterpath website www.xten.com
After install the x-ltie, right click the panel and select the SIP Account Setting and
then configure it:
Display Name: Edwin
User Name: 8806

www.atcom.cn
10/35
Password: 8806
Authorization User Name: 8806
Domain: 192.168.1.100 (IP address of the IP04)
2. Register IP phone AT-530
a) Connect the AT-530‟s WAN port to the switch. And it can get the ip from your router.
b) Press the “sysinfo”key on AT-530 to get the IP ofAT-530.
c) Put the IP on web browser then you can enter the AT-530 configure page through this
IP.
d) Put the SIP extensions info on the AT-530 IP phones.
Register ServerAddr: 192.168.1.100 IP address of Trixbox server.
Register Username: 8047
Register Password: 8047
Phone Number: 8047
Use the same method register another AT-530 to extension 8469, then you can make free inbound
call between these three extensions 8806, 8047, 8469.
2.5 Add Zap extensions
Port 3 and port4 are configure as the fxs ports, so we can add the normal phone to it and the
normal will be an extension of our service. We need to assign the numbers for port3 and port4 as
below:

www.atcom.cn
11/35
2.6 Voice Mail Box
Voice mail box is enabled when we create the extensions. If somebody calls you on your extension
and you are unavailable, he will hear the voice mail greeting message and leave voice message.
Retrieve voice message
To retrieve the voice message, we need to create a voicemail extension in voicemail page. Once
user dial to this extension, he will be prompted the greeting message. After dialing the correct
username/password, user will hear the old and new voicemail.
Voicemail->VoiceMail Configuration:
2.7 Voice Mail to Email
The ssmtp packages is a simple voicemail to Email application. With this function setting correctly,
the ip04 will send the Voicemail to your mail address whenever there is a new voice message. The
ssmtp package is installed by default in the IP04.
1/ in the user setting page, we need to put the mail address of each extension.
2/ in the /etc/ssmtp/ssmtp.conf:
mailhub=your_mail_host //set the mailhub to your mail host
3/ in the voicemail.conf:
format=wav49
serveremail=asterisk@legitimate_mail_domain
mailcmd=/bin/ssmtp -t

www.atcom.cn
12/35
3. Make outbound call
To make an outbound call, we need to add trunk/service provider first. There are two types of
service provider:
Analog Ports: FXO ports of IP04, connect to local PSTN
VoIP: SIP or IAX trunk, connect to remote SIP/IAX server
In the IP04 i am using, the port 1 and port2 are configured as FXO ports, port 3 and port 4 are
configured as FXS ports.
When a port is configured as FXO port, the corresponding LED shows RED. When a port is
configured as FXS port, the corresponding LED shows GREEN.
What are FXO and FXS?
FXS (Foreign eXchange Station) is an interface which drives a telephone or FAX machine.
FXS interfaces get phones plugged into them, delivery battery, and provide ringing. FXS
interfaces are signalled with FXO signalling.
FXO (Foreign eXchange Office) is an interface that connects to a phone line. They supply
your PBX with access to the public telephone network. FXO interfaces use FXS signalling.
FXS interfaces are what allow you to hook telephones to your PBX, and FXO interfaces
allow you to connect your PBX to real analog phone lines.
3.1 Make call via PSTN trunk
Add Analog service provider
Service Provider -> Add Service Providers:
Add Calling Rule

www.atcom.cn
13/35
In Calling Rules -> add a new calling rule as below
Calling Rules
We have now added a new calling rule “OUT_PSTN”in the “DialPlan1”.
As we can see from the dialing rule of “OUT_PSTN”, all numbers start with 9 will be cut the first
digit („9‟) and sent to PSTN (port1 or port2).
Choose Dial Plan for extensions:
In the User page, edit the extensions to choose DialPlan1.
After we have done above, in the extension we can dial 9 + local number to dial out via PSTN line.

www.atcom.cn
14/35
3.2 Make call via VoIP trunk
Add VoIP service provider
Service Provider -> Add Service Providers:
Add a voip service provider.
Add Calling Rule
In Calling Rules -> add a new calling rule as below
Calling Rules
We have now added a new calling rule “OUT_VOIPBUSTER”in the “DialPlan1”.
As we can see from the dialing rule of “OUT_VOIPBUSTER”, all numbers start with 00 will be
cut the first two digits („00‟) and sent to my sip service provide voipbuster.
The OUT_VOIPBUSTER is in the same DialPlan1. Since we have added this dial plan to the
extensions in above, we don‟t need to add dial plan again.
So far when we have added two calling rules, any call start with 9 will be route to PSTN, and call
starts with 00 will be route to voipbuster.

www.atcom.cn
15/35
4. Add Incoming Call operator
4.1 Multiple FXO incoming calls to one extension
Purpose: Secretary phone to receive multiple FXO incoming calls , put 1st call on hold pickup 2nd
call and then transfer or hang call. Be able to do this for 4 FXO.
In this case, we use the extension, 6000 as operator, and extension 6001,6002 for clerk. Below is
the configure page:
Register extension 6000 with eyebeam. And register 6001 and 6002 with IP phone AT-530.
Configure the service provide to add all FXO ports to the same service provider.
Add the incoming and route all the calls from ports 1,2,3,4 to the 6000 extension.

www.atcom.cn
16/35
Make an incoming pstn call to port 1 and you can see 6000 extension will ring. Use the eyebeam
to answer the call.
Make another incoming call to port 2 and you can see the line2 of 6000 is ringing. You can press
LINE2 to answer the second call; Line1 will be hold and hear the music. To transfer this call to
extension 6001, press XFER in the eyebeam and then press 6001 and then XFER again to transfer
the call, after transfer the call, press hang up to return to line1.
4.2 Ring another extension if operator doesn‟t answer
Purpose: If secretary does not answer FXO CALL pass call to next extensions, If no call answer
send call to voicemail. 6000 ext voicemail
Setting a Ring Group as show below:
Put 6000 and 6001 to the ring group. Set the strategy to Ring In Order. And set the timeout to 15
seconds. If not answer, the call will go to the 6000 voicemail box
Set the incoming route to the new one “incoming_group”

www.atcom.cn
17/35
4.3 Time Base Rule
Purpose: set different rules for office time and close time. If there is incoming call in office time,
the call will be route to operator as mentioned above. If there is incoming call in close time, the
caller will hear that the company is close at this moment.
First, we need to record a voice menu for the close time (off_time1), refer chapter five for how to
record the voice menu
Second, set up the time base rule as below:
In above rule, we have set a time base as required.
Third, we need to point the incoming call to this time base rule.
5. IVR
IVR, means Interactive Voice Response. It is very important for the enterprise application. We can
use the IVR to do the auto-attendant job.
5.1 Add Greeting Menu
Go to Voice Menus--> add new voice menu

www.atcom.cn
18/35
We have added a new voice menu:
Name: Greeting
Extension 9999
Then we will need to add how this menu should work. We will set this menu as the greeting menu
and when there is incoming call, the caller will hear: “thanks for your calling, if you know the
extension of the part you wish to reach then dial now ”during the greeting voice. You can dial the
number you wish to reach.
Add two new background steps. The voice we choose are: “thank-you-for-calling”and
“if-u-know-ext-dial”and remember to enable the “dial other extensions”.

www.atcom.cn
19/35
5.2 Route incoming route to greeting menu
In the incoming calls menu, route the incoming calls to the greeting extension (9999).
5.3 Record your voice.
You may need also need to record your voice for greeting or other voice menu.
Go to Record a Menu -> Record a new voice menu
Then you will be prompted as below.
Type the name of your record and choose the extension to record. After that, click the Record
button and your extension will ring. Answer the call and make a record.
After recording, you can see the record in the page:

www.atcom.cn
20/35
The record files are stored in the /storage/sounds/record directory, if you have the voice files
already, you can use the FTP server to put the files to this directory too.