IXJ-DRIVER-HOWTO
上传用户:sy_wanhua
上传日期:2013-07-25
资源大小:3048k
文件大小:9k
- 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 gherlein@quicknet.net.
- 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 <gherlein@quicknet.net>
- Ed Okerson <eokerson@quicknet.net>
- 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:
- majordomo@lists.quicknet.net
- 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
- linux-driver@lists.quicknet.net
- Your message will go out to everyone on the list.
- To unsubscribe to the mailing list, send an email to:
- majordomo@lists.quicknet.net
- 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
-