Digium TDM400P User manual

TDM400P
User’s Manual
June 28, 2005
Release 1.0

Page 2 Digium, Inc. Release 1.0
© Digium, Inc. 2005
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. has made every effort to ensure that the instructions contained in this document
are adequate and error free. The manufacturer will, if necessary, explain issues which may
not be covered by this documentation. The manufacturer’s liability for any errors in the
documents is limited to the correction of errors and the aforementioned advisory services.
This document has been prepared for use by professional and properly trained personnel,
and the customer assumes full responsibility when using it.
Adobe and Acrobat are registered trademarks, and Acrobat Reader is a trademark of Adobe
Systems Incorporated.
Asterisk and Digium are registered trademarks of Digium, Inc.
Any other trademarks mentioned in the document are the property of their respective owners.
Digium, Inc.
150 West Park Loop, Suite 100
Huntsville, AL 35806
Phone: 877.546.8963
877.linux.me!
www.digium.com
www.asterisk.com

Release 1.0 Digium, Inc. Page 3
Safety Certification and Agency Approvals
Safety:
UL, CE
A-Tick (Australia)
Telco:
FCC Part 68 TIA-968-A including amendments A1 & A2
Industry Canada IC-CS-03
Australia S002 (POTS line) / S003 (POTS Extn)
Immunity:
EN55024 ITE (US, CA, AU, EU)
Emissions:
EN55022 Class A Radiated & Conducted (US FCC Part 15, CA, AU, EU)
Class A (Commercial)
Cisper
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 the TDM400P 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.
A plug and jack used to connect this equipment to the premises wiring
and telephone network must comply with the applicable FCC Part 68
rules and requirements adopted by the ACTA.

Page 4 Digium, Inc. Release 1.0
The REN is used to determine the number of devices that may be
connected to a telephone line. Excessive RENs on a telephone line may
result in the devices not ringing in response to an incoming call. In most
but not all areas, the sum of RENs should not exceed five (5.0). To be
certain of the number of devices that may be connected to a line, as
determined by the total RENs, contact the local telephone company. For
products approved after July 23, 2001, the REN is part of the product
identifier that has the format US:AAAEQ##TXXXX. The digits
represented by ## are the REN without a decimal point (e.g., 03 is a REN
of 0.3).
If the TDM400P causes harm to the telephone network, the telephone
company may notify you in advance that temporary discontinuance of
service may be required. But if advance notice is not practical, the
telephone company will notify you as soon as possible. Also, you will be
advised of your right to file a complaint with the FCC if you believe it is
necessary.
The telephone company may make changes in its facilities, equipment,
operations or procedures that could affect the operation of the equipment.
If this happens, the telephone company will provide advance notice in
order for you to make necessary modifications to maintain uninterrupted
service.
If you experience problems with the TDM400P,contact Digium, Inc.
(877.546.8963) for repair and/or warranty information. If the equipment
is causing harm to the telephone network, the telephone company may
request that you disconnect the equipment until the problem is resolved.
Connection to party line service is subject to state tariffs. Contact the state
public utility commission, public service commission, or corporation
commission for information.

Release 1.0 Digium, Inc. Page 5
Introduction to TDM400P Documentation
This manual contains product information for the TDM400P card. 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
1Overview Identifies the card and type of modules you received
with the TDM400P. This chapter covers applications
and uses of the TDM400P in the real world.
2Card Installation Provides instructions for installing the card in your
PC, acquiring correct drivers, and checking device
compatibility.
3Configuration Provides examples for configuring dial plan options.
4FXS and FXO
Explained
Describes the FXO (Foreign Exchange Office) and
FXS (Foreign Exchange Station) modules and their
significance.
5Troubleshooting Explains resolutions to common problems and
frequently asked questions pertaining to card
installation and usage.
6Service Personnel
Requisites
Provides details for labeling the card and external PC
enclosures by qualified service personnel.
APin Assignments Lists the connectors and pin assignments.
BSpecifications Details card specifications.

Page 6 Digium, Inc. Release 1.0
Symbol Definitions
CAsterisk
Configuration
Commands
Describes all available configuration commands and
their option settings in the zapata.conf file.
DDial Plan
Applications
Defines configuration features in the extensions.conf
file.
EGlossary and
Acronyms
Defines terms related to this product.
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.
The Electrical Hazard Symbol indicates a possibility of electrical
shock when operating this unit in certain situations. To reduce the
risk of damage or injury, follow all steps or procedures as
instructed.

Release 1.0 Digium, Inc. Page 7
Important Safety Instructions
User Cautions
Warning
This card must be used with the PC lid screwed down.
Telecommunications network voltages exist inside the PC!
The PC must be shut down and telecommunications line connection
shall be removed before opening the PC.
Electrical Shock.
To reduce the risk of injury, damage to the unit or your equipment, do
not attempt to touch the modules while they are powered. The case
should be securely closed before power is applied to the unit.
Alarm Dialing Equipment.
If your home has specially wired alarm equipment connected to the
telephone line, ensure the installation of the TDM400P does not
disable your alarm equipment. If you have questions, consult your
telephone company or a qualified installer.
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.
Do not operate or store this product near heat sources such as
radiators, air ducts, areas subject to direct, intense sunlight, or other
products that produce heat.
Static Electricity.
To reduce the risk of damaging the unit or your equipment, do not
attempt to open the enclosure or gain access to areas where you are
not instructed to do so. Refer servicing to qualified service personnel.

Page 8 Digium, Inc. Release 1.0
Service Personnel Cautions
Warning.
This card must be used with the PC lid screwed down.
Telecommunications network voltages exist inside the PC!
The PC must be shut down and telecommunications line connection
shall be removed before opening the PC.
Electrical Shock.
To reduce the risk of injury, damage to the unit or your equipment, do
not attempt to touch the modules while they are powered. The case
should be securely closed before power is applied to the unit.
Servicing.
Disconnect telecommunications network cable before opening the
cover or removing the card from the mother equipment
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.

Release 1.0 Digium, Inc. Page 9
TABLE OFCONTENTS
Chapter 1
Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13
What is Asterisk? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .14
Chapter 2
Card Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .15
Unpacking the Card . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .15
Shipment Inspection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .16
Module Identification . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .16
Port Identification . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .16
Hardware Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .20
Software Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .22
Chapter 3
Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .31
General Options. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .31
Voicemail . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .32
Dial Plan . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .33
Testing Your Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .34
Chapter 4
FXS and FXO Explained . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .37
Identification. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .37
FXS Module . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .37

Page 10 Digium, Inc. Release 1.0
Table Of Contents
FXO Module. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .37
Using Your TDM400P Card . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .38
Chapter 5
Troubleshooting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .39
The FXO module never seems to hang-up the line. How do I set it to
hang-up? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .39
My card is acting strange. There is static on the line, poor sound
quality, and random hang-ups. How can I solve this? . . . . . . . . .39
There is a slight echo. How can I adjust the sound quality? . . . . . .40
How can I enable more features? . . . . . . . . . . . . . . . . . . . . . . . . . .40
Where can I ask even more questions? . . . . . . . . . . . . . . . . . . . . .41
Chapter 6
Service Personnel Requisites . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .43
Card Labeling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .44
Labeling the External PC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .45
Appendix A
Pin Assignments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .47
Appendix B
Specifications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .49
Appendix C
Asterisk Configuration Commands . . . . . . . . . . . . . . . . . . . . . . . . . .51
Appendix D
Dial Plan Applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .59

Release 1.0 Digium, Inc. Page 11
Table Of Contents
Appendix E
Glossary and Acronyms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .63
List of Figures
Figure 1: Sample Card Application . . . . . . . . . . . . . . . . . . . . .13
Figure 2: TDM400P Card (Model TDM22) . . . . . . . . . . . . . . . .18
Figure 3: Insert the Card . . . . . . . . . . . . . . . . . . . . . . . . . . . . .21
Figure 4: Connect Power for FXS Modules . . . . . . . . . . . . . . .21
Figure 5: Checking PCI Compatibility Screen . . . . . . . . . . . . .24
Figure 6: dmesg Screen Shot . . . . . . . . . . . . . . . . . . . . . . . . .28
Figure 7: Sample Application . . . . . . . . . . . . . . . . . . . . . . . . . .35
Figure 8: Actual Label on Card . . . . . . . . . . . . . . . . . . . . . . . .45
Figure 9: External Caution Label . . . . . . . . . . . . . . . . . . . . . . .46
List of Tables
Table 1: Standard Card Configurations . . . . . . . . . . . . . . . . . 19
Table 2: Card Label . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
Table A-1: RJ11 Telco Port Connector . . . . . . . . . . . . . . . . . . . .47
Table B-1: Maximum Power Consumption . . . . . . . . . . . . . . . . .50

Page 12 Digium, Inc. Release 1.0
Table Of Contents

Release 1.0 Digium, Inc. Page 13
Chapter 1
Overview
The TDM400P card is a device used for connecting your phone network
to the PSTN (Public Switched Telephone Network) world. This is
accomplished through phone lines connected to the FXO (Foreign
Exchange Office) ports and phones connected via the FXS (Foreign
Exchange Station) ports. The card allows Asterisk PBX software to
connect to your phone network, creating a Small Office Home Office
(SOHO) telephony environment. See Figure 1 for an example of the
card’s primary application.
Figure 1: Sample Card Application

Page 14 Digium, Inc. Release 1.0
Chapter 1: Overview
What is Asterisk?
Asterisk is the first Open Source PBX. Since it runs on Linux, it inherits
all of the power and stability of the operating system. The name Asterisk
is derived from the all-inclusive “wildcard” symbol in UNIX, because it
is opening a wide range of opportunities for developers worldwide to
create solutions which would otherwise be cost-prohibitive.
Asterisk allows you to create a PBX solution that rivals the features and
functionality of traditional telephony switches. Current PBX solutions are
expensive and proprietary. International companies are discovering that
Asterisk is cost effective, low maintenance, and flexible enough to handle
all of their voice and data networking. Combined with Digium hardware
and a common PC, anyone can replace an existing switch or complement
a PBX by adding VoIP, voicemail, conferencing, and many other
capabilities. Asterisk will integrate with most standards-based IP
telephone handsets and software. Analog phones and ADSI-screen
phones are also supported.

Release 1.0 Digium, Inc. Page 15
Chapter 2
Card Installation
This chapter provides the following information:
Unpacking the Card on page 15
Shipment Inspection on page 16
Module Identification on page 16
Port Identification on page 16
Hardware Installation on page 20
Software Installation on page 22
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 where the card was purchased, or Digium
Technical Support (877.546.8963 or 1.877.LINUXME!). 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. Users
should not attempt to perform this function themselves.

Page 16 Digium, Inc. Release 1.0
Chapter 2: Card Installation
Shipment Inspection
The following items are included in shipment of the TDM400P:
TDM400P card
A combination of FXO and/or FXS modules
Port Identification label
User’s manual
Module Identification
The TDM400P card ships with FXO and/or FXS modules. These are
identified by their color. Take a moment to identify which modules were
shipped with your card.
FXO (Foreign Exchange Office) modules are Red
FXS (Foreign Exchange Station) modules are Green
See Figure 2 on page 18 for an example of the card shown with two of
each module.
Port Identification
Each card consists of four RJ11 ports located on the bracket. Each port
correlates to a module slot (containing the FXO or FXS modules). The
ports are numbered in sequence from one to four. The top port is Port 1
and the bottom port is Port 4. See Figure 2 on page 18 for appropriate
identification of these ports.
Note: It is important to identify the type and location of your
TDM400P modules. You will need this information during the
Asterisk configuration.

Release 1.0 Digium, Inc. Page 17
Chapter 2: Card Installation
There are multiple standard configurations in which the TDM400P card
may be purchased. Each configuration consists of one to four FXS and/or
FXO modules.
It is easiest to identify your card by understanding the naming scheme for
each card. The first digit provides the number of FXS modules present on
the card. The second digit provides the number of FXO modules present
on the card. See Table 1 on page 19 for a complete list of possible
configurations.

Page 18 Digium, Inc. Release 1.0
Chapter 2: Card Installation
Figure 2: TDM400P Card (Model TDM22)
FXS
Modules
(Green)
FXO
Modules
(Red)
Power
Supply
Connection
Ports
1
2
3
4
4
12
3
Module
Slots

Release 1.0 Digium, Inc. Page 19
Chapter 2: Card Installation
Table 1: Standard Card Configurations
Card ID Modules Included in
Configuration
TDM10 1 FXS module
TDM20 2 FXS modules
TDM30 3 FXS modules
TDM40 4 FXS modules
TDM01 1 FXO module
TDM02 2 FXO modules
TDM03 3 FXO modules
TDM04 4 FXO modules
TDM11 1 FXS module and 1 FXO module
TDM22 2 FXS modules and 2 FXO modules
TDM12 1 FXS module and 2 FXO modules
TDM13 1 FXS module and 3 FXO modules
TDM21 2 FXS modules and 1 FXO module
TDM31 3 FXS modules and 1 FXO module

Page 20 Digium, Inc. Release 1.0
Chapter 2: Card Installation
There are multiple standard configurations in which the TDM400P card
may be purchased. Each configuration consists of one to four FXS and/or
FXO modules.
It is easiest to identify your card by understanding the naming scheme for
each card. The first digit provides the number of FXS modules present on
the card. The second digit provides the number of FXO modules present
on the card.
Hardware Installation
1. Now that you are acquainted with your card, power down your com-
puter and unplug it from its power source.
2. Attach a static strap to your wrist and open the case.
3. Remove the bracket place holder and insert the card into a 3.3 or 5 volt
PCI slot (PCI 2.2 or greater). See Figure 3.
Caution.
Only qualified service personnel should continue with
hardware installation and configuration of the TDM400P card.
Users should not attempt to perform these functions themselves.
Table of contents
Other Digium PCI Card manuals