home *** CD-ROM | disk | FTP | other *** search
/ Troubleshooting Netware Systems / CSTRIAL0196.BIN / attach / pcc / v08n03 / netwrk.exe / WDPOST.ZIP / WDPOST.TAR / wdpost.dir / super / unix53 / install.doc < prev    next >
Text File  |  1988-06-21  |  7KB  |  204 lines
  1.                          WESTERN DIGITAL
  2.                 UNIX STREAMS DRIVER FOR USE WITH
  3.                 "PLUS"-FAMILY LAN ADAPTER BOARDS
  4.  
  5.                        INSTALLATION GUIDE
  6.  
  7.  
  8. INTRODUCTION
  9.  
  10. This driver provides a link layer interface for Western Digital 
  11. "PLUS"-family LAN adapter boards:
  12.  
  13.      For Ethernet:
  14.          EtherCard PLUS        (WD8003E, WD8003EBT)
  15.  
  16.      For StarLAN:
  17.          StarCard PLUS         (WD8003S)
  18.          StarLink PLUS         (WD8003SH)
  19.  
  20. The driver uses streams facilities and conforms to the AT&T LLI 
  21. interface specification for streams drivers.
  22.  
  23. Following is the procedure for installing the streams driver for 
  24. Western Digital "PLUS"-family LAN adapter boards on 80386-based 
  25. computers operating under the UNIX (*) System V.3 operating system. 
  26. Because the information given is intended to be generic, you 
  27. will need to use the file and path naming conventions specific 
  28. to your UNIX V.3 system.
  29.  
  30.  
  31. COPYING FILES
  32.  
  33. The UNIX V.3 streams driver supplied on this disk is named wd.
  34. To begin the installation, first log in to your system as root 
  35. and make a directory for the driver with:
  36.  
  37.                   mkdir /etc/atconf/modules/wd
  38.  
  39. Next, place this DOS format driver disk into the computer's 
  40. floppy disk drive and copy the files to the appropriate UNIX 
  41. directories.  On Interactive 386/ix (*), this can be done with 
  42. the command:
  43.  
  44.                             dossette
  45.  
  46. to enter the DOS diskette subsystem.  Change to the subdirectory
  47. of the driver disk containing the UNIX driver; for example:
  48.  
  49.              a:
  50.              cd unix53
  51.  
  52. Copy the driver and configuration files into the appropriate 
  53. UNIX directories by typing:
  54.  
  55.              get -b config /etc/atconf/modules/wd/config
  56.              get -b space.c /etc/atconf/modules/wd/space.c
  57.              get -b wd.o /etc/atconf/modules/wd/wd.o
  58.              get -b wd.h /usr/include/sys/wd.h
  59.              q
  60.  
  61. These commands assume that any required directories already 
  62. exist, and copy the proper files into the appropriate 
  63. directories.  If your system uses different naming or 
  64. structural conventions for the directories, you will need to 
  65. modify the newly created directories to be consistent with 
  66. your system.
  67.  
  68.  
  69. STREAMS DEVICE NUMBERS
  70.  
  71. To set the streams device numbers for the Western Digital
  72. LAN adapter device, use the following command:
  73.  
  74.                       mknod /dev/wd c 12 35
  75.  
  76. The number 12 is the streams device number found in the config 
  77. file for the clone driver in the /etc/atconf/modules/clone 
  78. directory.
  79.  
  80. The number 35 is the streams device number found in the newly 
  81. created config file in the /etc/atconf/modules/wd directory. 
  82. If no clone driver is available,  use "35  0" instead of 
  83. "12  35" in setting the streams device number.  This will create 
  84. a minor device for a single process.  Add additional minor 
  85. device≤ likσ "3╡  1" and "3╡  2" fo≥ additional processes if 
  86. desired.
  87.  
  88. The number 35 can be changed if it conflicts with another device 
  89. on your system.  Edit the wd/config file and change the 35 to a 
  90. different major device number that is unused on your system.  
  91. In addition, be sure to remember to change the 35 to the 
  92. appropriate matching number in the mknod command.
  93.  
  94. If you wish to allow general access to the LAN adapter device, 
  95. use the following command:
  96.  
  97.                         chmod 666 /dev/wd
  98.  
  99.  
  100. ADAPTER BOARD CONFIGURATION PARAMETERS
  101.  
  102. Listed below are the software default settings for IRQ (interrupt), 
  103. Base I/O Port, and Base Shared Memory Address used by the LAN
  104. adapter board:
  105.  
  106.            IRQ = 3
  107.            Base I/O Port = 0x280
  108.            Base Shared Memory Address = 0xcc000
  109.  
  110. The IRQ and Base I/O Port values correspond to the factory
  111. default jumper settings for "PLUS"-family LAN adapter boards.
  112. The Base Shared Memory Address is set entirely by software;
  113. it is not affected by adapter board jumper settings.
  114.  
  115. If these settings match those of the LAN adapter board you are 
  116. using, you may continue with the installation procedures.  If 
  117. the default values do not match those of the LAN adapter board, 
  118. you must modify the config and space.c files.  The procedure 
  119. for modifying these files is discussed below.
  120.  
  121. The config and space.c files may be found on the driver disk, 
  122. and are located in the /etc/atconf/modules/wd directory.  If you 
  123. are going to change the IRQ, you must modify both the config and 
  124. space.c files.  If you are going to change the Base I/O Port or 
  125. Base Shared Memory Address, you need only modify the space.c file.
  126.  
  127. To change the IRQ, edit the intvec = n parameter in the config 
  128. file.  The value for n should be set based on the following 
  129. values:
  130.  
  131.            INTVEC:   9    3    4    5    6    7
  132.  
  133.            IRQ:      2    3    4    5    6    7
  134.  
  135. Once the proper intvec value has been designated in the config 
  136. file, edit the following line in the space.c file:
  137.  
  138.            #define WDIRQ            n
  139.  
  140. Set the value of n to the appropriate IRQ value.  A new kernel 
  141. must be built with these values in their respective files before 
  142. the new IRQ value becomes effective.  
  143.  
  144. To change the Base I/O Port, edit the following line in the 
  145. space.c file:
  146.  
  147.            #define WDBASEPORT        0xn
  148.  
  149. Set the value of n to the appropriate Base I/O Port value.  A new 
  150. kernel must be built with this value before the new Base I/O Port 
  151. becomes effective. 
  152.  
  153. To change the Base Shared Memory Address, edit the following 
  154. line in the space.c file:
  155.  
  156.            #define WDBASEADDR        0xn
  157.  
  158. Set the value of n to the appropriate Base Shared Memory 
  159. Address value.  A new kernel must be built with this value before 
  160. the new Base Shared Memory Address becomes effective.
  161.  
  162.  
  163. SYSTEMS FILES AND DIRECTORIES
  164.  
  165. Once the appropriate directories have been created and the 
  166. proper files copied, you must edit the system.std file in 
  167. the /etc/atconf/systems directory.
  168.  
  169. Add wd to the list of modules.
  170.  
  171.  
  172. BUILDING A NEW KERNEL
  173.  
  174. At this point, a new kernel must be built.  To do so, use the 
  175. following command:
  176.  
  177.                mkunix -c /etc/atconf -s system.std
  178.  
  179. This command will create the unix.std.n file in the
  180. /etc/atconf/kernels directory.  n is the incremented number of 
  181. the new kernel.
  182.  
  183. To complete the installation of the Western Digital streams driver, 
  184. you must move and link the necessary files.  To do this, use the 
  185. following commands:
  186.  
  187.             mv /etc/atconf/kernels/unix.std.n  /
  188.  
  189.             mv /unix  /Ounix
  190.  
  191.             ln /unix.stn.n  /unix
  192.  
  193. Finally, shut down the system and then reboot.  When the system 
  194. becomes operational, the wd streams driver will be available for 
  195. use.
  196.  
  197.  
  198.  
  199. (*) UNIX is a registered trademark of AT&T.  Interactive and 
  200. 386/ix are trademarks of Interactive Systems Corporation.  
  201.  
  202. EtherCard PLUS, StarLink PLUS and StarCard PLUS are trademarks 
  203. of Western Digital Corporation.
  204.