TE120 Series TE120P/TE121/TE122 User Manual Release 2.
Digium, Inc. 445 Jan Davis Drive Huntsville, AL 35806 United States Main Number: 1.256.428.6000 Tech Support: 1.256.428.6161 U.S. Toll Free: 1.877.344.4861 Sales: 1.256.428.6262 www.digium.com www.asterisk.org www.asterisknow.org © Digium, Inc. 2007 All rights reserved. No part of this publication may be copied, distributed, transmitted, transcribed, stored in a retrieval system, or translated into any human or computer language without the prior written permission of Digium, Inc. Digium, Inc.
Safety Certification and Agency Approvals Safety: UL 60950-1:2003, First Edition CSA C22.2 No. 60950-1-03 1st Ed. April 1, 2003 IEC 60950-1:2001 First Edition EN 60950 Note: Canada, Finland, Norway, Sweden and the United States of America require that equipment using this product must be located in a Restricted Access Location (RAL).
Federal Communications Commission Part 68 This equipment complies with Part 68 of the FCC rules and the requirements adopted by the ACTA. On the back of your TE120 Series printed circuit board is a label that contains, among other information, a product identifier in the format US:AAAEQ##TXXXX. If requested, this number must be provided to the telephone company.
The following information may be required when applying to the telephone company for service: Reg. Number Service Type US: DIGDENANTE120P 1.544 Mbps – SF 1.544 Mbps - SF and B8ZS 1.544 Mbps – ESF 1.544 Mbps – ESF and B8ZS SOC 6.0N FIC 04DU9-BN 04DU9-DN 04DU9-1KN 04DU9-1SN USOC RJ-48C If you experience problems with the TE120 Series, contact Digium, Inc. Technical Support +1.256.428.6161 for repair and/or warranty information.
Introduction to TE120 Series Documentation This manual contains product information for the TE120 Series of cards (TE120P, TE121, and TE122). Be sure to refer to any supplementary documents or release notes that were shipped with your equipment. The manual is organized in the following manner: Chapter/ Appendix Title Description 1 Overview Identifies your card’s features. This chapter also covers applications and uses for the TE120 Series card in the real world.
Symbol Definitions Caution statements indicate a condition where damage to the unit or its configuration could occur if operational procedures are not followed. To reduce the risk of damage or injury, follow all steps or procedures as instructed. The ESD symbol indicates electrostatic sensitive devices. Observe precautions for handling devices. Wear a properly grounded electrostatic discharge (ESD) wrist strap while handling the device.
Important Safety Instructions User Cautions Servicing. Do not attempt to service this card unless specifically instructed to do so. Do not attempt to remove the card from your equipment while power is present. Refer servicing to qualified service personnel. Water and Moisture. Do not spill liquids on this unit. Do not operate this equipment in a wet environment. Heat.
Service Personnel Cautions Servicing. Disconnect telecommunications network cable before opening the cover or removing the card from the motherboard. Labeling. For safety reasons, only connect equipment with a Telecommunications Compliance label. This includes customer equipment previously labelled Permitted or Certified. Caution. Only connect regulatory equipment (approved for use in your specific country) to the telecommunications network voltage circuit ports. Caution.
TABLE OF CONTENTS Chapter 1 Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14 Echo-Cancellation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17 What is Asterisk®? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18 Asterisk as a Switch (PBX) . . . . . . . . . . . . . . . . . . . . . . . . . .
Table Of Contents Configuring Card Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34 Configuring T1/E1 Lines . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .37 T1 Channel Bank . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40 E1 Channel Bank . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40 Testing Your Configuration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45 Chapter 4 Troubleshooting . .
List of Figures Figure 1: Figure 2: Figure 3: Figure 4: Figure 5: Figure 6: Figure 7: Figure 8: Release 2.2 Sample Legacy Phone Application . . . . . . . . . . . . . .16 Sample IP Phone Application . . . . . . . . . . . . . . . . . . 16 TE120P Card . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23 TE121 Card with Echo Cancellation Module . . . . . . 24 TE122 Card with Echo Cancellation Module . . . . . . 25 Motherboard PCI Slots . . . . . . . . . . . . . . . . . . . . . . .
List of Tables Table 1: Table A-1: Table B-2: Release 2.2 Card Identifiers . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30 RJ45 Telco Port Connector . . . . . . . . . . . . . . . . . . . .53 Maximum Power Consumption . . . . . . . . . . . . . . . . .55 Digium, Inc.
Chapter 1 Overview The Digium TE120 Series cards are T1/E1 capable cards that can handle both voice and data. It supports industry standard protocols, including Robbed Bit Signaling also known as CAS (Channel Associated Signaling) and CCS (Common Channel Signaling), E&M (Digital Emulation), Primary Rate ISDN (PRI), and several data modes (PPP, HDLC, Cisco HDLC and frame relay). It is capable of running in E1, T1, or J1 modes.
Chapter 1: Overview Voice Modes: PRI CPE and PRI NET – NI1 – NI2 – EuroISDN – 4ESS (AT&T) – 5ESS (Lucent) – DMS100 E&M – Wink – Feature Group B – Feature Group D FXO and FXS – Ground Start – Loop Start – Loop Start with Disconnect Detect The TE120 Series cards can be used to connect your Asterisk machine to the PSTN world, your channel bank, or even another PBX. This is accomplished via a T1/E1 interface.
Chapter 1: Overview Asterisk Server T1 TE12X Internet Legacy PBX Legacy Phones Remote offices Figure 1: Sample Legacy Phone Application Eth LAN Switch TE12X T1 CLEC Asterisk Server IP Phones Figure 2: Sample IP Phone Application Release 2.2 Digium, Inc.
Chapter 1: Overview Echo-Cancellation Users connecting their TE120 series cards to the PSTN or other devices are likely to be placing calls that will result, at some point, in an unbalanced 4-wire/2-wire hybrid. The result of this hybrid is the reflection of a near-end echo to the calling party. Elimination of this echo is the responsibility of echo cancellation. The TE120 series cards, unless otherwise equipped, utilize Asterisk to perform software-based echo cancellation.
Chapter 1: Overview What is Asterisk®? Asterisk is the world’s leading open source telephony engine and tool kit. Offering flexibility unheard of in the world of proprietary communications, Asterisk empowers developers and integrators to create advanced communication solutions...for free. Asterisk® is released as open source under the GNU General Public License (GPL), and it is available for download free of charge.
Chapter 1: Overview 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.
Chapter 2 Card Installation This chapter provides the following information: Unpacking the Card on page 21 Shipment Inspection on page 22 Identifying Features on page 22 T1/E1 Selection on page 22 Slot Compatibility on page 26 Hardware Installation on page 28 Software Installation on page 29 Installing Asterisk on page 32 Note: The TE120 Series card installation instructions are written so that they will apply to any card in the series.
Chapter 2: Card Installation Unpacking the Card When you unpack your card, carefully inspect it for any damage that may have occurred in shipment. If damage is suspected, file a claim with the carrier and contact your reseller from which the card was purchased, or Digium Technical Support at 1.256.428.6161. Keep the original shipping container to use for future shipment or proof of damage during shipment. Note: Only qualified service personnel should install the card.
Chapter 2: Card Installation Shipment Inspection The following items are included in shipment of the TE120 Series: A TE120P, TE121, or TE122 card. Identifying Features Your TE120 Series card has one RJ45 port and two status LEDs. The port is used for connecting T1, E1, or J1 cables. The two LEDs serve as a status LED and an amber loop-back LED. The card includes a strap for selecting either T1 or E1 line mode. See Figure 3 on page 23 to locate these features.
Chapter 2: Card Installation T1/E1 Jumper Status LED Loopback Mode LED Port 1 PCI Connector Figure 3: TE120P Card Release 2.2 Digium, Inc.
Chapter 2: Card Installation Status LED VPMADT032 Loopback Mode LED Port 1 PCI Express Connector Figure 4: TE121 Card with Echo Cancellation Module Release 2.2 Digium, Inc.
Chapter 2: Card Installation Status LED VPMADT032 Loopback Mode LED Port 1 PCI Connector Figure 5: TE122 Card with Echo Cancellation Module Caution. Only qualified service personnel should continue with hardware installation and configuration of a TE120 Series card. Non-qualified personnel should not attempt to perform these functions. Release 2.2 Digium, Inc.
Chapter 2: Card Installation Slot Compatibility Check the type of card you received to be sure it is compatible with your PCI slot. To determine which slot you have, identify it by comparing it to those shown in Figure 6 on page 26. Slot Number: 0: AGP Pro Slot 1: 64-bit 5.0 volt PCI Slot 2: 64-bit 3.3 volt PCI Slot 3: 32-bit 5.0 volt PCI Slot 4: PCI Express Slot Slots 0 1 2 3 4 Figure 6: Motherboard PCI Slots Release 2.2 Digium, Inc.
Chapter 2: Card Installation The TE120 Series and TE122 cards are 32-bit 33MHz cards keyed for universal 3.3 volt or 5.0 volt operation and works in any PCI 2.2 (or greater) compliant slot. This means that in the motherboard shown in Figure 6, the TE120 Series and TE122 cards will fit into Slots 1, 2, or 3 (PCI slots) but will not fit into Slot 0 (AGP slot). The TE121 card is a PCI Express card. Slot 4, illustrated above, is a 1 lane (X1) PCI Express compliant slot.
Chapter 2: Card Installation Hardware Installation 1. Now that you are acquainted with the TE120 Series cards, power down your computer and unplug it from its power source. 2. Attach a static strap to your wrist and open the case. 3. Check the jumper setting to ensure it matches your equipment configuration. Setting the jumper with the strap on enables the ports for E1. Setting the jumper with the strap off enables the ports for T1. 4.
Chapter 2: Card Installation Caution. This unit must be connected to the Telecommunications Network in your country using an approved line cord. Caution. This unit must be connected only to the appropriate Telecommunications Network port (as approved for use in your specific country). Software Installation The TE120 Series cards are only supported on a Linux system. Digium, Inc. recommends Debian, Fedora, and Red Hat.
Chapter 2: Card Installation 1. Check your lspci PCI device listing. Boot the computer into Linux. After the machine has loaded, log in and execute the following: # lspci -n | grep d161 Confirm your lspci PCI device listing by scanning for the following information in the output screen: 0000:01:00.0 0200: d161: In the device listing shown above, will be populated with one of the identifiers listed in the table below.
Chapter 2: Card Installation 2. Download the latest branch of libpri that matches the branch of Zaptel and Asterisk which you are using. If you are using the 1.2.x branch, then download the 1.2.x branch of libpri. Likewise if you are using the 1.4.x branch, then obtain that version of libpri. Libpri is available from http://downloads.digium.com/pub/telephony/libpri. 3. Expand the downloaded tarballs. Substitute the version of libpri you are using with the X.X in the command lines below.
Chapter 2: Card Installation Installing Asterisk If you wish to use Asterisk with your new hardware, you can follow the instructions below. If you are using the 1.2.x series of Asterisk and Zaptel, you will need Asterisk 1.2.26 or newer, and Zaptel 1.2.23 or newer. If you are using the 1.4.x series of Asterisk and Zaptel, you will need Asterisk 1.4.17 or newer and Zaptel 1.4.8 or newer. 1. Download the latest released version of Asterisk, either 1.2.26 (or later), or 1.4.17 (or later).
Chapter 3 Configuration The TE120 Series cards have a variety of configuration options. This chapter provides configurations for PRI, channel bank, E&M wink, and finally, data mode. These sample configurations are provided to assist you in familiarizing yourself with the flexibility of editing the configuration files to meet your specific needs. The list of possible configurations is too expansive to cover in this user manual. Release 2.2 Digium, Inc.
Chapter 3: Configuration Configuring Card Features Configure Zapata.conf, which is the layer between zaptel and Asterisk, to configure the essential card features. Switchtype: national: dms100: 4ess: 5ess: euroisdn: ni1: National ISDN 2 (default) Nortel DMS100 AT&T 4ESS Lucent 5ESS EuroISDN Old National ISDN 1 Echocancel: Echo Cancellation is enabled in zapata.
Chapter 3: Configuration Users of Digium's HPEC software have the following additional options: echocancel=512 (this sets 512 taps or 64ms) or echocancel=1024 (this sets 1024 taps or 128ms) Please note that HPEC consumes extremely high amounts of CPU MIPS that increase as the number of taps are increased. Audio quality issues may result from choosing a taps length greater than the server's ability to process the echo in real-time.
Chapter 3: Configuration Signalling: pri_cpe for CPE side. pri_net for NET side. If you have a T1 PRI, add these lines to the following lines of the sample file.
Chapter 3: Configuration Configuring T1/E1 Lines 1. Begin by opening the /etc/zaptel.conf. This is where the base configuration for your hardware is stored. If you did a make samples during the install, you can read through the commented example and edit it to your needs. Otherwise, continue following these instructions. 2. Next, configure your T1/E spans in the span definitions.
Chapter 3: Configuration Choose 1 to make the equipment at the far end of the E1/T1 link the preferred source of the master clock. Choose 2 to make it the second choice for the master clock, if the first choice port fails (the far end dies, a cable breaks, etc.). Choose 3 to make a port the third choice, and so on. If you have, for instance, 2 ports connected to the PSTN, mark those as 1 and 2. The number used for each port should be different.
Chapter 3: Configuration d4 or esf for T1 cas, or ccs for E1 ami or b8zs for T1 ami or hdb3 for E1 E1 can also have the extra flag CRC4 at the end for CRC4 checking. [,yellow] (optional) If the keyword yellow follows, yellow alarm is transmitted when Asterisk is not running. The following is a typical setup for a telco in the US: span=1,1,0,esf,b8zs In Europe: span=1,1,0,ccs,hdb3,crc4 3. Next, define the country zone. See the example configuration file for more details.
Chapter 3: Configuration First Example: Channel Bank The Channel Bank in this example has 24 FXS ports. In this configuration, the zaptel.conf is set for the card to provide timing to the channel bank and fxoks is set for 24 stations. Set zapata.conf to mirror the configuration with signalling=fxo_ks and define it for channels 1-24. T1 Channel Bank /etc/zaptel.conf: span=1,0,0,esf,b8zs fxoks=1-24 /etc/asterisk/zapata.
Chapter 3: Configuration Second Example: E&M Line To configure a span for E&M, the zaptel.conf must specify the span and the channel definition, while the zapata.conf specifies the signalling and incoming dialplan context for a group of channels. In the example below, the zaptel.conf shows the first span port configured to receive timing, with no line build-out (LBO), using ESF and B8ZS for framing and coding. The zapata.
Chapter 3: Configuration Third Example: PRI By setting the card to take timing in zaptel.conf, you acquire 23 b channels and voice channels, with channel 24 as the data transport. For Asterisk, define PRI_CPE so that it is the client side. Define the switch type you are connecting to as national. There are several options for the switch type including 5ESS, 4ESS, and NI1. You will then have 23 voice channels for Asterisk. PRI T1 /etc/zaptel.
Chapter 3: Configuration PRI E1 /etc/zaptel.conf: span=1,1,0,ccs,hdb3 bchan=1-15,17-31 dchan=16 /etc/asterisk/zapata.conf group=1 signalling=pri_cpe switchtype=euroisdn context=incoming channel=1-15,17-31 Fourth Example: Data Mode Data mode is a little different than the other options. The zaptel.conf is configured as follows: /etc/zaptel.conf span=1,0,0,esf,b8zs nethdlc=1-24 1. Uncomment the following line in zconfig.
Chapter 3: Configuration Build the data tools for Zaptel by executing: make data; make sethdlc-new Or, for kernels prior to 2.4.19 make data; make sethdlc make install 2. Load and configure your driver: modprobe wcte12xp ztcfg 3. Use sethdlc to bring up the interface: sethdlc hdlc0 cisco -or- for old style (make sethdlc instead of sethdlc-new) use: sethdlc hdlc0 mode cisco 4. Assign the interface an address: ifconfig hdlc0 192.168.0.1 netmask 255.255.255.0 5.
Chapter 3: Configuration Testing Your Configuration. 1. Load Zaptel drivers into the kernel using the program modprobe. The appropriate driver for the TE120 Series cards is wcte12xp. Use the following modprobe command: # modprobe wcte12xp # ztcfg -vv # dmesg ACPI: PCI interrupt 0000:01:00.
Chapter 3: Configuration 3. Execute the following Asterisk command to see if the span came up successfully. asterisk asterisk -vvvr Note: More detailed troubleshooting information is provided on http:// www.asterisk.org. Release 2.2 Digium, Inc.
Chapter 4 Troubleshooting This chapter provides frequently asked questions as identified from Digium Technical Support and possible resolutions. Multiple resources are available to obtain more information about Asterisk and Digium products. These resources are listed on page 52. What do the Status LED colors indicate? Green - Card is in-sync with the far end. Yellow - Card is synchronizing or is receiving a red alarm from the far end.
Chapter 4: Troubleshooting 2. Then type reload in the Asterisk console and call in. You should see the DID come in on your T1/E1 line. My D Channel seems to go up and down. Check to be sure you have set your timing parameters correctly. Also check the common causes of problems for a T1. See the Common Fixes for all cards, page 50. I have trouble dialing out. It seems that one type of dialing works (local, long distance, international) but another does not.
Chapter 4: Troubleshooting I am still having problems and the telco tells me it is my equipment. The first thing to do in this situation is to test your equipment. 1. Connect a loopback plug. (A loopback plug has pin 1 going to pin 4 and pin 2 going to pin 5.) Insert the plug into the span and wait for its LED to turn green. 2. Stop Asterisk and edit zaptel.
Chapter 4: Troubleshooting 3. Navigate to your zaptel source directory and type: make tests Followed by: ./patlooptest /dev/zap/1 60 The first argument in the patlooptest command is the device for the channel number you want to test. You should always test the first channel of a span. The second argument is the duration in seconds to run the test. This runs a pattern looptest for 60 seconds.
Chapter 4: Troubleshooting 2. Check to see if X windows is running by entering the following: ps aux|grep X If X windows is running, stop the application since it may cause a conflict with Asterisk. 3. Check to see if your IDE hard drives are running with DMA levels set. Advanced users can perform an hdparm on your hard drive interface. Use hdparm with caution as the man page states that hard drive corruption can occur when using incorrect settings.
Chapter 4: Troubleshooting How can I enable more features? To view all of the options available to add to your dial plan, type the following command from within Asterisk: show applications Digium also offers services to help configure and add features you might need. Contact Digium Technical Support at 1.256.428.6161 for more information. Where can I ask even more questions? There are several places to inquire for more information about Asterisk Digium products: 1. Digium Technical Support at 1.256.428.
Appendix A Pin Assignments The communication port on the TE120 Series card bracket is an 8-pin RJ45 port. The pin assignments are identified in Table A-1. Table A-1: RJ45 Telco Port Connector Pin 1 Pin 8 Release 2.2 Pin Description 1 Rx 2 Rx 3 Not used 4 Tx 5 Tx 6 Not used 7 Not used 8 Not used Digium, Inc.
Appendix B Specifications This appendix provides specifications, required environmental conditions, and maximum power consumption for the TE120P card. Physical. Size: Weight: 4.82” × 2.175” × 0.63” (12.2 x 5.5 x 1.6 cm) PCB size, does not include the PCI bracket 2 oz (57g) Interfaces. Local Loop Access: E1, T1, J1, PRI; RJ45 PCI Bus (TE120P and TE122): 3.3V or 5V bus slot, half-length slot minimum size, 33MHz minimum bus speed, compliant with PCI 2.2 or greater.
Appendix B: Specifications Hardware and Software Requirements. 800-Mhz Pentium III or better 64MB RAM Available PCI Slot (as described previously) Table B-2: Maximum Power Consumption Model Release 2.2 Power TE120P 3.3V 5V 1.5 Watts 0.1Watt TE121 3.3V 2.0 Watts TE121B 3.3V 3.0 Watts TE122 3.3V 5V 1.5 Watts 0.1Watt TE122B 3.3V 5V 2.5 Watts 0.1Watt Digium, Inc.
Appendix C Glossary and Acronyms ANSI American National Standards Institute An organization which proposes and establishes standards for international communications. asynchronous Not synchronized; not timed to an outside clock source. Transmission is controlled by start bits at the beginning and stop bits at the end of each character. Asynchronous communications are often found in internet access and remote office applications.
Appendix C: Glossary and Acronyms broadband Broadband transmission shares the bandwidth of a particular medium (copper or fiber optic) to integrate multiple signals. The channels take up different frequencies on the cable, integrating voice, data, and video over one line. channel A generic term for an individual data stream. Service providers can use multiplexing techniques to transmit multiple channels over a common medium. Cat5 Category of Performance for wiring and cabling.
Appendix C: Glossary and Acronyms CO central office The CO houses local switching equipment. All local access lines in a particular geographic area terminate at this facility (which is usually owned and operated by an ILEC). CPE customer premises equipment Terminal equipment which is connected to the telecommunications network and which resides within the home or office of the customer. This includes telephones, modems, terminals, routers, and television set-top boxes.
Appendix C: Glossary and Acronyms E1 The European equivalent of North American T1, transmits data at 2.048 Mbps, up to 32 voice channels (DS0s). E3 The European equivalent of North American T3, transmits data at 34.368 Mbps, up to 512 voice channels (DS0s). Equivalent to 16 E1 lines. EMI Electromagnetic Interference Unwanted electrical noise present on a power line full duplex Data transmission in two directions simultaneously. G.
Appendix C: Glossary and Acronyms IAX Inter-Asterisk eXchange A VoIP protocol used by Asterisk. It is used to enable VoIP connections between Asterisk servers, and between servers and clients that also use the IAX protocol. iLBC internet Low Bitrate Codec A free speech codec used for voice over IP. It is designed for narrow band speech with a payload bitrate of 13.33 kbps (frame length = 30ms) and 15.2 kbps (frame length = 20 ms).
Appendix C: Glossary and Acronyms loopback A state in which the transmit signal is reversed back as the receive signal, typically by a far end network element. MGCP Media Gateway Control Protocol multiplexing Transmitting multiple signals over a single line or channel. FDM (frequency division multiplexing) and TDM (time division multiplexing) are the two most common methods.
Appendix C: Glossary and Acronyms POTS plain old telephone service Standard phone service over the public switched telephone network (PSTN). This service provides analog bandwidth of less than 4 kHz. PPP point-to-point protocol Type of communications link that connects a single device to another single device, such as a remote terminal to a host computer.
Appendix C: Glossary and Acronyms T1 A dedicated digital carrier facility which transmits up to 24 voice channels (DS0s) and transmits data at 1.544 Mbps. Commonly used to carry traffic to and from private business networks and ISPs. T3 A dedicated digital carrier facility which consists of 28 T1 lines and transmits data at 44.736 Mbps. Equivalent to 672 voice channels (DS0s).
Appendix C: Glossary and Acronyms V volts VoIP Voice over IP Technology used for transmitting voice traffic over a data network using the Internet Protocol. Zaptel (Zap) Zapata Telephony Project dedicated to implementing a reasonable and affordable Computer Telephony platform into the world marketplace. Release 2.2 Digium, Inc.