Another update. Clarify that a shared spinlock can be acquired while holding
[dragonfly.git] / 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