cachepc-linux

Fork of AMDESE/linux with modifications for CachePC side-channel attack
git clone https://git.sinitax.com/sinitax/cachepc-linux
Log | Files | Refs | README | LICENSE | sfeed.txt

NinjaSCSI.rst (3994B)

      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>