요약·해설, 영어 원문, 전체 번역을 구분해 실었습니다. API 이름, 코드 심벌, 소스 경로는 원문 표기를 유지합니다.
1. 요약·해설
원문의 핵심 내용을 정리하고 커널 프로그래밍에 필요한 설명을 덧붙였습니다. 아래의 전체 번역과는 별도로 작성한 해설입니다.
2. 영어 원문 전체
번역에 사용한 Linux v6.18.37 원문입니다. 줄 번호는 해당 버전의 소스 파일을 기준으로 합니다.
원문 전체 펼치기
.. SPDX-License-Identifier: GPL-2.0
===============================================================
Driver for Western Digital WD7193, WD7197 and WD7296 SCSI cards
===============================================================
The card requires firmware that can be cut out of the Windows NT driver that
can be downloaded from WD at:
http://support.wdc.com/product/download.asp?groupid=801&sid=27&lang=en
There is no license anywhere in the file or on the page - so the firmware
probably cannot be added to linux-firmware.
This script downloads and extracts the firmware, creating wd719x-risc.bin and
d719x-wcs.bin files. Put them in /lib/firmware/::
#!/bin/sh
wget http://support.wdc.com/download/archive/pciscsi.exe
lha xi pciscsi.exe pci-scsi.exe
lha xi pci-scsi.exe nt/wd7296a.sys
rm pci-scsi.exe
dd if=wd7296a.sys of=wd719x-risc.bin bs=1 skip=5760 count=14336
dd if=wd7296a.sys of=wd719x-wcs.bin bs=1 skip=20096 count=514
rm wd7296a.sys
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미에 맞춰 전체 내용을 번역했습니다. 코드, 함수명, 코드 심벌, URL은 원문 표기를 유지합니다.
Firmware 출처와 배포 제약
1-13GPL-2.0 driver 문서는 Western Digital WD7193, WD7197, WD7296 SCSI card를 다룬다. Card에는 WD support URL에서 받는 Windows NT driver 안의 firmware가 필요하다. File과 download page 어디에도 license가 없으므로 firmware를 `linux-firmware`에 추가하기는 어려울 것으로 판단한다.
.. SPDX-License-Identifier: GPL-2.0
===============================================================
Driver for Western Digital WD7193, WD7197 and WD7296 SCSI cards
===============================================================
The card requires firmware that can be cut out of the Windows NT driver that
can be downloaded from WD at:
http://support.wdc.com/product/download.asp?groupid=801&sid=27&lang=en
There is no license anywhere in the file or on the page - so the firmware
probably cannot be added to linux-firmware.
Windows driver에서 firmware 추출
14-24원문의 shell script는 `pciscsi.exe`를 내려받고 `lha`로 `pci-scsi.exe`, 다시 `nt/wd7296a.sys`를 추출한다. `dd`로 offset 5760에서 14,336 byte를 잘라 `wd719x-risc.bin`, offset 20,096에서 514 byte를 잘라 `wd719x-wcs.bin`을 만든다. 중간 file을 지운 뒤 두 firmware file을 `/lib/firmware/`에 둔다. URL, command, filename, byte offset과 count를 모두 보존한다.
Shell script의 `dd` 좌표를 구조화했다.
Windows package에서 Linux driver용 binary 두 개를 얻는 순서다.
This script downloads and extracts the firmware, creating wd719x-risc.bin and
d719x-wcs.bin files. Put them in /lib/firmware/::
#!/bin/sh
wget http://support.wdc.com/download/archive/pciscsi.exe
lha xi pciscsi.exe pci-scsi.exe
lha xi pci-scsi.exe nt/wd7296a.sys
rm pci-scsi.exe
dd if=wd7296a.sys of=wd719x-risc.bin bs=1 skip=5760 count=14336
dd if=wd7296a.sys of=wd719x-wcs.bin bs=1 skip=20096 count=514
rm wd7296a.sys
요약·해설
wd719x.rst:1-24WD7193·WD7197·WD7296 card에 필요한 firmware의 출처, licensing 제약과 정확한 binary 추출 절차를 설명합니다.