^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1) .. SPDX-License-Identifier: GPL-2.0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 3) =========================================
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 4) WorkBiT NinjaSCSI-3/32Bi driver for Linux
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 5) =========================================
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 6)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 7) 1. Comment
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 8) ==========
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 9)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 10) This is Workbit corp.'s(http://www.workbit.co.jp/) NinjaSCSI-3
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 11) for Linux.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 12)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 13) 2. My Linux environment
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 14) =======================
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 15)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 16) :Linux kernel: 2.4.7 / 2.2.19
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 17) :pcmcia-cs: 3.1.27
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 18) :gcc: gcc-2.95.4
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 19) :PC card: I-O data PCSC-F (NinjaSCSI-3),
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 20) I-O data CBSC-II in 16 bit mode (NinjaSCSI-32Bi)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 21) :SCSI device: I-O data CDPS-PX24 (CD-ROM drive),
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 22) Media Intelligent MMO-640GT (Optical disk drive)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 23)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 24) 3. Install
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 25) ==========
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 26)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 27) (a) Check your PC card is true "NinjaSCSI-3" card.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 28)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 29) If you installed pcmcia-cs already, pcmcia reports your card as UNKNOWN
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 30) card, and write ["WBT", "NinjaSCSI-3", "R1.0"] or some other string to
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 31) your console or log file.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 32)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 33) You can also use "cardctl" program (this program is in pcmcia-cs source
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 34) code) to get more info.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 35)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 36) ::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 37)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 38) # cat /var/log/messages
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 39) ...
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 40) Jan 2 03:45:06 lindberg cardmgr[78]: unsupported card in socket 1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 41) Jan 2 03:45:06 lindberg cardmgr[78]: product info: "WBT", "NinjaSCSI-3", "R1.0"
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 42) ...
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 43) # cardctl ident
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 44) Socket 0:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 45) no product info available
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 46) Socket 1:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 47) product info: "IO DATA", "CBSC16 ", "1"
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 48)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 49)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 50) (b) Get the Linux kernel source, and extract it to /usr/src.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 51) Because the NinjaSCSI driver requires some SCSI header files in Linux
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 52) kernel source, I recommend rebuilding your kernel; this eliminates
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 53) some versioning problems.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 54)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 55) ::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 56)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 57) $ cd /usr/src
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 58) $ tar -zxvf linux-x.x.x.tar.gz
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 59) $ cd linux
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 60) $ make config
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 61) ...
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 62)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 63) (c) If you use this driver with Kernel 2.2, unpack pcmcia-cs in some directory
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 64) and make & install. This driver requires the pcmcia-cs header file.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 65)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 66) ::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 67)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 68) $ cd /usr/src
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 69) $ tar zxvf cs-pcmcia-cs-3.x.x.tar.gz
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 70) ...
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 71)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 72) (d) Extract this driver's archive somewhere, and edit Makefile, then do make::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 73)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 74) $ tar -zxvf nsp_cs-x.x.tar.gz
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 75) $ cd nsp_cs-x.x
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 76) $ emacs Makefile
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 77) ...
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 78) $ make
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 79)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 80) (e) Copy nsp_cs.ko to suitable place, like /lib/modules/<Kernel version>/pcmcia/ .
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 81)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 82) (f) Add these lines to /etc/pcmcia/config .
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 83)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 84) If you use pcmcia-cs-3.1.8 or later, we can use "nsp_cs.conf" file.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 85) So, you don't need to edit file. Just copy to /etc/pcmcia/ .
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 86)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 87) ::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 88)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 89) device "nsp_cs"
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 90) class "scsi" module "nsp_cs"
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 91)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 92) card "WorkBit NinjaSCSI-3"
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 93) version "WBT", "NinjaSCSI-3", "R1.0"
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 94) bind "nsp_cs"
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 95)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 96) card "WorkBit NinjaSCSI-32Bi (16bit)"
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 97) version "WORKBIT", "UltraNinja-16", "1"
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 98) bind "nsp_cs"
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 99)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 100) # OEM
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 101) card "WorkBit NinjaSCSI-32Bi (16bit) / IO-DATA"
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 102) version "IO DATA", "CBSC16 ", "1"
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 103) bind "nsp_cs"
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 104)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 105) # OEM
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 106) card "WorkBit NinjaSCSI-32Bi (16bit) / KME-1"
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 107) version "KME ", "SCSI-CARD-001", "1"
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 108) bind "nsp_cs"
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 109) card "WorkBit NinjaSCSI-32Bi (16bit) / KME-2"
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 110) version "KME ", "SCSI-CARD-002", "1"
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 111) bind "nsp_cs"
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 112) card "WorkBit NinjaSCSI-32Bi (16bit) / KME-3"
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 113) version "KME ", "SCSI-CARD-003", "1"
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 114) bind "nsp_cs"
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 115) card "WorkBit NinjaSCSI-32Bi (16bit) / KME-4"
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 116) version "KME ", "SCSI-CARD-004", "1"
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 117) bind "nsp_cs"
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 118)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 119) (f) Start (or restart) pcmcia-cs::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 120)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 121) # /etc/rc.d/rc.pcmcia start (BSD style)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 122)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 123) or::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 124)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 125) # /etc/init.d/pcmcia start (SYSV style)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 126)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 127)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 128) 4. History
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 129) ==========
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 130)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 131) See README.nin_cs .
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 132)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 133) 5. Caution
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 134) ==========
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 135)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 136) If you eject card when doing some operation for your SCSI device or suspend
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 137) your computer, you encount some *BAD* error like disk crash.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 138)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 139) It works good when I using this driver right way. But I'm not guarantee
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 140) your data. Please backup your data when you use this driver.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 141)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 142) 6. Known Bugs
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 143) =============
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 144)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 145) In 2.4 kernel, you can't use 640MB Optical disk. This error comes from
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 146) high level SCSI driver.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 147)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 148) 7. Testing
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 149) ==========
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 150)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 151) Please send me some reports(bug reports etc..) of this software.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 152) When you send report, please tell me these or more.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 153)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 154) - card name
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 155) - kernel version
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 156) - your SCSI device name(hard drive, CD-ROM, etc...)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 157)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 158) 8. Copyright
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 159) ============
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 160)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 161) See GPL.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 162)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 163)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 164) 2001/08/08 yokota@netlab.is.tsukuba.ac.jp <YOKOTA Hiroshi>