From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from mail-dl1-f68.google.com (mail-dl1-f68.google.com [74.125.82.68]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 933E235B644 for ; Sun, 10 May 2026 08:11:00 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=74.125.82.68 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1778400661; cv=none; b=RTN0C1K8yiT+O4pkQfZxK6Y8D+VP3YQ4bnl0Z6p3vSj4cDF9FGjklxxlblT1CEhoRaasz3b/9gmRl3ARFrwbct5EDozFoZhL4swPz5HWAcyf8/FcZabWzLBwSJPMvnFpHuKLIXEu7Piu4nqqDOAVtn5gNF9o9OmOWiPvhjeTHkw= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1778400661; c=relaxed/simple; bh=qV39xNtfL4QWl44+opgnZA/dVGnBNDm/6My8Yisoxac=; h=From:To:Cc:Subject:Date:Message-Id:MIME-Version; b=e6yCcN5ZPvchdAE7RWVvndZBtPIRz2XOhO7P13ExdNQvtVstdpRH6PDClSTie4L+fQOGxkd5e5aujDXW/zyktsyIWhf8fCUh4+akZphr/DH1+GoCLjuTjBVixuXfJLBFdHBmcAIy+fwjKb0eQ9q9LHGG6m2JJXpHBkca8/S7nng= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com; spf=pass smtp.mailfrom=gmail.com; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b=qW3a4ALG; arc=none smtp.client-ip=74.125.82.68 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=gmail.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b="qW3a4ALG" Received: by mail-dl1-f68.google.com with SMTP id a92af1059eb24-12c19d23b19so5660716c88.0 for ; Sun, 10 May 2026 01:11:00 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20251104; t=1778400660; x=1779005460; darn=vger.kernel.org; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:from:to:cc:subject:date:message-id:reply-to; bh=bIvPRt9dlizeEm93tbtAZzvWwvO1azBOrboHx0X4jRw=; b=qW3a4ALGwDPT7Jkm5jDpnDIbkNo6znjZS/sC64xJ0u7nMQvsLb4MaJfDuwDtl/kjE7 boy1iT74PXqRp7efX7S5jt4UyXP4mtO9is4pywKuFlY1oY0ZMsfJDxk0Gp98Fml+ggho 62JG4WqxdOVk5lyg1aOm63T0ufw40Iva8KqoN/6+zeNzbrfxInbt0BRGkU8mpO8DnjVh EdhOVz7jr2V1YQS4IxZhlrSCbWHWA0/32Jp24MneF6OhXykQxUchMKVMVLc32SF77xbX AENrdZWl/pbNu/5MuDmhN/wIckwcMxAH8Zy4hpK5WCO5RNZz79fFlD76qGLxI4u0VEf+ BVKA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20251104; t=1778400660; x=1779005460; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:x-gm-gg:x-gm-message-state:from:to:cc:subject:date :message-id:reply-to; bh=bIvPRt9dlizeEm93tbtAZzvWwvO1azBOrboHx0X4jRw=; b=fIzbdqPvCLChRscAIi9rgqrd0I3tb7XF2TXFVhmoF3czOW9wtJwsW2rl5Pje8pO9hR 90sA5YyCrp2ou4rnGg42y+/AejQzjkzJuf5y+pZSKaTOlAYrbgTl/gUr8ZD8IJ2jWGA1 cqiBQQInrHhWAwgWg002CtUYnIUr4vrmA1fhJDWjpCeBBd7jIy7HWrb9k1HulU1pwJlF u3fM0EvPLEOoPk22I1lVOy1T0HDavzOd006u0/5OymApTPYZ/ct9PHMvlZEbPvTfwzmw Znz+bie9gT+Y+/gNkBrBeTzdSy5lun8jf35yBrfEZIvULPExrphEmV0OHqRlhOTQEkQo ml9g== X-Forwarded-Encrypted: i=1; AFNElJ87qsEGGMpMB6whAGSViPmDJoTOOFYNp24j/SDcU/7WO+roTPvqYuQ0Icm1/1VSQia1JgtOrN6TDGZ5GSE=@vger.kernel.org X-Gm-Message-State: AOJu0Yznmj5TDBK2qccrEntTNlH0LBPZv5qcVgfS5O2C8CvvjVE50t0q w+w/w/s1XousJzSdFFSntk2Eo3eGMuqTTdUZRPo2knMU23llnn3jH3Kq X-Gm-Gg: Acq92OE2UIr5DqVCfpgNAuvySyIV2zGCBl0W48nd4oHNT5lTQX2/jhIvI3f+csRVj/P RefJ1pkNf0N4dhf9RvXiphNfMRpJ0kw93h6fEokuobwFOpKrEeCVjWyfkDmHsrUpcPplwbNjPxT Q8vzK7veTKwMde9oyxeA7rKtf5Q/peySmFa/9l1f9MrwG9aZtXh+UsMu8CSCla6VYc608vsq2RM XEfdjPhqCCYjPhJfLUcRlkOXW8DotsLxvZmPHj+RpbRPDY4UYMtpKJKTXMVOBiJx+B/BE/LqfCa D+AE5sdIGP/Zyu1mscjO7pvdYIoBlZqPGUFxZUPXKWDUjXum72V22t94KKrXXKdGHy5ARXgcWxK E2DUnovX1T2GrPQAiDWOIqzR9X49tzKxm2dooiGs3mePxpGwRLUPUs4Rvb6GJiOW4ub9rxF+c14 YTx4XTXxISvgcfvU8a9qWI/HQ7abalK5MHGFaQASpQmnpePZDxdE+osjf1Qc/sZ6yRSA== X-Received: by 2002:a05:7022:4a9:b0:12d:de3e:be88 with SMTP id a92af1059eb24-131a69f2f19mr8868177c88.36.1778400659598; Sun, 10 May 2026 01:10:59 -0700 (PDT) Received: from localhost.localdomain ([76.32.119.210]) by smtp.gmail.com with ESMTPSA id a92af1059eb24-132787673ffsm12053688c88.15.2026.05.10.01.10.58 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sun, 10 May 2026 01:10:59 -0700 (PDT) From: Hungyu Lin To: jic23@kernel.org, lars@metafoo.de, Michael.Hennerich@analog.com, gregkh@linuxfoundation.org Cc: dlechner@baylibre.com, nuno.sa@analog.com, andy@kernel.org, linux-iio@vger.kernel.org, linux-staging@lists.linux.dev, linux-kernel@vger.kernel.org, Hungyu Lin Subject: [PATCH v2] staging: iio: addac: adt7316: document SPI interface switching sequence Date: Sun, 10 May 2026 08:10:41 +0000 Message-Id: <20260510081041.85880-1-dennylin0707@gmail.com> X-Mailer: git-send-email 2.34.1 Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: 8bit 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 expected and are ignored. Add a comment to clarify this behavior. Signed-off-by: Hungyu Lin --- Changes in v2: - Add datasheet reference - Add TL;DR note drivers/staging/iio/addac/adt7316-spi.c | 12 +++++++++++- 1 file changed, 11 insertions(+), 1 deletion(-) diff --git a/drivers/staging/iio/addac/adt7316-spi.c b/drivers/staging/iio/addac/adt7316-spi.c index f91325d11394..980532b7fa1e 100644 --- a/drivers/staging/iio/addac/adt7316-spi.c +++ b/drivers/staging/iio/addac/adt7316-spi.c @@ -106,7 +106,17 @@ 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 ("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 expected and are 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); -- 2.34.1