요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
.. SPDX-License-Identifier: GPL-2.0
=============================================
FORE Systems PCA-200E/SBA-200E ATM NIC driver
=============================================
This driver adds support for the FORE Systems 200E-series ATM adapters
to the Linux operating system. It is based on the earlier PCA-200E driver
written by Uwe Dannowski.
The driver simultaneously supports PCA-200E and SBA-200E adapters on
i386, alpha (untested), powerpc, sparc and sparc64 archs.
The intent is to enable the use of different models of FORE adapters at the
same time, by hosts that have several bus interfaces (such as PCI+SBUS,
or PCI+EISA).
Only PCI and SBUS devices are currently supported by the driver, but support
for other bus interfaces such as EISA should not be too hard to add.
Firmware Copyright Notice
-------------------------
Please read the fore200e_firmware_copyright file present
in the linux/drivers/atm directory for details and restrictions.
Firmware Updates
----------------
The FORE Systems 200E-series driver is shipped with firmware data being
uploaded to the ATM adapters at system boot time or at module loading time.
The supplied firmware images should work with all adapters.
However, if you encounter problems (the firmware doesn't start or the driver
is unable to read the PROM data), you may consider trying another firmware
version. Alternative binary firmware images can be found somewhere on the
ForeThought CD-ROM supplied with your adapter by FORE Systems.
You can also get the latest firmware images from FORE Systems at
https://en.wikipedia.org/wiki/FORE_Systems. Register TACTics Online and go to
the 'software updates' pages. The firmware binaries are part of
the various ForeThought software distributions.
Notice that different versions of the PCA-200E firmware exist, depending
on the endianness of the host architecture. The driver is shipped with
both little and big endian PCA firmware images.
Name and location of the new firmware images can be set at kernel
configuration time:
1. Copy the new firmware binary files (with .bin, .bin1 or .bin2 suffix)
to some directory, such as linux/drivers/atm.
2. Reconfigure your kernel to set the new firmware name and location.
Expected pathnames are absolute or relative to the drivers/atm directory.
3. Rebuild and re-install your kernel or your module.
Feedback
--------
Feedback is welcome. Please send success stories/bug reports/
patches/improvement/comments/flames to <[email protected]>.
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
지원 adapter, architecture와 bus interface
1-20FORE Systems PCA-200E/SBA-200E ATM NIC driver
이 driver는 FORE Systems 200E-series ATM adapter를 Linux operating system에서 사용할 수 있게 합니다. Uwe Dannowski가 작성한 이전 PCA-200E driver를 기반으로 합니다.
Driver는 i386, alpha(시험되지 않음), powerpc, sparc, sparc64 architecture에서 PCA-200E와 SBA-200E adapter를 동시에 지원합니다.
목적은 PCI+SBUS 또는 PCI+EISA처럼 여러 bus interface를 가진 host가 서로 다른 FORE adapter model을 동시에 사용할 수 있게 하는 것입니다.
현재 driver가 지원하는 device는 PCI와 SBUS뿐이지만 EISA 같은 다른 bus interface 지원도 크게 어렵지 않게 추가할 수 있을 것입니다.
.. SPDX-License-Identifier: GPL-2.0
=============================================
FORE Systems PCA-200E/SBA-200E ATM NIC driver
=============================================
This driver adds support for the FORE Systems 200E-series ATM adapters
to the Linux operating system. It is based on the earlier PCA-200E driver
written by Uwe Dannowski.
The driver simultaneously supports PCA-200E and SBA-200E adapters on
i386, alpha (untested), powerpc, sparc and sparc64 archs.
The intent is to enable the use of different models of FORE adapters at the
same time, by hosts that have several bus interfaces (such as PCI+SBUS,
or PCI+EISA).
Only PCI and SBUS devices are currently supported by the driver, but support
for other bus interfaces such as EISA should not be too hard to add.
Firmware 저작권 고지
21-28Firmware Copyright Notice
자세한 내용과 제한 사항은 `linux/drivers/atm` directory에 있는 `fore200e_firmware_copyright` file을 읽으십시오.
Firmware Copyright Notice
-------------------------
Please read the fore200e_firmware_copyright file present
in the linux/drivers/atm directory for details and restrictions.
Firmware load, 대체 image와 갱신 절차
29-59Firmware Updates
FORE Systems 200E-series driver에는 system boot 또는 module load 시 ATM adapter로 upload되는 firmware data가 포함되어 있습니다. 제공된 firmware image는 모든 adapter에서 작동해야 합니다.
그러나 firmware가 시작되지 않거나 driver가 PROM data를 읽지 못하는 문제가 생기면 다른 firmware version을 시험해 볼 수 있습니다. 대체 binary firmware image는 FORE Systems가 adapter와 함께 제공한 ForeThought CD-ROM에서 찾을 수 있습니다.
FORE Systems의 최신 firmware image는 https://en.wikipedia.org/wiki/FORE_Systems 에서도 구할 수 있습니다. TACTics Online에 등록한 뒤 `software updates` page로 이동하십시오. Firmware binary는 여러 ForeThought software distribution에 포함되어 있습니다.
PCA-200E firmware에는 host architecture endianness에 따라 서로 다른 version이 있다는 점에 유의하십시오. Driver에는 little-endian과 big-endian PCA firmware image가 모두 포함되어 있습니다.
새 firmware image의 이름과 위치는 kernel configuration 시점에 다음 절차로 설정할 수 있습니다.
- 새 firmware binary file을 `.bin`, `.bin1` 또는 `.bin2` suffix와 함께 `linux/drivers/atm` 같은 directory로 복사합니다.
- Kernel을 다시 configure하여 새 firmware 이름과 위치를 설정합니다. Pathname은 absolute path이거나 `drivers/atm` directory 기준 relative path여야 합니다.
- Kernel 또는 module을 rebuild한 뒤 다시 install합니다.
Firmware Updates
----------------
The FORE Systems 200E-series driver is shipped with firmware data being
uploaded to the ATM adapters at system boot time or at module loading time.
The supplied firmware images should work with all adapters.
However, if you encounter problems (the firmware doesn't start or the driver
is unable to read the PROM data), you may consider trying another firmware
version. Alternative binary firmware images can be found somewhere on the
ForeThought CD-ROM supplied with your adapter by FORE Systems.
You can also get the latest firmware images from FORE Systems at
https://en.wikipedia.org/wiki/FORE_Systems. Register TACTics Online and go to
the 'software updates' pages. The firmware binaries are part of
the various ForeThought software distributions.
Notice that different versions of the PCA-200E firmware exist, depending
on the endianness of the host architecture. The driver is shipped with
both little and big endian PCA firmware images.
Name and location of the new firmware images can be set at kernel
configuration time:
1. Copy the new firmware binary files (with .bin, .bin1 or .bin2 suffix)
to some directory, such as linux/drivers/atm.
2. Reconfigure your kernel to set the new firmware name and location.
Expected pathnames are absolute or relative to the drivers/atm directory.
3. Rebuild and re-install your kernel or your module.
Feedback 연락처
60-66Feedback
Feedback을 환영합니다. 성공 사례, bug report, patch, 개선 사항, 의견과 비판은 `<[email protected]>`로 보내십시오.
Feedback
--------
Feedback is welcome. Please send success stories/bug reports/
patches/improvement/comments/flames to <[email protected]>.
요약·해설
fore200e.rst:1-66`fore200e` driver는 PCA-200E와 SBA-200E ATM adapter를 여러 architecture와 bus 조합에서 함께 사용할 수 있게 합니다. 정상적으로는 내장 firmware image를 boot 또는 module load 때 adapter에 올리며, 시작 실패나 PROM 읽기 실패가 있을 때만 architecture endianness에 맞는 대체 image와 kernel 재구성을 검토합니다.
두 200E model을 같은 driver가 동시에 지원합니다.
현재 구현과 확장 가능성을 구분합니다.
제공 image는 일반적으로 별도 조작 없이 adapter에 upload됩니다.
대체 image는 명시된 실패 상황에서 검토합니다.
Host architecture byte order와 맞는 image를 선택해야 합니다.
Kernel configuration에 image pathname을 반영하는 세 단계입니다.