^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1) ===========================
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2) Kernel driver spi-sc18is602
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 3) ===========================
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 4)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 5) Supported chips:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 6)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 7) * NXP SI18IS602/602B/603
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 8)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 9) Datasheet: https://www.nxp.com/documents/data_sheet/SC18IS602_602B_603.pdf
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 10)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 11) Author:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 12) Guenter Roeck <linux@roeck-us.net>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 13)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 14)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 15) Description
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 16) -----------
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 17)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 18) This driver provides connects a NXP SC18IS602/603 I2C-bus to SPI bridge to the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 19) kernel's SPI core subsystem.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 20)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 21) The driver does not probe for supported chips, since the SI18IS602/603 does not
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 22) support Chip ID registers. You will have to instantiate the devices explicitly.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 23) Please see Documentation/i2c/instantiating-devices.rst for details.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 24)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 25)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 26) Usage Notes
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 27) -----------
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 28)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 29) This driver requires the I2C adapter driver to support raw I2C messages. I2C
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 30) adapter drivers which can only handle the SMBus protocol are not supported.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 31)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 32) The maximum SPI message size supported by SC18IS602/603 is 200 bytes. Attempts
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 33) to initiate longer transfers will fail with -EINVAL. EEPROM read operations and
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 34) similar large accesses have to be split into multiple chunks of no more than
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 35) 200 bytes per SPI message (128 bytes of data per message is recommended). This
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 36) means that programs such as "cp" or "od", which automatically use large block
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 37) sizes to access a device, can not be used directly to read data from EEPROM.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 38) Programs such as dd, where the block size can be specified, should be used
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 39) instead.