pcmser.device - An Amiga PCMCIA Modem Driver by Pontus Fuchs
                and Neil Cafferkey


Distribution Conditions
-----------------------
You may use pcmser.device and the source in ANY way you like.


Disclaimer
----------
This package is provided "as is" without warranty of any kind. The authors
assume no responsibility or liability whatsoever for any damage or loss of
data caused by using this package.


Introduction
------------
pcmser.device is a PCMCIA-modem driver for the A1200 and A600.

In order to work with pcmser.device, a modem must be:

 - 16-bit rather than 32-bit/CardBus.
 - A hardware modem rather than a "WinModem".

Most modems that meet these requirements should work fine, but unfortunately
they are becoming increasingly uncommon. You should look for modems that
work with both MS-DOS and Linux, but even this doesn't guarantee anything.


Compatibility
-------------

Modems reported to be compatible:

Megahertz 14400bps Faxmodem, Model #CC1144-49
Intelligent 56k Fax Modem
Motorola CELLect 14.4 PCMCIA Modem
PSION DACOM 56K+FAX Gold Card
Dynalink 1456CS

Modems reported to be incompatible:

Nokia GSM-card  (I just get a lot of strange ints all the time)
USR 16.8DS      (Seems to be incompatible with the A1200's PCMCIA port)
Dynalink 1456VQC-T5
3Com Megahertz 3CCEM556 B


Features
--------
7-8 databits
1-2 stopbits
110-115200 BAUD
CTS/RTS handshaking
EOF-mode supported

Not implemented:
CMD_BREAK
xON/xOFF handshake


Installation
------------
Just copy pcmser.device to DEVS: and make sure that you don't have a program
called "remcard" installed.


You can help me!
----------------
Please mail me if you find bugs or find a modem which doesn't work. If the
modem doesn't work test it with prepcard or "modemtest" which can be found
on Aminet.


History
-------
v0.5  97-08-05  First aminet release.

v0.6  97-08-24  Second aminet release.

                The SDCMD_QUERY-code was broken so CD and DSR didn't work.

                Added a little delay in OpenDevice() so that the modem
                can start up and activate its DSR.

                My IObase testingcode was broken so modems which has
                it's first configuration at $2f8 didn't work.

                Removed quickIO for CMD_READ. Either my code was broken
                or some programs can't handle quickIO for CMD_READ
                (ie NComm and Trapdoor). Anyway I'm to lazy to find out :)

v0.7  99-11-26  Third Aminet release (first release by Neil Cafferkey).

                Changed code to allow modems with missing parameters to
                work.

v0.9  00-02-08  Fourth Aminet release.

                Does a soft reset of the modem during device initialisation.

                Now returns IO_ERROR from OpenDevice().

                Deallocates resources if device initialisation fails.

v0.11 00-02-20  Fifth Aminet release.

                Doesn't soft reset the modem during device initialisation
                anymore.

v0.15 00-09-15  Sixth Aminet release.

                Cards can now have up to 64kb of I/O address space.

v0.17 02-09-02  Seventh Aminet release.

                Now checks that UART has space for a byte before sending it.

                Updated advice about what modems might work.


Thanks
------
Thanks to Pontus Fuchs for writing this driver and for letting me release
my changes in a new version, and to the people who sent me bug reports.


Current Maintainer
------------------
Neil Cafferkey
email: caffer@cs.ucc.ie


Original Author
---------------
Pontus Fuchs
email: pontus@tactel.se


Thanks to (from Pontus Fuchs)
-----------------------------
Johannes Carlsson    for lending me 2 modems.
Olov Lindberg        for lending me a modem.
Henric Andersson     for helping me with debugging.
Bruce Abbot          (maker of cnet.device) for inspiring me
                     to write this device.
Mikael Niczko        for BUYING me a modem. Thanks a LOT dude!
Glenn Björckén       for lending me a modem.

All of you who has tested different modems and mailed me!

 PERMSSN    UID  GID    PACKED    SIZE  RATIO METHOD CRC     STAMP          NAME
---------- ----------- ------- ------- ------ ---------- ------------ -------------
[generic]                  271     628  43.2% -lh5- 1f97 Nov 26  1999 pcmser.info
[generic]                 2128    3272  65.0% -lh5- 4011 Sep  2  2002 pcmser/pcmser.device
[generic]                 1983    4306  46.1% -lh5- ba6d Sep  2  2002 pcmser/Read Me
[generic]                  237     446  53.1% -lh5- 74ca Nov 26  1999 pcmser/Read Me.info
[generic]                  589    1502  39.2% -lh5- 15f1 Jan  5  2000 pcmser/source/cisreg.i
[generic]                  446    1363  32.7% -lh5- 1ac2 Feb  6  2000 pcmser/source/cistpl.i
[generic]                  142     305  46.6% -lh5- 3ebe Feb 28  2000 pcmser/source/macros.i
[generic]                  250     419  59.7% -lh5- dbea Sep 20  2000 pcmser/source/Makefile
[generic]                 7995   30532  26.2% -lh5- 50d6 Sep  2  2002 pcmser/source/pcmser.device.asm
[generic]                  345     815  42.3% -lh5- e6b1 Aug 25  2002 pcmser/source/pcmser.i
[generic]                  267     643  41.5% -lh5- ca8b Sep 16  2000 pcmser/source/uart.i
---------- ----------- ------- ------- ------ ---------- ------------ -------------
 Total        11 files   14653   44231  33.1%            Oct 13  2002