xref: /linux/Documentation/devicetree/bindings/sound/rt5682.txt (revision 4d3c884ca7fb8ea25555c9a4b5ab1f9acad22587)
10ddce71cSBard LiaoRT5682 audio CODEC
20ddce71cSBard Liao
30ddce71cSBard LiaoThis device supports I2C only.
40ddce71cSBard Liao
50ddce71cSBard LiaoRequired properties:
60ddce71cSBard Liao
70ddce71cSBard Liao- compatible : "realtek,rt5682" or "realtek,rt5682i"
80ddce71cSBard Liao
90ddce71cSBard Liao- reg : The I2C address of the device.
100ddce71cSBard Liao
11*4d3c884cSNícolas F. R. A. Prado- AVDD-supply: phandle to the regulator supplying analog power through the
12*4d3c884cSNícolas F. R. A. Prado  AVDD pin
13*4d3c884cSNícolas F. R. A. Prado
14*4d3c884cSNícolas F. R. A. Prado- MICVDD-supply: phandle to the regulator supplying power for the microphone
15*4d3c884cSNícolas F. R. A. Prado  bias through the MICVDD pin. Either MICVDD or VBAT should be present.
16*4d3c884cSNícolas F. R. A. Prado
17*4d3c884cSNícolas F. R. A. Prado- VBAT-supply: phandle to the regulator supplying battery power through the
18*4d3c884cSNícolas F. R. A. Prado  VBAT pin. Either MICVDD or VBAT should be present.
19*4d3c884cSNícolas F. R. A. Prado
200ddce71cSBard LiaoOptional properties:
210ddce71cSBard Liao
220ddce71cSBard Liao- interrupts : The CODEC's interrupt output.
230ddce71cSBard Liao
240ddce71cSBard Liao- realtek,dmic1-data-pin
250ddce71cSBard Liao  0: dmic1 is not used
260ddce71cSBard Liao  1: using GPIO2 pin as dmic1 data pin
270ddce71cSBard Liao  2: using GPIO5 pin as dmic1 data pin
280ddce71cSBard Liao
290ddce71cSBard Liao- realtek,dmic1-clk-pin
300ddce71cSBard Liao  0: using GPIO1 pin as dmic1 clock pin
310ddce71cSBard Liao  1: using GPIO3 pin as dmic1 clock pin
320ddce71cSBard Liao
330ddce71cSBard Liao- realtek,jd-src
340ddce71cSBard Liao  0: No JD is used
350ddce71cSBard Liao  1: using JD1 as JD source
360ddce71cSBard Liao
370ddce71cSBard Liao- realtek,ldo1-en-gpios : The GPIO that controls the CODEC's LDO1_EN pin.
380ddce71cSBard Liao
39059c67f1SShuming Fan- realtek,btndet-delay
40059c67f1SShuming Fan  The debounce delay for push button.
41059c67f1SShuming Fan  The delay time is realtek,btndet-delay value multiple of 8.192 ms.
42059c67f1SShuming Fan  If absent, the default is 16.
43059c67f1SShuming Fan
448b59e642SDerek Fang- #clock-cells : Should be set to '<1>',  wclk and bclk sources provided.
458b59e642SDerek Fang- clock-output-names : Name given for DAI clocks output.
468b59e642SDerek Fang
478b59e642SDerek Fang- clocks : phandle and clock specifier for codec MCLK.
488b59e642SDerek Fang- clock-names : Clock name string for 'clocks' attribute, should be "mclk".
498b59e642SDerek Fang
50235eb700SOder Chiou- realtek,dmic-clk-rate-hz : Set the clock rate (hz) for the requirement of
51235eb700SOder Chiou  the particular DMIC.
52235eb700SOder Chiou
53235eb700SOder Chiou- realtek,dmic-delay-ms : Set the delay time (ms) for the requirement of
54235eb700SOder Chiou  the particular DMIC.
55235eb700SOder Chiou
568dd85533SBhaskar Chowdhury- realtek,dmic-clk-driving-high : Set the high driving of the DMIC clock out.
5733ee67b4SOder Chiou
5807b16192SNícolas F. R. A. Prado- #sound-dai-cells: Should be set to '<1>'.
590adccaf1SNícolas F. R. A. Prado
600ddce71cSBard LiaoPins on the device (for linking into audio routes) for RT5682:
610ddce71cSBard Liao
620ddce71cSBard Liao  * DMIC L1
630ddce71cSBard Liao  * DMIC R1
640ddce71cSBard Liao  * IN1P
650ddce71cSBard Liao  * HPOL
660ddce71cSBard Liao  * HPOR
670ddce71cSBard Liao
680ddce71cSBard LiaoExample:
690ddce71cSBard Liao
700ddce71cSBard Liaort5682 {
710ddce71cSBard Liao	compatible = "realtek,rt5682i";
720ddce71cSBard Liao	reg = <0x1a>;
730ddce71cSBard Liao	interrupt-parent = <&gpio>;
74abe42b09SKrzysztof Kozlowski	interrupts = <TEGRA_GPIO(U, 6) IRQ_TYPE_LEVEL_HIGH>;
750ddce71cSBard Liao	realtek,ldo1-en-gpios =
760ddce71cSBard Liao		<&gpio TEGRA_GPIO(R, 2) GPIO_ACTIVE_HIGH>;
770ddce71cSBard Liao	realtek,dmic1-data-pin = <1>;
780ddce71cSBard Liao	realtek,dmic1-clk-pin = <1>;
790ddce71cSBard Liao	realtek,jd-src = <1>;
80059c67f1SShuming Fan	realtek,btndet-delay = <16>;
818b59e642SDerek Fang
828b59e642SDerek Fang	#clock-cells = <1>;
838b59e642SDerek Fang	clock-output-names = "rt5682-dai-wclk", "rt5682-dai-bclk";
848b59e642SDerek Fang
858b59e642SDerek Fang	clocks = <&osc>;
868b59e642SDerek Fang	clock-names = "mclk";
87*4d3c884cSNícolas F. R. A. Prado
88*4d3c884cSNícolas F. R. A. Prado	AVDD-supply = <&avdd_reg>;
89*4d3c884cSNícolas F. R. A. Prado	MICVDD-supply = <&micvdd_reg>;
900ddce71cSBard Liao};
91