Installing the Windows NT and Advanced Server drivers
=====================================================
                              			           November 1994 
                                                           -------------

The Windows NT driver is called MDGMPORT.SYS. It provides an NDIS 3.0 
Miniport interface for Windows NT 3.5. You  can  install  the  
driver  either  DURING  or  AFTER installation of Windows NT. If you are 
adding a server to an  existing Domain  of servers, you must install the 
driver during installation of Advanced Server.

Note  
*****  
If you are installing a Madge 16/4 AT or 16/4 ISA Client adapter then 
before  following the instructions in this section, make a note of the 
IRQ number, I/O location, and DMA channel that your Ringnode is using.

Section 1)  Installing  MDGMPORT.SYS  during  NT installation
=============================================================

1 The procedure for installing Windows NT is documented in the Windows 
  NT System Guide. Follow this procedure until you come to the section 
  of the System Guide entitled "Setting Up a Network Adapter Card".

2 Perform one of the following:

* If you are  using Express Setup, the software attempts to detect the 
  network cards in your computer. It does not detect  Madge  adapters. 
  The  program  then  asks you if you want to install Microsoft Remote 
  Access Service  (for  network  connections  over  telephone  lines). 
  Answer  No.  The  program  then  displays  the Network Adapter Setup 
  dialog box.  This  includes  a  list  of  network  adapters.  Select 
  "<Other> Requires disk from manufacturer".

* If you are using Custom Setup, make sure that you are installing the 
  Network  components  of  Windows  NT.  Reject automatic detection of 
  adapters, and, from the Network Adapter  Setup  dialog  box,  select 
  "<Other>  Requires  disk  from  manufacturer".  Proceed to Step 5 in 
  Section 2.

3 Insert the Madge release disk and  enter  the  path  of  the  driver 
  software. For example:

	A:\MDGMPORT

  Windows NT then  copies some files. When it has finished, proceed to 
  Step 6 in Section 2.



Section 2)  Installing  MDGMPORT.SYS after NT installation 
==========================================================

1 Start  up  your  Windows  NT  station,   and   logon   as   an 
  Administrator. 

2 From the Control Panel select the Networks icon.  This displays  the 
  Network Settings window. 

3 Click  on  the  Add  Adapter  button.  This displays the Add Network 
  Adapter window. 

4 From the list of  adapters  select "<Other>  Requires  a  disk  from 
  manufacturer", then click on the Continue button. 

5 Insert the Madge Release Disk, as prompted, and enter  the  path  of 
  the Madge Windows NT files as follows: 

  A:\MDGMPORT 
 
  Then click on OK. 

6 NT will display a list of Madge adapters that may be installed and
  an option called "Madge Automated Smart Ringnode Installation". 
  If you select automated installation the Madge installation program
  will search your machine for Madge Smart Ringnodes and attempt
  to determine any hardware settings (IRQ number and DMA channel).
  If you do not use automated installation you will have to supply
  all of the hardware settings required by the driver yourself. 
  Unless you have good reason not to, Madge recommends that you use
  automated installation. Select automated installation or an adapter
  type. If you have selected an adapter to proceed to setp 8.

  IMPORTANT NOTE FOR PCI ADAPTERS: Automated installation will not 
  find 16/4 PCI Ringnodes. To install a 16/4 PCI Ringnode please select 
  the "Madge Smart 16/4 PCI Ringnode" and proceed to step 8.

7 After a short pause a dialog box will appear that lists all of the 
  Madge Smart Ringnodes present in your Machine. Select the one
  you wish to install and click on OK.

8 You will now see a Madge dialog box that describes the configuration
  of your adapter. Depending on the type of adapter you have, the
  dialog box will contain different configuration options. Most
  of the options correspond to the hardware configuration of your
  adapter. To the right of each of these hardware configuration options 
  will be displayed the option setting for which the installation program 
  thinks your adapter is currently configured. Any option settings that 
  could not be determined by the installation program will be marked as
  "UNKNOWN". For all of the options marked as "UNKNOWN" you must
  set the value that matches the configuration of your adapter (as
  set by the switches on older adapters or by the DIAG configuration
  program on newer adapters). If you did not select automated installation
  in step 6, all hardware configuration options will be unknown.

  Further information on the hardware configuration click on the HELP
  button in the Madge dialog box.

  IMPORTANT NOTE FOR PCI ADAPTERS: If you do not know the PCI Device 
  Number of your 16/4 PCI Ringnode (your PC's configuration utility may
  tell you the PCI Devive IDs of the PCI adapters in your machine, or
  it may not) then leave the "PCI Device ID" option set to "UNKNOWN".
  If you do this MDGMPORT will use the first 16/4 PCI Ringnode it finds
  in the machine. (If you install a second instance of MDGMPORT for
  a 16/4 PCI Ringnode in the same way then this instance of MDGMPORT 
  will find the second 16/4 PCI Ringnode.)

9 You can also use the Madge dialog box to set a different  Maximum  Frame  
  Size from the default,  and to set a Locally Adminstered Address for your 
  Ringnode. (If you are setting an LAA  you can make it easier to read 
  by separating every two digits with a hyphen.) 

  The Madge Dialog Box contains a final list box which allows you to
  choose the number of receive and transmit buffers to use. If your
  machine is a '486' class PC being used as a personal workstation then
  leave this setting at its default (RX=04 TX=04). If your machine is a
  high performance RISC platform or a machine being used as a server
  then you may wish to increase the buffer allocation. Please note that 
  if you have multiple adapter cards in a server and a large maximum frame 
  size then you have to use fewer buffers to avoid running out of memory.

  Once you have finished, click on the CONTINUE button.

10 Restart the system as prompted.

Section 3) Advanced Configuration
=================================

To set your adapter's advanced configuration options you must add the
options to the NT registry. To do this use the NT program called 
REGEDT32.EXE. The location that you need in the registry database is:

HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\SERVICES\MDGMPORT?\PARAMETERS

Alternate Bus-Timing
--------------------

To configure your adapter for alternate bus-timing, insert the word 
Alternate into the registry, and give it the value 1.

Test and XID Frame Handling
---------------------------

Certain contectivity products require that the NDIS driver be able to
handle LLC TEST and XID frames. To enable this processing insert the
word TestAndXIDEnabled into the registry, and give it the value 1. Do 
not set this configuration option unless it is required in your 
internetwork.

Forced Open
-----------

Normally a token ring adapter checks that the ring is in a good state
before it inserts into the ring, and refuses to insert if the ring
is in a bad state. However, the adapter can be configured to insert
into the ring irrespective of the ring's state. To configure your
adapter to do such a forced open insert the word ForceOpen into the
registry and give it the value 1. Do NOT use this configuration unless
you have good reason to do so.

Section 4) Error Messages
=========================

If your installation of MDGMPORT fails to load, the Windows NT  Service 
Control Manager displays the following message:

" At least one service or driver failed during system startup. Use the 
  Event Viewer to examine the event log for details. "

Once  your  Windows  NT  workstation  has  booted up, invoke the Event 
Viewer to search for a message from MDGMPORT.

If you need to check your registry entries, run the Windows NT program 
called REGEDT32.EXE. The  location  that  you  need  in  the  registry 
database is:

HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\SERVICES\MDGMPORT?\PARAMETERS

When you look at the event viewer message for MDGMPORT you will see an error 
message explaining why the driver has not been able to initialize properly. 
If the error message claims that there has been a hardware failure then 
details of the hardware failure can be found from the data section of the 
event window. The last eight bytes in the data section will look similar to 
the following:

28: 00 00 00 00 70 00 00 00 
30: PP 00 00 00 QQ 00 00 00

Where: PP is a hexadecimal number between 0x0 and 0x9.
       QQ is a hexadecimal number between 0x0 and 0xFF.

       PP is a category of error
       QQ is an error within that category


Some  of  the  common  errors are listed below. If the QQ displayed in 
your installation does not  match  any  of  the  values listed  below, 
contact  MADGE  technical  support. Please quote the values for PP and 
QQ.


PP = 0x04
QQ = 0x05 or 0x06
=================
Reason
------
There is not enough memory available to your Windows NT system.

Action
------
Install more hard disk space.


PP = 0x05 
QQ = 0x01 
=========
Reason: 
-------
The adapter has failed to open onto the ring. This could be caused  by 
one of the following:

i)   The lobe cable is not securely attached to the  adapter  card  or 
     cabling unit.
        
ii)  The ring speed setting on the card does not match the actual ring 
     speed.
        
iii) Insertion  onto  the  ring has been prevented by  ring management 
     software.
        
iv)  The ring is beaconing.
       
v)   A ring parameter server on the ring has crashed.
       
Action:
-------
Check  the  above and then retry the operation.

PP = 0x05
QQ = 0x02
=========
Reason: 
------- 
The IO location given is not valid for the adapter card you are using. 

Action
------
Check that the registry entry for IoLocation and the switch IoLocation 
settings on the card match.


PP = 0x05
QQ = 0x03 
=========
Reason 
------ 
The  interrupt number you have given is not valid for the Ringnode you 
are using.

Action  
------ 
Check  that  the  registry  entries for InterruptNumber and the switch 
interrupt settings match the corresponding settings on the card or  in 
the EISA/ MCA configuration information.


PP = 0x05
QQ = 0x04
=========
Reason 
------ 
Either the DMA channel you have given is not valid  for  the  Ringnode 
you are using, or you have specified a DMA channel for a Ringnode that 
is configured to perform PIO. 

Note  that  16/4 PC Ringnodes do not support DMA, and that EISA and MC 
Ringnodes do not support PIO.

Action
------
Check  that  the registry entry for DmaChannel matches the DMA setting 
on the Ringnode (or, for  Micro-Channel  adapters,  the  Micro-Channel 
configuration information).

Note  that  MADGE  EISA  Ringnodes  require  the  registry  value  for 
DmaChannel to be set to 0xFF.

PP = 0x05
QQ = 0x05 
=========
Reason
------
No adapter card has been found at the IO location you gave. 

Action
------
Check that the Ringnode details you gave were  correct  and  that  you 
have installed the Ringnode correctly into your computer.


PP = 0x05
QQ = 0x06 
---------
Reason
------
You cannot use DMA with your Ringnode in an 8-bit slot.  

Action
------
Either  select  PIO as your mode of data transfer, or put the Ringnode 
into a 16-bit slot. Note that 16/4 PC cards do not support DMA.


PP = 0x05
QQ = 0x0D
=========
Reason
------
The Ringnode has not been enabled. You must configure your EISA or MC 
Ringnode properly before you use it.

Action  
------  
Configure the Ringnode using the configuration utility  provided  with 
your computer.

PP = 0x05
QQ = 0x0E 
=========
Reason
------
You  have not selected a Ring Speed (either 16 Mbps or 4Mbps) for your 
Ringnode.

Action
------
Use the configuration utility provided with your computer to configure 
the Ring Speed of your EISA or MC Ringnode.

PP = 0x05
QQ = 0x07 or 0x08 or 0x09
=========================
Reason
------
NT has been unable to download your driver software to the Ringonde.

Action 
------ 
You  might  be  able  to  identify  the  problem  by running the Madge 
Ringnode Diagnostics  program  from  DOS.   Otherwise  try  installing 
another Ringnode.  Check, also, that your driver software has not been 
corrupted.


PP = 0x05
QQ = 0x0B or 0x0C
=================
Reason
------
Windows NT has been unable to enable an interrupt (0x0B) or a DMA 
channel (0x0C).

Action
------
Check that there are no conflicting interrupt or DMA settings.
Contact your Windows NT supplier.


PP = 0x06
QQ = 0x00 - 0x06 0x10
=====================
Reason
------
Your Ringnode could not be initialized.

Action
------

Try  running  the Madge Ringnodes Diagnostics program from DOS. If you 
cannot isolate the problem you will need to try another Ringnode.

PP = 0x07
QQ = 0x09, 0x0A - 0x0C
======================
Reason
------
Your Ringnode cannot perform DMA transfers properly.

Action
------
Run the Diagnostics program from DOS to try to isolate the problem.
Check that your DMA channels are set correctly and do not clash.
 
PP = 0x08
QQ = 0x01 or 0x02
=================
Reason
------
The network you are attached to is malfunctioning.

Action
------
Try checking that you have not caused the error by setting your 
Ringnode to the wrong speed.

                    ****** End README.INF ******
