1.\" 2.\" Device driver optimized for the Symbios/LSI 53C896/53C895A/53C1010 3.\" PCI-SCSI controllers. 4.\" 5.\" Copyright (C) 1999-2000 Gerard Roudier <groudier@club-internet.fr> 6.\" 7.\" This driver also supports the following Symbios/LSI PCI-SCSI chips: 8.\" 53C810A, 53C825A, 53C860, 53C875, 53C876, 53C885, 53C895. 9.\" 10.\" but does not support earlier chips as the following ones: 11.\" 53C810, 53C815, 53C825. 12.\" 13.\" This driver for FreeBSD-CAM is derived from the Linux sym53c8xx driver. 14.\" Copyright (C) 1998-1999 Gerard Roudier 15.\" 16.\" The sym53c8xx driver is derived from the ncr53c8xx driver that had been 17.\" a port of the FreeBSD ncr driver to Linux-1.2.13. 18.\" 19.\" The original ncr driver has been written for 386bsd and FreeBSD by 20.\" Wolfgang Stanglmeier <wolf@cologne.de> 21.\" Stefan Esser <se@mi.Uni-Koeln.de> 22.\" Copyright (C) 1994 Wolfgang Stanglmeier 23.\" 24.\" The initialization code, and part of the code that addresses 25.\" FreeBSD-CAM services is based on the aic7xxx driver for FreeBSD-CAM 26.\" written by Justin T. Gibbs. 27.\" 28.\" Other major contributions: 29.\" 30.\" NVRAM detection and reading. 31.\" Copyright (C) 1997 Richard Waltham <dormouse@farsrobt.demon.co.uk> 32.\" 33.\" ---------------------------------------------------------------------------- 34.\" 35.\" Redistribution and use in source and binary forms, with or without 36.\" modification, are permitted provided that the following conditions 37.\" are met: 38.\" 1. Redistributions of source code must retain the above copyright 39.\" notice, this list of conditions and the following disclaimer. 40.\" 2. Redistributions in binary form must reproduce the above copyright 41.\" notice, this list of conditions and the following disclaimer in the 42.\" documentation and/or other materials provided with the distribution. 43.\" 3. The name of the author may not be used to endorse or promote products 44.\" derived from this software without specific prior written permission. 45.\" 46.\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS AND CONTRIBUTORS ``AS IS'' AND 47.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 48.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 49.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE FOR 50.\" ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 51.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 52.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 53.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 54.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 55.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 56.\" SUCH DAMAGE. 57.\" 58.\" $FreeBSD$ 59.\" 60.Dd January 12, 2000 61.Dt SYM 4 i386 62.Os FreeBSD 63.Sh NAME 64.Nm sym 65.Nd Symbios/LSI Logic PCI-SCSI host adapter driver 66.Sh SYNOPSIS 67For any number of cards: 68.Cd device sym 69.Pp 70To disable PCI parity checking (needed for broken bridges) 71.Cd options SYM_SETUP_PCI_PARITY=<boolean> 72.Pp 73To control driver probing against HVD buses 74.Cd options SYM_SETUP_SCSI_DIFF=<bit combination> 75.Pp 76To control chip attachment balancing between the ncr driver and this driver 77.Cd options SYM_SETUP_LP_PROBE_MAP=<bit combination> 78.Sh DESCRIPTION 79This driver provides support for the Symbios/LSI Logic 80.Tn 53C810A, 81.Tn 53C825A, 82.Tn 53C860, 83.Tn 53C875, 84.Tn 53C876, 85.Tn 53C895, 86.Tn 53C895A, 87.Tn 53C896, 88.Tn 53C897, 89.Tn 53C1510D, 90and 91.Tn 53C1010 92PCI-SCSI controllers. 93.Pp 94Driver features include support for wide SCSI busses, fast10, fast20, 95fast40 and fast80-dt synchronous data transfers depending on controller 96capabilities. It also provides generic SCSI features as tagged command 97queuing and auto-request sense. This driver is configured by default 98for a maximum of 446 outstanding commands per bus, 8 LUNs per target 99and 64 tagged tasks per LUN. These numbers are not so limited by design, 100as have been considered reasonable values for current SCSI technology. 101These values can be increased by changing appropriate 102constants in driver header files (not recommended). 103.Pp 104This driver requires the PCI-SCSI chip to implement LOAD/STORE SCRIPTS 105instructions and therefore it does not provide support for 53C810 revid < 16, 10653C825 revid < 16 and all 53C815 revisions. The generic 107.Nm ncr 108driver can be used to support these early chips. 109.Pp 110By default, when both the 111.Nm ncr 112and 113.Nm 114drivers are configured, the 115.Nm 116driver takes precedence over the 117.Nm ncr 118driver for all chips that are supported by 119both drivers. As result, the 120.Nm ncr 121driver does only attach the 53C8XX 122chips that donnot support LOAD/STORE (i.e.: 53C810, 53C815 and 53C825). 123User can change the balancing of chip types between drivers by defining 124the 125.Ar SYM_SETUP_LP_PROBE_MAP 126kernel configuration option as follows: 127.Bl -column "Bit " "53C8XXA, 53C8XX, 53C8XX, 53C8XX, 53C8XX, 53C8XX" 128.Em Bit Devices attached by ncr instead 1291 53C810a, 53C860 1302 53C825a, 53C875, 53C876, 53C885, 53C895 1314 53C895a, 53C896, 53C897, 53C1510d 132.El 133.Ed 134.Pp 135For example, if 136.Ar SYM_SETUP_LP_PROBE_MAP 137is supplied with value 7, all the 138above chips will be attached by the 139.Nm ncr 140driver and the 141.Nm 142driver will only 143attach the 53C1010 Ultra-3 controllers. 144.Pp 145HVD/LVD capable controllers (895, 895A, 896, 897 and 1010) report 146the actual bus mode from the STEST4 chip IO registers. This feature 147allows to safely probe against bus mode and to set up the chip 148accordingly. By default the driver only supports HVD for these chips. 149For other chips that can support HVD but not LVD, the driver has to probe 150implementation dependent registers (GPIO) in order to detect HVD bus mode. 151Only HVD implementations that conform with Symbios Logic recommendation can 152be detected by the driver. When the 153.Ar SYM_SETUP_SCSI_DIFF 154kernel is provided 155as value 1, the driver will also probe against HVD for 825a, 875, 876 and 156885 chips, assuming Symbios Logic compatible implementation of HVD. 157.Pp 158When supplied as 0, the 159.Ar SYM_SETUP_PCI_PARITY 160kernel configuration option 161indicates the driver not to enable PCI parity checking. PCI parity 162checking should not be an option for PCI-SCSI controllers, but some 163systems have been reported to fail using 53C8XX chips due to spurious or 164permanent PCI parity errors detected. This option is supplied for 165convenience but it is not recommended nor supported. 166.Pp 167This driver offers other options that are not currently exported to user. 168They are defined and documented in the sym_conf.h driver file. It is not 169recommended to change these options unless absolute need. Some of these 170options are planned to be exported through SYSCTL or equivalent mechanism 171in a further driver release and therefore, no compatibility is guaranteed. 172.Pp 173At initialization, the driver tries to detect and read user settings from 174controller NVRAM. The Symbios/Logic NVRAM layout and the Tekram NVRAM 175layout are currently supported. If the reading of the NVRAM succeeds, the 176following settings are taken into account and reported to CAM: 177.Pp 178.Bl -column "SCSI parity checking " "Symbios " "Tekram" 179.Em Host settings Symbios Tekram 180SCSI parity checking Y N 181Host SCSI ident Y Y 182Verbose messages Y N 183Scan targets hi-lo Y N 184Avoid SCSI bus reset Y N 185.Pp 186.El 187.Bl -column "Synchronous period " "Symbios " "Tekram" 188.Em Device settings Symbios Tekram 189Synchronous period Y Y 190SCSI bus width Y Y 191Queue tag enable Y Y 192Number of tags NA Y 193Disconnect enable Y Y 194Scan at boot time Y N 195Scan LUN Y N 196.El 197.Pp 198Devices that are configured as disabled for 'scan' in the NVRAM are not 199reported to CAM at system start-up. They can be discovered later using 200the 201.Nm camcontrol rescan 202command. 203.Pp 204The table below summarizes the main features and capabilities of the 205NCR/Symbios/LSI Logic 53C8XX family of PCI-SCSI controllers. 206.Pp 207.Bl -column sym53c1510d "Sync " "Width " "SRAM " "PCI64" 208.Em Chip Sync Width SRAM PCI64 Supported 209sym53c810 10MHz 8Bit N N N 210sym53c810a 10MHz 8Bit N N Y 211sym53c815 10MHz 8Bit N N N 212sym53c825 10MHz 16Bit N N N 213sym53c825a 10MHz 16Bit 4KB N Y 214sym53c860 20MHz 8Bit N N Y 215sym53c875 20MHz 16Bit 4KB N Y 216sym53c876 20MHz 16Bit 4KB N Y 217sym53c885 20MHz 16Bit 4KB N Y 218sym53c895 40MHz 16Bit 4KB N Y 219sym53c895A 40MHz 16Bit 8KB N Y 220sym53c896 40MHz 16Bit 8KB Y Y 221sym53c897 40MHz 16Bit 8KB Y Y 222sym53c1510D 40MHz 16Bit 4KB Y Y 223sym53c1010 80MHz 16Bit 8KB Y Y 224.El 225.Pp 226.Sh BUGS 227No known bugs. 228.Sh SEE ALSO 229.Xr cd 4 , 230.Xr da 4 , 231.Xr ncr 4 , 232.Xr sa 4 , 233.Xr scsi 4 , 234.Xr camcontrol 8 235.Sh AUTHORS 236The 237.Nm 238driver has been written by Gerard Roudier and is derived from the 239Linux sym53c8xx driver from the same author. 240The sym53c8xx driver is derived from the ncr53c8xx driver that had been 241a port of the 242.Fx 243.Nm ncr 244driver to Linux-1.2.13. 245The original 246.Nm ncr 247driver was written for 386BSD and 248.Fx 249by Wolfgang Stanglmeier and Stefan Esser. 250.Sh HISTORY 251The 252.Nm 253driver appeared in 254.Fx 4.0 . 255 256