README.TXT File Version 2.0 for
Infrared Stack (IrDA) Support for OS/2
September 23, 2004


Contents
========
1.0  Overview
2.0  IrDA Stack Installation Instructions
3.0  IrDA NDIS installation Instructions
4.0  IrDA Stack Un-Install Instructions
5.0  Hardware requirements
6.0  Configuration parameters
7.0  Copyright and Trademark Information


1.0  Overview
=============

This IRDA.EXE driver package provides you with IBM's most current support
for Infrared Stack (IrDA) devices on the OS/2 Operating System.

Following services are supported by the Infrared Stack:

   - printing to an IR-capable printer
   - serial communication through an IR-capable cell phone
   - LAN (Ethernet and Token Ring)
  
1.1  The IRDA.EXE file that you received contains the following files in
     a self-extracting compressed format.

        - README.TXT      This readme file
        - IRDA.DDP        Installation script file for DDINSTAL.EXE
        - IRDA_PHY.OS2    OS/2 IR physical driver (supports IR Tx, Rx, and
                          changing baud rate)
        - IRDA_PHY.MSG    Message file for IRDA_PHY.OS2
        - IRDA_PHY.SYM    Debug sybol file for IRDA_PHY.SYM
        - IRDA_DD.OS2     OS/2 IrDA protocol driver (include LAP layer, LMP
                          layer, and TTP layer)
        - IRDA_DD.MSG     Message file for IRDA_DD.OS2
        - IAS_DD.OS2      OS/2 Information Access Service (IAS) driver
        - IAS_DD.MSG      Message file for IAS_DD.OS2
        - IRCOMM.SYS      IrDA IrCOMM physical device driver that emulates a
                          serial com-port
        - IRCOMM.SYM      Debug sybol file for IRCOMM.SYS
        - PMIRDA.EXE      IrDA IrCOMM Presentation Manager frontend that talks
                          to the IrCOMM driver and allows status display and
                          settings
        - RXIRDA.DLL      IrDA IrCOMM Presentation Manager Rexx Interface
        - IRDANDIS.OS2    NDIS2 driver for OS/2 (requires IRDA_PHY,IRDA_DD and
                          IAS_DD)
        - IRDANDIS.NIF    Installation information file for IBM LAN software
                          for OS/2
        - IR1.MSG         NDIS driver message file
        - IR1H.MSG        NDIS driver message file


2.0  IrDA Stack Installation Instructions
===========================================================

2.1  Using IrDA Stack files

     To use these IrDA Stack files, you must expand the IRDA.EXE file into its
     15 component files by

        (a.) opening an OS/2 window and
        (b.) typing IRDA.EXE at the OS/2 command prompt.

     Please make sure you delete the old IrDA stack drivers from your
     CONFIG.SYS file. Once the IRDA.EXE file is expanded, please continue with
     the IrDA Installation Instructions.

2.2  Device Driver Install

     o  (Warp 3, Warp Server) Open the Device Driver Install program
        in the OS/2 System Folder/System Setup Folder.

     o  (Warp 4, Warp Server for e-business) Open the Device Driver
        Install program in the OS/2 System/System Setup/Install-Remove
        Folder.

2.3  Change Source directory to current (where component files reside) by
     pressing 'Change..." button.

2.4  Press "Install..." button to perform actual installation and "Exit" button
     installtion utility.

2.5  This completes the installation procedure. You must now REBOOT you system
     to initialize the IrDA Stack device driver support. Please make sure your 
     Infrared hardware is enabled (for Thinkpad users it could be done using
     IBM BIOS Setup Utility by pressing F1 key during BIOS screen is active or
     using corresponding Thinkpad Configuration Utility program available for
     download at following link: http://www.ibm.com/support/ddrivers.html).
        
2.6  After IrDA stack successfully loaded, you need to start Presentation
     Manager Discovery Daemon application (PMIRDA.EXE) that talks to the IrCOMM
     device driver for discovering available Infrared devices and allows status
     display (connection/disconnection). You may also add Presentation Manager Discovery
     Daemon application to your Startup folder for automatically starting every
     time your Workplace Shell loading up.

        
3.0  IrDA NDIS Installation Instructions
===========================================================

3.1  Installing IrDA NDIS as primary network adapter

     Use MPTS Network Adapters and Protocol Services from System Setup folder
     to install IRDANDIS.OS2 driver for Ethernet/Token Ring network support
     through IrDA stack.

     IrDA Stack also provides an NDIS (Network Driver Interface Specification
     2.01) programming interface. This code replaces the IR drivers that are
     shipped with Warp 4/Warp Server for e-business, which works on the 760
     series Thinkpads, but not on the newer ones.

     The drivers support the following software combinations: 

       o   OS/2 Warp 4.0 (TCP/IP 4.x, Peer networking, LAN Requester)
       o   OS/2 Warp Server for e-business
       o   Convenience Package for OS/2 Warp 4
       o   Convenience Package for OS/2 Warp Server for e-business
       
     All protocols which use NDIS (i.e. NetBIOS, TCP/IP, 802.2) may be used.
     The setup for all of these is similar:

       a)  Install the base OS/2 Infrared drivers (see above).

       b)  Install the communications product you are using with Warp, as
           listed in the supported products above. In each case select MPTS
           (Multi-Protocol Transport Services) as the transport method.
           Configure MPTS by clicking on its icon or by typing MPTS on an OS/2
           command line. Select "Configure" in the first panel. In the second
           panel, select LAN Adapter and Protocols, and click on "Configure". 
           If you are using a previous level of Infrared support (such as that
           shipped with OS/2 Warp 4.0), check in the Current Configuration for"
           IBM Infrared NDIS MAC driver". If it exists, select "Remove". If you
           have the "IBM IrDA NDIS2 driver" previously installed, you will need
           to select "Remove", then "OK", close, and reboot, since there are
           locked files. Restart MPTS and continue below. 

       c)  Under "Network Adapters", select "Other Adapters", then enter the
           path "x:\IRDD\NDIS". Files will be copied onto the hard disk into
           the \IBMCOM and \IBMCOM\MACS directories. Once the copying completes,
           select "IBM IrDA NDIS2 driver" from the list, and click on "Add".
           Under "Protocols", select the higher-level client protocols which
           will be required. Specify "TCP/IP" for TCP products, or "NetBIOS"
           for LAN Requester/Server and Peer Networking Products. 
                 
       d)  Edit the individual protocol selections: From "Current Configuration",
           select "IBM IrDA NDIS2 Driver" and select "Edit". To view the
           allowable values for any field, put the mouse cursor in the field,
           click and press F1. Enter a unique Network Address of the form
           "Xhhhhhhhhhhhh" where "h" is a hex character, or the
           locally-administered LAN address if you are connecting through an IR
           LAN Access Point. This address must be different from your session
           partner in a point-to-point setup, and unique in a LAN setup. If you
           are using a LAN Access Point, you must also configure the
           appropriate Type of LAN Emulation ("Ethernet" or "TokenRing"). Edit
           the client Protocol which you selected. 
                 
       e)  Click on "OK" to close and save your changes. After MPTS ends, you
           need to reboot your system. 


3.2  Installing IrDA NDIS as additional network adapter

     In order to install IrDA NDIS adapter as an additional adapter and maintain the 
     functionality of existing adapter use MPTS as described in 3.1, and afterwards
     you have to do following :
	
	a) if you use Warp 4, launch PEERINST.EXE application located in \IBMLAN\INSTALL
	   and choose to configure your workstation without re-installing MPTS. This 
	   utility will configure network adapter settings and will update IBMLAN.INI file.

	b) if you use Warp Server, Warp Server for e-Business or Convenience Pak version 
	   of OS/2, launch LANINST.EXE application located in \IBMLAN\INSTALL and choose 
	   to configure your workstation without re-installing MPTS. This utility will 
	   configure network adapter settings and will update IBMLAN.INI file.

     In the case of the adapter parameters needing to be changed, follow the installation
     tool help file guidelines.
     
     In case if PEERINST.EXE/LANINST.EXE is not installed on system, IBMLAN.INI file
     could be updated manually to enable secondary network. The following sections/items
     must be added/changed:
            [networks]

     net1 = NETBEUI$,0,LM10,34,100,14
     net2 = NETBEUI$,1,LM10,34,100,14
     ; Comment : Add network for second adapter
     
     [requester]

     wrknets = net1, net2 
     ; Comment : define the second network as working network
     
     [peer]

     srvnets = NET1, NET2
     ; Comment : define the second network as working network

     After LAN install application is finished updating the system you need to reboot 
     the system.


4.0  IrDA Stack Un-Install Instructions
================================================

4.1  Delete from CONFIG.SYS file lines configuring following drivers:

        -  IRDA_PHY.OS2
        -  IRDA_DD.OS2
        -  IAS_DD.OS2
        -  IRCOMM.SYS

     Use MPTS Network Adapters and Protocol Services from System Setup folder
     to un-install IRDANDIS.OS2 driver.

4.2  Safely shut down and then re-boot your system in order to remove the
     IrDA Stack drivers from the system configuration.


5.0  Hardware Requirements
==========================

     IrDA Stack drivers are designed to work on following IBM Thinkpad Models:

     380, 380D, 380E, 380ED, 380XD, 380Z, 385D, 385ED, 385XD, 560E, 560X, 560Z,
     600, 600E, 600X, 770, 770E, 770ED, 770X, T20, T21, T22, T23, T30, T40, T41
     T42.

     They do NOT work on the 560.

     Tests are performed for following systems:

     o  Thinkpad 600E, 600X, T20, T21

     Tests are performed for following adapters:

     o  ACTiSYS IR-220L+

     Tests are performed for following printers:

     o  HP LaserJet 6M/6MP

     Tests are performed for following cell phones:

     o  Nokia 6210, 7110
     o  Ericsson R320, SH888
     o  Siemens S25, S35i, ME45

     Tests are performed on following network protocols:

     o  IBM TCP/IP
     o  IBM OS/2 NETBIOS OVER TCP/IP
     o  IBM OS/2 NETBIOS (not recommended for large data amount transfers)


6.0  Configuration parameters
=============================

6.1  IRDA_PHY.OS2 parameter description

     Following parameters must be used to change IrDA stack physical layer
     driver settings:

     IRDA_PHY.OS2 [/Pn] [/In] [/Sn] [/Jn] [/Dn] [/En]

     /Pn         Hexdecimal port number.

     /In         Interrupt number.

     /Sn         Hexdecimal port number for SDLC.

     /Jn         Interrupt number for SDLC.

     /Dn         Transmit Tx DMA channel

     /En         Receive Rx DMA channel

     Note: current code isn't capable to recognize all existing Infrared
     hardware configurations automatically and therefore driver provides a 
     command line parameters interface which allows user to specify hardware
     configuration settings manually.
     
     If the driver doesn't recognize the hardware settings, it will serve
     Infrared adapter at 0x3F8 using IRQ4 (COM1 default settings) using SIR
     mode.
     
     Here is the list of possible configurations for Thinkpad models:

     Port:      3F8, 2F8, 3E8, 2E8
     Interrupt: 3, 4, 5, 7
     DMA:       0, 1, 3

     There is Thinkpad Configuration Utility program which allows to configure
     your Thinkpad hardware as well as to see the current settings. The program
     utility could be downloaded from web at following link:

        http://www.ibm.com/support/ddrivers.html. 
        
     There are GUI and command line interfaces provided by the program. The GUI
     version is selected by default and command line version will be installed
     by selecting 'Thinkpad Configuration for DOS' checkbox. To get current
     Infrared hardware configuration run following command in command line
     interface:
     
        PS2.EXE ? IR

6.2  IRDA_DD.OS2 driver parameters

     IRDA_DD.OS2 [/Wn] [/Nn]

     /Wn            Packet window size in range 1..7. Default value is 7. Used
                    to calculate physical layer receive buffer size by
                    following formula: 2k * n + 2k

     /Nn            Number of LSAP clients in range 1..112. Default value is 8.

6.3  IAS_DD.OS2 driver parameters

     IAS_DD.OS2 [/L]

     /L             Legacy mode support.

6.4  IRCOMM.SYS driver parameters (case sensitive)

     IRCOMM.SYS [/V] [/COMPORT:COMx]

     /V		     tells you which COM port the driver has assigned to itself

     /COMPORT:COMx  sets the COM port that IrCOMM will use


7.0 Copyright and Trademark Information
=======================================

The following terms are trademarks of International Business Machines
Corporation in the United States and/or other countries:

     o  IBM
     o  OS/2
     o  OS/2 Warp
     o  Thinkpad

Other company, product, and service names may be trademarks or service
marks of others.

THE INFORMATION PROVIDED IN THIS README IS PROVIDED "AS IS" WITHOUT 
WARRANTY OF ANY KIND.  IBM DISCLAIMS ALL WARRANTIES, WHETHER 
EXPRESSED OR IMPLIED, INCLUDING WITHOUT LIMITATION, THE IMPLIED 
WARRANTIES OF FITNESS FOR A PARTICULAR PURPOSE AND MERCHANTABILITY 
WITH RESPECT TO THE INFORMATION IN THIS DOCUMENT. BY FURNISHING
THIS DOCUMENT, IBM GRANTS NO LICENSES TO ANY PATENTS OR COPYRIGHTS.

(C) Copyright IBM Corporation, 2001, 2004. All rights reserved.
U.S. Government Users Restricted Rights -- Use, duplication or 
disclosure restricted by GSA ADP Schedule Contract with IBM Corp.
