LXR linux/Documentation/scsi/NinjaSCSI.rst

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