From: Chi-Wen Weng <cwweng.linux@gmail.com>
To: 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-arm-kernel@lists.infradead.org, linux-iio@vger.kernel.org,
devicetree@vger.kernel.org, linux-kernel@vger.kernel.org,
chernyakin.victor.j@outlook.com, cwweng@nuvoton.com,
cwweng.linux@gmail.com
Subject: [PATCH v5 2/3] dt-bindings: iio: adc: Add Nuvoton MA35D1 EADC
Date: Tue, 17 Nov 2026 16:28:31 +0800 [thread overview]
Message-ID: <20261117082832.1551574-3-cwweng.linux@gmail.com> (raw)
In-Reply-To: <20261117082832.1551574-1-cwweng.linux@gmail.com>
From: Chi-Wen Weng <cwweng@nuvoton.com>
Add a binding for the Enhanced Analog-to-Digital Converter found on
Nuvoton MA35D1 SoCs.
The controller provides eight external analog inputs that can be used
as single-ended inputs or as the four fixed differential pairs 0-4,
1-5, 2-6 and 3-7. The VBAT input is internally connected and needs no
devicetree description.
Signed-off-by: Chi-Wen Weng <cwweng@nuvoton.com>
---
.../bindings/iio/adc/nuvoton,ma35d1-eadc.yaml | 174 ++++++++++++++++++
1 file changed, 174 insertions(+)
create mode 100644 Documentation/devicetree/bindings/iio/adc/nuvoton,ma35d1-eadc.yaml
diff --git a/Documentation/devicetree/bindings/iio/adc/nuvoton,ma35d1-eadc.yaml b/Documentation/devicetree/bindings/iio/adc/nuvoton,ma35d1-eadc.yaml
new file mode 100644
index 000000000000..1bf64913d67d
--- /dev/null
+++ b/Documentation/devicetree/bindings/iio/adc/nuvoton,ma35d1-eadc.yaml
@@ -0,0 +1,174 @@
+# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
+%YAML 1.2
+---
+$id: http://devicetree.org/schemas/iio/adc/nuvoton,ma35d1-eadc.yaml#
+$schema: http://devicetree.org/meta-schemas/core.yaml#
+
+title: Nuvoton MA35D1 Enhanced Analog-to-Digital Converter
+
+maintainers:
+ - Chi-Wen Weng <cwweng@nuvoton.com>
+
+description: >
+ The Nuvoton MA35D1 Enhanced Analog-to-Digital Converter (EADC) is a
+ 12-bit successive approximation converter with eight external analog
+ inputs and one internally connected VBAT input.
+
+ The external inputs can be used as eight single-ended channels or as
+ four fixed differential pairs: 0-4, 1-5, 2-6 and 3-7. The VBAT input
+ needs no devicetree description.
+
+ The controller provides four interrupt outputs, ADINT0 through ADINT3.
+
+properties:
+ compatible:
+ const: nuvoton,ma35d1-eadc
+
+ reg:
+ maxItems: 1
+
+ interrupts:
+ items:
+ - description: ADINT0
+ - description: ADINT1
+ - description: ADINT2
+ - description: ADINT3
+
+ clocks:
+ maxItems: 1
+
+ resets:
+ maxItems: 1
+
+ vref-supply:
+ description:
+ Optional external reference voltage connected to the VREF pin. If this
+ supply is absent, the internal reference is used.
+
+ dmas:
+ maxItems: 1
+
+ dma-names:
+ const: rx
+
+ '#io-channel-cells':
+ const: 1
+ description:
+ The cell selects the logical external EADC channel identified by the reg
+ value of the corresponding channel child node. Only channels represented
+ by child nodes are valid I/O channel specifiers.
+
+ '#address-cells':
+ const: 1
+
+ '#size-cells':
+ const: 0
+
+patternProperties:
+ '^channel@[0-7]$':
+ type: object
+ $ref: /schemas/iio/adc/adc.yaml#
+ description: >
+ External EADC channel description. The reg property identifies the
+ logical IIO channel index.
+
+ A single-ended channel may use single-channel to select an external
+ analog input independently of reg. If single-channel and diff-channels
+ are both absent, the external analog input is selected by reg.
+
+ A differential channel uses diff-channels to select one of the fixed
+ hardware input pairs: 0-4, 1-5, 2-6 or 3-7. Each single-ended input
+ and each differential input pair may be described at most once.
+
+ properties:
+ reg:
+ maximum: 7
+
+ single-channel:
+ maximum: 7
+
+ diff-channels:
+ oneOf:
+ - items:
+ - const: 0
+ - const: 4
+ - items:
+ - const: 1
+ - const: 5
+ - items:
+ - const: 2
+ - const: 6
+ - items:
+ - const: 3
+ - const: 7
+
+ additionalProperties: false
+
+required:
+ - compatible
+ - reg
+ - interrupts
+ - clocks
+ - resets
+ - '#io-channel-cells'
+ - '#address-cells'
+ - '#size-cells'
+
+anyOf:
+ - required:
+ - channel@0
+ - required:
+ - channel@1
+ - required:
+ - channel@2
+ - required:
+ - channel@3
+ - required:
+ - channel@4
+ - required:
+ - channel@5
+ - required:
+ - channel@6
+ - required:
+ - channel@7
+
+additionalProperties: false
+
+examples:
+ - |
+ #include <dt-bindings/clock/nuvoton,ma35d1-clk.h>
+ #include <dt-bindings/interrupt-controller/arm-gic.h>
+ #include <dt-bindings/interrupt-controller/irq.h>
+ #include <dt-bindings/reset/nuvoton,ma35d1-reset.h>
+
+ soc {
+ #address-cells = <2>;
+ #size-cells = <2>;
+
+ adc@40430000 {
+ compatible = "nuvoton,ma35d1-eadc";
+ reg = <0x0 0x40430000 0x0 0x10000>;
+ interrupts = <GIC_SPI 65 IRQ_TYPE_LEVEL_HIGH>,
+ <GIC_SPI 66 IRQ_TYPE_LEVEL_HIGH>,
+ <GIC_SPI 67 IRQ_TYPE_LEVEL_HIGH>,
+ <GIC_SPI 68 IRQ_TYPE_LEVEL_HIGH>;
+ clocks = <&clk EADC_GATE>;
+ resets = <&sys MA35D1_RESET_EADC0>;
+
+ #io-channel-cells = <1>;
+ #address-cells = <1>;
+ #size-cells = <0>;
+
+ channel@0 {
+ reg = <0>;
+ single-channel = <2>;
+ };
+
+ channel@1 {
+ reg = <1>;
+ diff-channels = <0 4>;
+ };
+ };
+ };
+
+...
--
2.25.1
next prev parent reply other threads:[~2026-11-17 8:29 UTC|newest]
Thread overview: 6+ messages / expand[flat|nested] mbox.gz Atom feed top
2026-11-17 8:28 [PATCH v5 0/3] iio: adc: Add Nuvoton MA35D1 EADC support Chi-Wen Weng
2026-11-17 8:28 ` [PATCH v5 1/3] dt-bindings: iio: adc: Fix channel property validation Chi-Wen Weng
2026-11-17 8:28 ` Chi-Wen Weng [this message]
2026-11-17 8:42 ` [PATCH v5 2/3] dt-bindings: iio: adc: Add Nuvoton MA35D1 EADC sashiko-bot
2026-11-17 8:28 ` [PATCH v5 3/3] iio: adc: Add Nuvoton MA35D1 EADC driver Chi-Wen Weng
2026-11-17 9:43 ` Andy Shevchenko
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20261117082832.1551574-3-cwweng.linux@gmail.com \
--to=cwweng.linux@gmail.com \
--cc=andy@kernel.org \
--cc=chernyakin.victor.j@outlook.com \
--cc=conor+dt@kernel.org \
--cc=cwweng@nuvoton.com \
--cc=devicetree@vger.kernel.org \
--cc=dlechner@baylibre.com \
--cc=jic23@kernel.org \
--cc=krzk+dt@kernel.org \
--cc=linux-arm-kernel@lists.infradead.org \
--cc=linux-iio@vger.kernel.org \
--cc=linux-kernel@vger.kernel.org \
--cc=nuno.sa@analog.com \
--cc=robh@kernel.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.