From 058595d58217fc062ed95c8a5621d2bc26a7a9bb Mon Sep 17 00:00:00 2001 From: Mauro Carvalho Chehab Date: Mon, 2 Mar 2020 09:15:59 +0100 Subject: scsi: docs: convert qlogicfas.txt to ReST Link: https://lore.kernel.org/r/b69f795c781811b9a908abe43485f1dca0ee8ac5.1583136624.git.mchehab+huawei@kernel.org Signed-off-by: Mauro Carvalho Chehab Signed-off-by: Martin K. Petersen --- Documentation/scsi/index.rst | 1 + Documentation/scsi/qlogicfas.rst | 87 ++++++++++++++++++++++++++++++++++++++++ Documentation/scsi/qlogicfas.txt | 78 ----------------------------------- drivers/scsi/Kconfig | 2 +- 4 files changed, 89 insertions(+), 79 deletions(-) create mode 100644 Documentation/scsi/qlogicfas.rst delete mode 100644 Documentation/scsi/qlogicfas.txt diff --git a/Documentation/scsi/index.rst b/Documentation/scsi/index.rst index 17327f67af68..29e211ee9145 100644 --- a/Documentation/scsi/index.rst +++ b/Documentation/scsi/index.rst @@ -30,5 +30,6 @@ Linux SCSI Subsystem ncr53c8xx NinjaSCSI ppa + qlogicfas scsi_transport_srp/figures diff --git a/Documentation/scsi/qlogicfas.rst b/Documentation/scsi/qlogicfas.rst new file mode 100644 index 000000000000..b17f1b3676c3 --- /dev/null +++ b/Documentation/scsi/qlogicfas.rst @@ -0,0 +1,87 @@ +.. SPDX-License-Identifier: GPL-2.0 + +================================= +Qlogic FASXXX Family Driver Notes +================================= + +This driver supports the Qlogic FASXXX family of chips. This driver +only works with the ISA, VLB, and PCMCIA versions of the Qlogic +FastSCSI! cards as well as any other card based on the FASXX chip +(including the Control Concepts SCSI/IDE/SIO/PIO/FDC cards). + +This driver does NOT support the PCI version. Support for these PCI +Qlogic boards: + + * IQ-PCI + * IQ-PCI-10 + * IQ-PCI-D + +is provided by the qla1280 driver. + +Nor does it support the PCI-Basic, which is supported by the +'am53c974' driver. + +PCMCIA Support +============== + +This currently only works if the card is enabled first from DOS. This +means you will have to load your socket and card services, and +QL41DOS.SYS and QL40ENBL.SYS. These are a minimum, but loading the +rest of the modules won't interfere with the operation. The next +thing to do is load the kernel without resetting the hardware, which +can be a simple ctrl-alt-delete with a boot floppy, or by using +loadlin with the kernel image accessible from DOS. If you are using +the Linux PCMCIA driver, you will have to adjust it or otherwise stop +it from configuring the card. + +I am working with the PCMCIA group to make it more flexible, but that +may take a while. + +All Cards +========= + +The top of the qlogic.c file has a number of defines that controls +configuration. As shipped, it provides a balance between speed and +function. If there are any problems, try setting SLOW_CABLE to 1, and +then try changing USE_IRQ and TURBO_PDMA to zero. If you are familiar +with SCSI, there are other settings which can tune the bus. + +It may be a good idea to enable RESET_AT_START, especially if the +devices may not have been just powered up, or if you are restarting +after a crash, since they may be busy trying to complete the last +command or something. It comes up faster if this is set to zero, and +if you have reliable hardware and connections it may be more useful to +not reset things. + +Some Troubleshooting Tips +========================= + +Make sure it works properly under DOS. You should also do an initial FDISK +on a new drive if you want partitions. + +Don't enable all the speedups first. If anything is wrong, they will make +any problem worse. + +Important +========= + +The best way to test if your cables, termination, etc. are good is to +copy a very big file (e.g. a doublespace container file, or a very +large executable or archive). It should be at least 5 megabytes, but +you can do multiple tests on smaller files. Then do a COMP to verify +that the file copied properly. (Turn off all caching when doing these +tests, otherwise you will test your RAM and not the files). Then do +10 COMPs, comparing the same file on the SCSI hard drive, i.e. "COMP +realbig.doc realbig.doc". Then do it after the computer gets warm. + +I noticed my system which seems to work 100% would fail this test if +the computer was left on for a few hours. It was worse with longer +cables, and more devices on the SCSI bus. What seems to happen is +that it gets a false ACK causing an extra byte to be inserted into the +stream (and this is not detected). This can be caused by bad +termination (the ACK can be reflected), or by noise when the chips +work less well because of the heat, or when cables get too long for +the speed. + +Remember, if it doesn't work under DOS, it probably won't work under +Linux. diff --git a/Documentation/scsi/qlogicfas.txt b/Documentation/scsi/qlogicfas.txt deleted file mode 100644 index c211d827fef2..000000000000 --- a/Documentation/scsi/qlogicfas.txt +++ /dev/null @@ -1,78 +0,0 @@ - -This driver supports the Qlogic FASXXX family of chips. This driver -only works with the ISA, VLB, and PCMCIA versions of the Qlogic -FastSCSI! cards as well as any other card based on the FASXX chip -(including the Control Concepts SCSI/IDE/SIO/PIO/FDC cards). - -This driver does NOT support the PCI version. Support for these PCI -Qlogic boards: - - * IQ-PCI - * IQ-PCI-10 - * IQ-PCI-D - -is provided by the qla1280 driver. - -Nor does it support the PCI-Basic, which is supported by the -'am53c974' driver. - -PCMCIA SUPPORT - -This currently only works if the card is enabled first from DOS. This -means you will have to load your socket and card services, and -QL41DOS.SYS and QL40ENBL.SYS. These are a minimum, but loading the -rest of the modules won't interfere with the operation. The next -thing to do is load the kernel without resetting the hardware, which -can be a simple ctrl-alt-delete with a boot floppy, or by using -loadlin with the kernel image accessible from DOS. If you are using -the Linux PCMCIA driver, you will have to adjust it or otherwise stop -it from configuring the card. - -I am working with the PCMCIA group to make it more flexible, but that -may take a while. - -ALL CARDS - -The top of the qlogic.c file has a number of defines that controls -configuration. As shipped, it provides a balance between speed and -function. If there are any problems, try setting SLOW_CABLE to 1, and -then try changing USE_IRQ and TURBO_PDMA to zero. If you are familiar -with SCSI, there are other settings which can tune the bus. - -It may be a good idea to enable RESET_AT_START, especially if the -devices may not have been just powered up, or if you are restarting -after a crash, since they may be busy trying to complete the last -command or something. It comes up faster if this is set to zero, and -if you have reliable hardware and connections it may be more useful to -not reset things. - -SOME TROUBLESHOOTING TIPS - -Make sure it works properly under DOS. You should also do an initial FDISK -on a new drive if you want partitions. - -Don't enable all the speedups first. If anything is wrong, they will make -any problem worse. - -IMPORTANT - -The best way to test if your cables, termination, etc. are good is to -copy a very big file (e.g. a doublespace container file, or a very -large executable or archive). It should be at least 5 megabytes, but -you can do multiple tests on smaller files. Then do a COMP to verify -that the file copied properly. (Turn off all caching when doing these -tests, otherwise you will test your RAM and not the files). Then do -10 COMPs, comparing the same file on the SCSI hard drive, i.e. "COMP -realbig.doc realbig.doc". Then do it after the computer gets warm. - -I noticed my system which seems to work 100% would fail this test if -the computer was left on for a few hours. It was worse with longer -cables, and more devices on the SCSI bus. What seems to happen is -that it gets a false ACK causing an extra byte to be inserted into the -stream (and this is not detected). This can be caused by bad -termination (the ACK can be reflected), or by noise when the chips -work less well because of the heat, or when cables get too long for -the speed. - -Remember, if it doesn't work under DOS, it probably won't work under -Linux. diff --git a/drivers/scsi/Kconfig b/drivers/scsi/Kconfig index 82462d6a4ce5..d34c682e94cf 100644 --- a/drivers/scsi/Kconfig +++ b/drivers/scsi/Kconfig @@ -1117,7 +1117,7 @@ config SCSI_QLOGIC_FAS SCSI support"), below. Information about this driver is contained in - . You should also read the + . You should also read the SCSI-HOWTO, available from . -- cgit v1.2.3