ixj-driver-howto

mgcp协议源代码。支持多种编码：g711

Linux Quicknet-Linux-Driver-HOWTO
Quicknet Technologies, Inc. (www.quicknet.net)
Version 0.3.16  January 28, 2000
Copyright 1999-2000 Quicknet Technologies, Inc. 

1.0  Introduction

This document provides basic information on how to build and install
the newly GPL'd linux driver the Quicknet Internet PhoneJACK, Internet
PhoneJACK-PCI, Internet LineJACK, and Internet PhoneCARD telephony
cards.  More information about these cards is available at
http://www.quicknet.net.

These cards offer nice telco style interfaces to use your standard
telephone/key system/PBX as the user interface for VoIP applications.
The Internet LineJACK also offers PSTN connectivity for a single line
Internet to PSTN gateway.  Of course, you can add more than one card
to a system to obtain multi-line functionality. 

THE LINUX DRIVERS FOR QUICKNET CARDS ARE PRESENTLY IN A ALPHA
STATE.  SOME USERS MAY EXPERIENCE TROUBLES.

They are released early in the spirit of Internet development and to
make this technology available to innovators who would benefit from
early exposure.

When we promote the device driver to "beta" level it will be
considered ready for non-programmer, non-technical users.  Until then,
please be aware that these drivers may not be stable and may affect
the performance of your system.

IMPORTANT: if you are using the driver in the kernel then you need to
manually configure the card, but the separately available driver can
support isapnp which is much easier.  This situation will persist
until we can get isapnp into the kernel.  Until then, the version of
the driver included with the kernel requires manual card
configuration.  The stand-alone version of the driver distributed by
Quicknet supports isapnp by default, but can be built by the user to
support manual configuration if desired.

You can obtain the standalone driver from:

	http://www.quicknet.net/develop.htm


1.1 Latest Additions/Improvements

Refer to the CHANGES file for details on the latest changes and updates.


1.2 Copyright, Trademarks, Disclaimer, & Credits 

Copyright

Copyright (c) 1999-2000 Quicknet Technologies, Inc.  Permission is granted
to freely copy and distribute this document provided you preserve it
in its original form. For corrections and minor changes contact the
maintainer at [e-mail].

Trademarks

Internet PhoneJACK, Internet PhoneJACK-PCI, Internet LineJACK and
Internet PhoneCARD are registered trademarks of Quicknet Technologies,
Inc.

Disclaimer

Much of the info in this HOWTO is early information released by
Quicknet Technologies, Inc. for the express purpose of allowing early
testing and use of the Linux drivers developed for their products.
While every attempt has been made to be thorough, complete and
accurate, the information contained here may be unreliable and there
are likely a number of errors in this document. Please let the
maintainer know about them. Since this is free documentation, it
should be obvious that neither I nor previous authors can be held
legally responsible for any errors.

Credits

This HOWTO was written by:

	Greg Herlein <[e-mail]>
	Ed Okerson <[e-mail]> 


1.3  Future Plans: You Can Help 

Please let the maintainer know of any errors in facts, opinions,
logic, spelling, grammar, clarity, links, etc.  But first, if the date
is over a month old, check to see that you have the latest
version. Please send any info that you think belongs in this document.

You can also contribute code and/or bug-fixes for the sample
applications.


1.4  Where to get things

You can download the latest versions of the driver from:

	http://www.quicknet.net/develop.htm

You can download the latest version of this document from:

	http://www.quicknet.net/develop.htm


1.5  Mailing List

Quicknet operates a mailing list to provide a public forum on using
these drivers.

To subscribe to the linux-driver mailing list, send an email to:

   [e-mail]

In the body of the email, type:

   subscribe linux-driver <your-email-address>

Please delete any signature block that you would normally add to the
bottom of your email - it tends to confuse majordomo.

To send mail to the list, address your mail to 

   [e-mail]

Your message will go out to everyone on the list.

To unsubscribe to the mailing list, send an email to:

   [e-mail]

In the body of the email, type:

   unsubscribe linux-driver <your-email-address>



2.0  Requirements

You will need an Internet PhoneJACK, Internet PhoneJACK-PCI, Internet
LineJACK, or Internet PhoneCARD. The driver will support up to 16
cards in any one system, of any mix between the types.


3.0  Making the driver

3.1  Untar the distribution and enter the ixj directory.  Note that it
will be named something like ixj-0.3.16-gpl or similar.

IMPORTANT: if you are using the driver in the kernel then you need to
manually configure the card, but the separately available driver can
support isapnp which is much easier.  This situation will persist
until we can get isapnp into the kernel.  Until then, the version of
the driver included with the kernel requires manual card
configuration.  The stand-alone version of the driver distributed by
Quicknet supports isapnp by default, but can be built by the user to
support manual configuration if desired.

You can obtain the standalone driver from:

	http://www.quicknet.net/develop.htm


3.2  Internet PhoneJACK-PCI

If you are using ONLY the Internet PhoneJACK-PCI, then you do not need
to do use any external tools or worry about isapnp at all.  All you
have to do is enter the driver source code directory and type "make"
and let it do the work for you.

3.3  Internet PhoneCARD

If you are using ONLY the Internet PhoneCARD, then you do not need to
do use any external tools or worry about isapnp at all.  All you have
to do is enter the driver source code directory and type "make ixj-cs"
and let it do the work for you.  The makefile will build a card
services enabled driver and install it.

3.4  Internet PhoneJACK and Internet LineJACK 

You have two choices: you can use the default and use the isapnp
method of configuration and make your life easy, or you can configure
the driver by hand by editing a series of configuration files.

If you choose to use the manual method, you will need the isapnp tools
package to configure the cards.  This package probably came with your
Linux distribution.  Documentation on this package is available online
at:

http://mailer.wiwi.uni-marburg.de/linux/LDP/HOWTO/Plug-and-Play-HOWTO.html

We'd prefer that you use the new isapnp module that is distributed
with the driver source code.  This is the preferred method.  If you
choose this, you need not do anything other than type "make" and let
it do the work for you.

4.0 Manual Card Configuration

This applies ONLY to the Internet PhoneJACK and Internet LineJACK
products.  The Internet PhoneCARD and Internet PhoneJACK-PCI are not
configured by isapnp-tools!

4.1 Configuration of the hardware 

If you are new to the isapnp tools, you can jumpstart yourself by
doing the following:

   a.  run pnpdump to get a blank isapnp.conf file

        pnpdump > /etc/isapnp.conf

   b.  edit the /etc/isapnp.conf file to set the register IO
addresses.  Due to irregularities in isapnp-tools package, you will
have to change the following things too: 

       - Change the IO to WARNING on the top lines.  This will prevent
         a halt on error.

       - Remove the (CHECK) on each i/o range line to force the card to 
         go through.  

Pick IOPORT addresses for the Quicknet ports that do not conflict with
other ports in use by other ISA PnP devices.

   c.  if you have multiple Quicknet cards, make sure that you do not
have any overlaps.  Be especially careful if you are mixing Internet
PhoneJACK and Internet LineJACK cards in the same system.  Note that
the maximum i/o range of our cards is 0x3F0, not 0xFFF0.

4.2  Setting up the modules.conf file for an Internet PhoneJACK only:

You need to edit your modules.conf file to include the following:

	options ixj dspio=0xAAA 

note that 0xAAA must match the IOPORT number that you chose in the
isapnp.conf file.

4.2  Setting up the modules.conf file for an Internet LineJACK only:

You need to edit your modules.conf file to include the following:

	options ixj dspio=0xAAA xio=0xBBB

note that 0xAAA (dspio param) must match the first IOPORT number that
you chose in the isapnp.conf file, and the 0xBBB (xio param) must
likewise match the second IOPORT number.

4.3 Setting up the modules.conf file for an Internet PhoneJACK and
Internet LineJACK in the same system:

You need to edit your modules.conf file to include the following:

	options ixj dspio=0xAAA,0xMMM xio=0x000,0xPPP

The first port numbers apply to the Internet PhoneJACK which is dealt
with first.  The 0xAAA (dspio param) must match the IOPORT number that
you chose in the isapnp.conf file for the PhoneJACK.  The xio param
must be included, but must have a 0x000 value for the PhoneJACK.  The
second set of params (after the commas) apply to the Internet
LineJACK.  The 0xMMM (dspio param) must match the first IOPORT
configured for the LineJACK, and the 0xPPP (xio param) must likewise
match the second IOPORT number.


5.0  How to Make Use of the Driver

You should obtain the Software Development Kit from Quicknet.  This
will include documentation and sample code to show how to use the
driver.  You can obtain the latest SDK from:

	http://www.quicknet.net/develop.htm