aic79xx.txt 24 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497
  1. ====================================================================
  2. = Adaptec Ultra320 Family Manager Set =
  3. = =
  4. = README for =
  5. = The Linux Operating System =
  6. ====================================================================
  7. The following information is available in this file:
  8. 1. Supported Hardware
  9. 2. Version History
  10. 3. Command Line Options
  11. 4. Additional Notes
  12. 5. Contacting Adaptec
  13. 1. Supported Hardware
  14. The following Adaptec SCSI Host Adapters are supported by this
  15. driver set.
  16. Ultra320 ASIC Description
  17. ----------------------------------------------------------------
  18. AIC-7901A Single Channel 64-bit PCI-X 133MHz to
  19. Ultra320 SCSI ASIC
  20. AIC-7901B Single Channel 64-bit PCI-X 133MHz to
  21. Ultra320 SCSI ASIC with Retained Training
  22. AIC-7902A4 Dual Channel 64-bit PCI-X 133MHz to
  23. Ultra320 SCSI ASIC
  24. AIC-7902B Dual Channel 64-bit PCI-X 133MHz to
  25. Ultra320 SCSI ASIC with Retained Training
  26. Ultra320 Adapters Description ASIC
  27. --------------------------------------------------------------------------
  28. Adaptec SCSI Card 39320 Dual Channel 64-bit PCI-X 133MHz to 7902A4/7902B
  29. Ultra320 SCSI Card (one external
  30. 68-pin, two internal 68-pin)
  31. Adaptec SCSI Card 39320A Dual Channel 64-bit PCI-X 133MHz to 7902B
  32. Ultra320 SCSI Card (one external
  33. 68-pin, two internal 68-pin)
  34. Adaptec SCSI Card 39320D Dual Channel 64-bit PCI-X 133MHz to 7902A4
  35. Ultra320 SCSI Card (two external VHDC
  36. and one internal 68-pin)
  37. Adaptec SCSI Card 39320D Dual Channel 64-bit PCI-X 133MHz to 7902A4
  38. Ultra320 SCSI Card (two external VHDC
  39. and one internal 68-pin) based on the
  40. AIC-7902B ASIC
  41. Adaptec SCSI Card 29320 Single Channel 64-bit PCI-X 133MHz to 7901A
  42. Ultra320 SCSI Card (one external
  43. 68-pin, two internal 68-pin, one
  44. internal 50-pin)
  45. Adaptec SCSI Card 29320A Single Channel 64-bit PCI-X 133MHz to 7901B
  46. Ultra320 SCSI Card (one external
  47. 68-pin, two internal 68-pin, one
  48. internal 50-pin)
  49. Adaptec SCSI Card 29320LP Single Channel 64-bit Low Profile 7901A
  50. PCI-X 133MHz to Ultra320 SCSI Card
  51. (One external VHDC, one internal
  52. 68-pin)
  53. Adaptec SCSI Card 29320ALP Single Channel 64-bit Low Profile 7901B
  54. PCI-X 133MHz to Ultra320 SCSI Card
  55. (One external VHDC, one internal
  56. 68-pin)
  57. 2. Version History
  58. 3.0 (December 1st, 2005)
  59. - Updated driver to use SCSI transport class infrastructure
  60. - Upported sequencer and core fixes from adaptec released
  61. version 2.0.15 of the driver.
  62. 1.3.11 (July 11, 2003)
  63. - Fix several deadlock issues.
  64. - Add 29320ALP and 39320B Id's.
  65. 1.3.10 (June 3rd, 2003)
  66. - Align the SCB_TAG field on a 16byte boundary. This avoids
  67. SCB corruption on some PCI-33 busses.
  68. - Correct non-zero luns on Rev B. hardware.
  69. - Update for change in 2.5.X SCSI proc FS interface.
  70. - When negotiation async via an 8bit WDTR message, send
  71. an SDTR with an offset of 0 to be sure the target
  72. knows we are async. This works around a firmware defect
  73. in the Quantum Atlas 10K.
  74. - Implement controller suspend and resume.
  75. - Clear PCI error state during driver attach so that we
  76. don't disable memory mapped I/O due to a stray write
  77. by some other driver probe that occurred before we
  78. claimed the controller.
  79. 1.3.9 (May 22nd, 2003)
  80. - Fix compiler errors.
  81. - Remove S/G splitting for segments that cross a 4GB boundary.
  82. This is guaranteed not to happen in Linux.
  83. - Add support for scsi_report_device_reset() found in
  84. 2.5.X kernels.
  85. - Add 7901B support.
  86. - Simplify handling of the packetized lun Rev A workaround.
  87. - Correct and simplify handling of the ignore wide residue
  88. message. The previous code would fail to report a residual
  89. if the transaction data length was even and we received
  90. an IWR message.
  91. 1.3.8 (April 29th, 2003)
  92. - Fix types accessed via the command line interface code.
  93. - Perform a few firmware optimizations.
  94. - Fix "Unexpected PKT busfree" errors.
  95. - Use a sequencer interrupt to notify the host of
  96. commands with bad status. We defer the notification
  97. until there are no outstanding selections to ensure
  98. that the host is interrupted for as short a time as
  99. possible.
  100. - Remove pre-2.2.X support.
  101. - Add support for new 2.5.X interrupt API.
  102. - Correct big-endian architecture support.
  103. 1.3.7 (April 16th, 2003)
  104. - Use del_timer_sync() to ensure that no timeouts
  105. are pending during controller shutdown.
  106. - For pre-2.5.X kernels, carefully adjust our segment
  107. list size to avoid SCSI malloc pool fragmentation.
  108. - Cleanup channel display in our /proc output.
  109. - Workaround duplicate device entries in the mid-layer
  110. devlice list during add-single-device.
  111. 1.3.6 (March 28th, 2003)
  112. - Correct a double free in the Domain Validation code.
  113. - Correct a reference to free'ed memory during controller
  114. shutdown.
  115. - Reset the bus on an SE->LVD change. This is required
  116. to reset our transceivers.
  117. 1.3.5 (March 24th, 2003)
  118. - Fix a few register window mode bugs.
  119. - Include read streaming in the PPR flags we display in
  120. diagnostics as well as /proc.
  121. - Add PCI hot plug support for 2.5.X kernels.
  122. - Correct default precompensation value for RevA hardware.
  123. - Fix Domain Validation thread shutdown.
  124. - Add a firmware workaround to make the LED blink
  125. brighter during packetized operations on the H2A4.
  126. - Correct /proc display of user read streaming settings.
  127. - Simplify driver locking by releasing the io_request_lock
  128. upon driver entry from the mid-layer.
  129. - Cleanup command line parsing and move much of this code
  130. to aiclib.
  131. 1.3.4 (February 28th, 2003)
  132. - Correct a race condition in our error recovery handler.
  133. - Allow Test Unit Ready commands to take a full 5 seconds
  134. during Domain Validation.
  135. 1.3.2 (February 19th, 2003)
  136. - Correct a Rev B. regression due to the GEM318
  137. compatibility fix included in 1.3.1.
  138. 1.3.1 (February 11th, 2003)
  139. - Add support for the 39320A.
  140. - Improve recovery for certain PCI-X errors.
  141. - Fix handling of LQ/DATA/LQ/DATA for the
  142. same write transaction that can occur without
  143. interveining training.
  144. - Correct compatibility issues with the GEM318
  145. enclosure services device.
  146. - Correct data corruption issue that occurred under
  147. high tag depth write loads.
  148. - Adapt to a change in the 2.5.X daemonize() API.
  149. - Correct a "Missing case in ahd_handle_scsiint" panic.
  150. 1.3.0 (January 21st, 2003)
  151. - Full regression testing for all U320 products completed.
  152. - Added abort and target/lun reset error recovery handler and
  153. interrupt coalescing.
  154. 1.2.0 (November 14th, 2002)
  155. - Added support for Domain Validation
  156. - Add support for the Hewlett-Packard version of the 39320D
  157. and AIC-7902 adapters.
  158. Support for previous adapters has not been fully tested and should
  159. only be used at the customer's own risk.
  160. 1.1.1 (September 24th, 2002)
  161. - Added support for the Linux 2.5.X kernel series
  162. 1.1.0 (September 17th, 2002)
  163. - Added support for four additional SCSI products:
  164. ASC-39320, ASC-29320, ASC-29320LP, AIC-7901.
  165. 1.0.0 (May 30th, 2002)
  166. - Initial driver release.
  167. 2.1. Software/Hardware Features
  168. - Support for the SPI-4 "Ultra320" standard:
  169. - 320MB/s transfer rates
  170. - Packetized SCSI Protocol at 160MB/s and 320MB/s
  171. - Quick Arbitration Selection (QAS)
  172. - Retained Training Information (Rev B. ASIC only)
  173. - Interrupt Coalessing
  174. - Initiator Mode (target mode not currently
  175. supported)
  176. - Support for the PCI-X standard up to 133MHz
  177. - Support for the PCI v2.2 standard
  178. - Domain Validation
  179. 2.2. Operating System Support:
  180. - Redhat Linux 7.2, 7.3, 8.0, Advanced Server 2.1
  181. - SuSE Linux 7.3, 8.0, 8.1, Enterprise Server 7
  182. - only Intel and AMD x86 supported at this time
  183. - >4GB memory configurations supported.
  184. Refer to the User's Guide for more details on this.
  185. 3. Command Line Options
  186. WARNING: ALTERING OR ADDING THESE DRIVER PARAMETERS
  187. INCORRECTLY CAN RENDER YOUR SYSTEM INOPERABLE.
  188. USE THEM WITH CAUTION.
  189. Edit the file "modprobe.conf" in the directory /etc and add/edit a
  190. line containing 'options aic79xx aic79xx=[command[,command...]]' where
  191. 'command' is one or more of the following:
  192. -----------------------------------------------------------------
  193. Option: verbose
  194. Definition: enable additional informative messages during
  195. driver operation.
  196. Possible Values: This option is a flag
  197. Default Value: disabled
  198. -----------------------------------------------------------------
  199. Option: debug:[value]
  200. Definition: Enables various levels of debugging information
  201. The bit definitions for the debugging mask can
  202. be found in drivers/scsi/aic7xxx/aic79xx.h under
  203. the "Debug" heading.
  204. Possible Values: 0x0000 = no debugging, 0xffff = full debugging
  205. Default Value: 0x0000
  206. -----------------------------------------------------------------
  207. Option: no_reset
  208. Definition: Do not reset the bus during the initial probe
  209. phase
  210. Possible Values: This option is a flag
  211. Default Value: disabled
  212. -----------------------------------------------------------------
  213. Option: extended
  214. Definition: Force extended translation on the controller
  215. Possible Values: This option is a flag
  216. Default Value: disabled
  217. -----------------------------------------------------------------
  218. Option: periodic_otag
  219. Definition: Send an ordered tag periodically to prevent
  220. tag starvation. Needed for some older devices
  221. Possible Values: This option is a flag
  222. Default Value: disabled
  223. -----------------------------------------------------------------
  224. Option: reverse_scan
  225. Definition: Probe the scsi bus in reverse order, starting
  226. with target 15
  227. Possible Values: This option is a flag
  228. Default Value: disabled
  229. -----------------------------------------------------------------
  230. Option: global_tag_depth
  231. Definition: Global tag depth for all targets on all busses.
  232. This option sets the default tag depth which
  233. may be selectively overridden vi the tag_info
  234. option.
  235. Possible Values: 1 - 253
  236. Default Value: 32
  237. -----------------------------------------------------------------
  238. Option: tag_info:{{value[,value...]}[,{value[,value...]}...]}
  239. Definition: Set the per-target tagged queue depth on a
  240. per controller basis. Both controllers and targets
  241. may be ommitted indicating that they should retain
  242. the default tag depth.
  243. Examples: tag_info:{{16,32,32,64,8,8,,32,32,32,32,32,32,32,32,32}
  244. On Controller 0
  245. specifies a tag depth of 16 for target 0
  246. specifies a tag depth of 64 for target 3
  247. specifies a tag depth of 8 for targets 4 and 5
  248. leaves target 6 at the default
  249. specifies a tag depth of 32 for targets 1,2,7-15
  250. All other targets retain the default depth.
  251. tag_info:{{},{32,,32}}
  252. On Controller 1
  253. specifies a tag depth of 32 for targets 0 and 2
  254. All other targets retain the default depth.
  255. Possible Values: 1 - 253
  256. Default Value: 32
  257. -----------------------------------------------------------------
  258. Option: rd_strm: {rd_strm_bitmask[,rd_strm_bitmask...]}
  259. Definition: Enable read streaming on a per target basis.
  260. The rd_strm_bitmask is a 16 bit hex value in which
  261. each bit represents a target. Setting the target's
  262. bit to '1' enables read streaming for that
  263. target. Controllers may be ommitted indicating that
  264. they should retain the default read streaming setting.
  265. Example: rd_strm:{0x0041}
  266. On Controller 0
  267. enables read streaming for targets 0 and 6.
  268. disables read streaming for targets 1-5,7-15.
  269. All other targets retain the default read
  270. streaming setting.
  271. Example: rd_strm:{0x0023,,0xFFFF}
  272. On Controller 0
  273. enables read streaming for targets 1,2, and 5.
  274. disables read streaming for targets 3,4,6-15.
  275. On Controller 2
  276. enables read streaming for all targets.
  277. All other targets retain the default read
  278. streaming setting.
  279. Possible Values: 0x0000 - 0xffff
  280. Default Value: 0x0000
  281. -----------------------------------------------------------------
  282. Option: dv: {value[,value...]}
  283. Definition: Set Domain Validation Policy on a per-controller basis.
  284. Controllers may be ommitted indicating that
  285. they should retain the default read streaming setting.
  286. Example: dv:{-1,0,,1,1,0}
  287. On Controller 0 leave DV at its default setting.
  288. On Controller 1 disable DV.
  289. Skip configuration on Controller 2.
  290. On Controllers 3 and 4 enable DV.
  291. On Controller 5 disable DV.
  292. Possible Values: < 0 Use setting from serial EEPROM.
  293. 0 Disable DV
  294. > 0 Enable DV
  295. Default Value: DV Serial EEPROM configuration setting.
  296. -----------------------------------------------------------------
  297. Option: seltime:[value]
  298. Definition: Specifies the selection timeout value
  299. Possible Values: 0 = 256ms, 1 = 128ms, 2 = 64ms, 3 = 32ms
  300. Default Value: 0
  301. -----------------------------------------------------------------
  302. *** The following three options should only be changed at ***
  303. *** the direction of a technical support representative. ***
  304. -----------------------------------------------------------------
  305. Option: precomp: {value[,value...]}
  306. Definition: Set IO Cell precompensation value on a per-controller
  307. basis.
  308. Controllers may be ommitted indicating that
  309. they should retain the default precompensation setting.
  310. Example: precomp:{0x1}
  311. On Controller 0 set precompensation to 1.
  312. Example: precomp:{1,,7}
  313. On Controller 0 set precompensation to 1.
  314. On Controller 2 set precompensation to 8.
  315. Possible Values: 0 - 7
  316. Default Value: Varies based on chip revision
  317. -----------------------------------------------------------------
  318. Option: slewrate: {value[,value...]}
  319. Definition: Set IO Cell slew rate on a per-controller basis.
  320. Controllers may be ommitted indicating that
  321. they should retain the default slew rate setting.
  322. Example: slewrate:{0x1}
  323. On Controller 0 set slew rate to 1.
  324. Example: slewrate :{1,,8}
  325. On Controller 0 set slew rate to 1.
  326. On Controller 2 set slew rate to 8.
  327. Possible Values: 0 - 15
  328. Default Value: Varies based on chip revision
  329. -----------------------------------------------------------------
  330. Option: amplitude: {value[,value...]}
  331. Definition: Set IO Cell signal amplitude on a per-controller basis.
  332. Controllers may be ommitted indicating that
  333. they should retain the default read streaming setting.
  334. Example: amplitude:{0x1}
  335. On Controller 0 set amplitude to 1.
  336. Example: amplitude :{1,,7}
  337. On Controller 0 set amplitude to 1.
  338. On Controller 2 set amplitude to 7.
  339. Possible Values: 1 - 7
  340. Default Value: Varies based on chip revision
  341. -----------------------------------------------------------------
  342. Example: 'options aic79xx aic79xx=verbose,rd_strm:{{0x0041}}'
  343. enables verbose output in the driver and turns read streaming on
  344. for targets 0 and 6 of Controller 0.
  345. 4. Additional Notes
  346. 4.1. Known/Unresolved or FYI Issues
  347. * Under SuSE Linux Enterprise 7, the driver may fail to operate
  348. correctly due to a problem with PCI interrupt routing in the
  349. Linux kernel. Please contact SuSE for an updated Linux
  350. kernel.
  351. 4.2. Third-Party Compatibility Issues
  352. * Adaptec only supports Ultra320 hard drives running
  353. the latest firmware available. Please check with
  354. your hard drive manufacturer to ensure you have the
  355. latest version.
  356. 4.3. Operating System or Technology Limitations
  357. * PCI Hot Plug is untested and may cause the operating system
  358. to stop responding.
  359. * Luns that are not numbered contiguously starting with 0 might not
  360. be automatically probed during system startup. This is a limitation
  361. of the OS. Please contact your Linux vendor for instructions on
  362. manually probing non-contiguous luns.
  363. * Using the Driver Update Disk version of this package during OS
  364. installation under RedHat might result in two versions of this
  365. driver being installed into the system module directory. This
  366. might cause problems with the /sbin/mkinitrd program and/or
  367. other RPM packages that try to install system modules. The best
  368. way to correct this once the system is running is to install
  369. the latest RPM package version of this driver, available from
  370. http://www.adaptec.com.
  371. 5. Adaptec Customer Support
  372. A Technical Support Identification (TSID) Number is required for
  373. Adaptec technical support.
  374. - The 12-digit TSID can be found on the white barcode-type label
  375. included inside the box with your product. The TSID helps us
  376. provide more efficient service by accurately identifying your
  377. product and support status.
  378. Support Options
  379. - Search the Adaptec Support Knowledgebase (ASK) at
  380. http://ask.adaptec.com for articles, troubleshooting tips, and
  381. frequently asked questions about your product.
  382. - For support via Email, submit your question to Adaptec's
  383. Technical Support Specialists at http://ask.adaptec.com/.
  384. North America
  385. - Visit our Web site at http://www.adaptec.com/.
  386. - For information about Adaptec's support options, call
  387. 408-957-2550, 24 hours a day, 7 days a week.
  388. - To speak with a Technical Support Specialist,
  389. * For hardware products, call 408-934-7274,
  390. Monday to Friday, 3:00 am to 5:00 pm, PDT.
  391. * For RAID and Fibre Channel products, call 321-207-2000,
  392. Monday to Friday, 3:00 am to 5:00 pm, PDT.
  393. To expedite your service, have your computer with you.
  394. - To order Adaptec products, including accessories and cables,
  395. call 408-957-7274. To order cables online go to
  396. http://www.adaptec.com/buy-cables/.
  397. Europe
  398. - Visit our Web site at http://www.adaptec-europe.com/.
  399. - To speak with a Technical Support Specialist, call, or email,
  400. * German: +49 89 4366 5522, Monday-Friday, 9:00-17:00 CET,
  401. http://ask-de.adaptec.com/.
  402. * French: +49 89 4366 5533, Monday-Friday, 9:00-17:00 CET,
  403. http://ask-fr.adaptec.com/.
  404. * English: +49 89 4366 5544, Monday-Friday, 9:00-17:00 GMT,
  405. http://ask.adaptec.com/.
  406. - You can order Adaptec cables online at
  407. http://www.adaptec.com/buy-cables/.
  408. Japan
  409. - Visit our web site at http://www.adaptec.co.jp/.
  410. - To speak with a Technical Support Specialist, call
  411. +81 3 5308 6120, Monday-Friday, 9:00 a.m. to 12:00 p.m.,
  412. 1:00 p.m. to 6:00 p.m.
  413. -------------------------------------------------------------------
  414. /*
  415. * Copyright (c) 2003 Adaptec Inc. 691 S. Milpitas Blvd., Milpitas CA 95035 USA.
  416. * All rights reserved.
  417. *
  418. * You are permitted to redistribute, use and modify this README file in whole
  419. * or in part in conjunction with redistribution of software governed by the
  420. * General Public License, provided that the following conditions are met:
  421. * 1. Redistributions of README file must retain the above copyright
  422. * notice, this list of conditions, and the following disclaimer,
  423. * without modification.
  424. * 2. The name of the author may not be used to endorse or promote products
  425. * derived from this software without specific prior written permission.
  426. * 3. Modifications or new contributions must be attributed in a copyright
  427. * notice identifying the author ("Contributor") and added below the
  428. * original copyright notice. The copyright notice is for purposes of
  429. * identifying contributors and should not be deemed as permission to alter
  430. * the permissions given by Adaptec.
  431. *
  432. * THIS README FILE IS PROVIDED BY ADAPTEC AND CONTRIBUTORS ``AS IS'' AND
  433. * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, ANY
  434. * WARRANTIES OF NON-INFRINGEMENT OR THE IMPLIED WARRANTIES OF MERCHANTABILITY
  435. * AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL
  436. * ADAPTEC OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
  437. * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED
  438. * TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
  439. * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
  440. * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
  441. * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS README
  442. * FILE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  443. */