Linux용 WorkBiT NinjaSCSI-3/32Bi 드라이버

문서와 드라이버 소개

이 문서는 WorkBiT사의 `NinjaSCSI-3` PC 카드용 Linux 드라이버를 설명한다. 원문에 기록된 제조사 웹 주소와 제품명은 당시의 식별 정보이므로 그대로 보존한다.

.. SPDX-License-Identifier: GPL-2.0

=========================================
WorkBiT NinjaSCSI-3/32Bi driver for Linux
=========================================

1. Comment
==========

This is Workbit corp.'s(http://www.workbit.co.jp/) NinjaSCSI-3
for Linux.

검증된 Linux 환경

작성자가 시험한 환경은 Linux 2.4.7 또는 2.2.19, `pcmcia-cs` 3.1.27, gcc 2.95.4이다. PC 카드는 I-O DATA PCSC-F(`NinjaSCSI-3`)와 16비트 모드의 I-O DATA CBSC-II(`NinjaSCSI-32Bi`)였고, CD-ROM 드라이브 CDPS-PX24와 광디스크 드라이브 MMO-640GT를 연결했다.

2. My Linux environment
=======================

:Linux kernel: 2.4.7 / 2.2.19
:pcmcia-cs:    3.1.27
:gcc:          gcc-2.95.4
:PC card:      I-O data PCSC-F (NinjaSCSI-3),
               I-O data CBSC-II in 16 bit mode (NinjaSCSI-32Bi)
:SCSI device:  I-O data CDPS-PX24 (CD-ROM drive),
               Media Intelligent MMO-640GT (Optical disk drive)

카드 확인과 드라이버 설치

먼저 카드가 실제 `NinjaSCSI-3`인지 확인한다. 이미 `pcmcia-cs`가 설치되어 있으면 `cardmgr`가 카드를 UNKNOWN 또는 unsupported로 보고하면서 제품 문자열 `"WBT", "NinjaSCSI-3", "R1.0"` 등을 로그에 남긴다. `cardctl ident`로 소켓별 제품 정보도 확인할 수 있다.

Linux 커널 소스를 `/usr/src`에 풀고 설정한다. 이 드라이버는 커널 소스의 SCSI 헤더를 사용하므로 버전 불일치를 피하려면 커널을 다시 빌드하는 편이 권장된다. Linux 2.2에서는 `pcmcia-cs` 소스도 풀어 빌드하고 설치해야 한다.

드라이버 압축을 풀고 Makefile을 환경에 맞게 편집한 뒤 `make`를 실행한다. 생성된 `nsp_cs.ko`는 `/lib/modules/<Kernel version>/pcmcia/` 같은 적절한 모듈 디렉터리에 둔다.

`/etc/pcmcia/config`에는 `nsp_cs` 장치와 `WBT`, `WORKBIT`, `IO DATA`, `KME`의 제품 식별 문자열을 연결하는 항목을 추가한다. `pcmcia-cs-3.1.8` 이상이라면 이 내용을 담은 `nsp_cs.conf`를 `/etc/pcmcia/`에 복사할 수 있어 기본 설정 파일을 직접 편집할 필요가 없다.

설치가 끝나면 BSD 방식 시스템에서는 `/etc/rc.d/rc.pcmcia start`, SYSV 방식 시스템에서는 `/etc/init.d/pcmcia start`로 PCMCIA 서비스를 시작하거나 다시 시작한다.

3. Install
==========

(a) Check your PC card is true "NinjaSCSI-3" card.

    If you installed pcmcia-cs already, pcmcia reports your card as UNKNOWN
    card, and write ["WBT", "NinjaSCSI-3", "R1.0"] or some other string to
    your console or log file.

    You can also use "cardctl" program (this program is in pcmcia-cs source
    code) to get more info.

    ::

        # cat /var/log/messages
        ...
        Jan  2 03:45:06 lindberg cardmgr[78]: unsupported card in socket 1
        Jan  2 03:45:06 lindberg cardmgr[78]:   product info: "WBT", "NinjaSCSI-3", "R1.0"
        ...
        # cardctl ident
        Socket 0:
          no product info available
        Socket 1:
          product info: "IO DATA", "CBSC16       ", "1"


(b) Get the Linux kernel source, and extract it to /usr/src.
    Because the NinjaSCSI driver requires some SCSI header files in Linux 
    kernel source, I recommend rebuilding your kernel; this eliminates 
    some versioning problems.

    ::

        $ cd /usr/src
        $ tar -zxvf linux-x.x.x.tar.gz
        $ cd linux
        $ make config
        ...

(c) If you use this driver with Kernel 2.2, unpack pcmcia-cs in some directory
    and make & install. This driver requires the pcmcia-cs header file.

    ::

        $ cd /usr/src
        $ tar zxvf cs-pcmcia-cs-3.x.x.tar.gz
        ...

(d) Extract this driver's archive somewhere, and edit Makefile, then do make::

        $ tar -zxvf nsp_cs-x.x.tar.gz
        $ cd nsp_cs-x.x
        $ emacs Makefile
        ...
        $ make

(e) Copy nsp_cs.ko to suitable place, like /lib/modules/<Kernel version>/pcmcia/ .

(f) Add these lines to /etc/pcmcia/config .

    If you use pcmcia-cs-3.1.8 or later, we can use "nsp_cs.conf" file.
    So, you don't need to edit file. Just copy to /etc/pcmcia/ .

    ::

        device "nsp_cs"
          class "scsi" module "nsp_cs"

        card "WorkBit NinjaSCSI-3"
          version "WBT", "NinjaSCSI-3", "R1.0"
          bind "nsp_cs"

        card "WorkBit NinjaSCSI-32Bi (16bit)"
          version "WORKBIT", "UltraNinja-16", "1"
          bind "nsp_cs"

        # OEM
        card "WorkBit NinjaSCSI-32Bi (16bit) / IO-DATA"
          version "IO DATA", "CBSC16       ", "1"
          bind "nsp_cs"

        # OEM
        card "WorkBit NinjaSCSI-32Bi (16bit) / KME-1"
          version "KME    ", "SCSI-CARD-001", "1"
          bind "nsp_cs"
        card "WorkBit NinjaSCSI-32Bi (16bit) / KME-2"
          version "KME    ", "SCSI-CARD-002", "1"
          bind "nsp_cs"
        card "WorkBit NinjaSCSI-32Bi (16bit) / KME-3"
          version "KME    ", "SCSI-CARD-003", "1"
          bind "nsp_cs"
        card "WorkBit NinjaSCSI-32Bi (16bit) / KME-4"
          version "KME    ", "SCSI-CARD-004", "1"
          bind "nsp_cs"

(f) Start (or restart) pcmcia-cs::

        # /etc/rc.d/rc.pcmcia start        (BSD style)

    or::

        # /etc/init.d/pcmcia start         (SYSV style)

이력과 데이터 안전 주의

변경 이력은 `README.nin_cs`를 참고한다. SCSI 장치가 동작 중일 때 카드를 꺼내거나 컴퓨터를 절전 상태로 전환하면 디스크 손상과 같은 심각한 오류가 생길 수 있다.

작성자는 올바르게 사용할 때 잘 동작했다고 밝혔지만 데이터 보증은 하지 않는다. 이 드라이버를 사용할 때는 반드시 중요한 데이터를 백업해야 한다.

4. History
==========

See README.nin_cs .

5. Caution
==========

If you eject card when doing some operation for your SCSI device or suspend
your computer, you encount some *BAD* error like disk crash.

It works good when I using this driver right way. But I'm not guarantee
your data. Please backup your data when you use this driver.

알려진 문제, 시험 보고와 저작권

Linux 2.4 커널에서는 640MB 광디스크를 사용할 수 없으며, 원문은 그 원인을 상위 SCSI 드라이버에 있다고 기록한다.

버그를 포함한 시험 결과를 보낼 때는 카드 이름, 커널 버전, 하드디스크나 CD-ROM 같은 SCSI 장치 이름을 포함해야 한다. 저작권 조건은 GPL을 따른다. 문서 말미에는 2001년 8월 8일과 YOKOTA Hiroshi의 연락처가 기록되어 있다.

6. Known Bugs
=============

In 2.4 kernel, you can't use 640MB Optical disk. This error comes from
high level SCSI driver.

7. Testing
==========

Please send me some reports(bug reports etc..) of this software.
When you send report, please tell me these or more.

        - card name
        - kernel version
        - your SCSI device name(hard drive, CD-ROM, etc...)

8. Copyright
============

 See GPL.


2001/08/08 [email protected] <YOKOTA Hiroshi>