TRCFGC Configuration Program
============================
            
                                             CSS 1.0(0), January 1997
                                             ------------------------

This  utility  enables  you to configure the AT Plus, ISA Client Plus, 
Plug and Play, PCMCIA, CardBus, and PCI adapter cards.  You can run it 
under DOS, or you can run it under OS/2, either as an OS/2 application 
or from a DOS box. 

**********************************************************************
Note: When you run TRCFGC.EXE as an OS/2 application, we recommend you 
      to stop all network applications on the PC.  If you do  not  you 
      might lose network connections.
      
      If  you are running TRCFGC as OS/2 application, and TRCFGC fails 
      to detect an adapter, try running it from a DOS-box  or  from  a 
      bootable DOS disk.      
**********************************************************************

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

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

The  switches  are  described  in  detail  in the AT Plus installation 
documentation, but, of the four switches, only the IO  and  ROM_ENABLE 
switches are of significance to TRCFGC.EXE. At "power up" the contents 
of  the  CMOS device are compared with the IO and ROM_ENABLE switches.  
If they disagree, the adapter is disabled until you either restore the 
switches or run TRCFGC.EXE to correct the information in the CMOS.

You must run the configuration utility after making any changes to the 
hardware  switch  settings.  Otherwise your network driver will not be 
able to access the adapter (and neither will the DIAG test software).

When the adapter is delivered  from  the  manufacturer,  the  switches 
match  the factory default configuration in the CMOS device. Also, the 
adapter is enabled.

If you want to change the IO location or the status of the  ROM_ENABLE 
switch, you must alter the switches before installing the adapter. You 
must then run TRCFGC.EXE.

To run TRCFGC.EXE, type:

 TRCFGC [command line options]

at the DOS prompt.


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


Typing:

 TRCFGC

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

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

The program tries to identify resources (such as DMA, IRQ, MEMORY  and 
I/O  addresses) that are being used by other devices in the system. It 
displays a warning if you choose any resource that is in use.



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

The command-line options are:

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

                  Valid values: 0a20, 1a20, 2a20, 3a20

		  If you use this option, the program will verify that 
		  the adapter at this address is an AT Plus card.

		  If you do not use  this  option,  the  program  will 
		  search for and list any AT Plus adapters and ask you 
		  which one is to be configured.


/16BITBUSMASTER - Sets  up the following default data transfer method: 
		  BUS MASTER DMA over channel  5;  NORMAL  (rev4)  bus 
		  timing; ASYNCH bus mode; and a 16 bit BUS width.

                  DMA is not available on ISA Client Plus cards.
    
		  If you use the /16BITBUSMASTER  option  before   the  
		  /SYNCH, /ASYNCH, /DMA,  /NORMAL, or /OTHER switches, 
		  then the latter  will  modify  the  transfer  method 
		  dictated by the former.
		  
/8BITBUSMASTER  - Sets up the following default data transfer  method: 
		  BUS  MASTER  DMA  over  channel  5; OTHER (rev3) bus 
		  timing; ASYNCH bus mode; and an 8 bit BUS width.

                  DMA is not available on ISA Client Plus cards.

		  If you use the  /8BITBUSMASTER  option  before   the  
		  /SYNCH, /ASYNCH, /DMA,  /NORMAL, or /OTHER switches, 
		  then the latter  will  modify  the  transfer  method 
		  dictated by the former.
		  
		  
/16BITPIO       - Sets up the following default data transfer  method: 
		  PIO; NORMAL (rev4) bus timing; 16 bit BUS width.

		  If you use this option before the /NORMAL, or /OTHER 
		  switches then the latter will  modify  the  defaults 
		  defaults dictated by the former.

/8BITPIO        - Sets  up the following default data transfer method: 
		  PIO; NORMAL (rev4) bus timing; an 8 bit BUS width.

		  If you use this option before the  /NORMAL,  /OTHER, 
		  switches  then  the  latter will modify the defaults 
		  dictated by the former.

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

                  Valid values: 0, 3, 5, 6

		  If  you  specify  0, DMA is disabled and the adapter 
		  software uses PIO transfers.

                  DMA is not available on ISA Client Plus cards.

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

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

                  Valid values: 2, 3, 5, 7, 10, 11, 12, 15


/NORMAL         - Causes  the  adapter  to use "normal" (REV 4) system 
		  bus timing
/OTHER          - Causes the adapter to use an alternate system bus timing.

/ASYNCH         - Causes the adapter to use ASYNCHRONOUS bus timing.
/SYNCH          - Causes  the  adapter  to  use SYNCHRONOUS bus timing 
		  mode.

/8_BIT          - Causes the adapter to use an 8-bit I/O width.
/16_BIT         - Causes the adapter to use a 16-bit I/O width.

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

/FACTORYDEF     - Restores the adapter's configuration to the  factory 
		  defaults   before   applying   other   configuration 
		  changes.

		  Use  this  (with  or  without  the  /IO= and /NEWIO= 
		  commands) to put the card back to  an  "as  shipped" 
		  state.

		  Make sure that the hardware switches (if any)  match 
		  the  new configuration.  The factory default command 
		  will  restore  all  settings,  except  the  IO   and 
		  ROM_ENABLE  settings,  to the factory defaults.  The 
		  IO and ROM_ENABLE settings,  however,  always  match 
		  the  hardware  settings.   Note  that the FACTORYDEF 
		  option does not alter the last user-setting for  the 
		  adapter's ring speed.

/READCONFIG     - Displays  the  current  configuration of the adapter 
		  without modifying the settings.
                  
/ENABLE         - Forces the adapter's IO Address, ring speed, and ROM 
		  Enable switches into the configuration  and  enables 
		  the adapter.

/ROM_ENABLE     - Enables the Smartrom for use with Remote Booting.

/ROM_DISABLE    - Disables the Smartrom.

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

/AUTO_RS_DETECT - Causes TRCFGC to attempt to determine the ring speed 
		  of  the  network.   If  this  is  different from the 
		  adapter's ring speed, TRCFGC will  ask  you  whether 
		  you  want  to  use  the  ring  speed  of the network 
		  instead.  This feature is only available on  certain 
		  adapters  and  then  only  if  they  are not running 
		  network software.  In addition, if  you  attempt  to 
		  configure  a  ring  speed that is different from the 
		  detected value then TRCFGC will  display  a  warning 
		  message.


Examples
--------

A. If  you  are installing a single card in a system and you intend to 
   use the factory default settings (and the card is new) you  do  not 
   need to run the AT Plus configuration utility.

   If  however  the  adapter  is  in  an unknown state, set the card's 
   switches to the settings you require, and install  it  into  a  PC. 
   Then run TRCFGC using the following command line:

        TRCFGC /IO=<io address> /FACTORYDEF

   Alternatively, type one of the following command lines  which  will 
   The  run the program in an interactive mode allowing you to specify 
   the IO address of the adapter and then examine, modify, and  update 
   the configuration:

        TRCFGC
   or
        TRCFGC /IO=<io address>


B. If you want to install a second  card  into  a  system  at  an  I/O 
   address  of  2a20, and you have the Smartrom disabled, then set the 
   adapter's IO and ROM switches to  the  required  settings  and  run 
   TRCFGC as follows :

        TRCFGC /IO=2a20


C. If you want to alter the  DMA  channel  on  the  card  at  0a20  to 
   make the card use PIO, run TRCFGC as follows:

        TRCFGC /IO=0a20 /DMA=0


D. To restore the card  to  its  factory  default  settings,  set  the 
   switches   to   their   factory  defaults  (see  the  adapter  card 
   documentation) and run TRCFGC as follows:

        TRCFGC /IO=0a20 /FACTORYDEF


E. To restore a card to its factory settings while moving it to an  IO 
   address  of  2a20,  retaining  the  ROM  settings  and  setting the 
   interrupt channel to 3, first alter the switches to reflect the new 
   IO address, then run TRCFGC as follows:
   
        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 utility 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 is for users  who  do 
		   not  have a configuration manager or do not wish to 
		   use one.

On systems with PNP BIOSs, if you put the adapter  into  NON-PNP  mode 
and  you configure a particular IO address, the BIOS might reconfigure 
the card.  It will do this, for example, if the BIOS  has  detected  a 
clash  with  another  adapter  or  with  an alias of the IO address of 
another adapter.  If the BIOS does reconfigure the  adapter,  TRCFGC's 
initial  screen  displays  the card at the address chosen by the BIOS, 
but the program's configuration screens display the address  that  you 
have  configured  for the adapter.  In this circumstance, we recommend 
you to put the adapter back into PNP mode, or to choose a new 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:  0920,  0940, 0960, 0980, 0a20, 0a40, 
		  0a60, 0a80, 0b20, 0b40, 0b60, 0b80

		  If specify this option, the program will verify that 
		  the adapter at this address is a PNP card.

		  If you do not specify this option, the program  will 
		  search  for  and list any PNP adapters and you 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 the following default data transfer  method: 
		  PIO; NORMAL (rev4) bus timing; 32-bit BUS width.

		  If you use this option before the /NORMAL, or /OTHER 
		  switches then the latter will  modify  the  defaults 
		  defaults dictated by the former.
      
/8BITPIO        - Sets up the following default data transfer  method: 
		  PIO; NORMAL (rev4) bus timing; 8-bit BUS width. 
   
		  If you use this option before the /NORMAL, or /OTHER 
		  switches then the latter will  modify  the  defaults 
		  defaults dictated by the former.
   
/INT=nn         - Where nn is the interrupt (IRQ) channel the adapter
                  is to use.

                  Valid values: 2, 3, 7, 10, 11, 15


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


/8BITIO         - Specifies an 8-bit data transfer width.
/32BITIO        - Specifies a 32-bit data transfer width.


/4MBITS         - Sets the adapter's ring speed to 4Mbps.
/16MBITS        - Sets the adapter's ring speed to 16Mbps.

/FACTORYDEF     - Restores the adapter's configuration to the  factory 
		  defaults   before   applying   other   configuration 
		  changes.

		  Use  this  (with  or  without  the  /IO= and /NEWIO= 
		  commands) to put the card back to  an  "as  shipped" 
		  state.

/READCONFIG     - Displays  the  current  configuration of the adapter 
		  without modifying the settings. Use this  option  in 
		  conjunction with the /IO= option.
                 
/NOMORE         - Disables  the  screen paging facility. Screen output 
		  will be continuous.

/AUTO_RS_DETECT - Causes TRCFGC to attempt to determine the ring speed 
		  of  the  network.   If  this  is  different from the 
		  adapter's ring speed, TRCFGC will  ask  you  whether 
		  you  want  to  use  the  ring  speed  of the network 
		  instead.  This feature is only available on  certain 
		  adapters  and  then  only  if  they  are not running 
		  network software.  In addition, if  you  attempt  to 
		  configure  a  ring  speed that is different from the 
		  detected value then TRCFGC will  display  a  warning 
		  message.



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

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

This  card  is very similar to the PLUG and PLAY card described in the 
previous section, but it supports additional data transfer methods and 
it also supports remote booting via  a  Smartrom.  The  data  transfer 
methods it supports are PIO, MMIO, and DMA (16-bit and 8-bit).


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

The command line options are:

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

                  Valid values: 

                        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 the following default data  transfer  method: 
		  BUS  MASTER  DMA  over  channel  5; NORMAL (rev4) bus 
		  timing; ASYNCH bus mode; and a 16-bit BUS width.

                  DMA is not available on ISA Client Plus cards.

		  If you use the  /16BITBUSMASTER  option before   the  
		  /SYNCH, /ASYNCH, /DMA,  /NORMAL, or /OTHER switches, 
		  then the latter  will  modify  the  transfer  method 
		  dictated by the former.

/8BITBUSMASTER  - Sets up the following default data  transfer  method: 
		  BUS  MASTER  DMA  over  channel  5; OTHER (rev3) bus 
		  timing; ASYNCH bus mode; and a 8-bit BUS width.

		  If  you  use  the /8BITBUSMASTER option before the /
		  NORMAL, or /OTHER switches,  then  the  latter  will 
		  modify the transfer method dictated by the former.
		  
/32BITPIO       - Sets up the following default data transfer  method: 
		  PIO; NORMAL (rev4) bus timing; 32-bit BUS width.

		  If you use this option before the /NORMAL, or /OTHER 
		  switches then the latter will  modify  the  defaults 
		  defaults dictated by the former.
      
/8BITPIO        - Sets up the following default data transfer  method: 
		  PIO; NORMAL (rev4) bus timing; 8-bit BUS width. 
   
		  If you use this option before the /NORMAL, or /OTHER 
		  switches then the latter will  modify  the  defaults 
		  dictated by the former.
		  		  
/MMIO           - Sets up Memory Mapped I/O (MMIO) as the default data 
		  transfer method.

		  Use  the  /MEM=  option  to  specify the memory base 
		  address to be used (it  is  the  same  as  the  base 
		  address for the Smartrom if this is enabled).

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

                  Valid values:

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

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

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

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

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

                  Valid values: 3, 5, 6

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

/8BITIO         - Specifies an 8 bit data transfer width.
/32BITIO        - Specifies a 32 bit data transfer width.

/4MBITS         - Sets the ring speed to 4Mbps.
/16MBITS        - Sets the ring speed to 16Mbps.


/FACTORYDEF     - Restores the adapter's configuration to the  factory 
		  defaults   before   applying   other   configuration 
		  changes.

		  Use  this  (with  or  without  the  /IO= and /NEWIO= 
		  commands) to put the card back to  an  "as  shipped" 
		  state.

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

/AUTO_RS_DETECT - Causes TRCFGC to attempt to determine the ring speed 
		  of  the  network.   If  this  is  different from the 
		  adapter's ring speed, TRCFGC will  ask  you  whether 
		  you  want  to  use  the  ring  speed  of the network 
		  instead.  This feature is only available on  certain 
		  adapters  and  then  only  if  they  are not running 
		  network software.  In addition, if  you  attempt  to 
		  configure  a  ring  speed that is different from the 
		  detected value then TRCFGC will  display  a  warning 
		  message.



		  
PCI, PCMCIA, and CardBus
------------------------
This  version  of TRCFGC includes support for the Smart PCI and PCMCIA 
range of Ringnodes, and also for the Madge 16/4 CardBus Adapter.

TRCFGC requires the BIOS to have enabled and configured any PCI cards, 
and the "card services" to have enables any PCMCIA or CardBus adapters 
that are present.

**********************************************************************
Note: When you run TRCFGC.EXE as an OS/2 application, we recommend you 
      to stop all network applications on the PC.  If you do  not  you 
      might lose network connections.
      
      If  you are running TRCFGC as OS/2 application, and TRCFGC fails 
      to detect an adapter, try running it from a DOS-box  or  from  a 
      bootable DOS disk.      
**********************************************************************
      


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  you  specify  neither  /SLOT nor /IO then TRCFGC 
		  displays a list of the adapters it has detected, and 
		  prompts you to select one.

/4MBITS         - Sets the ring speed to 4Mbps.
/16MBITS        - Sets the ring speed to 16Mbps.

/MMIO           - Allows  you to specify that the adapter can use MMIO 
		  if MMIO is possible. If MMIO is  not  possible,  the 
		  adapter will use PIO.
		  
/PIO            - Causes  the  adapter to use PIO as its data transfer 
		  method.

/AUTO_RS_DETECT - Causes TRCFGC to attempt to determine the ring speed 
		  of  the  network.   If  this  is  different from the 
		  adapter's ring speed, TRCFGC will  ask  you  whether 
		  you  want  to  use  the  ring  speed  of the network 
		  instead.  This feature is only available on  certain 
		  adapters  and  then  only  if  they  are not running 
		  network software.  In addition, if  you  attempt  to 
		  configure  a  ring  speed that is different from the 
		  detected value then TRCFGC will  display  a  warning 
		  message.



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