NinjaSCSI.rst 3.9 KB

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