TRCFGC Configuration Program
============================
            
                                             CSS 1.0(0), October 1996
                                             ------------------------

This utility allows the user to configure various aspects of AT Plus, 
ISA Client Plus,  Plug and Play,  PCMCIA,  CARDBUS, and  PCI  adapter
cards.  It may be run under DOS or  OS/2 from a DOS box or as an OS/2
application.

AT Plus and ISA Client Plus Adapters
------------------------------------

The AT Plus adapter cards are fitted with 4 switches, but the bulk of
the configuration information is held in a device on the adapter.

The switches  are  described  in  detail  in the AT Plus installation
documentation,  but  of  the  4 switches only  the  IO and ROM_ENABLE 
switches are meaningful to the AT Plus configuration program.

At "power up" the contents of the CMOS device is compared with the IO
and ROM_ENABLE switches.  If  the comparison  fails  the card will be
disabled for  use  by the  driver software.  This is until either the 
switches are restored  or until  the AT Plus configuration program is 
run to correct the CMOS contents.

It is important that the configuration utility  (TRCFGC) is run after
any changes are made to the hardware switch settings or the card will
be left in a disabled state and will not  be accessible by any driver
software or by DIAG when it attempts to test the adapter.

As  delivered,  the   switches   will   match   the  factory  default 
configuration in the CMOS device and the card will be enabled.

If you wish to change the IO location or the status of the ROM_ENABLE
switch, you must  alter these  switches  to  match your requirements,
before installing the adapter, and then run the AT Plus configuration
program.

To run the AT Plus configuration program, you must boot your system
under DOS and then enter :

 TRCFGC [command line options]

at the DOS prompt.


Entering   "TRCFGC /?"   will   display  help  information about  the 
command-line options that are available.


Entering :

 TRCFGC

will cause the program to enter  a  menu-based session with the user.

The configuration program will display  the new configuration details 
before returning to DOS.

The card will be directly  configured  unless the adapter in question
is currently running network software.  In this case the user will be
advised that a HARD RE-BOOT is required.

The program will  attempt  to  identify  resources (such as DMA, IRQ,
MEMORY and I/O  addresses) that  are or  may be  being  used by other
devices in the system,  and will  display a warning if those settings 
are chosen.



Command-Line Options
--------------------

The command-line options currently supported are :-

/IO=hhhh        - Where hhhh is the  hexadecimal  IO  address  of the
                  adapter to  be  configured (Must  match  the switch 
                  setting).

                  Valid values are - 0a20, 1a20, 2a20, 3a20

                  If  this  is specified the program will verify that 
                  the adapter at this address is an AT Plus card.

                  If not specified  the program  will search  for and
                  list any AT  Plus adapters  and  ask the user which 
                  one is to be configured.


/16BITBUSMASTER - Sets up a default data  transfer  method to use BUS
                  MASTER DMA over channel 5,  with  NORMAL (rev4) bus
                  timing, ASYNCH bus mode and a 16 bit BUS width.

                  DMA is not available on ISA Client Plus cards.

                  Note If this switch is specified before any usage of
                       the  /SYNCH,  /ASYNCH,  /DMA,  /NORMAL, /OTHER,
                       switches  then  they will be used to modify the
                       defaults used by this switch.

/8BITBUSMASTER  - Sets up a  default data  transfer method to use BUS
                  MASTER DMA  over channel  5, with  OTHER (rev3) bus
                  timing, ASYNCH bus mode and an 8 bit BUS width.

                  DMA is not available on ISA Client Plus cards.

                  Note If this switch is specified before any usage of
                       the  /SYNCH, /ASYNCH,  /DMA,  /NORMAL,  /OTHER,
                       switches then  they  will be used to modify the
                       defaults used by this switch.

/16BITPIO       - Sets up a default data  transfer  method to use PIO
                  for data  transfers, with NORMAL (rev4) bus timing, 
                  and a 16 bit BUS width.

                  Note If this switch is specified before any usage of
                       the /NORMAL, /OTHER, switches then they will be
                       used to modify the defaults used by this switch

/8BITPIO        - Sets up a default  data transfer  method to use PIO
                  for data transfers, with NORMAL (rev4)  bus timing,
                  and an 8 bit BUS width.

                  Note If this switch is specified before any usage of
                       the /NORMAL, /OTHER, switches then they will be
                       used to modify the defaults used by this switch

/DMA=nn         - Where nn is the DMA channel the adapter is to use.

                  Valid values are - 0, 3, 5, 6

                  0 will cause DMA to be disabled and for the adapter
                  software to use PIO for data transfer.

                  DMA is not available on ISA Client Plus cards.

/PIO            - Causes the card to use DMA channel 0 (PIO) for data
                  transfers.

/INT=nn         - Where nn is the interrupt (IRQ) channel the adapter
                  is to use.

                  Valid values are - 2, 3, 5, 7, 10, 11, 12, 15


/NORMAL         - Selects the system bus timing to be "normal" (Rev 4)
/OTHER          - Selects the system bus timing to be "other".


/ASYNCH         - Selects the ASYNCHRONOUS bus timing mode.
/SYNCH          - Selects the SYNCHRONOUS bus timing mode.


/8_BIT          - Defines that an 8 bit I/O width is to be used.
/16_BIT         - Defines that an 16 bit I/O width is to be used.


/4MBITS         - Selects a ring speed of 4Mbps.
/16MBITS        - Selects a ring speed of 16Mbps.


/FACTORYDEF     - Resets the configuration to the   factory  defaults
                  before applying other configuration changes.

                  Normally the  current contents  of the  CMOS device
                  are used as the basis of the new  configuration and
                  then altered  as  per  the  specified  command line 
                  options.

                  However, the user may specify this command to force
                  the adapter configuration back to a known state.
        
                  This command may be specified on  its  own (with or
                  without the /IO=  and /NEWIO=  commands) to put the
                  card back to an "as shipped" state.

                  The  user  must  ensure  that  the  switches (where
                  fitted) match the new configuration.

                  Note The factory default command  will  restore all
                       settings  back to  the  shipping default, with 
                       the  exception  of   the   IO  and  ROM_ENABLE 
                       sections.  These  are ALWAYS  set to match the 
                       current adapter switch settings (if fitted).


/READCONFIG     - Will  display  the  current  configuration  of  the
                  adapter without modifying the settings.

                  This  command is meaningless with most of the other
                  command line options, except /IO=.


/ENABLE         - Forces  the  values of the adapter IO Address, ring
                  speed,   and   ROM   Enable   switches   into   the 
                  configuration and enables the adapter.

/NOMORE         - Disables  the  screen   paging   facility  allowing
                  continuous output to the screen.

/AUTO_RS_DETECT - Will cause TRCFGC to attempt to determine  the ring
                  speed  of  the  attached network and, if  different
                  from  the  configured  value,  ask the  user if the 
                  detected value is to be used instead.  
                  This feature is only  present  on  certain adapters 
                  and  then  only  if  they are not  running  network
                  software.   In  addition,  if  the  user selects  a
                  ringspeed that is different from the detected value
                  then a warning will be displayed.



Examples
--------

A. If the user is installing a single card in a system and intends to
   use the shipping default settings (and the card is new)  the  user
   will not need to run the AT Plus configuration utility.

   If however the adapter is in an unknown state then it is suggested
   that the cards  switches  be  set  to  the  required  settings and 
   installed in a system and the following command line used :

        TRCFGC /IO=<io address> /FACTORYDEF

   Or the user can enter one  of the  following  command  lines which
   will then enter an  interactive mode  allowing the user to specify 
   the IO address of the adapter and then examine, modify, and update
   the configuration :

        TRCFGC
   or
        TRCFGC /IO=<io address>


B. If the user  wishes to install a  second card  into a system at an
   I/O address of  2a20  and  have the bootrom disabled he should set 
   the adapter IO and ROM  switches to the required settings and then 
   run TRCFGC as follows :

        TRCFGC /IO=2a20


C. If the user then wishes to  alter the DMA  channel on the existing
   card at 0a20  to DISABLED  (use PIO), the  following command  line 
   should be used :

        TRCFGC /IO=0a20 /DMA=0


D. To restore a card to the factory settings the user  should set the
   switches to the  factory  default  settings (see  the adapter card
   documentation) and use the following command line :

        TRCFGC /IO=0a20 /FACTORYDEF


E. To restore a card to the factory settings, but move the card to an
   IO address of 2a20, retain the ROM  settings and set the interrupt
   channel to 3,  the user  should  alter the switches to reflect the
   new IO address and use the following command line :

        TRCFGC /IO=3a20 /NEWIO=2A20 /FACTORYDEF /INT=3


PLUG AND PLAY SUPPORT
---------------------

This version of TRCFGC includes support for the Smart 16/4 ISA Client 
PNP ringnode.

The operation of the utility is similar  to  that for  AT  Plus cards 
with the following exceptions and a number of different  command line
option switches.

The utility includes  code  that  will locate and  temporarily enable
Madge  Plug aNd Play  (PNP) cards  to allow  them to be configured if
they are in the default "PNP mode".

The cards support 2 modes of operation :

        Full PNP - where the card  powers up  in an INACTIVE state on
                   the   bus   and   requires  the  services of a PNP
                   configuration   manager  or   the  Madge  PNPENABL
                   utility.

         NON-PNP - where the card  powers  up  at a user specified IO
                   address and  IRQ  channel. This would typically be
                   done where the user does not have a  configuration
                   manager or does not wish to use one.

On  systems with BIOSs  that  have PNP support, if the adapter is put
into NON-PNP  mode  at  a  specific IO address the BIOS may decide to
re-configure the card.   This  may happen if the BIOS detects a clash
with another adapter  or with  an  alias of the IO address of another
card.   If  this  occurs  the  card  will be displayed in the initial
screen at the  address  chosen   by  the  BIOS  but the configuration
screens will display  the  value chosen by the user.  The user should
reconfigure the adapter to use PNP mode or choose a new IO address.


Command Line Options
--------------------

The command line options currently supported are :-

/IO=hhhh        - Where hhhh  is  the  hexadecimal  IO address of the
                  adapter to  be  configured.

                  Valid values are - 0920, 0940, 0960, 0980, 0a20,
                  0a40, 0a60, 0a80, 0b20, 0b40, 0b60, 0b80

                  If this  is  specified the program will verify that
                  the adapter at this address is a PNP card.

                  If not  specified  the program  will search for and
                  list any PNP adapters and ask the user which one is
                  to be configured.

/PNP            - Puts the card into FULL PNP mode.

/NONPNP         - Puts the card into NON-PNP mode.

/8BITSLOT       - Specifies  that the card is mounted in an 8 bit bus
                  slot and therefore cannot use IRQ's above 7.

/16BITSLOT      - Specifies that the card is mounted in a  16 bit bus
                  slot.

/32BITPIO       - Sets up a default  data transfer  method to use PIO
                  for data transfers, with NORMAL (rev4)  bus timing,
                  and a 32 bit data transfer width.

                  N.B If this switch is specified before any usage of
                      the /NORMAL, /OTHER, switches then they will be
                      used to modify the defaults used by this switch

/8BITPIO        - Sets up a default data  transfer method  to use PIO
                  for data transfers, with NORMAL  (rev4) bus timing,
                  and an 8 bit data transfer width.

                  N.B If this switch is specified before any usage of
                      the /NORMAL, /OTHER, switches then they will be
                      used to modify the defaults used by this switch

/INT=nn         - Where nn is the interrupt (IRQ) channel the adapter
                  is to use.

                  Valid values are - 2, 3, 7, 10, 11, 15


/NORMAL         - Sets the system bus timing to be "normal" (Rev 4).
/OTHER          - Sets the system bus timing to be "other".


/8BITIO         - Defines that an 8 bit data transfer width is to  be
                  used.
/32BITIO        - Defines that an 32 bit data transfer width is to be
                  used.


/4MBITS         - Selects a ring speed of 4Mbps.
/16MBITS        - Selects a ring speed of 16Mbps.


/FACTORYDEF     - Resets  the  configuration to the  factory defaults
                  before applying other configuration changes.

                  Normally the current  contents of  the  CMOS device
                  are used as the  basis of the new configuration and
                  then  altered  as  per  the specified  command line
                  options.

                  However, the user may specify this command to force
                  the adapter configuration back to a known state.
        
                  This command may be specified (with or without the 
		  /IO=  and  /NEWIO= commands) to  put the card back 
		  to an "as shipped" state.


/READCONFIG     - Will  display  the  current  configuration  of  the
                  adapter without modifying the settings.

                  This  command is meaningless with most of the other
                  command line options, except /IO=.


/NOMORE         - Disables   the   screen  paging  facility  allowing
                  continuous output to the screen.


/AUTO_RS_DETECT - Will cause TRCFGC to attempt to determine  the ring
                  speed  of  the  attached network and, if  different
                  from  the  configured  value,  ask the  user if the 
                  detected value is to be used instead.  
                  This feature is only  present  on  certain adapters 
                  and  then  only  if  they are not  running  network
                  software.   In  addition,  if  the  user selects  a
                  ringspeed that is different from the detected value
                  then a warning will be displayed.



AT PLUG AND PLAY SUPPORT
------------------------

This  version  of  TRCFGC  includes support for the Smart 16/4 AT PNP
ringnode.

This card is very simmilar to the PLUG and PLAY card described in the
previous section, but with additional data transfer methods and
support for a remote boot ROM.

Memory Mapped  IO  (MMIO), Bus  Master  DMA  (16 bit  and 8  bit) are
supported.

Command Line Options
--------------------

The command line options currently supported are :-

/IO=hhhh        - Where  hhhh  is  the  hexadecimal IO address of the
                  adapter to be configured.

                  Valid values are - 

                        0920, 0940, 0960, 0980, 
                        0a20, 0a40, 0a60, 0a80, 
                        0b20, 0b40, 0b60, 0b80.

/PNP            - Puts the card into PNP mode.

/NONPNP         - Puts the card into NON-PNP mode.

/8BITSLOT       - Specifies that the card is mounted in an  8 bit bus
                  slot and therefore cannot use IRQ's above 7.

/16BITSLOT      - Specifies that the card is mounted in a  16 bit bus
                  slot.

/16BITBUSMASTER - Sets up a default  data transfer  method to use BUS
                  MASTER DMA over channel 5,  with NORMAL  (rev4) bus
                  timing, ASYNCH bus mode and a 16 bit BUS width.

                  N.B If this switch is specified before any usage of
                      the  /SYNCH, /ASYNCH,  /DMA,  /NORMAL,  /OTHER,
                      switches then they will  be used  to modify the
                      defaults used by this switch.

/8BITBUSMASTER  - Sets up a default  data  transfer method to use BUS
                  MASTER DMA  over  channel 5,  with OTHER (rev3) bus
                  timing, ASYNCH bus mode and an 8 bit BUS width.

                  N.B If this switch is specified before any usage of
                      the  /SYNCH,  /ASYNCH,  /DMA,  /NORMAL, /OTHER,
                      switches then they will  be  used to modify the
                      defaults used by this switch.

/32BITPIO       - Sets up a default  data transfer  method to use PIO
                  for data transfers, with  NORMAL (rev4) bus timing,
                  and a 32 bit data transfer width.

                  N.B If this switch is specified before any usage of
                      the /NORMAL, /OTHER, switches then they will be
                      used to modify the defaults used by this switch

/8BITPIO        - Sets up a default  data transfer  method to use PIO
                  for data transfers, with  NORMAL (rev4) bus timing,
                  and an 8 bit data transfer width.

                  N.B If this switch is specified before any usage of
                      the /NORMAL, /OTHER, switches then they will be
                      used to modify the defaults used by this switch

/MMIO           - Sets up  a  default  data  transfer  method  to use
                  Memory Mapped I/O for the data transfer method.

                  The /MEM= switch should  be  used to  specifiy  the
                  memory base address  to be  used (it is the same as
                  the smartrom if enabled).

/MEM=hhhhh      - Defines the memory start address to be used for the
                  smartrom and/or MMIO.

                  Valid values are - 

                    D2000, D4000, D6000, D8000,
                    DA000, DC000, and DE000.

/INT=nn         - Where nn is the interrupt (IRQ) channel the adapter
                  is to use.

                  Valid values are - 2, 3, 5, 7, 10, 11, 12, 15.

                  NB 10, 11, 12, and 15 are only  valid in  a 16  bit
                  system slot.

/DMA=nn         - Where nn is the DMA channel the adapter is to use.

                  Valid values are - 3, 5, 6

/NORMAL         - Sets the system bus timing to be "normal" (Rev 4).
/OTHER          - Sets the system bus timing to be "other".


/8BITIO         - Defines  that an 8 bit data transfer width is to be
                  used.
/32BITIO        - Defines that an 32 bit data transfer width is to be
                  used.


/4MBITS         - Selects a ring speed of 4Mbps.
/16MBITS        - Selects a ring speed of 16Mbps.


/FACTORYDEF     - Resets  the  configuration  to the factory defaults
                  before applying other configuration changes.

                  Normally  the  current contents  of the CMOS device
                  are used  as the basis of the new configuration and
                  then altered  as  per  the  specified  command line
                  options.

                  However, the user may specify this command to force
                  the adapter configuration back to a known state.
        
                  This command may be specified  on its  own (with or
                  without the /IO= and /NEWIO=  commands) to  put the
                  card back to an "as shipped" state.

/NOMORE         - Disables   the   screen   paging  facility allowing
                  continuous output to the screen.


/AUTO_RS_DETECT - Will cause TRCFGC to attempt to determine  the ring
                  speed  of  the  attached network and, if  different
                  from  the  configured  value,  ask the  user if the 
                  detected value is to be used instead.  
                  This feature is only  present  on  certain adapters 
                  and  then  only  if  they are not  running  network
                  software.   In  addition,  if  the  user selects  a
                  ringspeed that is different from the detected value
                  then a warning will be displayed.


CARDBUS, PCI and PCMCIA SUPPORT
-------------------------------

This version  of  TRCFGC  includes support for the Smart PCI, CARDBUS 
and PCMCIA range of ringnodes.

TRCFGC  requires  that the  BIOS has  enabled and  configured any PCI
cards and  that a  "card services" utility has been run to enable any
PCMCIA adapters that are present.

Note that  when  running  TRCFGC.EXE as  an OS2 application it may be 
unable to detect PCI or PCMCIA cards.  If this occurs the user should
run TRCFGC.EXE from a "DOS Box" or from a bootable DOS diskette.

Command Line Options
--------------------

The command line options currently supported are :-

/IO=hhhh        - Where  hhhh  is  the  hexadecimal IO address of the
                  adapter to be configured.


/SLOT=dd        - Where dd is the slot number of the card.

                  If neither /SLOT or /IO is specified then a list of
                  adapters that were detected  will be  displayed and
                  the user asked to select one.


/4MBITS         - Selects a ring speed of 4Mbps.


/16MBITS        - Selects a ring speed of 16Mbps.


/MMIO           - Allows the user  to  specify  that the card may use
                  MMIO if possible.  PIO will be used if it is not.


/PIO            - Sets up the data  transfer  method  to use  PIO for
                  data transfers.

NOTE :- The /MMIO and /PIO command line switches are only for certain 
        PCMCIA adapters and are ignored for PCI and CARDBUS.

/AUTO_RS_DETECT - Will cause TRCFGC to attempt to determine  the ring
                  speed  of  the  attached network and, if  different
                  from  the  configured  value,  ask the  user if the 
                  detected value is to be used instead.  
                  This feature is only  present  on  certain adapters 
                  and  then  only  if  they are not  running  network
                  software.   In  addition,  if  the  user selects  a
                  ringspeed that is different from the detected value
                  then a warning will be displayed.


                    ***** End of TRCFGC.TXT *****


