Lucent Winmodem driver ver 5.78/5.95/5.99/6.00 for FreeBSD 4.x/5.x rev 0.7

!! This document was translated by Web translation service.
!! It may include a mistranslation or a strange expression.


The driver for Lucent LT Winmodem on FreeBSD 4.x/5.x.

  The version of this driver set:

    This driver set adapts to the version 5.78, 5.95, 5.99, 6.00 of ltmdmobj.o.

  The target modem.

    LT Winmodem on PCI-bus using the Mars DSP chip which has
    the following vendor/device ( or subvendor/subdevice ) combination.

    vender = 0x115d / device = 0x0000 to 0x000f  - Xircom
    vender = 0x115d / device = 0x0440 to 0x045c  - Xircom
    vender = 0x11c1 / device = 0x0440 to 0x045c  - Lucent

    If your machine is shown in the following list,
    in many cases, your modem will work.
    (Depending on the case, it may be needed to tune up BIOS settings of
     APM/ACPI, PNP, IRQ assignment, etc.)

      IBM:        Thinkpad (except models with mwave such as 600,600E,770x)
      Dell:       Inspiron
      Compaq:     Presario
      GateWay:    Solo
      Toshiba:    Portege, Satellite
      Panasonic:  Let's Note
      Fujitsu:    Lifebook
      Sony:       VAIO (some of desktop model)

  Components.

    ltmdmobj.o - The binary-only file for the core part of the Linux driver
                 which was supplied to modem manufacturers by Lucent/Agere.
    ltmdmsio.c - The serial driver based on sio.c, modified for Virtual-UART. And
                 The interface functions for DSP-control/Virtual-UART of ltmdmobj.o.

  The device name is "ltmdm".

  The device file names are:

      /dev/cual0           callout
      /dev/cuail0          callout, control_init_state
      /dev/cuall0          callout, control_lock_state
      /dev/ttyl0
      /dev/ttyil0          control_init_state
      /dev/ttyll0          control_lock_state

      The device file name which corresponds to "/dev/cuaa0" of sio0
      is "/dev/cual0".

  The device major number is temporarily set to 228.

    from ${SYSDIR}/conf/majors:

      entries from 200-252 are reserved for local use

  Since ltmdmobj.o - the core part of the driver - is provided without
  source code and is distributed as a part of LGPL'ed(?) Linux driver,
  I have decided to make the driver for FreeBSD as a KLD module.
  You do not need to re-make a kernel.

  The place I downloaded ltmdmobj.o.

    i56lvp578.zip, linux595.zip :

      http://www.lectron.com.tw/DOWNLOAD/LUCENT/

    linux599.zip, linux600.zip :

      http://www.sfu.ca/~cth/ltmodem/archive/

  Limitation

    Two (or more) modems on one machine is not supported at this time.

    It may work, if you make two (or more) drivers which have
    independent device name and independent major number for each modem.

  Related sites.

    Lucent LT Win Modem

      http://808hi.com/56k/ltwin.htm

    linmodems.org

      http://www.linmodems.org/

    linmodems.org - mailinglist archives

      http://www.linmodems.org/cgi-bin/ezmlm-cgi/1

    Winmodems are not modems

      http://www.idir.net/~gromitkc/winmodem.html

    Lucent/Agere systems  V.90/K56flex

      http://www.agere.com/K56flex/

  Change Log

  * rev 0.1  2001.03.13

    * The first prototype.

  * rev 0.2  2001.03.18

    * ltmdmsio.c/ltmdm_pci_attach: Fixed - FIFO was disabled.
    * ltmdmsio.c/ltmdm_pci_probe: Added a check for vendor_id/device_id
      before calling lucent_detect_modem in ltmdmobj.o.

  * rev 0.3  2001.03.23

    * ltmdmsio.c/ltmdm_pci_attach: Added auto detection for PCI ioport base register.
    * ltmdmsio.c/ltmdm_pci_attach: Changed to try to allocate irq with
      shareable/non-fast mode if failed with non-shareable/fast mode.
    * ltmdmsio.c/siosetwater: Increased input buffer size to avoid buffer overflow.
    * ltmdmsio.c/ltmdm_pci_detach: Rewritten.
        thanks to ohki@gssm.otsuka.tsukuba.ac.jp(Atsuo Ohki)

  * rev 0.4  2001.03.28

    * ltmdmsio.c/ltmdm_pci_detach: Fixed.
        thanks to ohki@gssm.otsuka.tsukuba.ac.jp(Atsuo Ohki)
    * ltmdmsio.c: Changed so that the excessive code for debugging messages
      will not be compiled.
    * INSTALL.TXT: Added a example of settings for country code.

  * rev 0.5  2001.09.15

    * ltmdmsio.c: Added 5.0-CURRENT support. (It has not fully tested.)
    * ltmdmsio.c/ltmdm_pci_attach: Changed the priority of hardware interruption
      for DSP from INTR_TTY to INTR_NET. (The measure for the problem that the
      modem is disconnected when the load of CPU becomes heavy on 5.0-current.)
      The priority of software interruption is still SWI_TTY.
    * ltmdmsio.c/ltmdm_pci_attach: Changed so that it does not try to allocate
      irq with non-shareable/fast mode, always apply shareable/non-fast mode.
    * INSTALL.TXT: Changed so that only ltmdm.ko could be made alone,
      without compiling other modules.
    * Makefile: Changed so that ltmdmobj.o might not be deleted by "make clean".

  * rev 0.6  2001.10.15

    * ltmdmsio.c: Adapted for ltmdmobj.o of version 6.00.
 
  * rev 0.7  2002.03.11

    * ltmdmsio.c: Adapted for ltmdmobj.o of version 5.95 and 5.99.
 
------------------------------------------------------------------------------