URL https://opencores.org/ocsvn/or1k/or1k/trunk

Subversion Repositories or1k

[/] [or1k/] [trunk/] [uclinux/] [uClinux-2.0.x/] [drivers/] [scsi/] [README.AM53C974] - Blame information for rev 1765

Details | Compare with Previous | View Log


SUBJECT
-------
AM53/79C974 PC-SCSI Driver
 
 
DISCLAIMER
----------
***  THIS SHOULD BE CONSIDERED AS BETA SOFTWARE  ***
***  USE AT YOUR OWN RISK!                       ***
 
 
Copyright
---------
The architecture and much of the code of this device driver was
originally developed by Drew Eckhardt for the NCR5380. The
following copyrights apply:
 
For the architecture and all pieces of code which can also be found
in the NCR5380 device driver:
Copyright 1993, Drew Eckhardt
  Visionary Computing
  (Unix and Linux consulting and custom programming)
  drew@colorado.edu
  +1 (303) 666-5836
 
The AM53C974_nobios_detect code was originally developed by
Robin Cutshaw (robin@xfree86.org) and is used here in a
slightly modified form.
 
For the remaining code:
  Copyright 1994, D. Frieauff
  EMail: fri@rsx42sun0.dofn.de
  Phone: x49-7545-8-2256 , x49-7541-42305
 
 
Version
-------
AM53/79C974 (PC-SCSI) Linux driver ALPHA release 0.5, 19 November 1995
 
 
Changelog
---------
0.1 -> 0.2:
  - Extended message handling re-written to eliminate 'invalid message 17' bug
  - Parameters of AM53C974_intr adapted
  - Debug messages structured
  - Spelling improved
0.2 -> 0.3:
  - README file updated -- please read this file up to the end!
  - Automatic scanning of io_port and irq implemented; no need for BIOS32
    anymore
  - Improved configuration (now via LILO parameter string)
  - Cleanup of probing and initialisation code
  - Improved sync. negotiation (can be setup individually for every device)
  - Improved/ debugged code for reception of ext. messages
0.3 -> 0.4:
  - Improved PCI probing and initialisation code
  - Compatibility changes for Linux 1.3.x
0.4 -> 0.5:
  - Compatibility changes for Linux 1.3.42
 
Bugs & Todo
-----------
 - Add proc info function
 - Support SCSI-2 tagged queuing
 - Finalize abort code
 
Features
--------
This driver supports asynchronous and synchronous SCSI-I and SCSI-II devices.
It is capable of transfer rate and synchronous negotiation (see below).
The driver supports scatter-gather. Transfers are DMA based, but do not
(yet) make use of the AM53/79C974 MDL mode.
Max. transfer rate is 10MHz (whatever this is in real life). The transfer
rate is negotiated with each device (see dmesg output).
The AM53/79C974 has a 96-byte DMA FIFO to the PCI bus and a 16-byte SCSI
FIFO. It provides active negation and glitch suppression functions.
Burst DMA transfer rate is 132 MBytes/sec.
 
 
Configuration
-------------
The following communication characteristics can be set individually  for every
SCSI device on the bus:
  - enable/disable sync. negotiation
  - transfer rate
  - asynchronous or synchronous communication
  - in case of sync. communication, the sync. offset
 
The sync. offset specifies the number of bytes that can be sent or
received from the SCSI bus without ACK resp. REQ signal.
CAUTION: USING SYNCHRONOUS MODE ON LONG SCSI CABLES MAY CAUSE
         COMMUNICATION PROBLEMS LEADING TO LOSS OF DATA.
 
The default setting of the SCSI communication parameters is as follows:
  - no negotiation
  - 5.0 MHz transfer rate
  - asynchronous mode
  - zero offset
The parameters can be modified by passing a string with the following syntax to
the kernel: AM53C974=host-scsi-id,target-scsi-id,max-rate,max-offset
The parameters will be used by the driver as negotiation basis.
The range of the rate parameter is 3 to 10 MHz.
The range of the sync. offset parameter is 0 to 15 bytes. A value of 0 denotes
asynchronous comm. mode.
If the target cannot cope with the specified transfer rate, sync. mode or sync.
offset, the negotiation result will differ from the specified values.
The negotiation result is printed out at the end of the negotiation process
(to read it, use the dmesg program or the appropriate syslog).
The parameter strings (blank separated) can be passed to the kernel at the
LILO prompt, or as part of the LILO configuration file.
 
For example, the string "AM53C974=7,2,8,15" would be interpreted as follows:
 "For communication between the controller with SCSI-ID 7 and the device with
 SCSI-ID 2 a transfer rate of 8MHz in synchronous mode with max. 15 bytes offset
 should be negotiated".
 
As an example, here my LILO configuration file:
  boot = /dev/sda
  compact
  #prompt
  delay = 50    # optional, for systems that boot very quickly
  vga = normal  # force sane state
  ramdisk = 0   # paranoia setting
  root = current  # use "current" root
  image = /usr/src/linux/arch/i386/boot/zImage
    label = linux
    append = "AM53C974=7,0,10,0 AM53C974=7,1,10,0 AM53C974=7,2,10,15 AM53C974=7,4,10,0 AM53C974=7,5,10,0"
    read-only
  other = /dev/sda4
    label = os2
  other = /dev/sdb3
    loader = /boot/any_d.b
    table = /dev/sdb
    label = setup
 
The same parameters at the LILO prompt:
  LILO boot: linux AM53C974=7,0,10,0 AM53C974=7,1,10,0 AM53C974=7,2,10,15 AM53C974=7,4,10,0 AM53C974=7,5,10,0
 
You can override parameters specified in the LILO configuration file by
parameters specified on the LILO command line.
 
 
BIOS usage
----------
Version 0.4 of the driver will use the BIOS, if available. Otherwise
it will try its internal PCI scan and access routines.
The driver assumes that the controller's SCSI-ID (usually 7) has been
correctly loaded by the BIOS into the controller's register during
system boot. If the driver detects that the controller's SCSI ID is not
'7' it will print out a warning. If this happens to you please correct
setting of the controller's SCSI-ID. If it is wrong, then edit the
AM53C974_SCSI_ID definition in file AM53C974.h accordingly.
 
 
Test environment
----------------
This driver was tested on a Compaq XL566 with the following SCSI configuration:
2 x HP C2247 fixed disk (internal, rate=10MHz, async.)
1 x Micropolis 1624 fixed disk (external, rate=8MHz, sync., offset=15 bytes)
1 x Wangtek W5525ES cartridge streamer (internal, rate=5MHz, async.)
1 x Toshiba XM-3301B CD-ROM (external, rate=5MHz, async.)
 
 
Known problems
--------------
 - Compaq/Matsushita CD-ROM:
   Use of this device with AM53C974 driver version 0.2 caused the kernel to
   hang during Linux boot. If you encounter the problem, don't enable sync.
   negotiation with the CD-ROM, i.e. simply don't specify comm. parameters
   for this device on the LILO commandline or configuration file.
   The driver will thus use its default for the CD-ROM, which is 5MHz
   transfer rate asynch and no sync. negotiation.
 - Some disks cause problems.
 
 
What to do if there is a SCSI problem possibly related to the driver
--------------------------------------------------------------------
Read Klaus Liedl's WWW page (http://www-c724.uibk.ac.at/XL/).
In case this does not help:
Send me a complete description of the problem, including your SCSI
configuration plus as much debugging information as possible.
Don't wait until I ask you for this information. To enable the
generation of debugging output, remove the comments from the following
definitions in the AM53C974.h file:
    AM53C974_DEBUG
    AM53C974_DEBUG_MSG
    AM53C974_DEBUG_KEYWAIT
    AM53C974_DEBUG_INFO
    AM53C974_DEBUG_INTR
With these definitions enabled, the driver will enter single-step mode during
Linux boot. Use the spacebar for stepping.
Take note of at least the last 10 printout sections (marked by dashes) before
the crash/hangup or whatever happens and send me all of this information via
email. If the system can boot, use the syslogd daemon to record the debugging
output. Maybe you can use the ramdisk for this purpose too (if necessary, kindly
ask K. Liedl (Klaus.Liedl@uibk.ac.at) for support, he knows how to do it --
I never tried). Stay in email contact with me. Be aware that the following
weeks/months could be the worst of your life.
Note: If single-stepping takes up too much time, you can try to let the driver
catch the problem by pressing the 'r' key. The driver will automatically enter
single-step mode if it has detected something weird.
 
 
Author's Contact Address
-----------------------
Email: fri@rsx42sun0.dofn.de
Phone: x49-7545-2256 (office), x49-7541-42305 (home)
Home address: D. Frieauff, Stockerholzstr. 27, 88048 Friedrichshafen, Germany
 
 
!!!! Important Notice !!!!
-----------------------------
- Klaus Liedl maintains an excellent WWW page about Linux on Compaq XL.
  It includes an FAQ, lots of tips & tricks as well as downloadable
  boot disk images. The URL is: http://www-c724.uibk.ac.at/XL/
- Volunteer wanted for further maintenance of this driver software. I
  don't have the time anymore to do serious support as some of you will know.
 
Literature
----------
 - AMD AM53C974 PC-SCSI Technical Manual, publication #18624B
 - Amendment to the AMD AM53C974 PC-SCSI Technical Manual
 - AMD AM79C974 PC-NET Datasheet, publication #18681
 - Amendment to the AMD AM79C974 PC-NET Datasheet
 
 
THANKS to
---------
 - Drew Eckhardt, Robin Cutshaw, K. Liedl, Robert J. Pappas, A. Grenier,
   Mark Stockton, David C. Niemi, Ben Craft, and many others who have helped
 

Browse

Tools

Subversion Repositories or1k

[/] [or1k/] [trunk/] [uclinux/] [uClinux-2.0.x/] [drivers/] [scsi/] [README.AM53C974] - Blame information for rev 1765

Line No.	Rev	Author	Line
1	199	simons	`SUBJECT`
2			`-------`
3			`AM53/79C974 PC-SCSI Driver`
4
5
6			`DISCLAIMER`
7			`----------`
8			`* THIS SHOULD BE CONSIDERED AS BETA SOFTWARE *`
9			`* USE AT YOUR OWN RISK! *`
10
11
12			`Copyright`
13			`---------`
14			`The architecture and much of the code of this device driver was`
15			`originally developed by Drew Eckhardt for the NCR5380. The`
16			`following copyrights apply:`
17
18			`For the architecture and all pieces of code which can also be found`
19			`in the NCR5380 device driver:`
20			`Copyright 1993, Drew Eckhardt`
21			`Visionary Computing`
22			`(Unix and Linux consulting and custom programming)`
23			`drew@colorado.edu`
24			`+1 (303) 666-5836`
25
26			`The AM53C974_nobios_detect code was originally developed by`
27			`Robin Cutshaw (robin@xfree86.org) and is used here in a`
28			`slightly modified form.`
29
30			`For the remaining code:`
31			`Copyright 1994, D. Frieauff`
32			`EMail: fri@rsx42sun0.dofn.de`
33			`Phone: x49-7545-8-2256 , x49-7541-42305`
34
35
36			`Version`
37			`-------`
38			`AM53/79C974 (PC-SCSI) Linux driver ALPHA release 0.5, 19 November 1995`
39
40
41			`Changelog`
42			`---------`
43			`0.1 -> 0.2:`
44			`- Extended message handling re-written to eliminate 'invalid message 17' bug`
45			`- Parameters of AM53C974_intr adapted`
46			`- Debug messages structured`
47			`- Spelling improved`
48			`0.2 -> 0.3:`
49			`- README file updated -- please read this file up to the end!`
50			`- Automatic scanning of io_port and irq implemented; no need for BIOS32`
51			`anymore`
52			`- Improved configuration (now via LILO parameter string)`
53			`- Cleanup of probing and initialisation code`
54			`- Improved sync. negotiation (can be setup individually for every device)`
55			`- Improved/ debugged code for reception of ext. messages`
56			`0.3 -> 0.4:`
57			`- Improved PCI probing and initialisation code`
58			`- Compatibility changes for Linux 1.3.x`
59			`0.4 -> 0.5:`
60			`- Compatibility changes for Linux 1.3.42`
61
62			`Bugs & Todo`
63			`-----------`
64			`- Add proc info function`
65			`- Support SCSI-2 tagged queuing`
66			`- Finalize abort code`
67
68			`Features`
69			`--------`
70			`This driver supports asynchronous and synchronous SCSI-I and SCSI-II devices.`
71			`It is capable of transfer rate and synchronous negotiation (see below).`
72			`The driver supports scatter-gather. Transfers are DMA based, but do not`
73			`(yet) make use of the AM53/79C974 MDL mode.`
74			`Max. transfer rate is 10MHz (whatever this is in real life). The transfer`
75			`rate is negotiated with each device (see dmesg output).`
76			`The AM53/79C974 has a 96-byte DMA FIFO to the PCI bus and a 16-byte SCSI`
77			`FIFO. It provides active negation and glitch suppression functions.`
78			`Burst DMA transfer rate is 132 MBytes/sec.`
79
80
81			`Configuration`
82			`-------------`
83			`The following communication characteristics can be set individually for every`
84			`SCSI device on the bus:`
85			`- enable/disable sync. negotiation`
86			`- transfer rate`
87			`- asynchronous or synchronous communication`
88			`- in case of sync. communication, the sync. offset`
89
90			`The sync. offset specifies the number of bytes that can be sent or`
91			`received from the SCSI bus without ACK resp. REQ signal.`
92			`CAUTION: USING SYNCHRONOUS MODE ON LONG SCSI CABLES MAY CAUSE`
93			`COMMUNICATION PROBLEMS LEADING TO LOSS OF DATA.`
94
95			`The default setting of the SCSI communication parameters is as follows:`
96			`- no negotiation`
97			`- 5.0 MHz transfer rate`
98			`- asynchronous mode`
99			`- zero offset`
100			`The parameters can be modified by passing a string with the following syntax to`
101			`the kernel: AM53C974=host-scsi-id,target-scsi-id,max-rate,max-offset`
102			`The parameters will be used by the driver as negotiation basis.`
103			`The range of the rate parameter is 3 to 10 MHz.`
104			`The range of the sync. offset parameter is 0 to 15 bytes. A value of 0 denotes`
105			`asynchronous comm. mode.`
106			`If the target cannot cope with the specified transfer rate, sync. mode or sync.`
107			`offset, the negotiation result will differ from the specified values.`
108			`The negotiation result is printed out at the end of the negotiation process`
109			`(to read it, use the dmesg program or the appropriate syslog).`
110			`The parameter strings (blank separated) can be passed to the kernel at the`
111			`LILO prompt, or as part of the LILO configuration file.`
112
113			`For example, the string "AM53C974=7,2,8,15" would be interpreted as follows:`
114			`"For communication between the controller with SCSI-ID 7 and the device with`
115			`SCSI-ID 2 a transfer rate of 8MHz in synchronous mode with max. 15 bytes offset`
116			`should be negotiated".`
117
118			`As an example, here my LILO configuration file:`
119			`boot = /dev/sda`
120			`compact`
121			`#prompt`
122			`delay = 50 # optional, for systems that boot very quickly`
123			`vga = normal # force sane state`
124			`ramdisk = 0 # paranoia setting`
125			`root = current # use "current" root`
126			`image = /usr/src/linux/arch/i386/boot/zImage`
127			`label = linux`
128			`append = "AM53C974=7,0,10,0 AM53C974=7,1,10,0 AM53C974=7,2,10,15 AM53C974=7,4,10,0 AM53C974=7,5,10,0"`
129			`read-only`
130			`other = /dev/sda4`
131			`label = os2`
132			`other = /dev/sdb3`
133			`loader = /boot/any_d.b`
134			`table = /dev/sdb`
135			`label = setup`
136
137			`The same parameters at the LILO prompt:`
138			`LILO boot: linux AM53C974=7,0,10,0 AM53C974=7,1,10,0 AM53C974=7,2,10,15 AM53C974=7,4,10,0 AM53C974=7,5,10,0`
139
140			`You can override parameters specified in the LILO configuration file by`
141			`parameters specified on the LILO command line.`
142
143
144			`BIOS usage`
145			`----------`
146			`Version 0.4 of the driver will use the BIOS, if available. Otherwise`
147			`it will try its internal PCI scan and access routines.`
148			`The driver assumes that the controller's SCSI-ID (usually 7) has been`
149			`correctly loaded by the BIOS into the controller's register during`
150			`system boot. If the driver detects that the controller's SCSI ID is not`
151			`'7' it will print out a warning. If this happens to you please correct`
152			`setting of the controller's SCSI-ID. If it is wrong, then edit the`
153			`AM53C974_SCSI_ID definition in file AM53C974.h accordingly.`
154
155
156			`Test environment`
157			`----------------`
158			`This driver was tested on a Compaq XL566 with the following SCSI configuration:`
159			`2 x HP C2247 fixed disk (internal, rate=10MHz, async.)`
160			`1 x Micropolis 1624 fixed disk (external, rate=8MHz, sync., offset=15 bytes)`
161			`1 x Wangtek W5525ES cartridge streamer (internal, rate=5MHz, async.)`
162			`1 x Toshiba XM-3301B CD-ROM (external, rate=5MHz, async.)`
163
164
165			`Known problems`
166			`--------------`
167			`- Compaq/Matsushita CD-ROM:`
168			`Use of this device with AM53C974 driver version 0.2 caused the kernel to`
169			`hang during Linux boot. If you encounter the problem, don't enable sync.`
170			`negotiation with the CD-ROM, i.e. simply don't specify comm. parameters`
171			`for this device on the LILO commandline or configuration file.`
172			`The driver will thus use its default for the CD-ROM, which is 5MHz`
173			`transfer rate asynch and no sync. negotiation.`
174			`- Some disks cause problems.`
175
176
177			`What to do if there is a SCSI problem possibly related to the driver`
178			`--------------------------------------------------------------------`
179			`Read Klaus Liedl's WWW page (http://www-c724.uibk.ac.at/XL/).`
180			`In case this does not help:`
181			`Send me a complete description of the problem, including your SCSI`
182			`configuration plus as much debugging information as possible.`
183			`Don't wait until I ask you for this information. To enable the`
184			`generation of debugging output, remove the comments from the following`
185			`definitions in the AM53C974.h file:`
186			`AM53C974_DEBUG`
187			`AM53C974_DEBUG_MSG`
188			`AM53C974_DEBUG_KEYWAIT`
189			`AM53C974_DEBUG_INFO`
190			`AM53C974_DEBUG_INTR`
191			`With these definitions enabled, the driver will enter single-step mode during`
192			`Linux boot. Use the spacebar for stepping.`
193			`Take note of at least the last 10 printout sections (marked by dashes) before`
194			`the crash/hangup or whatever happens and send me all of this information via`
195			`email. If the system can boot, use the syslogd daemon to record the debugging`
196			`output. Maybe you can use the ramdisk for this purpose too (if necessary, kindly`
197			`ask K. Liedl (Klaus.Liedl@uibk.ac.at) for support, he knows how to do it --`
198			`I never tried). Stay in email contact with me. Be aware that the following`
199			`weeks/months could be the worst of your life.`
200			`Note: If single-stepping takes up too much time, you can try to let the driver`
201			`catch the problem by pressing the 'r' key. The driver will automatically enter`
202			`single-step mode if it has detected something weird.`
203
204
205			`Author's Contact Address`
206			`-----------------------`
207			`Email: fri@rsx42sun0.dofn.de`
208			`Phone: x49-7545-2256 (office), x49-7541-42305 (home)`
209			`Home address: D. Frieauff, Stockerholzstr. 27, 88048 Friedrichshafen, Germany`
210
211
212			`!!!! Important Notice !!!!`
213			`-----------------------------`
214			`- Klaus Liedl maintains an excellent WWW page about Linux on Compaq XL.`
215			`It includes an FAQ, lots of tips & tricks as well as downloadable`
216			`boot disk images. The URL is: http://www-c724.uibk.ac.at/XL/`
217			`- Volunteer wanted for further maintenance of this driver software. I`
218			`don't have the time anymore to do serious support as some of you will know.`
219
220			`Literature`
221			`----------`
222			`- AMD AM53C974 PC-SCSI Technical Manual, publication #18624B`
223			`- Amendment to the AMD AM53C974 PC-SCSI Technical Manual`
224			`- AMD AM79C974 PC-NET Datasheet, publication #18681`
225			`- Amendment to the AMD AM79C974 PC-NET Datasheet`
226
227
228			`THANKS to`
229			`---------`
230			`- Drew Eckhardt, Robin Cutshaw, K. Liedl, Robert J. Pappas, A. Grenier,`
231			`Mark Stockton, David C. Niemi, Ben Craft, and many others who have helped`
232