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