Linux-libre 5.4.47-gnu
[librecmc/linux-libre.git] / Documentation / devicetree / bindings / sound / atmel-pdmic.txt
1 * Atmel PDMIC driver under ALSA SoC architecture
2
3 Required properties:
4 - compatible
5         Should be "atmel,sama5d2-pdmic".
6 - reg
7         Should contain PDMIC registers location and length.
8 - interrupts
9         Should contain the IRQ line for the PDMIC.
10 - dmas
11         One DMA specifiers as described in atmel-dma.txt and dma.txt files.
12 - dma-names
13         Must be "rx".
14 - clock-names
15         Required elements:
16         - "pclk"        peripheral clock
17         - "gclk"        generated clock
18 - clocks
19         Must contain an entry for each required entry in clock-names.
20         Please refer to clock-bindings.txt.
21 - atmel,mic-min-freq
22         The minimal frequency that the micphone supports.
23 - atmel,mic-max-freq
24         The maximal frequency that the micphone supports.
25
26 Optional properties:
27 - pinctrl-names, pinctrl-0
28         Please refer to pinctrl-bindings.txt.
29 - atmel,model
30         The user-visible name of this sound card.
31         The default value is "PDMIC".
32 - atmel,mic-offset
33         The offset that should be added.
34         The range is from -32768 to 32767.
35         The default value is 0.
36
37 Example:
38         pdmic@f8018000 {
39                                 compatible = "atmel,sama5d2-pdmic";
40                                 reg = <0xf8018000 0x124>;
41                                 interrupts = <48 IRQ_TYPE_LEVEL_HIGH 7>;
42                                 dmas = <&dma0
43                                         (AT91_XDMAC_DT_MEM_IF(0) | AT91_XDMAC_DT_PER_IF(1)
44                                         | AT91_XDMAC_DT_PERID(50))>;
45                                 dma-names = "rx";
46                                 clocks = <&pdmic_clk>, <&pdmic_gclk>;
47                                 clock-names = "pclk", "gclk";
48
49                                 pinctrl-names = "default";
50                                 pinctrl-0 = <&pinctrl_pdmic_default>;
51                                 atmel,model = "PDMIC @ sama5d2_xplained";
52                                 atmel,mic-min-freq = <1000000>;
53                                 atmel,mic-max-freq = <3246000>;
54                                 atmel,mic-offset = <0x0>;
55         };