From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from mail-dy1-f195.google.com (mail-dy1-f195.google.com [74.125.82.195]) (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 048052C11F3 for ; Sat, 9 May 2026 02:27:37 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=74.125.82.195 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1778293660; cv=none; b=QEwF+ywfWjbz5CWrt0OfXDd+jpK3Xl4ra9WHo553FGD1PhFH2MR7DTatoNEa0PBff0cB/XfpQYX2aKdTEv8NuTl/44FepLIDNLS5AZyac5MOcjuBXprGABD+BNA2ZzxRm2UZQGK3iod6v7N9jfMUEvb9miG6OQinZbs6R5yhFHA= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1778293660; c=relaxed/simple; bh=FsdW0xSERWjE0FiMpistTS4WOSSmY49coVvgl6iWZcs=; h=From:To:Cc:Subject:Date:Message-Id:In-Reply-To:References: MIME-Version; b=r6/BjC8YYzjm4k6K9gXAX9e4beMaYgOOspJObB2AM/k2Bh4WXjJD0HZHCnJOCVhlxMOaV8gdACyNHEBzpO5ogLhrKLYfIGmX5az6rcg7ffRPHa6iOZl5Mg7AdYA94JDgDjLI2V2QhA41nObnQfCEaIyotXcyjkAkB/3NxvP/Gmo= 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=O1SKj7Pg; arc=none smtp.client-ip=74.125.82.195 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="O1SKj7Pg" Received: by mail-dy1-f195.google.com with SMTP id 5a478bee46e88-2ecf9e398f4so6800069eec.1 for ; Fri, 08 May 2026 19:27:37 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20251104; t=1778293657; x=1778898457; darn=vger.kernel.org; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:from:to:cc:subject:date :message-id:reply-to; bh=ddCrhD3GWsw1VzVrN+dsBIb0LRaCdnO2vYmJAaK5Vn8=; b=O1SKj7PghhCNiCXjQ8pNgU3WsI2DaKbejDEHgqfEIHVcHgSvVdfZOJP2hg9Oqv+rsK 8/eH+9BYWlGIdCdsFWmtEOvox5CS+B2UNP5EyVfUx3yOdTDLKcZWuq1GrwY9nGZGmeJc O4+x99aXBu0pzYy4nW9P9r0pwVxJLxEvCkDRGioxiNBSnpnuk3AhgKQqgBGEUFnP3ORZ 4reT+eDOuvuNXFCl//g4R0nRkeS5RytDBMUG49w+5IBiJTqYQfR5mcVr6iVCkmFwb16m IhCDoHLNNRoFCCiqq/LBwbrqQQvCIHQF5mlxcDaulzZXGxJ87spFkZxWu/VK7SUsJ7bj Yz8g== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20251104; t=1778293657; x=1778898457; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-gg:x-gm-message-state:from :to:cc:subject:date:message-id:reply-to; bh=ddCrhD3GWsw1VzVrN+dsBIb0LRaCdnO2vYmJAaK5Vn8=; b=OgiYU4U+lwEF6xfhuFzPCnNntT+Y3KRxTy1maumYgb69vYDh/hVBZOn23kmYAXorOj VI/9R1O25aUmX3bQMcAm4Ikkk4WgEyAkJoO/WhoZCmOr8FIP2LjLsi1jxq5Lu6EjihBT ZLTyA35jEJwitwWEvwqYWmEoE6ODT/c8nMxttlWvfM5KTAtX+q7JwhuRUinqvjWY+2UJ iDJGRT5e1QTSUuKLTuPQ1lfdYLAQldkFj5GPPmmO5xkGbq1c+U/1jiUOQaP/YqK3RB86 QJU0ECwcI6aNN9nwx1Cy+G2bMdcJEia1PkUQ6jTObHvJyB1QXzKvv6j247XYkLLSLZAE +iZA== X-Forwarded-Encrypted: i=1; AFNElJ++BdcepD4SXdRHtCkgmXdAPbwu2kGfxu+7/DBcflXMdBKh6T0nc+kOQREM85BOdKqP0TbQt10Juq/z@vger.kernel.org X-Gm-Message-State: AOJu0YxfIpsXLVQvwGw9UVHeRO9a5t+04QDtzk1DxFSKc6xoLwi44xZc 9c/j1Xzc4L51bwkr5gLk+jg44jmcMmN9+YPVnyx0dn7Ooge3UyQG2UE7 X-Gm-Gg: Acq92OFKvbzhxxLrRAH//xI3zcM8zy/26AqFsRmCq6lpPEV9GlVTCmCyM+Hd/rSbAL8 iZbPYNkMj4Ez8rorPvzK5MwPKUes7qsKtrm0kjSt7EU8NfLFEwLO2v8V7F5mz8kV+KGVNb5YOWl 1T+jLTGcvQXNVcP8Nz35apWkbpDLe/Eu4kkwS4BA7uLKSp+1zU2v8suiBlwwEanv7exaksFz/di 8IpksFL3CkN0uuH9Mxlju9syc51Y5+GH94qbIB6NMjV7bBCb69I4nUfdakMm7vfcEFrp8EweUxT gQEM3bHOYFeFgEH5xaqCitppv28xGmVKr5EOL+b9siYU79AUpDHos0xMmicUcOKbpneg9PAr3v9 /bwyAOPCHSBRFkuP1RIhebqdudPmgy9UTPTO/1M1ToqL8Ime+8QEqSRVohOwQT8BgEpncily+uG vjXguS02sWIHD2LNwSV57HPdQ9Q4RFSgc4SwWWOZtxGDQb2KqVqrBm1S8= X-Received: by 2002:a05:693c:2c14:b0:2dd:6937:79c8 with SMTP id 5a478bee46e88-2f54ad730a3mr7739721eec.5.1778293657154; Fri, 08 May 2026 19:27:37 -0700 (PDT) Received: from localhost.localdomain ([76.32.119.210]) by smtp.gmail.com with ESMTPSA id 5a478bee46e88-2f88924af95sm4689640eec.30.2026.05.08.19.27.35 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 08 May 2026 19:27:36 -0700 (PDT) From: Hungyu Lin To: lars@metafoo.de, Michael.Hennerich@analog.com, jic23@kernel.org, robh@kernel.org, krzk+dt@kernel.org, conor+dt@kernel.org Cc: dlechner@baylibre.com, nuno.sa@analog.com, andy@kernel.org, linux-iio@vger.kernel.org, devicetree@vger.kernel.org, linux-kernel@vger.kernel.org, Hungyu Lin Subject: [PATCH v3 1/1] dt-bindings: iio: adc: add AD7816/AD7817/AD7818 binding Date: Sat, 9 May 2026 02:27:18 +0000 Message-Id: <20260509022718.82957-2-dennylin0707@gmail.com> X-Mailer: git-send-email 2.34.1 In-Reply-To: <20260509022718.82957-1-dennylin0707@gmail.com> References: <20260509022718.82957-1-dennylin0707@gmail.com> Precedence: bulk X-Mailing-List: devicetree@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Add Device Tree binding documentation for the Analog Devices AD7816, AD7817 and AD7818 SPI ADC devices. The AD7816 provides temperature monitoring only, while the AD7817 and AD7818 provide analog input channels with an on-chip temperature sensor. The devices use control GPIOs for RD/WR and CONVST. BUSY is required for AD7816 and AD7817 variants. Signed-off-by: Hungyu Lin --- Changes in v3: - Fix commit message to match binding requirements - Fix commit message based on input from Sanjay Chitroda --- .../bindings/iio/adc/adi,ad7816.yaml | 94 +++++++++++++++++++ 1 file changed, 94 insertions(+) create mode 100644 Documentation/devicetree/bindings/iio/adc/adi,ad7816.yaml diff --git a/Documentation/devicetree/bindings/iio/adc/adi,ad7816.yaml b/Documentation/devicetree/bindings/iio/adc/adi,ad7816.yaml new file mode 100644 index 000000000000..490e5338d7b2 --- /dev/null +++ b/Documentation/devicetree/bindings/iio/adc/adi,ad7816.yaml @@ -0,0 +1,94 @@ +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/iio/adc/adi,ad7816.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: Analog Devices AD7816/AD7817/AD7818 ADC + +maintainers: + - Hungyu Lin + +description: | + Binding for Analog Devices AD7816, AD7817 and AD7818 SPI ADCs + with on-chip temperature sensor. + + The AD7816 provides temperature monitoring only. + The AD7817 provides up to 4 analog input channels. + The AD7818 provides a single analog input channel. + +properties: + compatible: + enum: + - adi,ad7816 + - adi,ad7817 + - adi,ad7818 + + reg: + maxItems: 1 + + interrupts: + maxItems: 1 + description: + Optional interrupt line used by the device. + + rdwr-gpios: + maxItems: 1 + description: + GPIO connected to the RD/WR pin used to control read/write cycles. + + convert-gpios: + maxItems: 1 + description: + GPIO connected to the CONVST pin used to trigger conversions. + + busy-gpios: + maxItems: 1 + description: + GPIO connected to the BUSY pin indicating conversion status. + +required: + - compatible + - reg + - rdwr-gpios + - convert-gpios + +allOf: + - $ref: /schemas/spi/spi-peripheral-props.yaml# + + - if: + properties: + compatible: + contains: + enum: + - adi,ad7816 + - adi,ad7817 + then: + required: + - busy-gpios + else: + properties: + busy-gpios: false + +unevaluatedProperties: false + +examples: + - | + gpio0: gpio { + gpio-controller; + #gpio-cells = <2>; + }; + + spi { + #address-cells = <1>; + #size-cells = <0>; + + adc@0 { + compatible = "adi,ad7816"; + reg = <0>; + spi-max-frequency = <5000000>; + rdwr-gpios = <&gpio0 1 0>; + convert-gpios = <&gpio0 2 0>; + busy-gpios = <&gpio0 3 0>; + }; + }; -- 2.34.1