===================================================================
Symbol Technologies                                    Apr 18, 2000
Spectrum24/IEEE Software for Linux                     version 1.00
===================================================================

This file contains general information on the Spectrum24t 11Mb
IEEE PCMCIA Card, and specific information for the Linux software.

*******************************************************************

               Table of Contents:

        1. About the Linux Driver Source/Library distribution
        2. Installation
        3. Troubleshooting
        4. 
        5. Contents of the distribution
        6. Identifying the software
        7. Change History

*******************************************************************

1.  About the Linux Driver Source/Library distribution
    =======================================================

    The distribution archive spectrum24t-3.1.12-1.00.tgz contains driver
    source files for the 3.1.12 PCMCIA release. With this software you can build and 
    install a Spectrum24t/IEEE PC Card driver for your specific Linux kernel.
    Currently Linux kernel versions 2.0.x through 2.2.x for the Intel
    architecture are supported.

2.  Installation
    =======================================================

    1) Read the Linux PCMCIA-HOWTO by David Hinds.

    2) Extract the Spectrum24t/IEEE distribution archive into the standard
       PCMCIA distribution.
       % cd pcmcia-cs-3.1.12
       % tar xzvf ../spectrum24t-3.1.12-1.00.tgz

    3) Build and install the PCMCIA package as normal.
       % make config
       % make all
       % make install

    4) Configure the Spectrum24t/IEEE PC Card. Refer to the Spectrum24t/IEEE
       manual page (Spectrum24t.4) and the PCMCIA documentation for
       more information (network adapter sections).
       % man Spectrum24t
       % more PCMCIA-HOWTO
       % vi /etc/pcmcia/config.opts

         For example:
           a) Attaching to an access point with the network name of
              "My Network", enter the following in the config.opts file:
   
                module "Spectrum24t" opts "network_name=101 channel=3"
   
              Notice that space characters in an option value need to be
	      escaped with a backslash.
           b) Ad-Hoc (peer-to-peer) network without an access point, enter
              the following in the config.opts file:
   
                module "Spectrum24t" opts "port_type=3"
   
           c) Attach to an access point with the network name of "Ocean",
              and export the station name as "W24t_1", enter the following
              in the config.opts file:
   
                module "Spectrum24t" opts "network_name=Ocean station_name=S24t_1"

       % vi /etc/pcmcia/network.opts
         Modify the network options for your adapter. The parameters need
         to be correct for the connected network. Check with your system
         administrator for the correct network information. Refer to the
         PCMCIA-HOWTO for more configuration information.

         For example:
              *,*,*,*)
                  IF_PORT=""
                  BOOTP="n"
                  DHCP="n"
                  IPADDR="10.0.0.5"
                  NETMASK="255.255.255.0"
                  NETWORK="10.0.0.0"
                  BROADCAST="10.0.0.255"
                  GATEWAY="10.0.0.1"
                  DOMAIN="domain.org"
                  DNS_1="dns1.domain.org"
                  ;;

    5) Restart the PCMCIA services.
       % /etc/rc.d/rc.pcmcia restart
         or
       % /etc/rc.d/init.d/pcmcia restart


3.  Troubleshooting
    =======================================================

    When the Spectrum24t/IEEE PC Card is inserted, the card manager will emit 
    beeps in different tones to indicate success or failure of particular
    configuration steps.
      a) Two high beeps
         - The card was identified and configured successfully.
      b) One high beep followed by a low beep
         - The card was identified, but could not be configured.
         - Examine the system log (dmesg) for PCMCIA error or warning
           messages.
      c) One low beep
         - The card could not be identified.
         - Execute "cardctl ident" to display the adapter PnP information.
           Verify the PnP information matches an entry in the PCMCIA
           configuration file (/etc/pcmcia/config).
         - Examine the system log (dmesg) for PCMCIA error or warning
           messages.

    The Spectrum24t/IEEE PC Card has two LEDs that indicate the state of the
    adapter and network.
      * Power LED (toward the middle of the adapter)
        - This LED indicates power has been applied, and the card is
          functional. In normal operation mode with Card Power Management
          disabled, it will be steady-on. With Card Power Management
          enabled, it will blink rapidly (several times per second).
      * Transmit/Receive LED (closer to the edge of the adapter)
        - This LED will flash when it detects transmit or receive packets.

      * Both LEDs blink at the same time every 10 seconds.
        - The adapter was unable to make contact with the named wireless
          network. Verify the network_name, in the config.opts file matches
          the network name of the access point.
      * LEDs indicate normal operation with the Power LED steady-on or
        blinking rapidly and Transmit/Receive LED flashing, but no traffic.
        - If the network is operating in normal mode (ie. port_type = 0 or
          not specified), and a network_name has been specified, verify the
          workstation network parameters (ifconfig, route, etc.) are correct
          for the wireless network.
        - If the network is operating in Ad-Hoc (peer-to-peer) mode
          (ie. port_type = 3), the adapter needs another workstation/adapter
          to communicate with. Verify the network parameters on both of the
          workstations (ifconfig, route, etc.) are correct.

    Refer to Spectrum24t/IEEE manual page for additional configuration, feature
    and support information.
       % man Spectrum24t 
         or
       % man 4 Spectrum24t 
         or
       % nroff -man Spectrum24t.4 | more

    I have also noticed problems with the DHCP client that is distributed with
    RedHat 6.1.An easy upgrade to dhcp-3.0b1pl0.tar.gz fixed the problem.

4.  
    =======================================================



5.  Contents of the distribution
    =======================================================

    General information:
     README.Spectrum24t              This file
     Spectrum24t.mk                  Top level Makefile

    Driver source:
     clients/Spectrum24t.mk          Driver Makefile
     clients/Spectrum24t.c           Driver source
     clients/Spectrum24tHw.c         Driver HW source 
     clients/Spectrum24t.h           Driver include file
     clients/debug.h                 Driver debug support

    Driver online manual page:
     man/Spectrum24t.4               Driver manual page

    PCMCIA configuration update:
     etc/Spectrum24t.mk              PCMCIA configuration update Makefile
     etc/Spectrum24t.patch           PCMCIA configuration update patch file


6.  Identifying the software
    =======================================================

    The Linux Driver Source distribution consist of two source
    files, Spectrum24tSw.c and Spectrum24tHw.c.

    To identify a compiled Spectrum24t.o driver, goto the directory where
    the driver is located. Installed drivers are normally located in: 
    /lib/modules/<kernel-version>/pcmcia

    To retrieve the version of the source used to compile the driver, type:
    % strings Spectrum24t.o | grep Spectrum24tSw.c
    Spectrum24tSw.c 3.14 03/15/2000 16:30:00 (Symbol Technologies)


7.  Change History
    =======================================================

    $Log: README.Spectrum24t,v $
    Revision 1.4  2000/04/18 20:58:04  rtg
    Release 1.00

    Revision 1.3  2000/03/16 00:29:51  rtg
    Fixed PCMCIA version 3.12 --> 3.1.12

    Revision 1.2  2000/03/16 00:27:46  rtg
    Updated for 0.02

    Revision 1.1  2000/03/09 04:24:56  rtg
    Initial revision



*******************************************************************
                                END OF FILE
