diff options
author | tzafrir <tzafrir@5390a7c7-147a-4af0-8ec9-7488f05a26cb> | 2007-10-16 20:25:29 +0000 |
---|---|---|
committer | tzafrir <tzafrir@5390a7c7-147a-4af0-8ec9-7488f05a26cb> | 2007-10-16 20:25:29 +0000 |
commit | 91f7650a0c02deff8489a37260f01b1debe32363 (patch) | |
tree | f5bbec7924eab1b1b1f438c380d3805ad78ead9c /README | |
parent | f314f6fcda2493f0097b4e2af46fd0c305e740d7 (diff) |
Update README yet again.
git-svn-id: http://svn.digium.com/svn/zaptel/branches/1.4@3147 5390a7c7-147a-4af0-8ec9-7488f05a26cb
Diffstat (limited to 'README')
-rw-r--r-- | README | 69 |
1 files changed, 50 insertions, 19 deletions
@@ -10,13 +10,13 @@ Supported Hardware Digital Cards ~~~~~~~~~~~~~ - wct4xxp: - - Digium newer quad-span T1/E1/J1 cards: Wildcard TE420P/TE410P/TE405P - - Digium newer dual-span T1/E1/J1 cards: Wildcard TE220P/TE210P/TE205P + * Digium newer quad-span T1/E1/J1 cards: Wildcard TE420P/TE410P/TE405P + * Digium newer dual-span T1/E1/J1 cards: Wildcard TE220P/TE210P/TE205P - wcte12xp: Digium Wildcard TE120P and the TE122P single-span T1/E1/J1 card - wcte11xp: Digium Wildcard TE110P T1/E1/J1 - wct1xxp: - - Wildcard T100P (old single-span T1) - - Wildcard E100P (old single-span E1) + * Wildcard T100P (old single-span T1) + * Wildcard E100P (old single-span E1) - tor2: Tormenta quad-span T1/E1 card from the Zapata Telephony project - torisa: The old dual-span ISA T1 card from Zapata Telephony @@ -24,8 +24,8 @@ Digital Cards Analog Cards ~~~~~~~~~~~~ - wctdm24xxp: - - Digium TDM2400P card: up to 24 analog ports - - Digium TDM800P card: up to 8 analog ports + * Digium TDM2400P card: up to 24 analog ports + * Digium TDM800P card: up to 8 analog ports - wctdm: Digium TDM400P card: up to 4 analog ports - xpp: Xorcom Astribank: a USB connected unit of up to 32 ports (also BRI) @@ -74,7 +74,7 @@ Kernel Source / "Headers" kernel image. * On Debian Etch and above and any Ubuntu this is +++ linux-headers-`uname -r` +++ - * On Fedora RHEL and compatibles (e.g. CentOS) this is the + * On Fedora, RHEL and compatibles (e.g. CentOS) this is the kernel-devel package. Or if you run kernel-smp or kernel-xen, you need kernel-smp-devel or kernel-xen-devel, respectively. * On SUSE you seem to need the package kernel-source . @@ -139,7 +139,7 @@ You need the following non-kernel-related packages: yum install gcc newt-devel libusb-devel If the following command produces an error, you need to install -ithe kernel devel package: +the kernel devel package: ls /lib/modules/`uname -r`/build/.config @@ -195,7 +195,6 @@ SUBDIRS_EXTRA: Note that those names are not guaranteed to continue to work on newer versions. Hopefully there will be no need for such extra configuration. - Partial Build/Install ^^^^^^^^^^^^^^^^^^^^^ There are some make targets that are provided to build or install just @@ -218,7 +217,6 @@ parts of Zaptel: * make install-include: install zaptel.h - make config: should be run once to configure - Building to a Subtree ^^^^^^^^^^^^^^^^^^^^^ The following may be useful when testing the package or when preparing a @@ -260,6 +258,8 @@ time, use: ./ocnfig.status --recheck +Configuration +------------- zaptel.conf ~~~~~~~~~~~ The main method to configure Zaptel devices is using the utility @@ -272,6 +272,22 @@ configuration. Alternatively use the script genzaptelconf to generate one that should work with your system. +sysconfig/default +~~~~~~~~~~~~~~~~~ +The configuration file of the zaptel init.d script is either +/etc/default/zaptel (Debian systems) or /etc/sysconfig/zaptel (most +others). That file is used to override defaults that are set at the +beginning of the init.d script. + +For instance, to define for the init.d script to load the modules wctdm +and xpp_usb (in that order) add the following line to that file: + + MODULES="wctdm xpp_usb" + +Currently that file must set "TELEPHONY=yes" for the zaptel init.d to +work. + + Zaptel PERL modules ------------------- The directory xpp/utils has, in addition to helper utilities for the @@ -297,14 +313,30 @@ To get usage information on a program, you can also use perldoc (sometimes provided in a package separate from perl itself). For instance: - perldoc ./xpp/utils/xpp_blink + perldoc ./xpp/utils/lszaptel + +Some of them are specific for the Xorcom Astribank and described in its +docuemntation. the others are: -zapconf is currently experimental and intended to eventually replace -genzaptelconf by a more maintainable code. +lszaptel:: + A somewhat glorified `cat /proc/zaptel/*`. +zapconf:: + An currently experimental and intended to eventually replace + genzaptelconf by a more maintainable code. +zaptel_drivers:: + A two-liner script (not installed by default) that simply returns the + modules that should be modprobed on this system. +zaptel_hardware:: + Uses the information from sysfs and its own knowledge to show + what PCI/USB Zaptel hardware is connected and if it is currently used + by a driver. Shows also some more information for Astrobanks from + /proc/xpp . +Internals +--------- Zaptel Device Files -------------------- +~~~~~~~~~~~~~~~~~~~ Userspace programs will usually interact with Zaptel through device files under the /dev/zap directory (pedantically: characted device files with major number 196) . Those device files can be generated statically @@ -328,7 +360,7 @@ or dynamically through the udev system. Zaptel Timing -------------- +~~~~~~~~~~~~~ A PBX system should generally have a single clock. If you are connected to a telephony provider via a digital interface (e.g: E1, T1) you should also typically use the provider's clock (as you get through the @@ -368,7 +400,7 @@ description. Or even run: Spans and Channels ------------------- +~~~~~~~~~~~~~~~~~~ Zaptel provides telephony *channels* to the userspace applications. Those channels are channels are incoreperated into logical units called *spans*. @@ -418,7 +450,6 @@ see an extra '(In use)': 2 XPP_FXS/0/0/1 FXOLS (In use) -[[ppp]] PPP Support ----------- Zaptel digital cards can provide data channels through ppp as @@ -465,7 +496,7 @@ Links ----- - http://asterisk.org/[] - The Asterisk PBX - http://voip-info.org/[] -- http://voip-info.org/wiki/view/Asterisk+Zaptel+Installation -- http://www.zapatatelephony.org/ - A historical site. +- http://voip-info.org/wiki/view/Asterisk+Zaptel+Installation[] +- http://www.zapatatelephony.org/[] - A historical site. - http://rapid.tzafrir.org.il/docs/README.html[Up-to-date HTML version of this file] |