From patchwork Tue Mar 4 01:45:20 2025 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Zhang Yi X-Patchwork-Id: 870585 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from alsa0.perex.cz (alsa0.perex.cz [77.48.224.243]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.lore.kernel.org (Postfix) with ESMTPS id 18EE8C19F32 for ; Wed, 5 Mar 2025 09:40:01 +0000 (UTC) Received: from alsa1.perex.cz (alsa1.perex.cz [45.14.194.44]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (No client certificate requested) by alsa0.perex.cz (Postfix) with ESMTPS id 412ED603BF; Wed, 5 Mar 2025 10:39:49 +0100 (CET) DKIM-Filter: OpenDKIM Filter v2.11.0 alsa0.perex.cz 412ED603BF DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=alsa-project.org; s=default; t=1741167599; bh=/BdeqteE2ILibLaDWZMQGWa3nDTJyw9I4kwq0AmALUM=; h=From:To:Cc:Subject:Date:In-Reply-To:References:List-Id: List-Archive:List-Help:List-Owner:List-Post:List-Subscribe: List-Unsubscribe:From; b=F7wklBna3m5a1kbo6YUOD9QK2eUdXHxwGqjkrnVQzXnXWXozms1Bh5hYwb65p7Nqz gySA9YKht7l2yPvCM3DCiqYTd7Vgd8y3djTHbJr/M0SM+spgEhfRR3OjaLG8oQCDJ/ 8hUYoafMGarHjSYCAsFz9LBucpEttCvTjU/6rkqM= Received: by alsa1.perex.cz (Postfix, from userid 50401) id CB610F80796; Wed, 5 Mar 2025 10:37:00 +0100 (CET) Received: from mailman-core.alsa-project.org (mailman-core.alsa-project.org [10.254.200.10]) by alsa1.perex.cz (Postfix) with ESMTP id A91D3F8077D; Wed, 5 Mar 2025 10:37:00 +0100 (CET) Received: by alsa1.perex.cz (Postfix, from userid 50401) id 481FBF80553; Tue, 4 Mar 2025 02:45:41 +0100 (CET) Received: from smtp134-87.sina.com.cn (smtp134-87.sina.com.cn [180.149.134.87]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by alsa1.perex.cz (Postfix) with ESMTPS id A3313F8049C for ; Tue, 4 Mar 2025 02:45:30 +0100 (CET) DKIM-Filter: OpenDKIM Filter v2.11.0 alsa1.perex.cz A3313F8049C Received: from unknown (HELO zy-virtual-machine.localdomain)([180.159.108.137]) by sina.net (10.185.250.30) with ESMTP id 67C65B3200001EC2; Tue, 4 Mar 2025 09:45:25 +0800 (CST) X-Sender: zhangyi@everest-semi.com X-Auth-ID: zhangyi@everest-semi.com Authentication-Results: sina.net; spf=none smtp.mailfrom=zhangyi@everest-semi.com; dkim=none header.i=none; dmarc=none action=none header.from=zhangyi@everest-semi.com X-SMAIL-MID: 73BFC20EC01C4C2E858E4681B809A653 X-SMAIL-UIID: 73BFC20EC01C4C2E858E4681B809A653-20250304-094525 From: Zhang Yi To: alsa-devel@alsa-project.org, broonie@kernel.org, devicetree@vger.kernel.org Cc: tiwai@suse.com, amadeuszx.slawinski@linux.intel.com, robh@kernel.org, Zhang Yi Subject: [PATCH v2 2/2] ASoC: dt-bindings: Add Everest ES8389 audio CODEC Date: Tue, 4 Mar 2025 09:45:20 +0800 Message-Id: <20250304014520.83292-3-zhangyi@everest-semi.com> X-Mailer: git-send-email 2.17.1 In-Reply-To: <20250304014520.83292-1-zhangyi@everest-semi.com> References: <20250304014520.83292-1-zhangyi@everest-semi.com> X-MailFrom: zhangyi@everest-semi.com X-Mailman-Rule-Hits: nonmember-moderation X-Mailman-Rule-Misses: dmarc-mitigation; no-senders; approved; emergency; loop; banned-address; member-moderation; header-match-alsa-devel.alsa-project.org-0; header-match-alsa-devel.alsa-project.org-1 Message-ID-Hash: E2ZJCC3NRHPCLRPOFODAI4JI2DBO7TSM X-Message-ID-Hash: E2ZJCC3NRHPCLRPOFODAI4JI2DBO7TSM X-Mailman-Approved-At: Wed, 05 Mar 2025 09:36:54 +0000 X-Mailman-Version: 3.3.9 Precedence: list List-Id: "Alsa-devel mailing list for ALSA developers - http://www.alsa-project.org" Archived-At: List-Archive: List-Help: List-Owner: List-Post: List-Subscribe: List-Unsubscribe: Add device tree binding documentation for Everest ES8389 Signed-off-by: Zhang Yi --- .../bindings/sound/everest,es8389.yaml | 78 +++++++++++++++++++ 1 file changed, 78 insertions(+) create mode 100644 Documentation/devicetree/bindings/sound/everest,es8389.yaml diff --git a/Documentation/devicetree/bindings/sound/everest,es8389.yaml b/Documentation/devicetree/bindings/sound/everest,es8389.yaml new file mode 100644 index 000000000000..b0f3a243b42c --- /dev/null +++ b/Documentation/devicetree/bindings/sound/everest,es8389.yaml @@ -0,0 +1,78 @@ +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/sound/everest,es8389.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: Everest ES8389 audio CODEC + +maintainers: + - Michael Zhang + +allOf: + - $ref: dai-common.yaml# + +properties: + compatible: + const: everest,es8389 + + reg: + maxItems: 1 + + clocks: + items: + - description: clock for master clock (MCLK) + + clock-names: + items: + - const: mclk + + "#sound-dai-cells": + const: 0 + + everest,adc-slot: + $ref: /schemas/types.yaml#/definitions/uint8 + description: | + This property is used to set the slots of recording data when multiple + codecs are connected in PTDM mode. + please set this property to default if you are setting STDM mode. + minimum: 0x00 + maximum: 0x07 + default: 0x00 + + everest,dac-slot: + $ref: /schemas/types.yaml#/definitions/uint8 + description: | + This property is used to set the slots of playing data when multiple + codecs are connected in TDM mode. + please do not set this property if you use single codec. + minimum: 0x00 + maximum: 0x07 + default: 0x00 + + prefix_name: + $ref: /schemas/types.yaml#/definitions/string + description: device name prefix + + everest,dmic-enabled: + $ref: /schemas/types.yaml#/definitions/flag + description: + The property is a choice between PDM and AMIC + +required: + - compatible + - reg + - "#sound-dai-cells" + +additionalProperties: false + +examples: + - | + es8389: es8389@10 { + compatible = "everest,es8389"; + reg = <0x10>; + everest,adc-slot = [00]; + everest,dac-slot = [00]; + prefix_name = "es8389_0"; + #sound-dai-cells = <0>; + };