From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from mail-pl1-f171.google.com (mail-pl1-f171.google.com [209.85.214.171]) (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 7EFE870809 for ; Mon, 29 Sep 2025 05:59:27 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.214.171 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1759125569; cv=none; b=uxsIgg505itfO5yjZS7sYLJ+v2ZLvrYqnwiAO6ft6wTGCmxdmo1YPLZEyAHlPKNVwPzN6Izi3k7dfklvMgJBYxmxc+DbvLffMNi1NvbP0sCtKIdunVI2V8L/mMtM+arbOSbNpH6EuxC+UzokPOHgWvde9z61cP0p0vm5BX37ulI= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1759125569; c=relaxed/simple; bh=Hpbsw+Og6s9yKgaYsaTWo582+rMNy7Y/tZsPq9IdEuo=; h=From:To:Cc:Subject:Date:Message-Id:MIME-Version:Content-Type; b=V2eihywdepgqwYgh1MKyZ3gwf8EVdLvnbXKNfi57oyCOsuV2wryOiEDHvguPRjpP8Zq0gObZ8mVdNsn96b2naUMfY1aJGGNeQwfC+0RXLzJ7Mgo8mbjWjyQCBqbth68syOm9aLNVcMfPSUiUEb+VIz82A5lk2KdkAzFIcJqp2qs= 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=Z3TUobub; arc=none smtp.client-ip=209.85.214.171 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="Z3TUobub" Received: by mail-pl1-f171.google.com with SMTP id d9443c01a7336-27eed7bdfeeso36826845ad.0 for ; Sun, 28 Sep 2025 22:59:27 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1759125567; x=1759730367; 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=2oJNfpk8MW5Bw6kfx3xSXkQNJdPPXDdao0EQbasGVIk=; b=Z3TUobubZ5/2G8ZssS8Y6Sx83eC5njXJ7KyDwNALkOc/zhjYhK2Csr8J+Wcab1j6+y T5obBZeCMm11a7PGgBFcpjtdbbfJSCQ1K3DxY4q7Y7cM+3Gr86KnyiYOFAB3JJbyX892 I/LsuHnW4hy10Rm3xoAy5i7487ghvNKl4VR6XYOZt/L/avMGc032DjD0rBaIm7QQ/5Of Ndz/vwoYxw45lXBitNz4aNhTKmLFixJrV6SBPbso6A3dcHS7VswPELYhcvCPOjsiAaA1 xuRNA2bZODUmWMgQK2GiVDN04Y3Hn3E0k5JX3rNnALAmVctTd3jUo2SOz5Ui4MVCocg5 MJqw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1759125567; x=1759730367; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:x-gm-message-state:from:to:cc:subject:date:message-id :reply-to; bh=2oJNfpk8MW5Bw6kfx3xSXkQNJdPPXDdao0EQbasGVIk=; b=GNZ3KZzE7nqPYkutJxD0udgJ1vNMAzoYTS4rD+1EWB9D1vKSeS4ftALmbKYzkGz8Qm JU5AfcwZlmRf82cAnzOtLZkSV34KR4oa2o8u3qwRU2g/rjEz6O9HxY0XII+lginU9k96 vdJngK2kqIq3adEoWQyvxZWJ/6s9hl6TgITHU620KzdVb24p4eC+jzjRWPVkR/q789Y/ K7Pb5EiEgurSz33f7gemH2u4iyvM7IhPc2sNdJ2iqvVWJ3m79W8SRNm37upnMQDFBPnp AZBU5Hts/yAsEYxb9dDGJsCfW8VJ2NhxDdubQ1M07baPVk97ZDOSe4oCQJAG1UOMwOti SALw== X-Forwarded-Encrypted: i=1; AJvYcCUa5PE+NMNVHdiyyj6720OV2PUBH1PHRn6od3VmU76eGSOstWH6FBDm1npbRtU4PVELmr+Dknv6504v4Ys=@vger.kernel.org X-Gm-Message-State: AOJu0YzyvvbfWg4x1aWiqcVglaJ9io4G5M94g8zQK54ZwnqbOHiJa4vS ImFoc8TyEfPS3t27TiVYyYyst2Fr6yb5FExmoBwkLWtnBK2CHN0TQqSl X-Gm-Gg: ASbGncvRIuxyOZXfn2asneaPNoQfuVYKvPTXoRZqdSGo9HhB5yoTu7roCsgPBeirrg1 9MHDNgDn09xwJsNzWBlb8zCfIs73ujgKoUhGxfjp4qIxg/9+CNpOXLdETVoAHJoae8pvChpJgZg okeyUuwwvqoaJbmdStcM2PeVnuXc4l7SGCQXf1NVNbolH7BZNPj/jiIwoLEicOu5CHwnjF9VOv7 0gD0iPbeC9MLSoJBoNuK+WJgLU8iRgB2d63CgLMQLYiY5VJJjNgaMuYPy8yZxmLzpk+Z79ng5GI rPzxJ9qeuhzHXZQMvkLdW0wWUhN9yPUKdzVcPcOm43lSZsLie/JmT6CuDCxagQlTCUrfEzv20RQ W8WGcz3qwAUyTyCucUhUvtOgX8RXn7A+7v3gJeTxb1JvEqw== X-Google-Smtp-Source: AGHT+IEV93Vc2c3TbwmaCoYkatVxk5uPZc3HoZY/BjqH2ZibvSGmWfVd6Kj7GpzQeMwI8HqVi8okAw== X-Received: by 2002:a17:902:e741:b0:24c:db7c:bc34 with SMTP id d9443c01a7336-27ed6df3f40mr178509295ad.13.1759125566572; Sun, 28 Sep 2025 22:59:26 -0700 (PDT) Received: from localhost.localdomain ([2804:7f5:b08b:fda4:f56e:95d0:3775:a428]) by smtp.gmail.com with ESMTPSA id d9443c01a7336-27ed69bc295sm119371015ad.123.2025.09.28.22.59.20 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sun, 28 Sep 2025 22:59:26 -0700 (PDT) From: Marilene Andrade Garcia To: linux-iio@vger.kernel.org, linux-kernel@vger.kernel.org, devicetree@vger.kernel.org Cc: Marilene Andrade Garcia , Kim Seer Paller , Lars-Peter Clausen , Michael Hennerich , Jonathan Cameron , David Lechner , =?UTF-8?q?Nuno=20S=C3=A1?= , Andy Shevchenko , Rob Herring , Krzysztof Kozlowski , Conor Dooley , Marcelo Schmitt , Marcelo Schmitt , Ceclan Dumitru , Jonathan Santos , Dragos Bogdan Subject: [PATCH v12 1/3] dt-bindings: iio: adc: add max14001 Date: Mon, 29 Sep 2025 02:58:38 -0300 Message-Id: <961e5351afa408e69541b60ec75852fbbd1ddd24.1759121938.git.marilene.agarcia@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-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Add device-tree documentation for MAX14001/MAX14002 ADCs. The MAX14001/MAX14002 are isolated, single-channel analog-to-digital converters with programmable voltage comparators and inrush current control optimized for configurable binary input applications. They share the same features, but in the MAX14001 the inrush trigger threshold, current magnitude, and current duration are all programmable, whereas in the MAX14002 these parameters are fixed. Co-developed-by: Kim Seer Paller Signed-off-by: Kim Seer Paller Signed-off-by: Marilene Andrade Garcia --- Hello maintainers, Thank you for reviewing v11 and for your suggestions. I believe I have addressed the requested code changes in this v12. Notes: - I have not removed the “|” in the interrupt descriptions because the descriptions were changed as requested, and I think they now need to keep it. Changes since v11: - Added spi-lsb-first in the example. - Improved the interrupt descriptions. Best regards, Marilene Andrade Garcia .../bindings/iio/adc/adi,max14001.yaml | 89 +++++++++++++++++++ MAINTAINERS | 8 ++ 2 files changed, 97 insertions(+) create mode 100644 Documentation/devicetree/bindings/iio/adc/adi,max14001.yaml diff --git a/Documentation/devicetree/bindings/iio/adc/adi,max14001.yaml b/Documentation/devicetree/bindings/iio/adc/adi,max14001.yaml new file mode 100644 index 000000000000..7b3a72dd0b0d --- /dev/null +++ b/Documentation/devicetree/bindings/iio/adc/adi,max14001.yaml @@ -0,0 +1,89 @@ +# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause) +# Copyright 2023-2025 Analog Devices Inc. +# Copyright 2023 Kim Seer Paller +# Copyright 2025 Marilene Andrade Garcia +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/iio/adc/adi,max14001.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: Analog Devices MAX14001-MAX14002 ADC + +maintainers: + - Kim Seer Paller + - Marilene Andrade Garcia + +description: | + Single channel 10 bit ADC with SPI interface. + Datasheet can be found here + https://www.analog.com/media/en/technical-documentation/data-sheets/MAX14001-MAX14002.pdf + +$ref: /schemas/spi/spi-peripheral-props.yaml# + +properties: + compatible: + oneOf: + - const: adi,max14002 + - items: + - const: adi,max14001 + - const: adi,max14002 + + reg: + maxItems: 1 + + spi-max-frequency: + maximum: 5000000 + + vdd-supply: + description: + Isolated DC-DC power supply input voltage. + + vddl-supply: + description: + Logic power supply. + + refin-supply: + description: + ADC voltage reference supply. + + interrupts: + minItems: 1 + items: + - description: | + cout: comparator output signal that asserts high on the COUT pin + when ADC readings exceed the upper threshold and low when readings + fall below the lower threshold. + - description: | + fault: when fault reporting is enabled, the FAULT pin is asserted + low whenever one of the monitored fault conditions occurs. + + interrupt-names: + minItems: 1 + items: + - const: cout + - const: fault + +required: + - compatible + - reg + - vdd-supply + - vddl-supply + +unevaluatedProperties: false + +examples: + - | + spi { + #address-cells = <1>; + #size-cells = <0>; + + max14001: adc@0 { + compatible = "adi,max14001", "adi,max14002"; + reg = <0>; + spi-max-frequency = <5000000>; + spi-lsb-first; + vdd-supply = <&vdd>; + vddl-supply = <&vddl>; + }; + }; +... diff --git a/MAINTAINERS b/MAINTAINERS index f090c2f6e63a..1e1a30f77a0c 100644 --- a/MAINTAINERS +++ b/MAINTAINERS @@ -14922,6 +14922,14 @@ S: Orphan F: drivers/video/fbdev/matrox/matroxfb_* F: include/uapi/linux/matroxfb.h +MAX14001/MAX14002 IIO ADC DRIVER +M: Kim Seer Paller +M: Marilene Andrade Garcia +L: linux-iio@vger.kernel.org +S: Maintained +W: https://ez.analog.com/linux-software-drivers +F: Documentation/devicetree/bindings/iio/adc/adi,max14001.yaml + MAX15301 DRIVER M: Daniel Nilsson L: linux-hwmon@vger.kernel.org base-commit: b9700f87939f0f477e5c00db817f54ab8a97702b -- 2.34.1