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/
Linux ACP Modem (Mwave) mini−HOWTO
Table of Contents
1. General Information and Hardware Requirements....................................................................................1
1.1. Introduction.......................................................................................................................................1
1.2. Credits...............................................................................................................................................1
1.3. Where Can I Get the Latest Version of this Driver?.........................................................................1
1.4. Are There Any Other Resources?.....................................................................................................1
1.5. Copyright Notice and Disclaimer.....................................................................................................1
1.6. Which Systems are Supported..........................................................................................................2
1.7. Features of the Modem.....................................................................................................................2
2. Compilation, Installation, and Startup.........................................................................................................3
2.1. Prerequisites......................................................................................................................................3
2.2. Building and Installing Source.........................................................................................................3
2.3. Setting Things Up.............................................................................................................................3
2.4. Runtime.............................................................................................................................................4
2.4.1. Loading the ACP device driver........................................................................................4
2.4.2. Running ACP Modem Application...................................................................................5
3. Resolving Installation and Configuration Problems...................................................................................7
3.1. DSP Does Not Start..........................................................................................................................7
3.2. Resource Conflicts............................................................................................................................7
3.3. Not Connecting at Specified Starting Speed.....................................................................................8
3.4. Dialer Application Cannot Detect Serial Port...................................................................................8
3.5. PPP Errors Using 2.4.0 Version of the Kernel..................................................................................9
4. Debugging Tips..............................................................................................................................................10
4.1. Error Logs.......................................................................................................................................10
4.2. Tracing............................................................................................................................................10
5. Test Claims....................................................................................................................................................12
6. List of Supported Countries.........................................................................................................................13
7. Trademarks...................................................................................................................................................16
i
1. 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/
1.4. Are There Any Other Resources?
Thomas Hood's 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. General Information and Hardware Requirements 1
Linux ACP Modem (Mwave) mini−HOWTO
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.
1.6. Which Systems are Supported 2
2. 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. 1.
Change directories with cd mwavem−yyyymmdd2.
Use the ./configure command to configure the build options. Issue ./configure −−help to view all of
3.
the options. The defaults are probably okay though.
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.
4.
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
5.
(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
The mwavem.conf file is installed in the
/usr/local/etc directory unless you specified otherwise
during the build process
2. Compilation, Installation, and Startup 3
Linux ACP Modem (Mwave) mini−HOWTO
Country information (including access codes) are listed in the mwavem.conf file. For example, for France
the following section is present:
[Telephony\Country List\33]
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
2.4. Runtime
An initialization script has been provided which may be used to to start, stop, or check the status of the ACP
Modem driver and application. It has been successfully run on the Debian, Slackware, SuSE, and Red Hat
distributions and should run on any of their derivitives. If you are using the runtime script, it will load the
mwave device driver module, configure the serial port, and start the mwave manager for you. All of the
options which can be passed to the device driver module, along with some options for the script itself, can be
configured by uncommenting and editing the appropriate variables at the beginning of the script.
The mwaved startup script can be found in the src/mwavem directory of the source distribution. If you are
running the Red Hat distribution, you can copy the script to your /etc/rc.d/init.d directory and issue
the ntsysv command in order to enable it at boot time. If not using Red Hat, see the documentation for your
distribution for information on how to set this up to run at boot time.
It is recommended that you use the provided mwaved script. If you are not using the script, however, the
following sections will describe how to manually start the device driver and application.
2.4.1. Loading the ACP device driver
To load the mwave device driver use
insmod mwave
or
modprobe mwave
The following arguments may be supplied with the insmod command:
NOTE
2.4. Runtime 4
Loading...