From patchwork Tue Jun 6 17:59:51 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Marek Vasut X-Patchwork-Id: 690557 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 57CF2C7EE24 for ; Tue, 6 Jun 2023 18:01:40 +0000 (UTC) Received: from alsa1.perex.cz (alsa1.perex.cz [207.180.221.201]) (using TLSv1.2 with cipher ADH-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by alsa0.perex.cz (Postfix) with ESMTPS id 52E6B820; Tue, 6 Jun 2023 20:00:47 +0200 (CEST) DKIM-Filter: OpenDKIM Filter v2.11.0 alsa0.perex.cz 52E6B820 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=alsa-project.org; s=default; t=1686074497; bh=vvoos0Vm8C75AL0lJpxSF+zp3pSVJ2QhBidNLr1gifQ=; h=From:To:Cc:Subject:Date:List-Id:List-Archive:List-Help:List-Owner: List-Post:List-Subscribe:List-Unsubscribe:From; b=JFGe1OnDT8YXfiC0nSpB/EVnD/3b8BZWGMABToC/s5DTNGIxhlJufmvKXgzhIf9po ptk3VBYtYMlZ4T5Me2m7XMjYEKYWtE8eYu90i5Rzdn7qnijgqxwASOxrT8Xy2j3Vic 9mQfig30iHBjGGrhf/pDvhXvBOXLkqwqLkvJ8UGU= Received: by alsa1.perex.cz (Postfix, from userid 50401) id 049E2F804DA; Tue, 6 Jun 2023 20:00:20 +0200 (CEST) Received: from mailman-core.alsa-project.org (mailman-core.alsa-project.org [10.254.200.10]) by alsa1.perex.cz (Postfix) with ESMTP id 87891F800C8; Tue, 6 Jun 2023 20:00:20 +0200 (CEST) Received: by alsa1.perex.cz (Postfix, from userid 50401) id 53218F80199; Tue, 6 Jun 2023 20:00:16 +0200 (CEST) Received: from phobos.denx.de (phobos.denx.de [85.214.62.61]) (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 alsa1.perex.cz (Postfix) with ESMTPS id A1119F800C8 for ; Tue, 6 Jun 2023 20:00:05 +0200 (CEST) DKIM-Filter: OpenDKIM Filter v2.11.0 alsa1.perex.cz A1119F800C8 Authentication-Results: alsa1.perex.cz; dkim=pass (2048-bit key, unprotected) header.d=denx.de header.i=@denx.de header.a=rsa-sha256 header.s=phobos-20191101 header.b=H12XuWtK Received: from tr.lan (ip-86-49-120-218.bb.vodafone.cz [86.49.120.218]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) (No client certificate requested) (Authenticated sender: marex@denx.de) by phobos.denx.de (Postfix) with ESMTPSA id 66DB185BC7; Tue, 6 Jun 2023 20:00:04 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=denx.de; s=phobos-20191101; t=1686074405; bh=F5ZNqjEs3oTfsrAMdqCV2n+Sc4o/8z8mTGUPDw5VqgU=; h=From:To:Cc:Subject:Date:From; b=H12XuWtKt+LOY+ZzWB7JyHe/yLSRGfungMIQF/RrGyTGtj2w8RVnkwt+C0IDb9i/A 2phvVb/YqRQWQENBNGZTtrfngwJYwrxCfgIzZiKnpL6LZ6vKwg+KGsG6Si0IVEaf3O +kpK7QEBuo01zHcOSZGLeqnaIrpT64mCTQJmk/Tr986+TRm5YZ71hRnb24KCdT5+AS gw/BVGJFj0WdvH4/qz24q9m4HxiqRmNDy1cNEqaE5VWmZeOAv7/XF7xk/HVfrfgeNt GcZQt9iw12yY8S7BMyP8NJW87uxxgKKi8WLmNYRL0qkroXKJDuLA3jmC2F+AxnIln5 wPgyArGVR9Xyg== From: Marek Vasut To: devicetree@vger.kernel.org Cc: Marek Vasut , Krzysztof Kozlowski , Kuninori Morimoto , Liam Girdwood , Mark Brown , Rob Herring , alsa-devel@alsa-project.org Subject: [PATCH] ASoC: dt-bindings: audio-graph-card: Expand 'widgets' documentation Date: Tue, 6 Jun 2023 19:59:51 +0200 Message-Id: <20230606175951.215740-1-marex@denx.de> X-Mailer: git-send-email 2.39.2 MIME-Version: 1.0 X-Virus-Scanned: clamav-milter 0.103.8 at phobos.denx.de X-Virus-Status: Clean Message-ID-Hash: 47U6JWFZBSEPTQQFY2JCU5Z36LOA6ZZD X-Message-ID-Hash: 47U6JWFZBSEPTQQFY2JCU5Z36LOA6ZZD X-MailFrom: marex@denx.de 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; nonmember-moderation; administrivia; implicit-dest; max-recipients; max-size; news-moderation; no-subject; digests; suspicious-header X-Mailman-Version: 3.3.8 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: Document the encoding of 'widgets' property to avoid confusion. Signed-off-by: Marek Vasut --- Cc: Krzysztof Kozlowski Cc: Kuninori Morimoto Cc: Liam Girdwood Cc: Mark Brown Cc: Rob Herring Cc: alsa-devel@alsa-project.org Cc: devicetree@vger.kernel.org --- Documentation/devicetree/bindings/sound/audio-graph.yaml | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/Documentation/devicetree/bindings/sound/audio-graph.yaml b/Documentation/devicetree/bindings/sound/audio-graph.yaml index c87eb91de1593..ed31e04ff6a68 100644 --- a/Documentation/devicetree/bindings/sound/audio-graph.yaml +++ b/Documentation/devicetree/bindings/sound/audio-graph.yaml @@ -24,7 +24,11 @@ properties: connection's sink, the second being the connection's source. $ref: /schemas/types.yaml#/definitions/non-unique-string-array widgets: - description: User specified audio sound widgets. + description: | + User specified audio sound widgets. + Each entry is a pair of strings, the first being the type of + widget ("Microphone", "Line", "Headphone", "Speaker"), the + second being the machine specific name for the widget. $ref: /schemas/types.yaml#/definitions/non-unique-string-array convert-rate: $ref: /schemas/sound/dai-params.yaml#/$defs/dai-sample-rate