요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
.. SPDX-License-Identifier: GPL-2.0
.. include:: <isonum.txt>
===================================
Adaptec Ultra320 Family Manager Set
===================================
README for The Linux Operating System
.. The following information is available in this file:
1. Supported Hardware
2. Version History
3. Command Line Options
4. Additional Notes
5. Contacting Adaptec
1. Supported Hardware
=====================
The following Adaptec SCSI Host Adapters are supported by this
driver set.
============= =========================================
Ultra320 ASIC Description
============= =========================================
AIC-7901A Single Channel 64-bit PCI-X 133MHz to
Ultra320 SCSI ASIC
AIC-7901B Single Channel 64-bit PCI-X 133MHz to
Ultra320 SCSI ASIC with Retained Training
AIC-7902A4 Dual Channel 64-bit PCI-X 133MHz to
Ultra320 SCSI ASIC
AIC-7902B Dual Channel 64-bit PCI-X 133MHz to
Ultra320 SCSI ASIC with Retained Training
============= =========================================
========================== ===================================== ============
Ultra320 Adapters Description ASIC
========================== ===================================== ============
Adaptec SCSI Card 39320 Dual Channel 64-bit PCI-X 133MHz to 7902A4/7902B
Ultra320 SCSI Card (one external
68-pin, two internal 68-pin)
Adaptec SCSI Card 39320A Dual Channel 64-bit PCI-X 133MHz to 7902B
Ultra320 SCSI Card (one external
68-pin, two internal 68-pin)
Adaptec SCSI Card 39320D Dual Channel 64-bit PCI-X 133MHz to 7902A4
Ultra320 SCSI Card (two external VHDC
and one internal 68-pin)
Adaptec SCSI Card 39320D Dual Channel 64-bit PCI-X 133MHz to 7902A4
Ultra320 SCSI Card (two external VHDC
and one internal 68-pin) based on the
AIC-7902B ASIC
Adaptec SCSI Card 29320 Single Channel 64-bit PCI-X 133MHz to 7901A
Ultra320 SCSI Card (one external
68-pin, two internal 68-pin, one
internal 50-pin)
Adaptec SCSI Card 29320A Single Channel 64-bit PCI-X 133MHz to 7901B
Ultra320 SCSI Card (one external
68-pin, two internal 68-pin, one
internal 50-pin)
Adaptec SCSI Card 29320LP Single Channel 64-bit Low Profile 7901A
PCI-X 133MHz to Ultra320 SCSI Card
(One external VHDC, one internal
68-pin)
Adaptec SCSI Card 29320ALP Single Channel 64-bit Low Profile 7901B
PCI-X 133MHz to Ultra320 SCSI Card
(One external VHDC, one internal
68-pin)
========================== ===================================== ============
2. Version History
==================
* 3.0 (December 1st, 2005)
- Updated driver to use SCSI transport class infrastructure
- Upported sequencer and core fixes from adaptec released
version 2.0.15 of the driver.
* 1.3.11 (July 11, 2003)
- Fix several deadlock issues.
- Add 29320ALP and 39320B Id's.
* 1.3.10 (June 3rd, 2003)
- Align the SCB_TAG field on a 16byte boundary. This avoids
SCB corruption on some PCI-33 busses.
- Correct non-zero luns on Rev B. hardware.
- Update for change in 2.5.X SCSI proc FS interface.
- When negotiation async via an 8bit WDTR message, send
an SDTR with an offset of 0 to be sure the target
knows we are async. This works around a firmware defect
in the Quantum Atlas 10K.
- Implement controller suspend and resume.
- Clear PCI error state during driver attach so that we
don't disable memory mapped I/O due to a stray write
by some other driver probe that occurred before we
claimed the controller.
* 1.3.9 (May 22nd, 2003)
- Fix compiler errors.
- Remove S/G splitting for segments that cross a 4GB boundary.
This is guaranteed not to happen in Linux.
- Add support for scsi_report_device_reset() found in
2.5.X kernels.
- Add 7901B support.
- Simplify handling of the packetized lun Rev A workaround.
- Correct and simplify handling of the ignore wide residue
message. The previous code would fail to report a residual
if the transaction data length was even and we received
an IWR message.
* 1.3.8 (April 29th, 2003)
- Fix types accessed via the command line interface code.
- Perform a few firmware optimizations.
- Fix "Unexpected PKT busfree" errors.
- Use a sequencer interrupt to notify the host of
commands with bad status. We defer the notification
until there are no outstanding selections to ensure
that the host is interrupted for as short a time as
possible.
- Remove pre-2.2.X support.
- Add support for new 2.5.X interrupt API.
- Correct big-endian architecture support.
* 1.3.7 (April 16th, 2003)
- Use del_timer_sync() to ensure that no timeouts
are pending during controller shutdown.
- For pre-2.5.X kernels, carefully adjust our segment
list size to avoid SCSI malloc pool fragmentation.
- Cleanup channel display in our /proc output.
- Workaround duplicate device entries in the mid-layer
device list during add-single-device.
* 1.3.6 (March 28th, 2003)
- Correct a double free in the Domain Validation code.
- Correct a reference to free'ed memory during controller
shutdown.
- Reset the bus on an SE->LVD change. This is required
to reset our transceivers.
* 1.3.5 (March 24th, 2003)
- Fix a few register window mode bugs.
- Include read streaming in the PPR flags we display in
diagnostics as well as /proc.
- Add PCI hot plug support for 2.5.X kernels.
- Correct default precompensation value for RevA hardware.
- Fix Domain Validation thread shutdown.
- Add a firmware workaround to make the LED blink
brighter during packetized operations on the H2A4.
- Correct /proc display of user read streaming settings.
- Simplify driver locking by releasing the io_request_lock
upon driver entry from the mid-layer.
- Cleanup command line parsing and move much of this code
to aiclib.
* 1.3.4 (February 28th, 2003)
- Correct a race condition in our error recovery handler.
- Allow Test Unit Ready commands to take a full 5 seconds
during Domain Validation.
* 1.3.2 (February 19th, 2003)
- Correct a Rev B. regression due to the GEM318
compatibility fix included in 1.3.1.
* 1.3.1 (February 11th, 2003)
- Add support for the 39320A.
- Improve recovery for certain PCI-X errors.
- Fix handling of LQ/DATA/LQ/DATA for the
same write transaction that can occur without
interveining training.
- Correct compatibility issues with the GEM318
enclosure services device.
- Correct data corruption issue that occurred under
high tag depth write loads.
- Adapt to a change in the 2.5.X daemonize() API.
- Correct a "Missing case in ahd_handle_scsiint" panic.
* 1.3.0 (January 21st, 2003)
- Full regression testing for all U320 products completed.
- Added abort and target/lun reset error recovery handler and
interrupt coalescing.
* 1.2.0 (November 14th, 2002)
- Added support for Domain Validation
- Add support for the Hewlett-Packard version of the 39320D
and AIC-7902 adapters.
Support for previous adapters has not been fully tested and should
only be used at the customer's own risk.
* 1.1.1 (September 24th, 2002)
- Added support for the Linux 2.5.X kernel series
* 1.1.0 (September 17th, 2002)
- Added support for four additional SCSI products:
ASC-39320, ASC-29320, ASC-29320LP, AIC-7901.
* 1.0.0 (May 30th, 2002)
- Initial driver release.
* 2.1. Software/Hardware Features
- Support for the SPI-4 "Ultra320" standard:
- 320MB/s transfer rates
- Packetized SCSI Protocol at 160MB/s and 320MB/s
- Quick Arbitration Selection (QAS)
- Retained Training Information (Rev B. ASIC only)
- Interrupt Coalescing
- Initiator Mode (target mode not currently
supported)
- Support for the PCI-X standard up to 133MHz
- Support for the PCI v2.2 standard
- Domain Validation
* 2.2. Operating System Support:
- Redhat Linux 7.2, 7.3, 8.0, Advanced Server 2.1
- SuSE Linux 7.3, 8.0, 8.1, Enterprise Server 7
- only Intel and AMD x86 supported at this time
- >4GB memory configurations supported.
Refer to the User's Guide for more details on this.
3. Command Line Options
=======================
.. Warning::
ALTERING OR ADDING THESE DRIVER PARAMETERS
INCORRECTLY CAN RENDER YOUR SYSTEM INOPERABLE.
USE THEM WITH CAUTION.
Put a .conf file in the /etc/modprobe.d/ directory and add/edit a
line containing ``options aic79xx aic79xx=[command[,command...]]`` where
``command`` is one or more of the following:
verbose
:Definition: enable additional informative messages during driver operation.
:Possible Values: This option is a flag
:Default Value: disabled
debug:[value]
:Definition: Enables various levels of debugging information
The bit definitions for the debugging mask can
be found in drivers/scsi/aic7xxx/aic79xx.h under
the "Debug" heading.
:Possible Values: 0x0000 = no debugging, 0xffff = full debugging
:Default Value: 0x0000
no_reset
:Definition: Do not reset the bus during the initial probe
phase
:Possible Values: This option is a flag
:Default Value: disabled
extended
:Definition: Force extended translation on the controller
:Possible Values: This option is a flag
:Default Value: disabled
periodic_otag
:Definition: Send an ordered tag periodically to prevent
tag starvation. Needed for some older devices
:Possible Values: This option is a flag
:Default Value: disabled
reverse_scan
:Definition: Probe the scsi bus in reverse order, starting with target 15
:Possible Values: This option is a flag
:Default Value: disabled
global_tag_depth
:Definition: Global tag depth for all targets on all busses.
This option sets the default tag depth which
may be selectively overridden vi the tag_info
option.
:Possible Values: 1 - 253
:Default Value: 32
tag_info:{{value[,value...]}[,{value[,value...]}...]}
:Definition: Set the per-target tagged queue depth on a
per controller basis. Both controllers and targets
may be omitted indicating that they should retain
the default tag depth.
:Possible Values: 1 - 253
:Default Value: 32
Examples:
::
tag_info:{{16,32,32,64,8,8,,32,32,32,32,32,32,32,32,32}
On Controller 0
- specifies a tag depth of 16 for target 0
- specifies a tag depth of 64 for target 3
- specifies a tag depth of 8 for targets 4 and 5
- leaves target 6 at the default
- specifies a tag depth of 32 for targets 1,2,7-15
All other targets retain the default depth.
::
tag_info:{{},{32,,32}}
On Controller 1
- specifies a tag depth of 32 for targets 0 and 2
All other targets retain the default depth.
rd_strm: {rd_strm_bitmask[,rd_strm_bitmask...]}
:Definition: Enable read streaming on a per target basis.
The rd_strm_bitmask is a 16 bit hex value in which
each bit represents a target. Setting the target's
bit to '1' enables read streaming for that
target. Controllers may be omitted indicating that
they should retain the default read streaming setting.
Examples:
::
rd_strm:{0x0041}
On Controller 0
- enables read streaming for targets 0 and 6.
- disables read streaming for targets 1-5,7-15.
All other targets retain the default read
streaming setting.
::
rd_strm:{0x0023,,0xFFFF}
On Controller 0
- enables read streaming for targets 1,2, and 5.
- disables read streaming for targets 3,4,6-15.
On Controller 2
- enables read streaming for all targets.
All other targets retain the default read
streaming setting.
:Possible Values: 0x0000 - 0xffff
:Default Value: 0x0000
dv: {value[,value...]}
:Definition: Set Domain Validation Policy on a per-controller basis.
Controllers may be omitted indicating that
they should retain the default read streaming setting.
:Possible Values:
==== ===============================
< 0 Use setting from serial EEPROM.
0 Disable DV
> 0 Enable DV
==== ===============================
:Default Value: DV Serial EEPROM configuration setting.
Example:
::
dv:{-1,0,,1,1,0}
- On Controller 0 leave DV at its default setting.
- On Controller 1 disable DV.
- Skip configuration on Controller 2.
- On Controllers 3 and 4 enable DV.
- On Controller 5 disable DV.
seltime:[value]
:Definition: Specifies the selection timeout value
:Possible Values: 0 = 256ms, 1 = 128ms, 2 = 64ms, 3 = 32ms
:Default Value: 0
.. Warning:
The following three options should only be changed at
the direction of a technical support representative.
precomp: {value[,value...]}
:Definition: Set IO Cell precompensation value on a per-controller basis.
Controllers may be omitted indicating that
they should retain the default precompensation setting.
:Possible Values: 0 - 7
:Default Value: Varies based on chip revision
Examples:
::
precomp:{0x1}
On Controller 0 set precompensation to 1.
::
precomp:{1,,7}
- On Controller 0 set precompensation to 1.
- On Controller 2 set precompensation to 8.
slewrate: {value[,value...]}
:Definition: Set IO Cell slew rate on a per-controller basis.
Controllers may be omitted indicating that
they should retain the default slew rate setting.
:Possible Values: 0 - 15
:Default Value: Varies based on chip revision
Examples:
::
slewrate:{0x1}
- On Controller 0 set slew rate to 1.
::
slewrate :{1,,8}
- On Controller 0 set slew rate to 1.
- On Controller 2 set slew rate to 8.
amplitude: {value[,value...]}
:Definition: Set IO Cell signal amplitude on a per-controller basis.
Controllers may be omitted indicating that
they should retain the default read streaming setting.
:Possible Values: 1 - 7
:Default Value: Varies based on chip revision
Examples:
::
amplitude:{0x1}
On Controller 0 set amplitude to 1.
::
amplitude :{1,,7}
- On Controller 0 set amplitude to 1.
- On Controller 2 set amplitude to 7.
Example::
options aic79xx aic79xx=verbose,rd_strm:{{0x0041}}
enables verbose output in the driver and turns read streaming on
for targets 0 and 6 of Controller 0.
4. Additional Notes
===================
4.1. Known/Unresolved or FYI Issues
-----------------------------------
* Under SuSE Linux Enterprise 7, the driver may fail to operate
correctly due to a problem with PCI interrupt routing in the
Linux kernel. Please contact SuSE for an updated Linux
kernel.
4.2. Third-Party Compatibility Issues
-------------------------------------
* Adaptec only supports Ultra320 hard drives running
the latest firmware available. Please check with
your hard drive manufacturer to ensure you have the
latest version.
4.3. Operating System or Technology Limitations
-----------------------------------------------
* PCI Hot Plug is untested and may cause the operating system
to stop responding.
* Luns that are not numbered contiguously starting with 0 might not
be automatically probed during system startup. This is a limitation
of the OS. Please contact your Linux vendor for instructions on
manually probing non-contiguous luns.
* Using the Driver Update Disk version of this package during OS
installation under RedHat might result in two versions of this
driver being installed into the system module directory. This
might cause problems with the /sbin/mkinitrd program and/or
other RPM packages that try to install system modules. The best
way to correct this once the system is running is to install
the latest RPM package version of this driver, available from
http://www.adaptec.com.
5. Adaptec Customer Support
===========================
A Technical Support Identification (TSID) Number is required for
Adaptec technical support.
- The 12-digit TSID can be found on the white barcode-type label
included inside the box with your product. The TSID helps us
provide more efficient service by accurately identifying your
product and support status.
Support Options
- Search the Adaptec Support Knowledgebase (ASK) at
http://ask.adaptec.com for articles, troubleshooting tips, and
frequently asked questions about your product.
- For support via Email, submit your question to Adaptec's
Technical Support Specialists at http://ask.adaptec.com/.
North America
- Visit our Web site at http://www.adaptec.com/.
- For information about Adaptec's support options, call
408-957-2550, 24 hours a day, 7 days a week.
- To speak with a Technical Support Specialist,
* For hardware products, call 408-934-7274,
Monday to Friday, 3:00 am to 5:00 pm, PDT.
* For RAID and Fibre Channel products, call 321-207-2000,
Monday to Friday, 3:00 am to 5:00 pm, PDT.
To expedite your service, have your computer with you.
- To order Adaptec products, including accessories and cables,
call 408-957-7274. To order cables online go to
http://www.adaptec.com/buy-cables/.
Europe
- Visit our Web site at http://www.adaptec.com/en-US/_common/world_index.
- To speak with a Technical Support Specialist, call, or email,
* German: +49 89 4366 5522, Monday-Friday, 9:00-17:00 CET,
http://ask-de.adaptec.com/.
* French: +49 89 4366 5533, Monday-Friday, 9:00-17:00 CET,
http://ask-fr.adaptec.com/.
* English: +49 89 4366 5544, Monday-Friday, 9:00-17:00 GMT,
http://ask.adaptec.com/.
- You can order Adaptec cables online at
http://www.adaptec.com/buy-cables/.
Japan
- Visit our web site at http://www.adaptec.co.jp/.
- To speak with a Technical Support Specialist, call
+81 3 5308 6120, Monday-Friday, 9:00 a.m. to 12:00 p.m.,
1:00 p.m. to 6:00 p.m.
Copyright |copy| 2003 Adaptec Inc. 691 S. Milpitas Blvd., Milpitas CA 95035 USA.
All rights reserved.
You are permitted to redistribute, use and modify this README file in whole
or in part in conjunction with redistribution of software governed by the
General Public License, provided that the following conditions are met:
1. Redistributions of README file must retain the above copyright
notice, this list of conditions, and the following disclaimer,
without modification.
2. The name of the author may not be used to endorse or promote products
derived from this software without specific prior written permission.
3. Modifications or new contributions must be attributed in a copyright
notice identifying the author ("Contributor") and added below the
original copyright notice. The copyright notice is for purposes of
identifying contributors and should not be deemed as permission to alter
the permissions given by Adaptec.
THIS README FILE IS PROVIDED BY ADAPTEC AND CONTRIBUTORS ``AS IS`` AND
ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, ANY
WARRANTIES OF NON-INFRINGEMENT OR THE IMPLIED WARRANTIES OF MERCHANTABILITY
AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL
ADAPTEC 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 README
FILE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
문서 구성과 Ultra320 driver
1-18이 README는 Linux용 Adaptec Ultra320 Family Manager Set을 설명한다. 지원 hardware, version history, command-line option, 추가 참고 사항, Adaptec 연락처 순으로 구성된다.
Hardware 확인에서 설정과 문제 해결로 이어집니다.
.. SPDX-License-Identifier: GPL-2.0
.. include:: <isonum.txt>
===================================
Adaptec Ultra320 Family Manager Set
===================================
README for The Linux Operating System
.. The following information is available in this file:
1. Supported Hardware
2. Version History
3. Command Line Options
4. Additional Notes
5. Contacting Adaptec
Ultra320 ASIC과 adapter
19-71Driver는 AIC-7901A/B single-channel과 AIC-7902A4/B dual-channel Ultra320 ASIC을 지원한다. 모두 64-bit PCI-X 133MHz host bus를 사용하며 B revision은 Retained Training을 제공한다.
39320 계열은 dual-channel 7902 ASIC과 외부·내부 68-pin 또는 VHDC connector 조합을 사용한다. 29320 계열은 single-channel 7901 ASIC이며 standard card는 외부 68-pin, 내부 68-pin 두 개와 내부 50-pin을 제공한다. LP와 ALP는 low-profile이고 외부 VHDC와 내부 68-pin을 갖는다.
원문에는 39320D가 같은 이름으로 두 번 나오며 한 설명은 AIC-7902A4 ASIC, 다른 설명은 AIC-7902B 기반이라고 적혀 있다. Hardware 판별 시 marketing name만 보지 말고 실제 ASIC revision을 함께 확인한다.
Channel 수와 Retained Training 지원을 구분합니다.
1. Supported Hardware
=====================
The following Adaptec SCSI Host Adapters are supported by this
driver set.
============= =========================================
Ultra320 ASIC Description
============= =========================================
AIC-7901A Single Channel 64-bit PCI-X 133MHz to
Ultra320 SCSI ASIC
AIC-7901B Single Channel 64-bit PCI-X 133MHz to
Ultra320 SCSI ASIC with Retained Training
AIC-7902A4 Dual Channel 64-bit PCI-X 133MHz to
Ultra320 SCSI ASIC
AIC-7902B Dual Channel 64-bit PCI-X 133MHz to
Ultra320 SCSI ASIC with Retained Training
============= =========================================
========================== ===================================== ============
Ultra320 Adapters Description ASIC
========================== ===================================== ============
Adaptec SCSI Card 39320 Dual Channel 64-bit PCI-X 133MHz to 7902A4/7902B
Ultra320 SCSI Card (one external
68-pin, two internal 68-pin)
Adaptec SCSI Card 39320A Dual Channel 64-bit PCI-X 133MHz to 7902B
Ultra320 SCSI Card (one external
68-pin, two internal 68-pin)
Adaptec SCSI Card 39320D Dual Channel 64-bit PCI-X 133MHz to 7902A4
Ultra320 SCSI Card (two external VHDC
and one internal 68-pin)
Adaptec SCSI Card 39320D Dual Channel 64-bit PCI-X 133MHz to 7902A4
Ultra320 SCSI Card (two external VHDC
and one internal 68-pin) based on the
AIC-7902B ASIC
Adaptec SCSI Card 29320 Single Channel 64-bit PCI-X 133MHz to 7901A
Ultra320 SCSI Card (one external
68-pin, two internal 68-pin, one
internal 50-pin)
Adaptec SCSI Card 29320A Single Channel 64-bit PCI-X 133MHz to 7901B
Ultra320 SCSI Card (one external
68-pin, two internal 68-pin, one
internal 50-pin)
Adaptec SCSI Card 29320LP Single Channel 64-bit Low Profile 7901A
PCI-X 133MHz to Ultra320 SCSI Card
(One external VHDC, one internal
68-pin)
Adaptec SCSI Card 29320ALP Single Channel 64-bit Low Profile 7901B
PCI-X 133MHz to Ultra320 SCSI Card
(One external VHDC, one internal
68-pin)
========================== ===================================== ============
Version history와 기능 범위
72-222Version 3.0은 2005년 SCSI transport class infrastructure로 전환하고 Adaptec 2.0.15의 sequencer와 core fix를 반영했다. 1.3.11은 여러 deadlock과 29320ALP·39320B ID를 고쳤다.
1.3.10은 `SCB_TAG`를 16-byte boundary에 맞춰 일부 PCI-33 bus의 SCB corruption을 막고 Rev B non-zero LUN을 수정했다. 2.5.x proc interface, 8-bit WDTR 뒤 offset 0 SDTR을 보내 Quantum Atlas 10K firmware 결함을 우회하는 async negotiation, suspend/resume, attach 시 PCI error state 정리도 포함했다.
1.3.9부터 1.3.5까지 compiler, 7901B, IWR residual, command-line type, packetized busfree, big-endian, shutdown timer와 free race, SE에서 LVD 전환 reset, register window, PPR read streaming, PCI hotplug, Domain Validation thread, LED와 locking 문제가 수정됐다.
1.3.4부터 1.0.0까지 error recovery race, GEM318 compatibility, high tag-depth write corruption, PCI-X recovery, abort와 target/LUN reset, interrupt coalescing, Domain Validation, HP adapter와 Linux 2.5 지원이 차례로 추가됐다. 1.2.0 이전 adapter는 충분히 시험되지 않아 사용자가 위험을 감수해야 한다.
기능은 SPI-4 Ultra320 320MB/s, 160·320MB/s packetized SCSI, QAS, Rev B Retained Training, interrupt coalescing, initiator mode, PCI-X 133MHz, PCI 2.2와 Domain Validation이다. Target mode는 지원하지 않는다. 당시 검증 환경은 Red Hat 7.2/7.3/8.0/Advanced Server 2.1과 SuSE 7.3/8.0/8.1/Enterprise Server 7, Intel·AMD x86이며 4GB 초과 memory를 지원했다.
Ultra320 protocol과 host infrastructure의 지원 범위입니다.
2. Version History
==================
* 3.0 (December 1st, 2005)
- Updated driver to use SCSI transport class infrastructure
- Upported sequencer and core fixes from adaptec released
version 2.0.15 of the driver.
* 1.3.11 (July 11, 2003)
- Fix several deadlock issues.
- Add 29320ALP and 39320B Id's.
* 1.3.10 (June 3rd, 2003)
- Align the SCB_TAG field on a 16byte boundary. This avoids
SCB corruption on some PCI-33 busses.
- Correct non-zero luns on Rev B. hardware.
- Update for change in 2.5.X SCSI proc FS interface.
- When negotiation async via an 8bit WDTR message, send
an SDTR with an offset of 0 to be sure the target
knows we are async. This works around a firmware defect
in the Quantum Atlas 10K.
- Implement controller suspend and resume.
- Clear PCI error state during driver attach so that we
don't disable memory mapped I/O due to a stray write
by some other driver probe that occurred before we
claimed the controller.
* 1.3.9 (May 22nd, 2003)
- Fix compiler errors.
- Remove S/G splitting for segments that cross a 4GB boundary.
This is guaranteed not to happen in Linux.
- Add support for scsi_report_device_reset() found in
2.5.X kernels.
- Add 7901B support.
- Simplify handling of the packetized lun Rev A workaround.
- Correct and simplify handling of the ignore wide residue
message. The previous code would fail to report a residual
if the transaction data length was even and we received
an IWR message.
* 1.3.8 (April 29th, 2003)
- Fix types accessed via the command line interface code.
- Perform a few firmware optimizations.
- Fix "Unexpected PKT busfree" errors.
- Use a sequencer interrupt to notify the host of
commands with bad status. We defer the notification
until there are no outstanding selections to ensure
that the host is interrupted for as short a time as
possible.
- Remove pre-2.2.X support.
- Add support for new 2.5.X interrupt API.
- Correct big-endian architecture support.
* 1.3.7 (April 16th, 2003)
- Use del_timer_sync() to ensure that no timeouts
are pending during controller shutdown.
- For pre-2.5.X kernels, carefully adjust our segment
list size to avoid SCSI malloc pool fragmentation.
- Cleanup channel display in our /proc output.
- Workaround duplicate device entries in the mid-layer
device list during add-single-device.
* 1.3.6 (March 28th, 2003)
- Correct a double free in the Domain Validation code.
- Correct a reference to free'ed memory during controller
shutdown.
- Reset the bus on an SE->LVD change. This is required
to reset our transceivers.
* 1.3.5 (March 24th, 2003)
- Fix a few register window mode bugs.
- Include read streaming in the PPR flags we display in
diagnostics as well as /proc.
- Add PCI hot plug support for 2.5.X kernels.
- Correct default precompensation value for RevA hardware.
- Fix Domain Validation thread shutdown.
- Add a firmware workaround to make the LED blink
brighter during packetized operations on the H2A4.
- Correct /proc display of user read streaming settings.
- Simplify driver locking by releasing the io_request_lock
upon driver entry from the mid-layer.
- Cleanup command line parsing and move much of this code
to aiclib.
* 1.3.4 (February 28th, 2003)
- Correct a race condition in our error recovery handler.
- Allow Test Unit Ready commands to take a full 5 seconds
during Domain Validation.
* 1.3.2 (February 19th, 2003)
- Correct a Rev B. regression due to the GEM318
compatibility fix included in 1.3.1.
* 1.3.1 (February 11th, 2003)
- Add support for the 39320A.
- Improve recovery for certain PCI-X errors.
- Fix handling of LQ/DATA/LQ/DATA for the
same write transaction that can occur without
interveining training.
- Correct compatibility issues with the GEM318
enclosure services device.
- Correct data corruption issue that occurred under
high tag depth write loads.
- Adapt to a change in the 2.5.X daemonize() API.
- Correct a "Missing case in ahd_handle_scsiint" panic.
* 1.3.0 (January 21st, 2003)
- Full regression testing for all U320 products completed.
- Added abort and target/lun reset error recovery handler and
interrupt coalescing.
* 1.2.0 (November 14th, 2002)
- Added support for Domain Validation
- Add support for the Hewlett-Packard version of the 39320D
and AIC-7902 adapters.
Support for previous adapters has not been fully tested and should
only be used at the customer's own risk.
* 1.1.1 (September 24th, 2002)
- Added support for the Linux 2.5.X kernel series
* 1.1.0 (September 17th, 2002)
- Added support for four additional SCSI products:
ASC-39320, ASC-29320, ASC-29320LP, AIC-7901.
* 1.0.0 (May 30th, 2002)
- Initial driver release.
* 2.1. Software/Hardware Features
- Support for the SPI-4 "Ultra320" standard:
- 320MB/s transfer rates
- Packetized SCSI Protocol at 160MB/s and 320MB/s
- Quick Arbitration Selection (QAS)
- Retained Training Information (Rev B. ASIC only)
- Interrupt Coalescing
- Initiator Mode (target mode not currently
supported)
- Support for the PCI-X standard up to 133MHz
- Support for the PCI v2.2 standard
- Domain Validation
* 2.2. Operating System Support:
- Redhat Linux 7.2, 7.3, 8.0, Advanced Server 2.1
- SuSE Linux 7.3, 8.0, 8.1, Enterprise Server 7
- only Intel and AMD x86 supported at this time
- >4GB memory configurations supported.
Refer to the User's Guide for more details on this.
기본 option과 tag queue
223-317잘못된 parameter는 system을 동작 불능으로 만들 수 있으므로 주의한다. `/etc/modprobe.d/`의 `.conf` 파일에 `options aic79xx aic79xx=[command[,command...]]` 형식으로 설정한다.
`verbose`는 추가 정보 message를 켜고, `debug`는 `drivers/scsi/aic7xxx/aic79xx.h`의 bit mask에 따라 0x0000부터 0xffff까지 진단을 제어한다. `no_reset`은 초기 probe의 bus reset을 생략하고, `extended`는 확장 geometry 변환을 강제한다. `periodic_otag`는 오래된 device의 tag starvation을 막도록 ordered tag를 주기적으로 보내고 `reverse_scan`은 target 15부터 역순으로 검색한다.
`global_tag_depth`는 모든 controller와 target의 기본 tagged queue depth를 1-253 사이로 정하며 기본값은 32다. `tag_info`가 controller와 target별로 이를 덮어쓴다. Controller 또는 target 위치를 비워 두면 기본값을 유지한다.
첫 예제는 controller 0에서 target 0을 16, target 3을 64, target 4·5를 8, target 6은 기본값, 나머지 명시 target을 32로 둔다. `tag_info:{{},{32,,32}}`는 controller 0을 건너뛰고 controller 1의 target 0과 2만 32로 둔다.
기본값과 영향을 구분합니다.
3. Command Line Options
=======================
.. Warning::
ALTERING OR ADDING THESE DRIVER PARAMETERS
INCORRECTLY CAN RENDER YOUR SYSTEM INOPERABLE.
USE THEM WITH CAUTION.
Put a .conf file in the /etc/modprobe.d/ directory and add/edit a
line containing ``options aic79xx aic79xx=[command[,command...]]`` where
``command`` is one or more of the following:
verbose
:Definition: enable additional informative messages during driver operation.
:Possible Values: This option is a flag
:Default Value: disabled
debug:[value]
:Definition: Enables various levels of debugging information
The bit definitions for the debugging mask can
be found in drivers/scsi/aic7xxx/aic79xx.h under
the "Debug" heading.
:Possible Values: 0x0000 = no debugging, 0xffff = full debugging
:Default Value: 0x0000
no_reset
:Definition: Do not reset the bus during the initial probe
phase
:Possible Values: This option is a flag
:Default Value: disabled
extended
:Definition: Force extended translation on the controller
:Possible Values: This option is a flag
:Default Value: disabled
periodic_otag
:Definition: Send an ordered tag periodically to prevent
tag starvation. Needed for some older devices
:Possible Values: This option is a flag
:Default Value: disabled
reverse_scan
:Definition: Probe the scsi bus in reverse order, starting with target 15
:Possible Values: This option is a flag
:Default Value: disabled
global_tag_depth
:Definition: Global tag depth for all targets on all busses.
This option sets the default tag depth which
may be selectively overridden vi the tag_info
option.
:Possible Values: 1 - 253
:Default Value: 32
tag_info:{{value[,value...]}[,{value[,value...]}...]}
:Definition: Set the per-target tagged queue depth on a
per controller basis. Both controllers and targets
may be omitted indicating that they should retain
the default tag depth.
:Possible Values: 1 - 253
:Default Value: 32
Examples:
::
tag_info:{{16,32,32,64,8,8,,32,32,32,32,32,32,32,32,32}
On Controller 0
- specifies a tag depth of 16 for target 0
- specifies a tag depth of 64 for target 3
- specifies a tag depth of 8 for targets 4 and 5
- leaves target 6 at the default
- specifies a tag depth of 32 for targets 1,2,7-15
All other targets retain the default depth.
::
tag_info:{{},{32,,32}}
On Controller 1
- specifies a tag depth of 32 for targets 0 and 2
All other targets retain the default depth.
Read streaming, DV와 IO cell 조정
318-472`rd_strm`은 controller별 16-bit hex mask로 target read streaming을 켠다. Bit 0-15가 target 0-15에 대응한다. `0x0041`은 controller 0의 target 0과 6, `0x0023,,0xFFFF`는 controller 0의 target 0·1·5와 controller 2의 모든 target을 활성화한다. 범위는 0x0000-0xffff, 기본 0이다.
`dv`는 controller별 Domain Validation policy다. 음수는 serial EEPROM 설정, 0은 끔, 양수는 켬이며 생략한 controller는 기본값을 유지한다. `dv:{-1,0,,1,1,0}`은 controller 0 기본, 1과 5 비활성, 2 생략, 3과 4 활성이다.
`seltime`은 selection timeout으로 0=256ms, 1=128ms, 2=64ms, 3=32ms이며 기본 0이다. `precomp`, `slewrate`, `amplitude`는 technical support 지시에 따라서만 바꿔야 하는 IO cell 신호 parameter다.
`precomp` 범위는 0-7이고 chip revision별 기본값을 쓰며 controller별 precompensation을 정한다. 원문의 `precomp:{1,,7}` 설명 중 controller 2를 8로 설정한다고 한 문장은 허용 범위 및 command의 7과 불일치하므로 실제 적용 전 확인해야 한다.
`slewrate`는 0-15, `amplitude`는 1-7이며 둘 다 chip revision별 기본값을 가진다. Controller 위치를 생략할 수 있다. 최종 예제 `options aic79xx aic79xx=verbose,rd_strm:{{0x0041}}`는 verbose 출력과 controller 0의 target 0·6 read streaming을 켠다.
정상 운영 option과 지원 담당자 전용 신호 조정을 구분합니다.
쉼표로 비운 위치는 해당 controller의 기본값을 유지합니다.
rd_strm: {rd_strm_bitmask[,rd_strm_bitmask...]}
:Definition: Enable read streaming on a per target basis.
The rd_strm_bitmask is a 16 bit hex value in which
each bit represents a target. Setting the target's
bit to '1' enables read streaming for that
target. Controllers may be omitted indicating that
they should retain the default read streaming setting.
Examples:
::
rd_strm:{0x0041}
On Controller 0
- enables read streaming for targets 0 and 6.
- disables read streaming for targets 1-5,7-15.
All other targets retain the default read
streaming setting.
::
rd_strm:{0x0023,,0xFFFF}
On Controller 0
- enables read streaming for targets 1,2, and 5.
- disables read streaming for targets 3,4,6-15.
On Controller 2
- enables read streaming for all targets.
All other targets retain the default read
streaming setting.
:Possible Values: 0x0000 - 0xffff
:Default Value: 0x0000
dv: {value[,value...]}
:Definition: Set Domain Validation Policy on a per-controller basis.
Controllers may be omitted indicating that
they should retain the default read streaming setting.
:Possible Values:
==== ===============================
< 0 Use setting from serial EEPROM.
0 Disable DV
> 0 Enable DV
==== ===============================
:Default Value: DV Serial EEPROM configuration setting.
Example:
::
dv:{-1,0,,1,1,0}
- On Controller 0 leave DV at its default setting.
- On Controller 1 disable DV.
- Skip configuration on Controller 2.
- On Controllers 3 and 4 enable DV.
- On Controller 5 disable DV.
seltime:[value]
:Definition: Specifies the selection timeout value
:Possible Values: 0 = 256ms, 1 = 128ms, 2 = 64ms, 3 = 32ms
:Default Value: 0
.. Warning:
The following three options should only be changed at
the direction of a technical support representative.
precomp: {value[,value...]}
:Definition: Set IO Cell precompensation value on a per-controller basis.
Controllers may be omitted indicating that
they should retain the default precompensation setting.
:Possible Values: 0 - 7
:Default Value: Varies based on chip revision
Examples:
::
precomp:{0x1}
On Controller 0 set precompensation to 1.
::
precomp:{1,,7}
- On Controller 0 set precompensation to 1.
- On Controller 2 set precompensation to 8.
slewrate: {value[,value...]}
:Definition: Set IO Cell slew rate on a per-controller basis.
Controllers may be omitted indicating that
they should retain the default slew rate setting.
:Possible Values: 0 - 15
:Default Value: Varies based on chip revision
Examples:
::
slewrate:{0x1}
- On Controller 0 set slew rate to 1.
::
slewrate :{1,,8}
- On Controller 0 set slew rate to 1.
- On Controller 2 set slew rate to 8.
amplitude: {value[,value...]}
:Definition: Set IO Cell signal amplitude on a per-controller basis.
Controllers may be omitted indicating that
they should retain the default read streaming setting.
:Possible Values: 1 - 7
:Default Value: Varies based on chip revision
Examples:
::
amplitude:{0x1}
On Controller 0 set amplitude to 1.
::
amplitude :{1,,7}
- On Controller 0 set amplitude to 1.
- On Controller 2 set amplitude to 7.
Example::
options aic79xx aic79xx=verbose,rd_strm:{{0x0041}}
enables verbose output in the driver and turns read streaming on
for targets 0 and 6 of Controller 0.
알려진 문제와 기술 제한
473-510SuSE Linux Enterprise 7에서는 kernel의 PCI interrupt routing 문제로 driver가 올바르게 동작하지 않을 수 있으므로 SuSE의 갱신 kernel이 필요하다. Adaptec은 최신 firmware를 쓰는 Ultra320 hard drive만 지원하므로 drive 제조사에서 최신 버전을 확인한다.
PCI Hot Plug은 시험되지 않아 OS가 응답하지 않을 수 있다. LUN 번호가 0부터 연속적이지 않으면 boot 때 자동 probe되지 않을 수 있으므로 Linux vendor의 수동 탐지 지침을 따른다.
Red Hat 설치 중 Driver Update Disk를 사용하면 module 디렉터리에 driver 두 버전이 들어가 `/sbin/mkinitrd`나 module을 설치하는 RPM package가 실패할 수 있다. System이 올라온 뒤 최신 driver RPM을 설치해 바로잡는다.
증상과 대응을 함께 기록합니다.
4. Additional Notes
===================
4.1. Known/Unresolved or FYI Issues
-----------------------------------
* Under SuSE Linux Enterprise 7, the driver may fail to operate
correctly due to a problem with PCI interrupt routing in the
Linux kernel. Please contact SuSE for an updated Linux
kernel.
4.2. Third-Party Compatibility Issues
-------------------------------------
* Adaptec only supports Ultra320 hard drives running
the latest firmware available. Please check with
your hard drive manufacturer to ensure you have the
latest version.
4.3. Operating System or Technology Limitations
-----------------------------------------------
* PCI Hot Plug is untested and may cause the operating system
to stop responding.
* Luns that are not numbered contiguously starting with 0 might not
be automatically probed during system startup. This is a limitation
of the OS. Please contact your Linux vendor for instructions on
manually probing non-contiguous luns.
* Using the Driver Update Disk version of this package during OS
installation under RedHat might result in two versions of this
driver being installed into the system module directory. This
might cause problems with the /sbin/mkinitrd program and/or
other RPM packages that try to install system modules. The best
way to correct this once the system is running is to install
the latest RPM package version of this driver, available from
http://www.adaptec.com.
TSID와 지역별 지원
511-564Adaptec technical support에는 12자리 TSID가 필요하다. 제품 상자 안 흰 barcode label에 있으며 제품과 지원 상태를 정확히 식별해 서비스를 빠르게 한다. ASK knowledgebase에서 문서·문제 해결·FAQ를 검색하거나 같은 site에서 email 질문을 제출할 수 있다.
북미에서는 Adaptec web site와 24시간 support option 안내 번호를 제공한다. Hardware와 RAID/Fibre Channel의 specialist 번호가 다르며 업무 시간은 월-금 PDT 기준이다. 빠른 처리를 위해 computer를 곁에 두고, 제품·accessory·cable 주문용 번호와 online cable 경로도 별도다.
유럽은 German, French, English별 전화와 ASK URL을 제공하며 CET 또는 GMT 업무 시간을 따른다. 일본은 일본 site와 월-금 오전·오후 기술 지원 번호를 제공한다. 이 연락처는 2003년 README의 기록이므로 현재 유효성은 별도 확인해야 한다.
오래된 연락처 기록의 핵심 절차를 정리합니다.
5. Adaptec Customer Support
===========================
A Technical Support Identification (TSID) Number is required for
Adaptec technical support.
- The 12-digit TSID can be found on the white barcode-type label
included inside the box with your product. The TSID helps us
provide more efficient service by accurately identifying your
product and support status.
Support Options
- Search the Adaptec Support Knowledgebase (ASK) at
http://ask.adaptec.com for articles, troubleshooting tips, and
frequently asked questions about your product.
- For support via Email, submit your question to Adaptec's
Technical Support Specialists at http://ask.adaptec.com/.
North America
- Visit our Web site at http://www.adaptec.com/.
- For information about Adaptec's support options, call
408-957-2550, 24 hours a day, 7 days a week.
- To speak with a Technical Support Specialist,
* For hardware products, call 408-934-7274,
Monday to Friday, 3:00 am to 5:00 pm, PDT.
* For RAID and Fibre Channel products, call 321-207-2000,
Monday to Friday, 3:00 am to 5:00 pm, PDT.
To expedite your service, have your computer with you.
- To order Adaptec products, including accessories and cables,
call 408-957-7274. To order cables online go to
http://www.adaptec.com/buy-cables/.
Europe
- Visit our Web site at http://www.adaptec.com/en-US/_common/world_index.
- To speak with a Technical Support Specialist, call, or email,
* German: +49 89 4366 5522, Monday-Friday, 9:00-17:00 CET,
http://ask-de.adaptec.com/.
* French: +49 89 4366 5533, Monday-Friday, 9:00-17:00 CET,
http://ask-fr.adaptec.com/.
* English: +49 89 4366 5544, Monday-Friday, 9:00-17:00 GMT,
http://ask.adaptec.com/.
- You can order Adaptec cables online at
http://www.adaptec.com/buy-cables/.
Japan
- Visit our web site at http://www.adaptec.co.jp/.
- To speak with a Technical Support Specialist, call
+81 3 5308 6120, Monday-Friday, 9:00 a.m. to 12:00 p.m.,
1:00 p.m. to 6:00 p.m.
README 재배포 조건과 면책
565-593Copyright는 2003 Adaptec Inc.에 있으며 모든 권리를 보유한다. GPL software 재배포와 함께라면 README 전체 또는 일부를 재배포·사용·수정할 수 있지만 세 조건을 지켜야 한다.
재배포본은 copyright notice, 조건 목록과 disclaimer를 수정 없이 유지해야 한다. 사전 서면 허가 없이 저자 이름을 파생 제품 홍보에 사용할 수 없다. 수정 또는 새 기여는 contributor를 식별하는 copyright notice로 원 notice 아래에 표시해야 하며, 이 표시는 Adaptec이 부여한 permission을 바꿀 권한을 뜻하지 않는다.
README는 어떠한 명시적·묵시적 보증도 없이 AS IS로 제공된다. 비침해성, 상품성, 특정 목적 적합성 보증을 부인하며, 계약·strict liability·tort 등 책임 이론과 관계없이 사용·data·profit 손실, business interruption을 포함한 직접·간접·부수·특별·징벌·결과 손해에 Adaptec과 contributor가 책임지지 않는다.
허용과 의무, 책임 제한을 구분합니다.
Copyright |copy| 2003 Adaptec Inc. 691 S. Milpitas Blvd., Milpitas CA 95035 USA.
All rights reserved.
You are permitted to redistribute, use and modify this README file in whole
or in part in conjunction with redistribution of software governed by the
General Public License, provided that the following conditions are met:
1. Redistributions of README file must retain the above copyright
notice, this list of conditions, and the following disclaimer,
without modification.
2. The name of the author may not be used to endorse or promote products
derived from this software without specific prior written permission.
3. Modifications or new contributions must be attributed in a copyright
notice identifying the author ("Contributor") and added below the
original copyright notice. The copyright notice is for purposes of
identifying contributors and should not be deemed as permission to alter
the permissions given by Adaptec.
THIS README FILE IS PROVIDED BY ADAPTEC AND CONTRIBUTORS ``AS IS`` AND
ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, ANY
WARRANTIES OF NON-INFRINGEMENT OR THE IMPLIED WARRANTIES OF MERCHANTABILITY
AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL
ADAPTEC 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 README
FILE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
요약·해설
aic79xx.rst:1-593AIC7901/7902 Ultra320 hardware, driver 이력, queue·read streaming·Domain Validation과 IO cell option을 설명합니다.