Linux ACP Modem (Mwave) mini-HOWTO, Mike Sullivan [best summer reads .txt] 📗

Linux ACP Modem (Mwave) mini-HOWTO

Mike Sullivan

sullivam@us.ibm.com

Paul Schroeder

paulsch@us.ibm.com

Joy Yokley - Edited document and coverted to DocBook v4.1 (SGML).

2001-01-12

Revision History

Revision .11 2002-07-18 Revised by: PBS

Revision .10 2001-07-18 Revised by: PBS

Revision .09 2001-05-21 Revised by: PBS

Revision .08 2001-05-09 Revised by: JEY

Revision .07 2001-04-30 Revised by: JEY

This document describes how to build, setup, and use the driver and user

space application necessary for using the ACP (Mwave) Modem in the IBM

Thinkpad?? 600, 600E, and 770 models which include the on board ACP modem

hardware. The latest version of this document can always be found at [http://

www.ibm.com/linux/ltc/] http://www.ibm.com/linux/ltc/

Table of Contents

General Information and Hardware Requirements

1.1. Introduction

1.2. Credits

1.3. Where Can I Get the Latest Version of this Driver?

1.4. Are There Any Other Resources?

1.5. Copyright Notice and Disclaimer

1.6. Which Systems are Supported

1.7. Features of the Modem

Compilation, Installation, and Startup

2.1. Prerequisites

2.2. Building and Installing Source

2.3. Setting Things Up

2.4. Runtime

Resolving Installation and Configuration Problems

3.1. DSP Does Not Start

3.2. Resource Conflicts

3.3. Not Connecting at Specified Starting Speed

3.4. Dialer Application Cannot Detect Serial Port

3.5. PPP Errors Using 2.4.0 Version of the Kernel

Debugging Tips

4.1. Error Logs

4.2. Tracing

Test Claims

List of Supported Countries

Trademarks

General Information and Hardware Requirements

1.1. Introduction

The ACP Modem for Linux is a software based modem. Support software for the

ACP modem is composed of a loadable kernel module and a user level

application. Together these components support direct connection to public

switched telephone networks (PSTNs) and support selected countries world

wide. Refer to Section 6 of this document for the supported country list.

The modem also supports the standard communications port interface (ttySx)

and is compatible with the Hayes AT Command Set.

ACP Modem software is continually under development. If you encounter bugs or

usability issues, please contact us and we'll work to correct them.

1.2. Credits

This Linux ACP Modem driver was ported from the Windows NT?? version of the

driver available from IBM. Many thanks to Keith Frechette, Charles Ball, and

Frank Novak for their technical and support efforts in making this project

possible.

1.3. Where Can I Get the Latest Version of this Driver?

The latest version of this driver is available from [http://www.ibm.com/linux

/ltc/] http://www.ibm.com/linux/ltc/

1.4. Are There Any Other Resources?

Thomas Hood's [http://panopticon.csustan.edu/thood/tp600lnx.htm] Debian GNU/

Linux on IBM ThinkPad 600 and 600x page contains lots of useful information.

1.5. Copyright Notice and Disclaimer

Copyright (c) 2002 IBM Corporation

This document may be reproduced or distributed in any form without prior

permission. Modified versions of this document may be freely distributed,

provided that they are clearly identified as such, and this copyright is

included intact.

This document is provided "AS IS", with no express or implied warranties. Use

the information in this document at your own risk.

1.6. Which Systems are Supported

This version of the ACP Modem driver supports the IBM Thinkpad?? 600E, 600,

and 770 that include on-board ACP modem hardware.

1.7. Features of the Modem

The ACP Modem provides the following features:

��*�Standard asynchronous COM port interface (NS16550A UART compatible)

operation

��*�Bell-103/212A, CCITT-V.21/V.22,V.22bis protocols with data from 300 to

2400 bps

��*�CCITT-V.32 protocols with data rates of 4800, 9600 uncoded, and 9600 bps

Trellis coded (Optional)

��*�CCITT-V.32bis protocols with data rates of 4800, 9600, 12000, and 14400

bps (optional)

��*�ITU-T V.34 protocols with data rates from 2400 to 33600 bps.

��*�56K capable modem

��*�Hayes AT Command Set compatibility

��*�DTMF and pulse dialing

��*�Asynchronous error recovery protocol

��*�Error correction via Microcom Network Protocol (MNP) classes 1-4

��*�Error correction via the V.42 error correction standard

��*�MNP class 5 for up to 2x data compression

��*�V.42bis for up to 4x data compression

��*�"Adaptive Rate Negotiation" which provides for "Fallback / Fallforward"

as line quality deteriorates or improves

Your modem contains 56K technology. To take advantage of this technology, you

must first make sure that your Internet Service Provider (ISP) supports a 56K

modem protocol. Significantly higher modem connection speeds, up to 56kbps,

require all-digital transmission connections from your ISP to the line card

in the central office from which your phone line is connected. The actual

connection rate may be limited by the quality of your telephone lines.

Telephone line quality may vary from location to location. Current

regulations limit maximum trasfer rates to 53K. While your modem contains 56K

technology, typical maximum connection rates in the receive direction may be

significantly less than 56K. Currently, 56K capability is for the receive

direction only. The transmit direction uses V.34 technology.

Compilation, Installation, and Startup

2.1. Prerequisites

��*�A 2.2.16 series (or later) Linux kernel source tree

��*�An appropriate set of module utilities

��*�gcc version 2.7.x or later

If you are building the ACP Modem driver along with the user space

application, you need to have a complete Linux source tree for your kernel,

not just an up-to-date kernel image.

2.2. Building and Installing Source

Use tar xzvf mwavem-yyyymmdd.tar.gz to unpack the distribution.

Change directories with cd mwavem-yyyymmdd

Use the ./configure command to configure the build options. Issue ./

configure --help to view all of the options. The defaults are probably

okay though.

Note NOTE

� As of mwavem-1.0.3 you must give ./configure the

--enable-mwavedd argument in order to build the driver with the user space application.

Use the make command to build all of the ACP Modem binaries.

Note NOTE

� Your gcc package should be at least at the 2.7.x level.

Check your /usr/src/linux/Documentation/Changes file for the minimum version information.

Use make install to install the mwavem binary, mwavem.conf configuration,

the extra binary (mostly .dsp) files, and module device driver (if you

specified that it must be built) and to create the /dev/modems/mwave

device node.

2.3. Setting Things Up

In the [WORLDTRADE] section of your mwavem.conf file, set the Country=

parameter to your country access code.

Note NOTE

� The mwavem.conf file is installed in the /usr/local/etc directory unless

you specified otherwise during the build process

Country information (including access codes) are listed in the mwavem.conf

file. For example, for France the following section is present:

[TelephonyCountry List33]

CountryCode=00000021

Name=France

SameAreaRule=0FG

LongDistanceRule=0FG

InternationsalRule=00EFG

To set France to be your configured country in the [WORLDTRADE] section of

mwavem.conf,

+---------------------------------------------------------------------------+

|set Country=33