요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
===========================
Kernel driver spi-sc18is602
===========================
Supported chips:
* NXP SI18IS602/602B/603
Datasheet: https://www.nxp.com/documents/data_sheet/SC18IS602_602B_603.pdf
Author:
Guenter Roeck <[email protected]>
Description
-----------
This driver provides connects a NXP SC18IS602/603 I2C-bus to SPI bridge to the
kernel's SPI core subsystem.
The driver does not probe for supported chips, since the SI18IS602/603 does not
support Chip ID registers. You will have to instantiate the devices explicitly.
Please see Documentation/i2c/instantiating-devices.rst for details.
Usage Notes
-----------
This driver requires the I2C adapter driver to support raw I2C messages. I2C
adapter drivers which can only handle the SMBus protocol are not supported.
The maximum SPI message size supported by SC18IS602/603 is 200 bytes. Attempts
to initiate longer transfers will fail with -EINVAL. EEPROM read operations and
similar large accesses have to be split into multiple chunks of no more than
200 bytes per SPI message (128 bytes of data per message is recommended). This
means that programs such as "cp" or "od", which automatically use large block
sizes to access a device, can not be used directly to read data from EEPROM.
Programs such as dd, where the block size can be specified, should be used
instead.
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
지원 chip과 드라이버 설명
1-25이 커널 드라이버는 NXP SC18IS602, SC18IS602B, SC18IS603 chip을 지원한다. 원문은 NXP 데이터시트 주소와 저자 Guenter Roeck의 연락처를 제공한다.
드라이버는 NXP SC18IS602/603 I2C bus-to-SPI bridge를 커널 SPI core subsystem에 연결한다.
SC18IS602/603에는 Chip ID register가 없으므로 드라이버가 지원 chip을 probe하지 않는다. 장치를 명시적으로 instantiate해야 하며 자세한 방법은 `Documentation/i2c/instantiating-devices.rst`를 참조한다.
Chip ID 자동 탐지가 불가능하므로 플랫폼 설명이 bridge instance를 제공해야 한다.
===========================
Kernel driver spi-sc18is602
===========================
Supported chips:
* NXP SI18IS602/602B/603
Datasheet: https://www.nxp.com/documents/data_sheet/SC18IS602_602B_603.pdf
Author:
Guenter Roeck <[email protected]>
Description
-----------
This driver provides connects a NXP SC18IS602/603 I2C-bus to SPI bridge to the
kernel's SPI core subsystem.
The driver does not probe for supported chips, since the SI18IS602/603 does not
support Chip ID registers. You will have to instantiate the devices explicitly.
Please see Documentation/i2c/instantiating-devices.rst for details.
I2C 요구 사항과 200바이트 제한
26-39이 드라이버를 사용하려면 I2C adapter driver가 raw I2C message를 지원해야 한다. SMBus protocol만 처리할 수 있는 I2C adapter driver는 지원하지 않는다.
SC18IS602/603이 지원하는 최대 SPI message 크기는 200 byte다. 더 긴 transfer를 시작하려 하면 `-EINVAL`로 실패한다.
EEPROM read와 비슷한 큰 접근은 SPI message 하나당 200 byte 이하인 여러 chunk로 나눠야 하며, message당 data 128 byte를 권장한다. 자동으로 큰 block size를 사용하는 `cp`나 `od`는 EEPROM을 직접 읽는 데 사용할 수 없다. block size를 지정할 수 있는 `dd` 같은 프로그램을 대신 사용해야 한다.
I2C transport와 SPI message 크기 제한을 정리한다.
큰 요청을 bridge 한도 안의 여러 SPI message로 분할한다.
Usage Notes
-----------
This driver requires the I2C adapter driver to support raw I2C messages. I2C
adapter drivers which can only handle the SMBus protocol are not supported.
The maximum SPI message size supported by SC18IS602/603 is 200 bytes. Attempts
to initiate longer transfers will fail with -EINVAL. EEPROM read operations and
similar large accesses have to be split into multiple chunks of no more than
200 bytes per SPI message (128 bytes of data per message is recommended). This
means that programs such as "cp" or "od", which automatically use large block
sizes to access a device, can not be used directly to read data from EEPROM.
Programs such as dd, where the block size can be specified, should be used
instead.
요약·해설
spi-sc18is602.rst:1-39NXP SC18IS602/603 I2C-to-SPI bridge의 명시적 장치 생성, raw I2C 요구 사항과 200바이트 message 제한을 설명합니다.