1 # SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
4 $id: http://devicetree.org/schemas/iio/adc/st,stm32-dfsdm-adc.yaml#
5 $schema: http://devicetree.org/meta-schemas/core.yaml#
7 title: STMicroelectronics STM32 DFSDM ADC device driver
10 - Fabrice Gasnier <fabrice.gasnier@st.com>
11 - Olivier Moysan <olivier.moysan@st.com>
14 STM32 DFSDM ADC is a sigma delta analog-to-digital converter dedicated to
15 interface external sigma delta modulators to STM32 micro controllers.
16 It is mainly targeted for:
17 - Sigma delta modulators (motor control, metering...)
18 - PDM microphones (audio digital microphone)
20 It features up to 8 serial digital interfaces (SPI or Manchester) and
21 up to 4 filters on stm32h7 or 6 filters on stm32mp1.
23 Each child node matches with a filter instance.
37 Internal clock used for DFSDM digital processing and control blocks.
38 dfsdm clock can also feed CLKOUT, when CLKOUT is used.
39 - description: audio clock can be used as an alternate to feed CLKOUT.
56 SPI clock OUT frequency (Hz). Requested only for SPI master mode.
57 This clock must be set according to the "clock" property.
58 Frequency must be a multiple of the rcc clock frequency.
59 If not, SPI CLKOUT frequency will not be accurate.
70 additionalProperties: false
75 description: child node
84 description: Specifies the DFSDM filter instance used.
92 List of single-ended channels muxed for this ADC.
93 On stm32h7 and stm32mp1:
94 - For st,stm32-dfsdm-adc: up to 8 channels numbered from 0 to 7.
95 - For st,stm32-dfsdm-dmic: 1 channel numbered from 0 to 7.
96 $ref: /schemas/types.yaml#/definitions/uint32-array
101 st,adc-channel-names:
102 description: List of single-ended channel names.
106 SinC filter order from 0 to 5.
108 - [1-5]: order 1 to 5.
109 For audio purpose it is recommended to use order 3 to 5.
110 $ref: /schemas/types.yaml#/definitions/uint32
118 st,adc-channel-types:
120 Single-ended channel input type.
121 - "SPI_R": SPI with data on rising edge (default)
122 - "SPI_F": SPI with data on falling edge
123 - "MANCH_R": manchester codec, rising edge = logic 0, falling edge = logic 1
124 - "MANCH_F": manchester codec, rising edge = logic 1, falling edge = logic 0
126 enum: [ SPI_R, SPI_F, MANCH_R, MANCH_F ]
127 $ref: /schemas/types.yaml#/definitions/non-unique-string-array
129 st,adc-channel-clk-src:
131 Conversion clock source.
132 - "CLKIN": external SPI clock (CLKIN x)
133 - "CLKOUT": internal SPI clock (CLKOUT) (default)
134 - "CLKOUT_F": internal SPI clock divided by 2 (falling edge).
135 - "CLKOUT_R": internal SPI clock divided by 2 (rising edge).
137 enum: [ CLKIN, CLKOUT, CLKOUT_F, CLKOUT_R ]
138 $ref: /schemas/types.yaml#/definitions/non-unique-string-array
142 Must be defined if two sigma delta modulators are
143 connected on same SPI input.
144 If not set, channel n is connected to SPI input n.
145 If set, channel n is connected to SPI input n + 1.
150 Set to 1 to synchronize with DFSDM filter instance 0.
151 Used for multi microphones synchronization.
166 - st,adc-channel-names
168 - "#io-channel-cells"
175 const: st,stm32-dfsdm-adc
183 st,adc-channel-names:
187 st,adc-channel-types:
191 st,adc-channel-clk-src:
197 From common IIO binding. Used to pipe external sigma delta
198 modulator or internal ADC output to DFSDM channel.
207 const: st,stm32-dfsdm-dmic
214 st,adc-channel-names:
217 st,adc-channel-types:
220 st,adc-channel-clk-src:
230 description: child node
235 - st,stm32h7-dfsdm-dai
242 From common IIO binding. Used to pipe external sigma delta
243 modulator or internal ADC output to DFSDM channel.
255 const: st,stm32h7-dfsdm
270 const: st,stm32mp1-dfsdm
283 #include <dt-bindings/interrupt-controller/arm-gic.h>
284 #include <dt-bindings/clock/stm32mp1-clks.h>
285 dfsdm: dfsdm@4400d000 {
286 compatible = "st,stm32mp1-dfsdm";
287 reg = <0x4400d000 0x800>;
288 clocks = <&rcc DFSDM_K>, <&rcc ADFSDM_K>;
289 clock-names = "dfsdm", "audio";
290 #address-cells = <1>;
294 compatible = "st,stm32-dfsdm-dmic";
296 interrupts = <GIC_SPI 110 IRQ_TYPE_LEVEL_HIGH>;
297 dmas = <&dmamux1 101 0x400 0x01>;
299 #io-channel-cells = <1>;
300 st,adc-channels = <1>;
301 st,adc-channel-names = "dmic0";
302 st,adc-channel-types = "SPI_R";
303 st,adc-channel-clk-src = "CLKOUT";
304 st,filter-order = <5>;
306 asoc_pdm0: dfsdm-dai {
307 compatible = "st,stm32h7-dfsdm-dai";
308 #sound-dai-cells = <0>;
309 io-channels = <&dfsdm0 0>;
313 dfsdm_pdm1: filter@1 {
314 compatible = "st,stm32-dfsdm-adc";
316 interrupts = <GIC_SPI 111 IRQ_TYPE_LEVEL_HIGH>;
317 dmas = <&dmamux1 102 0x400 0x01>;
319 #io-channel-cells = <1>;
320 st,adc-channels = <2 3>;
321 st,adc-channel-names = "in2", "in3";
322 st,adc-channel-types = "SPI_R", "SPI_R";
323 st,adc-channel-clk-src = "CLKOUT_F", "CLKOUT_F";
324 io-channels = <&sd_adc2 &sd_adc3>;
325 st,filter-order = <1>;