From patchwork Tue Mar 4 11:47:51 2025 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Zhang Yi X-Patchwork-Id: 871286 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 1719EC19F32 for ; Wed, 5 Mar 2025 09:42:02 +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 7FB3A6042B; Wed, 5 Mar 2025 10:41:50 +0100 (CET) DKIM-Filter: OpenDKIM Filter v2.11.0 alsa0.perex.cz 7FB3A6042B DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=alsa-project.org; s=default; t=1741167720; bh=hMDNTxNe1t6rAUme6MiOLElfl8ecDVJ2s28+Te73nNQ=; 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=q524NG7beEENIKCKaf4qDjM7RYn4dKImp5smmsEY0b/RvR444cE6QfL3lO7AbZHeC SX3c4Dn/DX+Isnqp504t12BZbZJRCQlL5vXhNYQi2rSSom/3Ewu1JpRFrCzQOk+x9H NR30B72gMrsmg/4i4HaojMK5CAikV2wp0DQa7XDM= Received: by alsa1.perex.cz (Postfix, from userid 50401) id DF867F80CBB; Wed, 5 Mar 2025 10:37:45 +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 C64A3F80684; Wed, 5 Mar 2025 10:37:45 +0100 (CET) Received: by alsa1.perex.cz (Postfix, from userid 50401) id 221AEF8051F; Tue, 4 Mar 2025 12:48:10 +0100 (CET) Received: from smtp134-90.sina.com.cn (smtp134-90.sina.com.cn [180.149.134.90]) (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 9C586F8001D for ; Tue, 4 Mar 2025 12:48:01 +0100 (CET) DKIM-Filter: OpenDKIM Filter v2.11.0 alsa1.perex.cz 9C586F8001D Received: from unknown (HELO zy-virtual-machine.localdomain)([180.159.108.137]) by sina.net (10.185.250.31) with ESMTP id 67C6E8690000342A; Tue, 4 Mar 2025 19:47:57 +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: A6BF3BA464544B9BB303CB3593A370FC X-SMAIL-UIID: A6BF3BA464544B9BB303CB3593A370FC-20250304-194757 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+dt@kernel.org, krzysztof.kozlowski+dt@linaro.org, conor+dt@kernel.org, Zhang Yi Subject: [PATCH v4 2/2] ASoC: dt-bindings: Add Everest ES8389 audio CODEC Date: Tue, 4 Mar 2025 19:47:51 +0800 Message-Id: <20250304114751.54635-3-zhangyi@everest-semi.com> X-Mailer: git-send-email 2.17.1 In-Reply-To: <20250304114751.54635-1-zhangyi@everest-semi.com> References: <20250304114751.54635-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: MZCRSRGQ72LP357ZD3MOBHHWZM7VISXW X-Message-ID-Hash: MZCRSRGQ72LP357ZD3MOBHHWZM7VISXW X-Mailman-Approved-At: Wed, 05 Mar 2025 09:37:04 +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 which is different from ES8388 Signed-off-by: Zhang Yi --- .../bindings/sound/everest,es8389.yaml | 83 +++++++++++++++++++ 1 file changed, 83 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..0860adbc8654 --- /dev/null +++ b/Documentation/devicetree/bindings/sound/everest,es8389.yaml @@ -0,0 +1,83 @@ +# 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/uint32 + 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: 0 + maximum: 7 + default: 0 + + everest,dac-slot: + $ref: /schemas/types.yaml#/definitions/uint32 + 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: 0 + maximum: 7 + default: 0 + + prefix_name: + $ref: /schemas/types.yaml#/definitions/string + description: + When using multiple codecs, The prefix_name is used to distinguish the + dapm and kcontrol of each individual codec. + + everest,dmic-enabled: + $ref: /schemas/types.yaml#/definitions/flag + description: + ES8389 use DMIC as input + +required: + - compatible + - reg + - "#sound-dai-cells" + +additionalProperties: false + +examples: + - | + i2c { + #address-cells = <1>; + #size-cells = <0>; + es8389: codec@10 { + compatible = "everest,es8389"; + reg = <0x10>; + everest,adc-slot = <0>; + everest,dac-slot = <0>; + #sound-dai-cells = <0>; + }; + };