staging: iio: addac: adt7316: document SPI interface switching sequence

The device powers up in I2C mode. Switching to SPI mode
requires sending a sequence of SPI writes as described in
the datasheet.

During this sequence, the device may still be in I2C mode,
so SPI transactions may not be recognized and can fail.
Such errors are therefore ignored.

Add a comment to clarify this behavior.

Datasheet: https://www.analog.com/en/products/adt7316.html
Reviewed-by: Maxwell Doose <m32285159@gmail.com>
Reviewed-by: Andy Shevchenko <andriy.shevchenko@intel.com>
Signed-off-by: Hungyu Lin <dennylin0707@gmail.com>
Signed-off-by: Jonathan Cameron <jic23@kernel.org>
This commit is contained in:
Hungyu Lin
2026-05-11 14:06:41 +00:00
committed by Jonathan Cameron
parent 79ab48ae4f
commit 8bf3e7a9de

View File

@@ -106,7 +106,18 @@ static int adt7316_spi_probe(struct spi_device *spi_dev)
return -EINVAL;
}
/* switch from default I2C protocol to SPI protocol */
/*
* The device powers up in I2C mode. Switching to SPI mode
* requires sending a sequence of SPI writes as described in
* the datasheet "ADT7316/ADT7317/ADT7318", Rev. B,
* in the "Serial Interface Selection" section.
*
* During this sequence, the device may still be in I2C mode,
* so SPI transactions may not be recognized and can fail.
* Such errors are therefore ignored.
*
* TL;DR: Do not change this!
*/
adt7316_spi_write(spi_dev, 0, 0);
adt7316_spi_write(spi_dev, 0, 0);
adt7316_spi_write(spi_dev, 0, 0);