diff mbox series

[2/2] ASoC: dt-bindings: Add Everest ES8389 audio CODEC

Message ID 20250226104949.16303-3-zhangyi@everest-semi.com
State New
Headers show
Series ASoC: codecs: add ES8389 codec driver | expand

Commit Message

Zhang Yi Feb. 26, 2025, 10:49 a.m. UTC 
Add device tree binding documentation for Everest ES8389

Signed-off-by: Zhang Yi <zhangyi@everest-semi.com>
---
 .../bindings/sound/everest,es8389.txt         | 68 +++++++++++++++++++
 1 file changed, 68 insertions(+)
 create mode 100755 Documentation/devicetree/bindings/sound/everest,es8389.txt
diff mbox series

Patch

diff --git a/Documentation/devicetree/bindings/sound/everest,es8389.txt b/Documentation/devicetree/bindings/sound/everest,es8389.txt
new file mode 100755
index 000000000000..a65222f984da
--- /dev/null
+++ b/Documentation/devicetree/bindings/sound/everest,es8389.txt
@@ -0,0 +1,68 @@ 
+ES8389 audio CODEC
+
+This device supports I2C only.
+
+Required properties:
+
+- compatible : "everest,es8389"
+
+- reg : The I2C address of the device.
+ It depends on The Voltage level on Chip Address Pin(AD1 = PIN11,AD0 = PIN1)
+
+- "#sound-dai-cells"
+
+Optional properties:
+
+- everest,adc-slot:
+ This property is used to set the slots of recording data when multiple codecs
+ are connected in PTDM mode. please do not set this property if you are setting
+ STDM mode.
+ minimum: 0x00
+ maximum: 0x07
+ default: 0x00
+
+- everest,dac-slot:
+ This property is used to set the slots of playing data when multiple codecs
+ are connected in TDM mode.
+ minimum: 0x00
+ maximum: 0x07
+ default: 0x00
+
+- prefix_name:
+ To set the prefix_name of kcontorls and dapm.
+
+- everest,dmic-enabled
+ The property selects the PDM interface of ES8389
+
+Example for single codec:
+
+ es8389: es8389@10 {
+                compatible = "everest,es8389";
+                status = "okay";
+                reg = <0x10>;
+                everest,adc-slot = [00];
+                everest,dac-slot = [00];
+                prefix_name = "es8389_0";
+                #sound-dai-cells = <0>;
+        };
+
+Example for multiple codecs:
+ es8389_0: es8389@10 {
+                compatible = "everest,es8389";
+                status = "okay";
+                reg = <0x10>;
+                everest,adc-slot = [00];
+                everest,dac-slot = [00];
+                prefix_name = "es8389_0";
+                #sound-dai-cells = <0>;
+        };
+es8389_1: es8389@11 {
+                compatible = "everest,es8389";
+                status = "okay";
+                reg = <0x11>;
+                everest,adc-slot = [01];
+                everest,dac-slot = [01];
+                prefix_name = "es8389_1";
+                clock-names = "mclk";
+                #sound-dai-cells = <0>;
+        };