On Thu, Jun 18, 2026 at 02:27:24PM +0100, Rodrigo Alencar wrote: > DT-bindings for AD9910, a 1 GSPS DDS with 14-bit DAC. It includes > configurations for clocks, DAC current, reset and basic GPIO control. > > Signed-off-by: Rodrigo Alencar <[email protected]> > --- > .../bindings/iio/frequency/adi,ad9910.yaml | 189 > +++++++++++++++++++++ > MAINTAINERS | 7 + > 2 files changed, 196 insertions(+) > > diff --git a/Documentation/devicetree/bindings/iio/frequency/adi,ad9910.yaml > b/Documentation/devicetree/bindings/iio/frequency/adi,ad9910.yaml > new file mode 100644 > index 000000000000..a78fe33ba21f > --- /dev/null > +++ b/Documentation/devicetree/bindings/iio/frequency/adi,ad9910.yaml > @@ -0,0 +1,189 @@ > +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) > +%YAML 1.2 > +--- > +$id: http://devicetree.org/schemas/iio/frequency/adi,ad9910.yaml# > +$schema: http://devicetree.org/meta-schemas/core.yaml# > + > +title: Analog Devices AD9910 Direct Digital Synthesizer > + > +maintainers: > + - Rodrigo Alencar <[email protected]> > + > +description:
You need '>' to preserve paragraphs. > + The AD9910 is a 1 GSPS direct digital synthesizer (DDS) with an integrated > + 14-bit DAC. It features single tone mode with 8 configurable profiles, > + a digital ramp generator, RAM control, OSK, and a parallel data port for > + high-speed streaming. > + > + https://www.analog.com/en/products/ad9910.html > + > +properties: > + compatible: > + const: adi,ad9910 > + > + reg: > + maxItems: 1 > + > + spi-max-frequency: > + maximum: 70000000 > + > + clocks: > + minItems: 1 > + items: > + - description: Reference clock (REF_CLK). > + - description: Optional synchronization clock (SYNC_IN). > + > + clock-names: > + minItems: 1 > + items: > + - const: ref_clk > + - const: sync_in > + > + '#clock-cells': > + const: 1 > + > + clock-output-names: > + minItems: 1 > + maxItems: 3 > + items: > + enum: [ sync_clk, pdclk, sync_out ] > + > + interrupts: > + minItems: 1 > + maxItems: 2 > + description: > + Requires interrupt-names property with the same number of items. The > + supported interrupts are 'drover' (digital ramp generator limit) and > + 'ram_swp_ovr' (end of RAM sweep). > + > + interrupt-names: > + minItems: 1 > + maxItems: 2 > + items: > + enum: [ drover, ram_swp_ovr ] > + > + dvdd-io33-supply: > + description: 3.3V Digital I/O supply. > + > + avdd33-supply: > + description: 3.3V Analog DAC supply. > + > + dvdd18-supply: > + description: 1.8V Digital Core supply. > + > + avdd18-supply: > + description: 1.8V Analog Core supply. > + > + reset-gpios: > + description: > + GPIOs controlling the Main Device reset. > + > + io-reset-gpios: > + maxItems: 1 > + description: > + GPIO controlling the I/O_RESET pin. > + > + powerdown-gpios: > + maxItems: 1 > + description: > + GPIO controlling the EXT_PWR_DWN pin. > + > + update-gpios: > + maxItems: 1 > + description: > + GPIO controlling the I/O_UPDATE pin. > + > + profile-gpios: > + minItems: 3 > + maxItems: 3 > + description: > + GPIOs controlling the PROFILE[2:0] pins for profile selection. > + > + sync-err-gpios: > + maxItems: 1 > + description: > + GPIO used to read SYNC_SMP_ERR pin status. > + > + lock-detect-gpios: > + maxItems: 1 > + description: > + GPIO used to read PLL_LOCK pin status. > + > + adi,pll-enable: > + type: boolean > + description: > + Indicates that a loop filter is connected and the internal PLL is > enabled. > + Often used when the reference clock is provided by a crystal or by a > + single-ended on-board oscillator. > + > + adi,charge-pump-current-microamp: > + minimum: 212 > + maximum: 387 > + default: 212 > + description: > + PLL charge pump current in microamps. Only applicable when the internal > + PLL is enabled. The value is rounded to the nearest supported step. > This > + value depends mostly on the loop filter design. > + > + adi,refclk-out-drive-strength: > + $ref: /schemas/types.yaml#/definitions/string > + enum: [ disabled, low, medium, high ] > + default: disabled > + description: > + Reference clock output (DRV0) drive strength. Only applicable when > + the internal PLL is enabled. > + > +dependencies: > + adi,charge-pump-current-microamp: [ 'adi,pll-enable' ] > + adi,refclk-out-drive-strength: [ 'adi,pll-enable' ] > + lock-detect-gpios: [ 'adi,pll-enable' ] > + interrupts: [ interrupt-names ] > + clocks: [ clock-names ] As clocks is required below, then 'clock-names' is also always required. > + '#clock-cells': [ clock-output-names ] The h/w sometimes has clock outputs and sometimes doesn't? #clock-cells should always be required IMO. > + > +required: > + - compatible > + - reg > + - clocks > + - dvdd-io33-supply > + - avdd33-supply > + - dvdd18-supply > + - avdd18-supply > + > +allOf: > + - $ref: /schemas/spi/spi-peripheral-props.yaml# > + > +unevaluatedProperties: false > + > +examples: > + - | > + #include <dt-bindings/gpio/gpio.h> > + spi { > + #address-cells = <1>; > + #size-cells = <0>; > + dds@0 { > + compatible = "adi,ad9910"; > + reg = <0>; > + spi-max-frequency = <1000000>; > + clocks = <&ad9910_refclk>; > + clock-names = "ref_clk"; > + > + dvdd-io33-supply = <&vdd_io33>; > + avdd33-supply = <&vdd_a33>; > + dvdd18-supply = <&vdd_d18>; > + avdd18-supply = <&vdd_a18>; > + > + reset-gpios = <&gpio 0 GPIO_ACTIVE_HIGH>; > + io-reset-gpios = <&gpio 1 GPIO_ACTIVE_HIGH>; > + powerdown-gpios = <&gpio 2 GPIO_ACTIVE_HIGH>; > + update-gpios = <&gpio 3 GPIO_ACTIVE_HIGH>; > + profile-gpios = <&gpio 4 GPIO_ACTIVE_HIGH>, > + <&gpio 5 GPIO_ACTIVE_HIGH>, > + <&gpio 6 GPIO_ACTIVE_HIGH>; > + > + adi,pll-enable; > + adi,charge-pump-current-microamp = <387>; > + adi,refclk-out-drive-strength = "disabled"; > + }; > + }; > +... > diff --git a/MAINTAINERS b/MAINTAINERS > index b051eccafa60..998b06fd97fd 100644 > --- a/MAINTAINERS > +++ b/MAINTAINERS > @@ -1645,6 +1645,13 @@ W: https://ez.analog.com/linux-software-drivers > F: Documentation/devicetree/bindings/iio/dac/adi,ad9739a.yaml > F: drivers/iio/dac/ad9739a.c > > +ANALOG DEVICES INC AD9910 DRIVER > +M: Rodrigo Alencar <[email protected]> > +L: [email protected] > +S: Supported > +W: https://ez.analog.com/linux-software-drivers > +F: Documentation/devicetree/bindings/iio/frequency/adi,ad9910.yaml > + > ANALOG DEVICES INC MAX22007 DRIVER > M: Janani Sunil <[email protected]> > L: [email protected] > > -- > 2.43.0 >
