From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-13.7 required=3.0 tests=BAYES_00,DKIM_SIGNED, DKIM_VALID,HEADER_FROM_DIFFERENT_DOMAINS,INCLUDES_CR_TRAILER,INCLUDES_PATCH, MAILING_LIST_MULTI,SPF_HELO_NONE,SPF_PASS,URIBL_BLOCKED autolearn=unavailable autolearn_force=no version=3.4.0 Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id D6AC2C433EF for ; Fri, 3 Sep 2021 08:31:57 +0000 (UTC) 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 mail.kernel.org (Postfix) with ESMTPS id 9F3126108E for ; Fri, 3 Sep 2021 08:31:55 +0000 (UTC) DMARC-Filter: OpenDMARC Filter v1.4.1 mail.kernel.org 9F3126108E Authentication-Results: mail.kernel.org; dmarc=none (p=none dis=none) header.from=baylibre.com Authentication-Results: mail.kernel.org; spf=pass smtp.mailfrom=alsa-project.org Received: from alsa1.perex.cz (alsa1.perex.cz [207.180.221.201]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by alsa0.perex.cz (Postfix) with ESMTPS id 91A9217D1; Fri, 3 Sep 2021 10:31:03 +0200 (CEST) DKIM-Filter: OpenDKIM Filter v2.11.0 alsa0.perex.cz 91A9217D1 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=alsa-project.org; s=default; t=1630657913; bh=XyR1K2Saapwjdv+YokvOxxxjAdtyUTPdgJwf7cgvrxY=; h=References:From:To:Subject:Date:In-reply-to:Cc:List-Id: List-Unsubscribe:List-Archive:List-Post:List-Help:List-Subscribe: From; b=qKVNVbJq2Fn8vNsbuzbhuwg4fsKfCAgCXdKORhBEiPDYJ+oX6IfTi72r1ChUJaNMj uFdpXsShMcn6e+3bLG/XlUXbHGExYdNL4yHi8m9VoN+eVbJ5NSJkuQugYrh7oBCscq baau0o5bWdqu//UKYJpMVDauqfVPpsYQHtnO75ko= Received: from alsa1.perex.cz (localhost.localdomain [127.0.0.1]) by alsa1.perex.cz (Postfix) with ESMTP id 2A650F80227; Fri, 3 Sep 2021 10:31:03 +0200 (CEST) Received: by alsa1.perex.cz (Postfix, from userid 50401) id 982A2F80254; Fri, 3 Sep 2021 10:31:01 +0200 (CEST) Received: from mail-wm1-x329.google.com (mail-wm1-x329.google.com [IPv6:2a00:1450:4864:20::329]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by alsa1.perex.cz (Postfix) with ESMTPS id 59A65F80088 for ; Fri, 3 Sep 2021 10:30:49 +0200 (CEST) DKIM-Filter: OpenDKIM Filter v2.11.0 alsa1.perex.cz 59A65F80088 Authentication-Results: alsa1.perex.cz; dkim=pass (2048-bit key) header.d=baylibre-com.20150623.gappssmtp.com header.i=@baylibre-com.20150623.gappssmtp.com header.b="K4wGE5iP" Received: by mail-wm1-x329.google.com with SMTP id k5-20020a05600c1c8500b002f76c42214bso3208190wms.3 for ; Fri, 03 Sep 2021 01:30:49 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=baylibre-com.20150623.gappssmtp.com; s=20150623; h=references:user-agent:from:to:cc:subject:date:in-reply-to :message-id:mime-version; bh=tSBoI24rmmAo/WWLDhLND6YxNYncWnjj1r5sALynAJ4=; b=K4wGE5iP441yxWa+TAQZ1VZZMZnv6OfvJKWEzE+MCQj7K2oMTS8aHeDQgL7IlCV5+r II5rICDjfU5wlQZmioHZXxoVszg5g1wTZIPmZf+V7KOVQKYfmuoowJ602eTn6HBmdjhR 40Z5W0mxAnYB/D/m3H3U18iiaEtRB1XAs6OsSrvD75MTsAFVEgpJuvIWB45lquL4eZPg WHGJylo9CiP3ELxpw7rat1Y5lK4ARxd2H5aZyiP/QOH5s9LmA5oPmoO04VDfHoMMtTxu mwZcDDhHJY/GZrwjRiCTfmJmArcJ97MVfnRwjnpryjB2B5p2fewYpM6VuJPJjmAlvb6U L/FQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:references:user-agent:from:to:cc:subject:date :in-reply-to:message-id:mime-version; bh=tSBoI24rmmAo/WWLDhLND6YxNYncWnjj1r5sALynAJ4=; b=apl86EwKphscyBdnbw5+QNaVDnlbJtsv3JT9tR6OYWkC7Vnkjm5kZWT9awDilcqqlh L9pl+NNXgeJ3MxWB5aeTsDbkZ07iCANKZYFgeS41VNjmsaNBVQmI8i09Z6Lxq3/GMnLi OrXi853+YVZVv+o+BwEEdxsCzwdYxVGBdr4sZijTigInOsI+vtaqtzDglDhUNiLZko22 MEeWlJZuMM8ivEfR28RRVgTBHpKwqkqjoCDnKS2lnF67bmxMexzkeRXOST4t6Jh0eGDN KN7qoflcBu7lFCd18GBSWpXsJGvGMTF9EEOtPURlknmmu2eIvQ7Lqk1qTzbnFaEq39d5 IFWA== X-Gm-Message-State: AOAM532mATlg6N6nHPV2Io8WTjjGnSYSJS2uJkYD4ohWp8lagTq1IebA QeP+jlFdXV6x9ZoPUCxZjZmTVg== X-Google-Smtp-Source: ABdhPJzIVzeO9objMjNkGGwltqZ/D3PN/vMifRhZaWUZqUx5iRpM6g1pt+vfuZhIf9TYGOJSBH5HPA== X-Received: by 2002:a05:600c:4ece:: with SMTP id g14mr2177689wmq.6.1630657843920; Fri, 03 Sep 2021 01:30:43 -0700 (PDT) Received: from localhost (laubervilliers-658-1-213-31.w90-63.abo.wanadoo.fr. [90.63.244.31]) by smtp.gmail.com with ESMTPSA id r12sm4323542wrv.96.2021.09.03.01.30.43 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 03 Sep 2021 01:30:43 -0700 (PDT) References: <1630562033-13231-1-git-send-email-spujar@nvidia.com> <1630562033-13231-2-git-send-email-spujar@nvidia.com> <1jpmtr5egi.fsf@starbuckisacylon.baylibre.com> User-agent: mu4e 1.6.5; emacs 27.1 From: Jerome Brunet To: Rob Herring Subject: Re: [PATCH v2 1/3] ASoC: Add json-schema documentation for sound-name-prefix Date: Fri, 03 Sep 2021 10:29:37 +0200 In-reply-to: Message-ID: <1jk0jyt617.fsf@starbuckisacylon.baylibre.com> MIME-Version: 1.0 Content-Type: text/plain Cc: devicetree@vger.kernel.org, alsa-devel@alsa-project.org, stephan@gerhold.net, linux-kernel@vger.kernel.org, Sameer Pujar , lgirdwood@gmail.com, jonathanh@nvidia.com, broonie@kernel.org, thierry.reding@gmail.com, linux-tegra@vger.kernel.org X-BeenThere: alsa-devel@alsa-project.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: "Alsa-devel mailing list for ALSA developers - http://www.alsa-project.org" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: alsa-devel-bounces@alsa-project.org Sender: "Alsa-devel" On Thu 02 Sep 2021 at 14:25, Rob Herring wrote: > On Thu, Sep 02, 2021 at 02:47:27PM +0200, Jerome Brunet wrote: >> >> On Thu 02 Sep 2021 at 11:23, Sameer Pujar wrote: >> >> > The 'sound-name-prefix' is used to prepend suitable strings to a >> > component widgets or controls. This is helpful when there are >> > multiple instances of the same component. Add relevant json-schema >> > and is inspired from sound-name-prefix.txt documentation. >> > >> > Signed-off-by: Sameer Pujar >> > Cc: Jerome Brunet >> > Cc: Rob Herring >> > --- >> > .../devicetree/bindings/sound/name-prefix.yaml | 35 ++++++++++++++++++++++ >> > 1 file changed, 35 insertions(+) >> > create mode 100644 Documentation/devicetree/bindings/sound/name-prefix.yaml >> > >> > diff --git a/Documentation/devicetree/bindings/sound/name-prefix.yaml b/Documentation/devicetree/bindings/sound/name-prefix.yaml >> > new file mode 100644 >> > index 00000000..b58cc9e >> > --- /dev/null >> > +++ b/Documentation/devicetree/bindings/sound/name-prefix.yaml >> > @@ -0,0 +1,35 @@ >> > +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) >> > +%YAML 1.2 >> > +--- >> > +$id: http://devicetree.org/schemas/sound/name-prefix.yaml# >> > +$schema: http://devicetree.org/meta-schemas/core.yaml# >> > + >> > +title: Component sound name prefix >> > + >> > +maintainers: >> > + - Jerome Brunet >> >> Since this file is referenced using "AllOf", am I going to be listed as >> maintainer of all the drivers using the property below ? I'm not sure I >> want that ... :P > > No. That's not how it works. You're maintainer of files that list you as > maintainer. Thanks for clarifying. You can ignore my comment then Sameer. > >> Maybe it would be better to drop the above ? >> >> > + >> > +properties: >> > + sound-name-prefix: >> > + $ref: /schemas/types.yaml#/definitions/string >> > + description: | >> > + Card implementing the routing property define the connection between >> > + audio components as list of string pair. Component using the same >> > + sink/source names may use this property to prepend the name of their >> > + sinks/sources with the provided string. >> > + >> > +additionalProperties: true >> > + >> > +examples: >> > + - | >> > + analog-amplifier@0 { >> > + compatible = "simple-audio-amplifier"; >> > + sound-name-prefix = "FRONT"; >> > + }; >> > + >> > + analog-amplifier@1 { >> > + compatible = "simple-audio-amplifier"; >> > + sound-name-prefix = "BACK"; >> > + }; >> > + >> > +... >> >>