From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from mail-pf1-f175.google.com (mail-pf1-f175.google.com [209.85.210.175]) (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 AA0EF21FF4A for ; Thu, 4 Dec 2025 15:30:44 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.210.175 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1764862246; cv=none; b=NAc9uQSqfa0UXbBwPoKK/PLEVyyZeZUtFDitgLUdyaGf2Pjv2w+5BtXMvRPCT4RIwM7KhMIAz2xUl9Mg22YhEXMu+6PI3a9Htmng8PSpQrh1a3Vi2RXUXMojbL5UfcBPo8rNYNlfwZatj/KElYhV9Q7yixTQFFnA4TUQ/XlEqLY= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1764862246; c=relaxed/simple; bh=Zm9ieslCALH/z4AjjiHUD1iIfB2/hgCbdZHjkZ+mjpg=; h=Date:From:To:Cc:Subject:Message-ID:References:MIME-Version: Content-Type:Content-Disposition:In-Reply-To; b=asf88gtM+y7Qjl65qOPUdaLUCUEI2MWdOvJeAUj2lp7DTe8JtedIJtuXGvQuwE9VJ6nInIS0kOQnOQbvlU+Zh8Y/36yLLvcfkpH7TvSymzNAu8tvxELDpsMYy98tVppZaquCbi8pdepkK3ILISxGeqSwkh593972F8+U+5FntoA= 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=XIpmek74; arc=none smtp.client-ip=209.85.210.175 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="XIpmek74" Received: by mail-pf1-f175.google.com with SMTP id d2e1a72fcca58-7ba55660769so933345b3a.1 for ; Thu, 04 Dec 2025 07:30:44 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1764862244; x=1765467044; darn=vger.kernel.org; h=in-reply-to:content-disposition:mime-version:references:message-id :subject:cc:to:from:date:from:to:cc:subject:date:message-id:reply-to; bh=4eYlycY1hylOTB5YUsmJJW41uY2q4hI0Kj0UWi48gjk=; b=XIpmek74Xd0B78Gu4v2qCnnpgD0WUvFTbGg5TfdL1GtbGpzCTbtk9lAv5s43ivTSj7 iaY3yLYTaw2Mo0Why5fDcmzpdA8dqO8InhRTQd6PZYNdTM+BHnhfOxxULWsguqY3pCMa dnMHwdX9RwAFSx7P/ngSaLdLRilOdfT1HTSjBMWkN9hmMHEAsdGV4Tfv/X+ow9QYkJGD omRtLRlAY0MkiOsU3dM/xDOc7guqm9bgbzNvPxdbbj5gQ2jlv2Uu6G0zmRyUuDQcR1fq wGlmqzENa38LMxUb9Hkf/En3tHcRjLRtsUJBFurmT9iQs5VEkfwZFj153osaqroIeWZE HKYg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1764862244; x=1765467044; h=in-reply-to:content-disposition:mime-version:references:message-id :subject:cc:to:from:date:x-gm-gg:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=4eYlycY1hylOTB5YUsmJJW41uY2q4hI0Kj0UWi48gjk=; b=GhzXNCTqm0pTN+CCgNm8WVx67Xs8VNJlGLvShbPiBJ1Jer5++dTOUopwvqlPMp0ddA K9/0hZsaqQer6VX0fbw4z02qHBkuZJ0abCttc4/X7l2DAjJz9V91qkrbtw+PvrkE2nkO YVjxdLmfKI51y3aDJE8z/YNvJUQ7I7iAt0aBkcxqzY65GXvLoya4iXe/bdEMknrEJN73 e2HwwEmz0xnjhaE1IZpvxfR68g6wNP2E5/+NLfCmvm9KDVRFPj/lP6xskiZ+p7QzXR1J Xah20vlQCDPVsHgO0RBbH877qU1mAVzU8T/nAgpxflWgWGdKtbJ5h7tTQzs3xVrOQ50s 4RqA== X-Forwarded-Encrypted: i=1; AJvYcCVn4VXb3N1mIUCC64JxNh1YoVncFYZgP0jEEHeQ2EtS4wgcGwFy8gx0rfzTUJO89JyyVGMN/kwg1mPMYTw=@vger.kernel.org X-Gm-Message-State: AOJu0YyoXVFL9pcmY+h7JwrAKZD5XY23KsLnEzU1GN42k37dn5unSi8Y jLxrMaX9bQLSYCnMtmMdpJXfg5WJxR+Z0f4Rd9AdsHgxww0tzC9DcuiaeRyrrzKl X-Gm-Gg: ASbGncukxHlkeALvYevuhR7BYeek+xVq7IhHaRzx9pkpK9np7KbCBOeyzWSOhzLp4uu nkzjcvqK8sO/+kEumth03ZCKdNopH7A8aLwZujJnS53Gp1nZx+llyMT7+3h9IBGIFIaa5wUD4RQ ic1J78FN+Xdytf5LuSE1f0ecT5ZTKa+dXOyX4vH8M7WeAH1lywRRrFufaKCZVhkH4N4JTIZURsz Mqjx9xUB633yMaXFatz7tt3fTycJ25tm5dH3OhFTZSbB+SpVSf9SVsJZf7O8Kfk0UcLvpR20iCT zKStABmGmxWCNVqfnRbtP0ETR6uYL0qGTKaCG5rns/wCHcOFQmMe2QZ5NhvA0EXrB38zLUHgG4+ uqYIuEaJbXjMoCRG3za5Q6qDaf+cF15HSQ5Ir4KC5n5nWPOCsk3BUnfC2GyOpUXNuYuW4rSdwJU CRQ/yGZ8Gsbr2CzjMHDpc= X-Google-Smtp-Source: AGHT+IGUuxpLqmy4omgL7DayDrCXKB4XMbmLpb2m72M6WfzhzKd/lpFRyfBDddrHoUtvpi7znSaRDQ== X-Received: by 2002:a05:7022:e98d:b0:11b:ceee:a469 with SMTP id a92af1059eb24-11df0c2fc19mr4186449c88.22.1764862243599; Thu, 04 Dec 2025 07:30:43 -0800 (PST) Received: from localhost ([2804:30c:941:4500:2e30:10b5:73b0:4b74]) by smtp.gmail.com with UTF8SMTPSA id a92af1059eb24-11df7552211sm8769605c88.1.2025.12.04.07.30.42 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 04 Dec 2025 07:30:42 -0800 (PST) Date: Thu, 4 Dec 2025 12:32:16 -0300 From: Marcelo Schmitt To: Tomas Melin Cc: Marcelo Schmitt , linux-iio@vger.kernel.org, devicetree@vger.kernel.org, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, jic23@kernel.org, nuno.sa@analog.com, dlechner@baylibre.com, andy@kernel.org, Michael.Hennerich@analog.com, robh@kernel.org, krzk+dt@kernel.org, conor+dt@kernel.org, corbet@lwn.net Subject: Re: [PATCH v3 3/3] Docs: iio: Add AD4134 Message-ID: References: <69b230190abb4cd76ad9eb25e2bde51caaa23d9a.1764708608.git.marcelo.schmitt@analog.com> <19d5c51d-41f3-446a-aced-5be2fe6ec0d2@vaisala.com> Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <19d5c51d-41f3-446a-aced-5be2fe6ec0d2@vaisala.com> On 12/03, Tomas Melin wrote: > Hi, > > On 02/12/2025 22:55, Marcelo Schmitt wrote: > > Add initial documentation for the ad4134 IIO driver. > > I wonder is there some information in here that is not readily available > in the device datasheet? After all, isn't idea with this file to > document peculiarities that are not easily found elsewhere? You are correct, these docs are mostly from data sheet info. The main idea of having the doc is to make clear what peripheral connection schema is currently supported. Because AD4134 is both flexible and somewhat extensible in the way it can be connected to the host, we could have different wiring configurations, for example +-------------+ +----------------------+ | DATA HOST | | AD4134 | | | | | | | |Data interface DOUT0 |----------------------------------->| GPI0 | |for ADC data DOUT1 |----------------------------------->| GPI1 | |read back DOUT2 |----------------------------------->| GPI2 | | DOUT3 |----------------------------------->| GPI3 | | DCLK |<--------------+ +---------->| GPI4 | | ODR |<------------+ | | +-------->| GPI5 | | | | | | | +------>| GPI6 | | | | | | | | +---->| GPI7 | | SPI interface CS |<-------+ | +--------|-|-|-|-----| DCLK | | for register SCLK |<-----+ | | | | | | | | | access SDI |<---+ | | | | | | | | TRIGGER | | SDO |--+ | | | | | | | | +-------------+ +----------------------+ | | | | +----------|-|-|-|---------+ | | | +---------------+ | | | | | +-------------------+ | | | +-----------------------+ | +---------------------------+ or even with two devices [1]. [1]: https://lore.kernel.org/linux-iio/aRIIDTUR5Pyz1Rxi@debian-BULLSEYE-live-builder-AMD64/ That is not a current use case but it could be possible. I think it's likely we will need extra software to support those cases and, when we get to that, we would be adding more diagrams to this doc. Still, no strong opinion, we can alternatively add the doc only when we get to those more complex cases. I'll follow reviewers' preferences if you or anybody else express any. Best regards, Marcelo