[Asterisk-doc] docs other-hardware.xml,1.6,1.7
marlow
asterisk-doc@lists.digium.com
Fri, 13 Aug 2004 01:06:58 +0000
Comments:
Update of /cvsroot/asterisk/docs
In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv12975
Modified Files:
other-hardware.xml
Log Message:
channel driver descriptions moved to modules chapter.
Index: other-hardware.xml
===================================================================
RCS file: /cvsroot/asterisk/docs/other-hardware.xml,v
retrieving revision 1.6
retrieving revision 1.7
diff -C2 -d -r1.6 -r1.7
*** other-hardware.xml 16 Jul 2004 01:06:00 -0000 1.6
--- other-hardware.xml 13 Aug 2004 01:06:53 -0000 1.7
***************
*** 50,242 ****
<title>ISDN Cards</title>
<para>
! ISDN hardware is quite inexpensive in most parts of the world. A basic AVM card
! that comes with CAPI compatible kernel modules is available for about $40US or less.
! Sometimes there are several differences between the capacity of the cards such as
! having more ports and supporting different ISDN standards.
! </para>
!
<para>
! There are several ways of integrating ISDN channels in Asterisk. Out of the box Asterisk
! only supports isdn4linux (chan_modem_i4l), but there are several more powerful
! 3rd party channel modules available: chan_capi utilizes capi supported ISDN
! cards, zaphfc/qozap utilizes ISDN cards based on the HFC chipset, both
! channel drivers are maintained by Klaus-Peter Junghanns and released under the terms of the GPL.
! And last but not least there is chan_mISDN, which utilizes the new isdn4linux mISDN
! architecture. Also this 3rd party channel driver is released under the terms of the GPL.
! </para>
!
<para>
! Currently chan_capi and zapbri will be the channel drivers that are described
! the best here because chan_modem_i4l doesn't give the best results. chan_mISDN
! is quite new and the mISDN architecture in isdn4linux has mainly been developed
! against kernel 2.6, so not too much information there yet.
! </para>
!
<sect2>
! <title>chan_modem_i4l</title>
! <para/>
! </sect2>
!
<sect2>
! <title>chan_capi</title>
<para>
! To use chan_capi you must have support for CAPI and your ISDN card in your
! kernel configuration. You will have to check with your vendor to see if your
! particular card is supported, but Linux has good support for ISDN cards, so
! most likely it will. Cards such as Eicon and AVM are known to work with
! Asterisk. However it can be a bit tricky to get CAPI support working for
! different ISDN cards. chan_capi only provides TE mode, you can only use it
! for connecting your asterisk box to a ISDN line, not connect phones internally
! to the ISDN card.
! </para>
!
<para>
! This is a list of those implemented in chan_capi:
! </para>
!
<para>
! <itemizedlist>
! <listitem><para>ISDN connection handling (CID,DNID)</para></listitem>
! <listitem><para>multiple controller support</para></listitem>
! <listitem><para>digital audio support</para></listitem>
! <listitem><para>DTMF detection/generation</para></listitem>
! <listitem><para>incoming/outgoing calls</para></listitem>
! <listitem><para>CLIP/CLIR</para></listitem>
! <listitem><para>early B3 connects</para></listitem>
! <listitem><para>native ISDN indications</para></listitem>
! <listitem><para>CD, HOLD, RETRIEVE, etc.</para></listitem>
! <listitem><para>overlap sending (dialtone)</para></listitem>
! <listitem><para>DID on point-to-point (PTP)</para></listitem>
! <listitem><para>call progress (INFO_IND)</para></listitem>
! <listitem><para>RX/TX gains</para></listitem>
! <listitem><para>call deflection on circuit busy</para></listitem>
! </itemizedlist>
! </para>
!
<para>
! chan_capi can be downloaded at:
! <ulink url="http://www.junghanns.net/asterisk/" type="http">http://www.junghanns.net/asterisk/</ulink>.
! </para>
!
! <sect3>
! <title>Eicon Diva</title>
!
! <para>
! <simplelist>
! <member><ulink url="http://www.melware.de/de/index.html" type="http">http://www.melware.de/de/index.html</ulink></member>
! <member><ulink url="http://isdn4linux.org/~armin/divas/" type="http">http://isdn4linux.org/~armin/divas/</ulink></member>
! <member><ulink url="http://www.eicon.com/worldwide/products/WAN/cn4linux.htm" type="http">http://www.eicon.com/worldwide/products/WAN/cn4linux.htm</ulink></member>
! </simplelist>
! </para>
! </sect3>
!
! <sect3>
! <title>AVM Fritz!</title>
!
! <para>
! <ulink url="http://www.avm.de" type="http">http://www.avm.de</ulink>
! </para>
!
! <para>
! The AVM Fritz! card is quite interesting, since it's the only passive ISDN card where the manufacturer
! did mind to write CAPI support (binary though). This driver unfortunately has one limitation:
! point-to-point (PTP) mode does not work.
! </para>
!
! <para>
! With the introduction of the isdn4linux new mISDN architecture and it's capi layer, that problem is fixed.
! chan_capi supports PTP on the AVM Fritz! card in that case and you even get rid of having a tainted
! kernel, at least for this module.
! </para>
!
! <para>
! <simplelist>
! <member><ulink url="ftp://ftp.avm.de/cardware/fritzcrd.pci/linux/suse.82/" type="http">ftp://ftp.avm.de/cardware/fritzcrd.pci/linux/suse.82/</ulink> (not only for SuSE)</member>
! <member><ulink url="http://www.linux-magazin.de/Artikel/ausgabe/2000/10/Capi/capi.html" type="http">http://www.linux-magazin.de/Artikel/ausgabe/2000/10/Capi/capi.html</ulink> (German article on getting capi to work with AVM Fritz!)</member>
! </simplelist>
! </para>
! </sect3>
!
! </sect2>
<sect2>
! <title>zapbri, qozap</title>
<para>
! The zapbri and qozap drivers take a bit different approach than chan_capi: they implement a full zaptel driver
! for Asterisk on ISDN cards based on the HFC chipset and can provide either TE and NT mode on a per port basis.
! As with all zaptel drivers you can have any amount of these cards in your Asterisk box.
! </para>
<para>
! Features at a glance:
! </para>
!
<para>
! <itemizedlist>
! <listitem><para>TE and NT mode</para></listitem>
! <listitem><para>PTP and PMP mode</para></listitem>
! <listitem><para>DTMF detection</para></listitem>
! <listitem><para>integration into asterisk as full zap channel driver</para></listitem>
! <listitem><para>caller name display on alphanumeric isdn phones</para></listitem>
! <listitem><para>text messages</para></listitem>
! <listitem><para>call parking</para></listitem>
! </itemizedlist>
! </para>
!
<para>
! The qozap driver is for 4 port (quadBRI) and 8 port (octoBRI) ISDN cards that are also designed and sold by it's
! developer. These cards can provide power and termination on the port for NT mode and do offer an internal PCM bus,
! that connects all quadBRI or octoBRI cards together to interconnect up to 64 full duplex connections at 64 kbit/s each
! without using that bandwidth on the PCI bus or the host CPU.
! </para>
!
<para>
! The zaphfc driver is basically the same driver just for a single port ISDN card available for about $30US in most hardware
! stores. TE mode, hooking it up against your ISDN line, is trivial and works as good as with the capi based cards,
! however to get NT mode to work with this card you will need to build yourself an ISDN crossover cable and provide power
! and termination on the ISDN bus. This can be done by taking an old NT1 that not is in use anymore and modify it a little.
! </para>
!
<para>
! These drivers are quite new and require to patch both Asterisk & libpri and build the kernel module (zapbri/qozap) to
! get them working, but once this is done you have full featured zap channels on these cards, which makes them really interesting.
! </para>
!
<para>
! zapbri and qozap can be downloaded at:
! <ulink url="http://www.junghanns.net/asterisk/" type="http">http://www.junghanns.net/asterisk/</ulink>.
! The package to be downloaded there is called "bristuff".
! </para>
!
! </sect2>
!
<sect2>
! <title>chan_mISDN</title>
!
! <para>
! Features at a glance:
! </para>
!
! <para>
! <itemizedlist>
! <listitem><para>TE and NT mode (NT mode is currently only supported on HFC based cards)</para></listitem>
! <listitem><para>PTP and PMP mode</para></listitem>
! <listitem><para>DTMF detection</para></listitem>
! <listitem><para>display text messages on isdn phones with alphanumeric display</para></listitem>
! <listitem><para>utilizes new isdn4linux mISDN architecture in *</para></listitem>
! </itemizedlist>
! </para>
!
! <para>
! chan_mISDN can be downloaded at:
! <ulink url="http://www.beronet.com/?PageID=3017" type="http">http://www.beronet.com/?PageID=3017</ulink>.
! </para>
!
! </sect2>
!
! <sect2>
! <title>Other Cards (LineJack/PhoneJack/VoiceTronix/Dialogic)</title>
! <para/>
! </sect2>
</sect1>
</appendix>
--- 50,162 ----
<title>ISDN Cards</title>
<para>
! ISDN hardware is quite inexpensive in most parts of the world. A basic AVM card
! that comes with CAPI compatible kernel modules is available for about $40US or less.
! Sometimes there are several differences between the capacity of the cards such as
! having more ports and supporting different ISDN standards.
! </para>
<para>
! There are several ways of integrating ISDN channels in Asterisk. Out of the box Asterisk
! only supports isdn4linux (chan_modem_i4l), but there are several more powerful
! 3rd party channel modules available: chan_capi utilizes capi supported ISDN
! cards, zaphfc/qozap utilizes ISDN cards based on the HFC chipset, both
! channel drivers are maintained by Klaus-Peter Junghanns and released under the terms of the GPL.
! And last but not least there is chan_mISDN, which utilizes the new isdn4linux mISDN
! architecture. Also this 3rd party channel driver is released under the terms of the GPL.
! </para>
<para>
! Currently chan_capi and zapbri will be the channel drivers that are described
! the best here because chan_modem_i4l doesn't give the best results. chan_mISDN
! is quite new and the mISDN architecture in isdn4linux has mainly been developed
! against kernel 2.6, so not too much information there yet.
! </para>
<sect2>
! <title>Eicon Diva</title>
! <para>
! <simplelist>
! <member><ulink url="http://www.melware.de/de/index.html" type="http">http://www.melware.de/de/index.html</ulink></member>
! <member><ulink url="http://isdn4linux.org/~armin/divas/" type="http">http://isdn4linux.org/~armin/divas/</ulink></member>
! <member><ulink url="http://www.eicon.com/worldwide/products/WAN/cn4linux.htm" type="http">http://www.eicon.com/worldwide/products/WAN/cn4linux.htm</ulink></member>
! </simplelist>
! </para>
! </sect2>
<sect2>
! <title>AVM Fritz!</title>
<para>
! <ulink url="http://www.avm.de" type="http">http://www.avm.de</ulink>
! </para>
<para>
! The AVM Fritz! card is quite interesting, since it's the only passive ISDN card where the manufacturer
! did mind to write CAPI support (binary though). This driver unfortunately has one limitation:
! point-to-point (PTP) mode does not work.
! </para>
<para>
! With the introduction of the isdn4linux new mISDN architecture and it's capi layer, that problem is fixed.
! chan_capi supports PTP on the AVM Fritz! card in that case and you even get rid of having a tainted
! kernel, at least for this module.
! </para>
<para>
! <simplelist>
! <member><ulink url="ftp://ftp.avm.de/cardware/fritzcrd.pci/linux/suse.82/" type="http">ftp://ftp.avm.de/cardware/fritzcrd.pci/linux/suse.82/</ulink> (not only for SuSE)</member>
! <member><ulink url="http://www.linux-magazin.de/Artikel/ausgabe/2000/10/Capi/capi.html" type="http">http://www.linux-magazin.de/Artikel/ausgabe/2000/10/Capi/capi.html</ulink> (German article on getting capi to work with AVM Fritz!)</member>
! </simplelist>
! </para>
! </sect2>
<sect2>
! <title>HFC based ISDN cards, quadBRI, octoBRI</title>
<para>
! HFC based ISDN cards can also be implemented with the zapbri and qozap kernel modules drivers, that provide zaptel telephony.
! As with all zaptel drivers you can have any amount of these cards in your Asterisk box, only limted by the amount of PCI ports
! available in your system.
! </para>
<para>
! Features at a glance:
! <itemizedlist>
! <listitem><para>TE and NT mode</para></listitem>
! <listitem><para>PTP and PMP mode</para></listitem>
! <listitem><para>DTMF detection</para></listitem>
! <listitem><para>caller name display on alphanumeric isdn phones</para></listitem>
! <listitem><para>text messages</para></listitem>
! <listitem><para>call parking</para></listitem>
! </itemizedlist>
! </para>
<para>
! The qozap driver is for 4 port (quadBRI) and 8 port (octoBRI) ISDN cards that are also designed and sold by it's
! developer. These cards can provide power and termination on the port for NT mode and do offer an internal PCM bus,
! that connects all quadBRI or octoBRI cards together to interconnect up to 64 full duplex connections at 64 kbit/s each
! without using that bandwidth on the PCI bus or the host CPU.
! </para>
<para>
! The zaphfc driver is basically the same driver just for a single port ISDN card available for about $30US in most hardware
! stores. TE mode, hooking it up against your ISDN line, is trivial and works as good as with the capi based cards,
! however to get NT mode to work with this card you will need to build yourself an ISDN crossover cable and provide power
! and termination on the ISDN bus. This can be done by taking an old NT1 that not is in use anymore and modify it a little.
! </para>
<para>
! These drivers are quite new and require to patch both Asterisk & libpri sourcetree to get them working. After that you
! can build the kernel module (zapbri/qozap). Once done you have a full features zaptel interface for these cards, which
! makes them quite interesting.
! </para>
<para>
! "bristuff", as the package is called, also introduces a couple new options to <filename>zapata.conf</filename>:
! <informalexample>
! <programlisting>
! signalling = bri_cpe_ptmp (or bri_cpe_ptmp for point to point)
! prilocaldialplan = national (can have the same values as pridialplan, this is used for phones on cards in NT mode)
! nationalprefix = 0
! internationalprefix = 00 (since asterisk doesn't tell you what dialplan the call came with, these are essential)
! </programlisting>
! </informalexample>
! </para>
<para>
! The package can be downloaded at:
! <ulink url="http://www.junghanns.net/asterisk/" type="http">http://www.junghanns.net/asterisk/</ulink>.
! </para>
! </sect2>
<sect2>
! <title>Other Cards (LineJack/PhoneJack/VoiceTronix/Dialogic)</title>
! <para/>
! </sect2>
</sect1>
</appendix>