freebsd-dev/sys/dev/sym/README.sym

298 lines
12 KiB
Plaintext

/*
* Device driver optimized for the Symbios/LSI 53C896/53C895A/53C1010
* PCI-SCSI controllers.
*
* Copyright (C) 1999 Gerard Roudier <groudier@club-internet.fr>
*
* This driver also supports the following Symbios/LSI PCI-SCSI chips:
* 53C810A, 53C825A, 53C860, 53C875, 53C876, 53C885, 53C895.
*
* but does not support earlier chips as the following ones:
* 53C810, 53C815, 53C825.
*
* This driver for FreeBSD-CAM is derived from the Linux sym53c8xx driver.
* Copyright (C) 1998-1999 Gerard Roudier
*
* The sym53c8xx driver is derived from the ncr53c8xx driver that had been
* a port of the FreeBSD ncr driver to Linux-1.2.13.
*
* The original ncr driver has been written for 386bsd and FreeBSD by
* Wolfgang Stanglmeier <wolf@cologne.de>
* Stefan Esser <se@mi.Uni-Koeln.de>
* Copyright (C) 1994 Wolfgang Stanglmeier
*
* The initialisation code, and part of the code that addresses
* FreeBSD-CAM services is based on the aic7xxx driver for FreeBSD-CAM
* written by Justin T. Gibbs.
*
* Other major contributions:
*
* NVRAM detection and reading.
* Copyright (C) 1997 Richard Waltham <dormouse@farsrobt.demon.co.uk>
*
*-----------------------------------------------------------------------------
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions
* are met:
* 1. Redistributions of source code must retain the above copyright
* notice, this list of conditions and the following disclaimer.
* 2. Redistributions in binary form must reproduce the above copyright
* notice, this list of conditions and the following disclaimer in the
* documentation and/or other materials provided with the distribution.
* 3. The name of the author may not be used to endorse or promote products
* derived from this software without specific prior written permission.
*
* THIS SOFTWARE IS PROVIDED BY THE AUTHORS AND CONTRIBUTORS ``AS IS'' AND
* ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
* ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE FOR
* ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
* DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
* OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
* HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
* LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
* OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
* SUCH DAMAGE.
*/
Status:
BETA-RELEASE
This driver is currently developped under the following O/S:
FreeBSD 4.0 SNAPSHOT July 5th 1999
FreeBSD 4.0 current October 1999
Starting with version 0.9.0, the driver contains conditionnal code
for using pre-4.0 BUS stuff for PCI. I have successfully tested driver
version 0.9.0 under:
FreeBSD 3.2 RELEASE
FreeBSD 3.3 RELEASE
Latest revision:
sym-0.12.0-19991127
Files to download:
SYM-0.9.0-19991024.tar.gz
PATCH-SYM-0.10.0-19991111.gz
PATCH-SYM-0.11.0-19991120.gz
PATCH-SYM-0.12.0-19991127.gz
Supported SCSI features:
- Initiator mode
- Wide 16 SCSI BUS
- FAST10 up to FAST80-DT synchronous data transfers
(depends on controller capabilities)
- 64 luns per target
- 256 tags per lun
- MDP (1)
- BUS DEVICE RESET message
- ABORT, ABORT TAG message
Supported generic chip features:
- On chip RAM
- PCI optimized transactions.
Supported features of 896/895A/1010:
- Full SCRIPTS in on-board RAM (8K)
- Phase mismatch handling from SCRIPTS.
Others:
- SYMBIOS NVRAM layout using 24c16 EEPROM
- TEKRAM NVRAM layout using 24c16 EEPROM (2)
- TEKRAM NVRAM layout using 93c46 EEPROM (2)
- Transfer residuals
- 0(1) for both SCRIPTS and C code, allowing
100% scalability.
Notes:
(1) Not yet reported. May not work as expected.
Files:
README.sym this file
sym_conf.h driver configuration
sym_defs.h driver definitions
sym_hipd.c driver code
sym_sys.patch kernel patch for FreeBSD 4
sym_sys_3.patch kernel patch for FreeBSD 3
These patches apply a change to the ncr.c driver that forces it to
ignore SYM53C8XX chips that support LOAD/STORE. These devices will
be attached by the sym_hipd.c driver.
Installation:
1) Untar SYM-0.9.0-19991024.tar.gz
2) Create the /usr/src/sys/dev/sym directory
3) Copy README.sym, sym_conf.h, sym_defs.h and sym_hipd.c to
/usr/src/sys/dev/sym/
4) Change to /usr/src/sys/ directory
5) If FreeBSD-4, apply the unified patch sym_sys.patch
(patch -p0 <sym_sys.patch)
Otherwise,
If FreeBSD-3, apply the unified patch sym_sys_3.patch
(patch -p0 <sym_sys_3.patch)
Otherwise, leave here. ;)
6) Change to /usr/src/sys/dev/sym directory
7) Update to SYM-0.11.0-19991120
gzip -d <PATCH-SYM-0.10.0-19991111.gz | patch -p0
gzip -d <PATCH-SYM-0.11.0-19991120.gz | patch -p0
gzip -d <PATCH-SYM-0.12.0-19991127.gz | patch -p0
8) Add sym0 to your kernel configuration as indicated in patched LINT file.
Configure and make your kernel.
As seen from the shell history file (driver material assumed from /tmp),
installation should proceed as follow (modulo mistakes from me:)):
cd /tmp
tar zxvf SYM-0.9.0-19991024.tar.gz
cp SYM-0.9.0-19991024/* /usr/src/sys/dev/sym
cd /usr/src/sys
patch -p0 <dev/sym/sym_sys.patch # use sym_sys_3.patch if FreeBSD-3.X
cd dev/sym
gzip -d </tmp/PATCH-SYM-0.10.0-19991111.gz | patch -p0
gzip -d </tmp/PATCH-SYM-0.11.0-19991120.gz | patch -p0
gzip -d </tmp/PATCH-SYM-0.12.0-19991127.gz | patch -p0
Configuring Ultra-3 DT data transfer support.
---------------------------------------------
If you have a board using the SYM53C1010 (only evaluation boards seem to
be available for now), you may want to give Ultra-3 DT transfer a try.
For the reasons that FreeBSD-CAM is not yet ready for Ultra-3 and that
early SYM53C1010 chips need some work-around for DT transfers to work
reliably, you must apply manually the following additionnal patch to your
kernel tree:
---------------------- Cut Here ------------------------
--- cam/scsi/scsi_all.c.00 1999/08/29 16:21:44
+++ cam/scsi/scsi_all.c 1999/11/23 22:11:22
@@ -2394,6 +2394,7 @@
u_int period_factor;
u_int period; /* in 10ths of ns */
} scsi_syncrates[] = {
+ { 0x09, 125 },
{ 0x0a, 250 },
{ 0x0b, 303 },
{ 0x0c, 500 }
--- pci/sym_conf.h.00 Fri Nov 26 22:58:59 1999
+++ pci/sym_conf.h Fri Nov 26 22:58:38 1999
@@ -69,6 +69,7 @@
* corresponding code will get useless.
*/
/* #define SYMCONF_BROKEN_U3EN_SUPPORT */
+#define SYMCONF_BROKEN_U3EN_SUPPORT
/*
* Use Normal IO instead of MMIO.
---------------------- Cut Here ------------------------
This change consist in allowing sync factor 9 support to be handled
by scsi_all.c and a compilation option to be defined in sym_conf.h.
The driver may only start a PPR negotiation if sync factor is 9.
This change has been only tested on FreeBSD-3.3 for the moment.
For the PPR negotiation to occur at system startup time, you need to
configure Ultra3 hard disks in the NVRAM for 80 Mega-transfers per second
Wide.
If you prefer to use camcontrol for such a negotiation to be performed after
system startup, then you have to rebuild either the libcam shareable library
with the patched version of scsi_all.c, on to rebuild camcontrol using
the new static version of the libcam library that includes the patched
version of scsi_all.o.
Warnings:
- This driver uses LOAD/STORE instructions from SCRIPTS and therefore does
not support earliest NCR chips (NCR53C810, NCR53C815, NCR53C825).
Versionning:
- The version number consists in 3 numbers X.Y.Z, starting with 0.0.0.
- Z will not be used for incremental patches, but may be used for
quick fixes.
- Incremental diff files are of the following pattern:
PATCH-SYM-X.Y.Z-YYYYMMDD
They must be applied from directory: /usr/src/sys/dev/sym/
- Version 1.0.0 will happen when the driver will be tested enough but this
driver version will probably not officially support the C1010 (Ultra-3)
since the testing of Ultra3 has just started and FreeBSD-CAM is not yet
ready for the support of Ultra-3. Some 1.X.0 version will support
DT data transfer for the C1010.
- Version 2.0.0 is not planned for now, but will add support for host target
mode if it will ever exist.
Change log:
* SYM-0.0.0-19990915
Initial release.
* SYM-0.1.0-19990919 (diff file PATCH-SYM-0.1.0-19990919
Add NVRAM support for latest Tekram boards using 24c16 EEPROM.
* SYM-0.2.0-19990922 (diff file PATCH-SYM-0.2.0-19990922
Add PPR negotiation and Ultra3 DT transfers for the LSI53C1010.
This corresponding code is untested since I haven't yet the
hardware. But the driver is not broken for current chips.
* SYM-0.3.0-19990925 (diff file PATCH-SYM-0.3.0-19990925
Source review.
Testing of the QUEUE FULL handling (some fixes applied).
* SYM-0.4.0-19990925 (diff file PATCH-SYM-0.4.0-19990928)
Fixes, notably the QUEUE FULL handling that requeued everything
without telling the XPT about the error. Note that this did not
break anything, but the queue depth was never reduced.
* SYM-0.5.0-19991001 (diff file PATCH-SYM-0.5.0-19991001)
Problem of not discovering LUNs != 0 hopefully fixed.
Some other minor fixes.
* SYM-0.6.0-19991003 (diff file PATCH-SYM-0.6.0-19991003)
Test error recovery pathes and residual calculation.
Improve Symbios NVRAM support by applying the SCAN_LUNS flag. The driver
answers DEV_NOT_THERE to INQUIRYs for LUNs that are not to be scanned.
Switch the driver status for SPI2 support to BETA-RELEASE.
* SYM-0.7.0-19991006 (diff file PATCH-SYM-0.7.0-19991006)
Add support of the LSI1510D that emulates a 895 (infos sent by Compaq
that seems to be the only supplier of this chip)
Return CAM_REQ_ABORTED on HS_ABORT host status.
Fix a tiny bug that let the driver miss the TAG setting.
* SYM-0.8.0-19991016 (diff file PATCH-SYM-0.8.0-19991016)
Heavy rewrite/rewamping of the error handling code in order to conform
to FreeBSD-CAM expectation of commands having to be requeued and device
queue to be frozen on any kind of error. Driver status switched back
to EXPERIMENTAL due to these changes.
Warn user about targets that are not flagged for SCAN AT BOOT in the
NVRAM, since the driver will not allow the corresponding devices to be
discovered by XPT.
And numerous minor changes.
* SYM-0.9.0-19991024 (Tar file SYM-0.9.0-19991024.tar.gz)
Add support for previous PCI BUS stuff, for the driver to be useable
under FreeBSD 3.X RELEASES. The source is #ifdefed for using the old
PCI BUS code under __FreeBSD_version < 400000 and the new one otherwise.
Tested under RELENG_3_2_0_RELEASE, but should also be just fine for 3.3.
Other changes against version 0.8.0 are only minor buglet fixes.
* SYM-0.10.0-19991111 (diff file PATCH-SYM-0.10.0-19991111)
Add support for Alpha - UNTESTED. Consists in some minor changes picked
mostly from the ncr driver and some others as ahc_pci.c.
Fix the LED support through GPIO0 for pre-896 chips. In fact some code
was wrongly conditionned by something that was never met.
Switch driver status to BETA-RELEASE given that this driver has been rock
solid even if a small number of users seems to actually use it.
* SYM-0.11.0-19991120 (diff file PATCH-SYM-0.11.0-19991120)
Rearrange a bit the initialisation code that deals with IO registers.
Fix a bug in MODIFY_DP/IGN_RESIDUE handling (May-be this code will
never be used).
Fix a tiny problem in Wide nego. The driver didn't start the Sync nego
after a Wide nego if synchronous parameters weren't also changed.
Apply fixes that should allow to successfully link the kernel on Alpha.
LSI53C1010 tested with Asynchronous, FAST5, FAST10, FAST20 and FAST40
data transfers.
* SYM-0.12.0-19991127 (diff file PATCH-SYM-0.12.0-19991127)
Some testing in Ultra3 FAST-80 DT mode using a SYM53C1010 connected
to an ATLAS 4 Ultra3 disk. Required some tiny fix in the ppr nego code.
Some cosmetic changes in messages displayed under DEBUG.
Fix the chip table (and code) that made the driver wrongly attach
810 and 825 devices.
November 27 1999. "Gerard Roudier"<groudier@club-internet.fr>