[Asterisk-doc] docs introduction.xml,1.5,1.6
websmith
asterisk-doc@lists.digium.com
Tue, 1 Jun 2004 00:32:14 +0000
Comments:
Update of /cvsroot/asterisk/docs
In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv9613
Modified Files:
introduction.xml
Log Message:
Changes contributed by Nicholas Bachmann to the mailing list on 31 May 2004.
Index: introduction.xml
===================================================================
RCS file: /cvsroot/asterisk/docs/introduction.xml,v
retrieving revision 1.5
retrieving revision 1.6
diff -C2 -d -r1.5 -r1.6
*** introduction.xml 31 May 2004 02:05:36 -0000 1.5
--- introduction.xml 1 Jun 2004 00:32:08 -0000 1.6
***************
*** 23,38 ****
</sect2>
<sect2>
! <title>PBX, IVR, ACD</title>
! <para/>
! </sect2>
! <sect2>
! <title>Telephony 101</title>
<sect3>
! <title>Basic Concepts (FXO/FXS, loop/ground start/PRI, etc.)</title>
! <para/>
</sect3>
<sect3>
! <title>Telephony Resources: Newton's Telecom Dictionary, etc.</title>
! <para/>
</sect3>
</sect2>
--- 23,67 ----
</sect2>
<sect2>
! <title>Prerequisite Knowledge and Skills</title>
! <para>
! This book assumes the reader has knowledge of both telephony and
! Linux system administration.
! </para>
<sect3>
! <title>Telephony</title>
! <para>
! Obviously, you should know enough about the telephony
! technology that you are using to use to be able to set
! up and debug it. As a general guideline, you should
! understand the difference between FXS/FXO, and what ISDN,
! PRI, BRI, POTS, PSTN, VoIP, signaling, and codecs are.
! </para>
! <para>
! For the novice, a good introductory work is Noll's
! <citetitle pubwork="book">Introduction to Telephones and
! Telephone Systems</citetitle>. Another indispensable
! resource for all skill levels is <citetitle pubwork="book">
! Newton's Telecom Dictionary</citetitle>.
! </para>
</sect3>
<sect3>
! <title>System Administration</title>
! <para>
! This book assumes that you have an i386 machine with Linux
! installed ready for Asterisk. Unfamiliarity with Linux
! administration will only compound the difficulties
! inherent in getting Asterisk installed and working. There
! are many resources that can help one learn about Linux.
! On the Internet, <ulink url="http://tldp.org/">Linux
! Documentation Project</ulink> provides many great
! resources for beginners. In the bookstore, Frisch's
! <citetitle pubwork="book">Essential System Administration
! </citetitle> along with Nemeth, et al.'s
! <citetitle pubwork="book"> Linux Administration Handbook
! </citetitle> and <citetitle pubwork="book">Unix System
! Administration Handbook</citetitle> are the best. Buying
! one or two of these books can save a lot of headaches down
! the road.
! </para>
</sect3>
</sect2>
***************
*** 42,46 ****
<title>Asterisk is not a turnkey system</title>
<para>
! The Asterisk PBX system is a complex peice of software. The learning curve
is very steep and simply reading any single resource will not teach you
everything that Asterisk is capable of. This resource is an attempt to gather
--- 71,75 ----
<title>Asterisk is not a turnkey system</title>
<para>
! The Asterisk PBX system is a complex piece of software. The learning curve
is very steep and simply reading any single resource will not teach you
everything that Asterisk is capable of. This resource is an attempt to gather
***************
*** 53,57 ****
the configuration of the many different kinds of interfaces that you would
like Asterisk to communicate with work in tandem with the dialplan. This
! relationship extends througout Asterisk with many other modules that are
not compiled by default. The term KISS (Keep It Super Simple) needs to be
applied here with great emphasis. The mistake many people make when first
--- 82,86 ----
the configuration of the many different kinds of interfaces that you would
like Asterisk to communicate with work in tandem with the dialplan. This
! relationship extends throughout Asterisk with many other modules that are
not compiled by default. The term KISS (Keep It Super Simple) needs to be
applied here with great emphasis. The mistake many people make when first
***************
*** 65,69 ****
<para>
Asterisk is an open piece of software. The ability to read the source code
! is its power. Most (if not all) other PBX's are entirely closed source
with only the abilities that have been provided to you. If something doesn't
work quite the way you would expect it to, you are able to change it.
--- 94,98 ----
<para>
Asterisk is an open piece of software. The ability to read the source code
! is its power. Most (if not all) other PBXs are entirely closed source
with only the abilities that have been provided to you. If something doesn't
work quite the way you would expect it to, you are able to change it.
***************
*** 81,87 ****
<title>The Big Picture</title>
<para>
! To summerise, a channel generally consists of either an analog signal running
on POTS (or Plain Old Telephone System) or some combination of codec and
! signalling protocol, ie. GSM and SIP or ULAW and IAX.
</para>
</sect2>
--- 110,116 ----
<title>The Big Picture</title>
<para>
! To summarize, a channel generally consists of either an analog signal running
on POTS (or Plain Old Telephone System) or some combination of codec and
! signaling protocol, ie. GSM and SIP or ULAW and IAX.
</para>
</sect2>
***************
*** 89,93 ****
<title>Channels</title>
<para>
! A channel is a voice path equivilent to a phone line between two points.
There are many different ways they can be sent, but can be split into two
groups -- analog and digital. Analog data is the type of signal that has
--- 118,122 ----
<title>Channels</title>
<para>
! A channel is a voice path equivalent to a phone line between two points.
There are many different ways they can be sent, but can be split into two
groups -- analog and digital. Analog data is the type of signal that has
***************
*** 96,100 ****
form. Digital data consist of ones and zeros. Analog data as picked up
from a microphone can not be sent as is over a digital network and must
! be converted into a series of discrete levels, or quantised, to be able
to form a digital signal. Once the data is in a digital state it will
require a fair amount of bandwidth to send as is (64kbits/sec for
--- 125,129 ----
form. Digital data consist of ones and zeros. Analog data as picked up
from a microphone can not be sent as is over a digital network and must
! be converted into a series of discrete levels, or quantized, to be able
to form a digital signal. Once the data is in a digital state it will
require a fair amount of bandwidth to send as is (64kbits/sec for
***************
*** 121,126 ****
Sending data to another phone would be easy if the data found its own way there
and knew what to do at the other end. Unfortunately it doesn't which is
! why we use a signalling protocol to encapsulate the voice data. The common
! signalling protocol used today is SIP (an acronym for Session Initiation Protocol).
Others that Asterisk supports include IAX, H.323 and CAPI. CAPI is a special
case in that it is used within a computer system to deal with ISDN interfaces.
--- 150,155 ----
Sending data to another phone would be easy if the data found its own way there
and knew what to do at the other end. Unfortunately it doesn't which is
! why we use a signaling protocol to encapsulate the voice data. The common
! signaling protocol used today is SIP (an acronym for Session Initiation Protocol).
Others that Asterisk supports include IAX, H.323 and CAPI. CAPI is a special
case in that it is used within a computer system to deal with ISDN interfaces.
***************
*** 144,148 ****
<para>
The drivers for Digium hardware can be obtained from the CVS server.
! These will allow you to integrate many types of legecy telephony
equipment such as T1/E1, PSTN, FXO and FXS devices.
</para>
--- 173,177 ----
<para>
The drivers for Digium hardware can be obtained from the CVS server.
! These will allow you to integrate many types of legacy telephony
equipment such as T1/E1, PSTN, FXO and FXS devices.
</para>
***************
*** 196,200 ****
standard analog telephones and analog lines to a computer. The card uses small
modules to activate the 4 ports on the card. Depending on which daughter card is plugged
! onto the board will determine whether the port acts as an FXO or FXSinterface. The boards
are not selectable between modes; the module used determines the type of interface.
</para>
--- 225,229 ----
standard analog telephones and analog lines to a computer. The card uses small
modules to activate the 4 ports on the card. Depending on which daughter card is plugged
! onto the board will determine whether the port acts as an FXO or FXS interface. The boards
are not selectable between modes; the module used determines the type of interface.
</para>