Etross-1200P User s Manual Page 1 of 31 Version 1.0
Contents Chapter 1 Introduction... 3 Chapter 2 Hardware introduction... 7 Chapter 3 Intallation and configuration... 9 Chapter 4 Test example... 26 Chapter 5 Reference... 31 Page 2 of 31 Version 1.0
Chapter 1 Introduction 1. What s 1200P? Etross-1200P is a 12 port FXS/FXO analog Asterisk PCI card which is mainly applied to PSTN environment. The PCI plug is based on PCI2.2, It supports all the functions of Asterisk PBX systems needed. User could choose any of combinations of FXO_200 or FXS_200 or FSO_200 modules according to their requirements. 2. What s Asterisk? Asterisk is the world's most popular open source telephony project. Under development since 1999, Asterisk is free, open source software that turns an ordinary computer into a feature-rich voice communications server. Asterisk makes it simple to create and deploy a wide range of telephony applications and services. Asterisk is released as open source under the GNU General Public License (GPL), and it is available for download free of charge. Asterisk is the leading open source telephony project and the Asterisk community has been ranked as a key factor in the growth of VoIP. 3. What Does Asterisk Do? Asterisk is like an erector set or a box of Legos for people who want to create communications applications. That's why we refer to it as a "tool-kit" or "development platform". Asterisk includes all the building blocks needed to create a PBX system, an IVR system or virtually any other kind of communications solution. The "blocks" in the kit include: Drivers for various VoIP protocols. Drivers for PSTN interface cards and devices. Routing and call handling for incoming calls. Outbound call generation and routing. Media management functions (record, play, generate tone, etc.). Call detail recording for accounting and billing. Page 3 of 31 Version 1.0
Transcoding (conversion from one media format to another). Protocol conversion (conversion from one protocol to another). Database integration for accessing information on relational databases. Web services integration for accessing data using standard internet protocols. LDAP integration for accessing corporate directory systems. Single and mult-party call bridging. Call recording and monitoring functions. Integrated "Dialplan" scripting language for call processing. External call management in any programming or scripting language through Asterisk Gateway Interface (AGI) Event notification and CTI integration via the Asterisk Manager Interface (AMI). Speech synthesis (aka "text-to-speech") in various languages and dialects using third party engines. Speech recognition in various languages using third party recognition engines. This combination of components allows an integrator or developer to quickly create voice-enabled applications. The open nature of Asterisk means that there is no fixed limit on what it can be made to do. Asterisk integrators have built everything from very small IP PBX systems to massive carrier media servers. 4. Asterisk In Action: Key Applications Asterisk As A PBX Asterisk can be configured as the core of an IP or hybrid PBX, switching calls, managing routes, enabling features, and connecting callers with the outside world over IP, analog (POTS), and digital (T1/E1) connections. Page 4 of 31 Version 1.0
Asterisk runs on a wide variety of operating systems including Linux, Mac OS X, OpenBSD, FreeBSD and Sun Solaris and provides all of the features you would expect from a PBX including many advanced features that are often associated with high end (and high cost) proprietary PBXs. Asterisk's architecture is designed for maximum flexibility and supports Voice over IP in many protocols, and can interoperate with almost all standards-based telephony equipment using relatively inexpensive hardware. Asterisk As A Gateway It can also be built out as the heart of a media gateway, bridging the legacy PSTN to the expanding world of IP telephony. Asterisk s modular architecture allows it to convert between a wide range of communications protocols and media codecs. Asterisk as a feature/media server. Need an IVR? Asterisk s got you covered. How about a conference bridge? Yep. It s in there. What about an automated attendant? Asterisk does that too. How about a replacement for your aging legacy voicemail system? Can do. Unified messaging? No problem. Need a telephony interface for your web site? Ok. Asterisk In The Call Center Asterisk has been adopted by call centers around the world based on its flexibility. Call center and contact center developers have built complete ACD systems based on Asterisk. Asterisk has also added new life to existing call center solutions by adding remote IP agent capabilities, advanced skills-based routing, predictive and bulk dialing, and more. Asterisk In The Public Network Internet Telephony Service Providers (ITSPs), competitive local exchange carriers (CLECS) and even first-tier incumbents have discovered the power of open source communications with Asterisk. Feature servers, hosted services clusters, voicemail systems, pre-paid calling solutions, all based on Asterisk have helped reduce costs and enabled flexibility. Asterisk Everywhere Asterisk has become the basis for thousands of communications solutions. If you need to communicate, Asterisk is your answer. Page 5 of 31 Version 1.0
Page 6 of 31 Version 1.0
Chapter 2 Hardware introduction 1. Operation Environment: CentOS 5.0 Zaptel-1.4.12.1 Asterisk-1.4.12.1 2. Etross-1200P Etross-1200P Picture as following: RJ 45 with 4 channels, channel 1-4 Red module is FXO Green RJ 45 with 4 module is channels, channel FXS 5-8 RJ 45 with 4 channels, channel 9-12 Spare RJ45 Power slot, it need connect to pc power Spare indicator lignt Indicator light first line is channel 1-4, second line is channel 5-8, Clock output plug when have FXS module on board. third line is channel 9-12 Etross-1200P has a clock output plug to realize the clock synchronization. Through the clock line connect to the plug; Etross-1200P can be connected to other cards, like GSM400P. With the clocks synchronization, user can plug some cards in one computer. Page 7 of 31 Version 1.0
Above is the adapter, which divide RJ45 to 4 RJ11. Page 8 of 31 Version 1.0
Chapter 3 Intallation and configuration 1. Plug Etross-1200P A. Shut down the PC and remove the power cable. B. Insert 1200P card in PCI slot, and fix with the screw. C. Connect power cable to the 1200P power slot D. Connect the PC power cable and turn on the PC. 2. Start the CentOs5 system, input lspci -v and click enter. It can diagnose whether 1200P is found in the operating system. If the operating system show the information like the red frame in following pictures, that s mean the 1200P was found. 3. Check the software packages which Asterisk needed: Input following command to check whether you have installed Asterisk auxiliary software package. rpm -q bison rpm -q bison-devel rpm -q ncurses rpm -q ncurses-devel Page 9 of 31 Version 1.0
rpm -q zlib rpm -q zlib-devel rpm -q openssl rpm -q openssl-devel rpm -q gnutls-devel rpm -q gcc rpm -q gcc-c++ It means that you have not installed Asterisk auxiliary software package if the computer shows the information as following picture. Please input yum install xxx to install the Asterisk auxiliary software package. xxx mean the relation Asterisk auxiliary software package, for example, bison-devel as following picture. Page 10 of 31 Version 1.0
4. Install Zaptel and Asterisk software package Download same version Zaptel and Asterisk software package, propose using version 1.4. A. Download way 1: Download it from website: http://downloads.asterisk.org/pub/telephony/ Find the version of the Zaptel and Asterisk you need. As following picture showed. Page 11 of 31 Version 1.0
The package downloaded is as following: B. Download way 2: Page 12 of 31 Version 1.0
Input cd /usr/src in the command line to enter the src directory. Page 13 of 31 Version 1.0
Input wget + xxx xxx mean files address 5. Compile Zaptel and Asterisk, follow is the step: A. Download http://www.etross.com/download.asp 下载 Etross-1200P.c,And copy it to /usr/src directory. B. Decompress the download software package: cd /usr/src tar xvzf zaptel-xxxx xxxx means the version tar xvzf asterisk-xxxx xxxx means the version For example: cp 1200.c /usr/src/zapterl-xxxx/kernel vi /usr/src/zaptel-xxxx/makefile Found the line has information of TOPDIR_MODULES=, add 1200P in it, like the picture as following, then save and quit. Found the line has information of ztmonitor.o: kernel/zapterl.h, add 1200P.o : kernel/zaptel.h kernel/wctdm.h in it, like the picture as following, then save and quit. Page 14 of 31 Version 1.0
vi /usr/src/zaptel-xxxx/zaptel.sysconfig add MODULES= $MODULES 1200P # 1200P, like the picture as following, then save and quit. cd /usr/src/zaptel-1.4.14.1/kernel/xpp/utils/ vi genzaptelconf In the last of the line of ALL_MODULES, add 1200P C. Compile Zaptel cd zaptel-xxxx./configure Page 14 of 31 Version 1.0
correctly. The following picture showes that./configure runs Input make as following picture Page 15 of 31 Version 1.0
The computer will show the information like following pictures if the make command run correctly. Input make install as following picture: The computer will show the information like following pictures if the make install command run correctly. Input make config as following picture: Page 16 of 31 Version 1.0
The computer will show the information like following pictures if the make config command run correctly. E. Compile Asterisk cd /usr/src/asterisk-xxxx xxxx means version./configure Page 17 of 31 Version 1.0
The computer will show the information like following pictures if the./configure command run correctly. Page 18 of 31 Version 1.0
Input make The computer will show the information like following pictures if the make command run correctly. Input make install The computer will show the information like following pictures if the make install command run correctly. Page 19 of 31 Version 1.0
Input make samples The computer will show the information like following pictures if the make samples command run correctly. E. Run two commands to produce automatically two files: cd /usr/src/zaptel-xxxx/kernel/xpps/utils xxxx means version./genzaptelconf sdvm Runs the command as above will produce two files: /etc/zaptel.conf and /etc/asterisk/zapata-channels.conf. zaptel.conf detail information as following: # Span 1: WCTDM/0 "etross 16line Rev 1.00 Board 1" (MASTER) fxsks=1 //FXO 口 fxsks=2 //FXO 口 fxsks=3 //FXO 口 fxsks=4 //FXO 口 fxoks=5 //FXS 口 fxoks=6 //FXS 口 fxoks=7 //FXS 口 fxoks=8 //FXS 口 fxoks=9 //FXS 口 fxoks=10 //FXS 口 fxoks=11 //FXS 口 fxoks=12 //FXS 口 # Global data Page 20 of 31 Version 1.0
loadzone = us defaultzone = us /etc/asterisk/zapata-channels.conf detail information as following: ; Span 1: WCTDM/0 "etross 16line Rev 1.00 Board 1" (MASTER) ;;; line="1 WCTDM/0/0" signalling=fxs_ks callerid=asreceived group=0 context=from-pstn channel => 1 context=default ;;; line="2 WCTDM/0/1" signalling=fxs_ks callerid=asreceived group=0 context=from-pstn channel => 2 context=default ;;; line="3 WCTDM/0/2" signalling=fxs_ks callerid=asreceived group=0 context=from-pstn channel => 3 context=default ;;; line="4 WCTDM/0/3" signalling=fxs_ks callerid=asreceived group=0 context=from-pstn channel => 4 context=default ;;; line="5 WCTDM/0/4" signalling=fxo_ks callerid="channel 5" <6005> mailbox=6005 Page 21 of 31 Version 1.0
group=5 context=from-internal channel => 5 callerid= mailbox= group= context=default ;;; line="6 WCTDM/0/5" signalling=fxo_ks callerid="channel 6" <6006> mailbox=6006 group=5 context=from-internal channel => 6 callerid= mailbox= group= context=default ;;; line="7 WCTDM/0/6" signalling=fxo_ks callerid="channel 7" <6007> mailbox=6007 group=5 context=from-internal channel => 7 callerid= mailbox= group= context=default ;;; line="8 WCTDM/0/7" signalling=fxo_ks callerid="channel 8" <6008> mailbox=6008 group=5 context=from-internal channel => 8 Page 22 of 31 Version 1.0
callerid= mailbox= group= context=default ;;; line="9 WCTDM/0/8" signalling=fxo_ks callerid="channel 9" <6009> mailbox=6009 group=5 context=from-internal channel => 9 callerid= mailbox= group= context=default ;;; line="10 WCTDM/0/9" signalling=fxo_ks callerid="channel 10" <6010> mailbox=6010 group=5 context=from-internal channel => 10 callerid= mailbox= group= context=default ;;; line="11 WCTDM/0/10" signalling=fxo_ks callerid="channel 11" <6011> mailbox=6011 group=5 context=from-internal channel => 11 callerid= mailbox= group= context=default Page 23 of 31 Version 1.0
;;; line="12 WCTDM/0/11" signalling=fxo_ks callerid="channel 12" <6012> mailbox=6012 group=5 context=from-internal channel => 12 callerid= mailbox= group= context=default F. Check whether the two files produced automatically is disposed identically with your 1200P. If not identical, please adapt it. Attention: FXS uses FXO signalling, FXO uses FXS signalling. The software version this manual used will have a problem, but other version will not have. The problem is that Page 24 of 31 Version 1.0
/etc/asterisk/zapata-channels.conf doesn t include in /etc/asterisk/zapata.conf. Our solution is to add #include zapata-channels.conf to the last line of zapata.conf G. Run following command: modprobe zaptel modprobe wctdm H. Start Asterisk, and run following command: asterisk vvvvvvvgc zap show channels Channel 1-4 are FXO, channel 5-12 are FXS. Page 25 of 31 Version 1.0
Chapter 4 Example of texting 1. Test FXS module Page 26 of 31 Version 1.0
A. Connect the adapter to the RJ45(Red frame pointed out) of the 1200P, and connect two analog phones to L1 and L2 of the adaper by RJ11 slot. B. Define the dialing rules: In the command line, run two commands: cd /etc/asterisk vi /extensions.conf Then turn to the last line of extensions.conf, add codes as following: [form-internal] exten => 6005,1,Dial(zap/5) exten => 6005,2,Hangup() exten => 6000,1,Dial(zap/6) exten => 6000,2,Hangup() The codes above define the dialing rules: Dial 6005 from FXS channel in addition to channel 5 can make the phone which connected to channel 2 ringing; dial 6006 from FXS channel in addition to channel 6 can make the phone which connected to channel 6 ringing. Right now run command asterisk r to enter CLI directory Run reload in CLI directory NOTED: Please reload the asterisk if you adapt the extensions.conf C. Check whether the dialing rules works by using phone dial the number 6005 and 6000. If the dialing is success, the system will show following informations in the CLI directory. And that s mean FXS works normally. Page 27 of 31 Version 1.0
2. Test FXO module: A. Connect the adapter to the RJ45 (Red frame pointed out) of the 1200P, and connect a PSTN line to L1 of the adapter by RJ11 slot. Page 28 of 31 Version 1.0
B. Define the dialing rules: In the command line, run two commands: cd /etc/asterisk vi /extensions.conf Then turn to the last line of extensions.conf, add codes as following: [form-internal] exten => 6005,1,Dial(zap/5) exten => 6005,2,Hangup() exten => 6006,1,Dial(zap/6) exten => 6006,2,Hangup() [form-pstn] exten => s,1,answer() exten => s,2,dial(zap/5) exten => s,3,hangup() The codes above define the dialing rules: The incoming phone call from PSTN will make the phone connect to channel 1 ringing. Right now run command asterisk r to enter CLI directory Page 29 of 31 Version 1.0
Run reload in CLI directory NOTED: Please reload the asterisk if you adapt the extensions.conf C. Check whether the dialing rules works by using phone or cell phone dial the number of the PSTN which we connect to the CT1200P. If dial succellfully, the phone connect to channel 10 will ringing. D. Same way to test other FXO module. Page 30 of 31 Version 1.0
Chapter 5 Reference www.etross.com www.asterisk.org www.digium.com www.voip-info.org www.ctiforum.com Disclaimers: Digium is registered trademark of Digium, Inc Asterisk is registered trademark of Digium, Inc Page 31 of 31 Version 1.0