[Asterisk-doc] patch for installation.xml
Martin List-Petersen
asterisk-doc@lists.digium.com
Tue, 01 Jun 2004 00:39:53 +0100
--=-9P3YIrhh+BoIbigvpiqq
Content-Type: text/plain
Content-Transfer-Encoding: 7bit
I've pepped the ISDN section of installation.xml a bit up and also run a
spell check on that file, while i was at it.
Kind regards,
Martin List-Petersen
martin at list-petersen dot net
--=-9P3YIrhh+BoIbigvpiqq
Content-Disposition: attachment; filename=installation.xml.diff
Content-Type: text/x-patch; name=installation.xml.diff; charset=ansi_x3.4-1968
Content-Transfer-Encoding: 7bit
--- docs-current/installation.xml 2004-05-31 13:12:54.000000000 +0100
+++ docs/installation.xml 2004-06-01 00:36:49.000000000 +0100
@@ -73,11 +73,11 @@
<sect2>
<title>IRQ Sharing Issues</title>
<para>
- Many telephony cards such as the X100P tend to generate a large amount of interupts.
+ Many telephony cards such as the X100P tend to generate a large amount of interrupts.
Servicing them takes time and drivers may not be able to do it on-time. If another device is
- processing the same shared IRQ, the IRQ line connot receive another one. It does
+ processing the same shared IRQ, the IRQ line cannot receive another one. It does
tend to work better on SMP (APIC) systems. On single chip systems you can get
- interupt misses and messed up clocking. Any of Digium's cards or other telephony
+ interrupt misses and messed up clocking. Any of Digium's cards or other telephony
cards can be subject to this problem. Because the precise delivery of IRQ's is
very much necessary in telephony, one should not share IRQ's with anything.
This is not to say you will necessarily have IRQ sharing conflicts, but it is
@@ -121,47 +121,92 @@
<title>ISDN Cards</title>
<para>[This should probably be moved somewhere else.]</para>
<para>
- ISDN hardware in most parts of the world are not very expensive. A basic AVM card
- that comes with CAPI compatible kernel modules is available for about $40US.
- Sometimes there are several differences between the capacity of the cards such as
- having more than 2 B-channels and supporting different ISDN standards. The chan_capi
- module is programmed to work even with multiple ISDN cards. 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. The following links have good
- descriptions on how to get CAPI support for several cards.
- </para>
+ ISDN hardware in most parts of the world are not very expensive. A basic AVM card
+ that comes with CAPI compatible kernel modules is available for about $40US.
+ Sometimes there are several differences between the capacity of the cards such as
+ having more than 2 B-channels and supporting different ISDN standards.
+ </para>
+ <sect3>
+ <title>chan_capi</title>
+ <para>
+ This channel driver is programmed to work even with multiple ISDN cards.
+ 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. Be also aware, that 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. The following links have good descriptions
+ on how to get CAPI support for several cards.
+ </para>
- <para>
- For a "Eicon Diva" visit:
- </para>
+ <para>
+ chan_capi is a third party channel driver, that can be downloaded at <ulink url="http://www.junghanns.net/asterisk/" type="http">http://www.junghanns.net/asterisk/</ulink>
+ </para>
+
+ <para>
+ For a "Eicon Diva" visit:
+ </para>
- <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>
+ <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>
- <para>
- For AVM cards visit:
- </para>
+ <para>
+ For AVM cards visit:
+ </para>
- <para>
- <ulink url="http://www.avm.de" type="http">http://www.avm.de</ulink>
- </para>
+ <para>
+ <ulink url="http://www.avm.de" type="http">http://www.avm.de</ulink>
+ </para>
- <para>
- For AVM-Fritz! cards:
- </para>
+ <para>
+ For AVM-Fritz! cards:
+ </para>
- <para>
- <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)
- <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>
- </para>
+ <para>
+ <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)
+ <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!)
+ </para>
+ </sect3>
+ <sect3>
+ <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>
+ The qozap driver is for 4 port (quadBRI) and 8 port (octoBRI) ISDN cards that also are 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 at about 30$ 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 are third party modules for asterisk and can be downloaded at:
+ <ulink url="http://www.junghanns.net/asterisk/" type="http">http://www.junghanns.net/asterisk/</ulink>. The package to download
+ there is called "bristuff".
+ </para>
+ </sect3>
</sect2>
<sect2>
--=-9P3YIrhh+BoIbigvpiqq--