[svn-commits] tzafrir: branch 1.4 r3147 - in /branches/1.4: ./ README

Tue Oct 16 15:25:30 CDT 2007

Author: tzafrir
Date: Tue Oct 16 15:25:29 2007
New Revision: 3147

URL: http://svn.digium.com/view/zaptel?view=rev&rev=3147
Log:
Update README yet again.

Modified:
    branches/1.4/   (props changed)
    branches/1.4/README

Propchange: branches/1.4/
------------------------------------------------------------------------------
Binary property 'branch-1.2-merged' - no diff available.

Modified: branches/1.4/README
URL: http://svn.digium.com/view/zaptel/branches/1.4/README?view=diff&rev=3147&r1=3146&r2=3147
==============================================================================

--- branches/1.4/README (original)
+++ branches/1.4/README Tue Oct 16 15:25:29 2007
@@ -10,13 +10,13 @@
 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 @@
 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 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 @@
   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
 
@@ -194,7 +194,6 @@
 
 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
 ^^^^^^^^^^^^^^^^^^^^^
@@ -218,7 +217,6 @@
     * 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 @@
   ./ocnfig.status --recheck
 
 
+Configuration
+-------------
 zaptel.conf
 ~~~~~~~~~~~
 The main method to configure Zaptel devices is using the utility
@@ -270,6 +270,22 @@
 installed by default to /etc/zaptel.conf . Edit it to suit your
 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
@@ -297,14 +313,30 @@
 (sometimes provided in a package separate from perl itself). For
 instance:
 
-  perldoc ./xpp/utils/xpp_blink
-
-zapconf is currently experimental and intended to eventually replace
-genzaptelconf by a more maintainable code.
-
-
+  perldoc ./xpp/utils/lszaptel
+
+Some of them are specific for the Xorcom Astribank and described in its
+docuemntation. the others are:
+
+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 @@
 
 
 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 @@
 
 
 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 @@
 
            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 @@
 -----
 - 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]


