share/examples/atm/fore-microcode.txt

   1
   2 HARP and FORE Systems Microcode
   3 ===============================
   4
   5 ATM adapters from FORE Systems use Intel i960 embedded processors and
   6 require that application software (herein called "microcode") be downloaded
   7 and executed on the adapter. The interface between the microcode and the host
   8 device driver is specified in the FORE ATM Adaptation Layer Interface (AALI)
   9 (available from ftp.fore.com:/pub/docs/port). HARP uses microcode supplied
  10 by FORE Systems. The HARP device driver for the FORE adapter (hfa) conforms
  11 to the AALI specification.
  12
  13 As part of the HARP ATM initialization procedure, the HARP 'fore_dnld' utility
  14 must be invoked in order to load the microcode file into each FORE adapter.
  15 However, the microcode file is NOT included in the FreeBSD distribution. It is
  16 the user's responsibilty to obtain and install the FORE microcode file. Below
  17 are notes to assist users in finding and installing microcode known to work
  18 with HARP.
  19
  20 FORE microcode files can be obtained from either FORE's web site
  21 (http://www.fore.com) or the CD distributed with new FORE adapters.
  22 When using FORE's web site, you must have a valid login to access the
  23 TACtics Online section of the site. The software download section is
  24 available via the 'Services & Support'->'TACtics Online'->Software links.
  25
  26 If you are currently using HARP and already have a working microcode file,
  27 that microcode will continue to work with this release of HARP.
  28
  29
  30 PCA200E
  31 -------
  32
  33 From the FORE web pages, the following PCA200E adapter distributions
  34 are known to have microcode which will work with HARP:
  35
  36         pc_adapter->OS/2->archive->os2_4.0.2_1.20.200.zip
  37                 unzip the file and execute the command:
  38
  39                 cp -p <unzip_directory>/Drivers/PCA200E.BIN /etc/pca200e.bin
  40
  41         pc_adapter->'Windows NT'->archive->pca2e_12.zip
  42                 unzip the file and execute the command:
  43
  44                 cp -p <unzip_directory>/NT/I386/PCA200E.BIN /etc/pca200e.bin
  45
  46
  47 The following distributions from the FORE web pages are known to have
  48 microcode which will NOT work with HARP:
  49
  50         pc_adapter:
  51                 OS/2:
  52                         release:
  53                                 os2_4.1.0_1.74.zip
  54                 Windows95:
  55                         archive:
  56                                 pc-w95_5.0.0.16432.zip
  57                                 win95_4.0.3_1.04.200.zip
  58                                 win95_4.1.6_1.16.zip
  59                         release:
  60                                 pc-w95_4.1.6_27.zip
  61                 Windows NT:
  62                         archive:
  63                                 pc-nt_5.0.0_16342.zip
  64                                 winnt_4.0.3_1.05.200.zip
  65                                 winnt_4.1.2_1.27.zip
  66                                 winnt_4.1.6_1.16.zip
  67                         release:
  68                                 pc-nt_4.1.6_27.zip
  69                                 pc-nt_i386_5.0.0_25096.zip
  70
  71
  72 From the "ForeRunner 200E for PC/Mac" distribution CD-ROM, the following
  73 PCA200E adapter distributions are known to have microcode which will work
  74 with HARP (assuming the CD-ROM is mounted on /cdrom):
  75
  76         /cdrom/rel4.0/os2/
  77                 execute the command:
  78
  79                 cp -p /cdrom/rel4.0/os2/drivers/pca200e.bin /etc/pca200e.bin
  80
  81
  82 Note: Windows-based files are supplied in a compressed form. If the
  83 'fore_dnld' command complains about an unrecognized header format, you should
  84 try to uncompress the microcode file. To do so, move the file in binary mode
  85 to a DOS/Windows machine and use the DOS command 'expand' to uncompress the
  86 file. The command syntax is:
  87
  88         expand <in-file> <out-file>
  89
  90 Move the resulting <out-file> in binary mode back to the HARP machine as
  91 /etc/pca200e.bin and try to initialize the ATM system again.
  92