Installation Notes for END FDDI Driver
---------------------------------------


Version      : 1.12
Release date : 2004-06-23

To build into kernel:
=====================
See vxWorks documentation to build driver into kernel.
Please use the ccFddiEndxxx.a Lib file for this.
     Where xxx=Rad    for Radstone PPC HCC
           xxx=X86    for X86 HCC
           xxx=178    for SVME178 HCC
           xxx=179    for SVME179 HCC
           xxx=Mv5100 for MVME5100 HCC
           xxx=Mv2700 for MVME2700 HCC

1. Copy ccFddiEndxxx.a to your BSP library directory (eg /tornado/target/config/mvme/lib).

2. Edit the Makefile in the BSP directory (eg /tornado/target/config/mvme).
	
	Find the line
		MACH_EXTRA	=

	and replace with
		MACH_EXTRA	=	./lib/ccFddiEndxxx.a
		
3.  Add the following code fragment to config.h 

	(before "#define DEFAULT_BOOT_LINE"):
		
	/*Added by CCII for FDDI driver*/
	#define INCLUDE_CCFDDI_END     /* CCII FDDI END DRIVER */ 


	/* CCII Modification */
	#ifdef INCLUDE_CCFDDI_END
	#ifndef INCLUDE_PCI
	#define INCLUDE_PCI
	#endif

	#ifdef INCLUDE_BSD
	#undef INCLUDE_BSD
	#endif

	#ifndef INCLUDE_END
	#define INCLUDE_END
	#endif
	#endif   

	/*End  CCII Modification */

4. In config.h, change the DEFAULT_BOOT_LINE to use the ccfddi driver.

5. Add the following to configNet.h

	(Before the start of the endDevTbl[] declaration.)

	IMPORT END_OBJ * fddiLoad (char *initString); 

	(Add the following segment to the endDevTbl[] , before the default last entry.)
		
	#ifdef INCLUDE_CCFDDI_END
	   { 0, fddiLoad, "", NULL, NULL, FALSE},
	#endif /* INCLUDE_CCFDDI_END */ 

6.  Rebuild all vxWorks images.


To load separately:
===================

From the vxWorks shell type:
       ld < ccFddiEndxxx.a

Starting the driver manually:
============================

The driver is started with the muxDevLoad and muxDevStart commands. The syntax is as
follows:
   muxDevStart ( muxDevLoad ( unit, fddiLoad, "", 0, 0 ))
where:
   unit must be 0 for first adaptor and 1 for second adaptor.(Only two adapters are supported per Host Carrier Card)

This is only necessary if the driver was not include in the configNet.h file.
Type 'muxShow' to see if the driver was installed.

To attach the driver to the TCP/IP protocol:
   ipAttach ( unit, "ccfddi" )

To set the IP address use ifAddrSet eg
   ifAddrSet "ccfddi0" , "10.0.0.5" for unit 0 and 
   ifAddrSet "ccfddi1" , "11.0.0.5" for unit 1  
   
WARNING: Changing any of these parameters from the default values may have
a profound effect on driver performance.

Command line Passing of FDDI Settings
=====================================
The Driver support the changing of some default parameters at startup.
 e.g. muxDevStart (muxDevLoad (0,fddiLoad,"BaseAddress:IntoNo:TRT:MTU:OSM",0,0))
          BaseAddress: Base Address in Hex - Only has effect on MVEM2700
          IntNo      : Interrupt no to use in Hex - Only has effect on MVME2700
          TRT        : Token Rotation Time to use in Decimal ms - Default 165ms
          MTU        : Max Transfer Unit size in decimal Bytes - Default 4352bytes
          OSM        : Online Special Mode ON(1) or OFF (0) - Default 0 (OFF)
 
          If a parameter is not used a placeholder of 0 MUST be used.
          e.g. You want to only change the TRT to 100ms
             muxDevStart (muxDevLoad (0,fddiLoad,"0:0:100:0:0",0,0))
 
          All Parameters preceding the ones you want to change must be specified
          e.g. You want to only change the TRT to 100ms
             muxDevStart (muxDevLoad (0,fddiLoad,"0:0:100",0,0))

         To keep all setting at default values use
         muxDevStart ( muxDevLoad ( unit, fddiLoad, "", 0, 0 ))
 
         Use ccfddiStats to confirm your changes.