From patchwork Tue Jul 17 15:43:03 2018 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Jerome Brunet X-Patchwork-Id: 142181 Delivered-To: patch@linaro.org Received: by 2002:a2e:9754:0:0:0:0:0 with SMTP id f20-v6csp3821289ljj; Tue, 17 Jul 2018 08:43:57 -0700 (PDT) X-Google-Smtp-Source: AAOMgpdxZeCtWs6Cpzapz4nx0/TIJNupKko2YXiGHtz3qjsabcdhS3Xs6QeWsuuSfOwIOI/FA0qp X-Received: by 2002:a63:1015:: with SMTP id f21-v6mr2126667pgl.354.1531842237849; Tue, 17 Jul 2018 08:43:57 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1531842237; cv=none; d=google.com; s=arc-20160816; b=PJIJWm7xpGDOgONzKBvGwOLt8wAq8KV9cRzwJ8BdfrSjqyKKoVSqbECsbfuWRJYwK8 uuSxDlFb7q4ITEekl0na6sSz0qrDFZXnxWU8JyqMwfJnIZcWt/m6XBx8i9ZPqK65cmiU 8AitH1gtn131D2m+oHYLOGwkO1y4YPTdkdf234D8CRbrCEriWK9A4A5l1mOaDUwzGFwU 7CT3KKv7IWCBDsu1yTs7DzQwctgS3egep4jxTghdzsq2hRRP2wer84MV9Ood8M8Vz54t 6cWW56ffLVWjy3rPuSM40j73B3/swZjLDN5VV2uELdSX1umjerSOeQmX1vHaPU3qcjdD gVOA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:sender:references:in-reply-to:message-id:date :subject:cc:to:from:dkim-signature:arc-authentication-results; bh=VBv8/QDWk+qHjJZaxe5JulpWKLqIxa2ERSD6Eqkd9xk=; b=GyO3txfJybHt/WrcyAiBGZ/TgxbpapTTIWQFIkv2cW6Ii+PFXi/g3V7aqTH3981baV lGHwFOfAwWEqpHRx973FinnAWt8sQTv05s5ud8LN5SzT2w5teovKrXmOhSDmSRYpIAGj Iy2XgzLTyUruDJSPYphRSEYti8fmX4F7EjZfpv3UWTrGWn6kAK24lQ+aRQlUP0JHUoaL h0OoXY7fHlTj7sjP+T+bafDjLjqp4/CenOjalOHGNJqEr+u/LiuV+I5w9vTApStP4t8V H64p8feFGZozZbkd4Bd9+di1YMdjSzjaKK9pNYzBW3mrEBJs6YeqeQum885LaSVnRd8h Dapg== ARC-Authentication-Results: i=1; mx.google.com; dkim=neutral (body hash did not verify) header.i=@baylibre-com.20150623.gappssmtp.com header.s=20150623 header.b=gZXCDJkb; spf=pass (google.com: best guess record for domain of devicetree-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) smtp.mailfrom=devicetree-owner@vger.kernel.org Return-Path: Received: from vger.kernel.org (vger.kernel.org. [209.132.180.67]) by mx.google.com with ESMTP id q10-v6si1108536pge.674.2018.07.17.08.43.57; Tue, 17 Jul 2018 08:43:57 -0700 (PDT) Received-SPF: pass (google.com: best guess record for domain of devicetree-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) client-ip=209.132.180.67; Authentication-Results: mx.google.com; dkim=neutral (body hash did not verify) header.i=@baylibre-com.20150623.gappssmtp.com header.s=20150623 header.b=gZXCDJkb; spf=pass (google.com: best guess record for domain of devicetree-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) smtp.mailfrom=devicetree-owner@vger.kernel.org Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1731613AbeGQQRL (ORCPT + 5 others); Tue, 17 Jul 2018 12:17:11 -0400 Received: from mail-wr1-f67.google.com ([209.85.221.67]:33776 "EHLO mail-wr1-f67.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1731545AbeGQQQo (ORCPT ); Tue, 17 Jul 2018 12:16:44 -0400 Received: by mail-wr1-f67.google.com with SMTP id g6-v6so1745872wrp.0 for ; Tue, 17 Jul 2018 08:43:29 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=baylibre-com.20150623.gappssmtp.com; s=20150623; h=from:to:cc:subject:date:message-id:in-reply-to:references; bh=N6GTffq4VROTez5mVO69vAu2OUH/qIKN2B9n0MrCC48=; b=gZXCDJkbbxdMAlykgi/nKAkQ+iKUivQ0erasXVwOHa1GW1ovrHFawFOioCSN7CYHxz mFEQj91aGz86zm8Q960qzh3Mgz0Q6azu0TdcMALA1ViqJtQhGo0a4oh3PfL48IzIMxc/ S+OAgmcUP474AxciyUlA9Owfzm4vlJtvdTfXDKoBZjYRmr1ddT3lAFLHSFZNEUqZi35t MniAqp8LlEQE1tgPbCd+qPDShQd8FVf6leJjrioudKW5UfBX/1UtDPxagpUlXrPnAXQW 0Qig/bfpwUSAKJuDmH4MRM+hbd9SOCxF4qroZK4ZjtIO4Xnv10RAvU/lNmh+po3b5ME6 W8fg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:date:message-id:in-reply-to :references; bh=N6GTffq4VROTez5mVO69vAu2OUH/qIKN2B9n0MrCC48=; b=G3mOq0a9RDBRXA6+EiPT7Zghbkd/w3oF3BzU2fuhB3IoWc5bfE0576/Vnzsmnf+hQh iULJwRJ+vqSk3d2S6tbPGFiMzXRRLYHtTjeTOn76fMhmDT5h5kplAgYB8/A+YLOrP1NO 4Aw9lzddAqypmHkroAfdtQx6tsaQUgucZJNkfI1TjFJFzZ71ibm9DI+k7kOB3smgXNbG YGgr3aLnvfpryS6J4JVLgS3Rvquj3GF7Wa9CHvGf4vPLkz5/b1anzzZvVVg/5KXaL9ZZ qS+BG35y15e9mVW11afJjJya0hYhSKZXI6GJhSF6Al6+3P3L1vH0hvgyRWT8UW68g4LX vYHw== X-Gm-Message-State: AOUpUlEhHj016U8c3BFgAMiRWT9ff+/Oa1ZVpHviSHUebC5HG0f8oXI8 7umdZeD6qRHFU7AIdvfTHdeg1g== X-Received: by 2002:adf:f210:: with SMTP id p16-v6mr1827816wro.184.1531842208515; Tue, 17 Jul 2018 08:43:28 -0700 (PDT) Received: from boomer.baylibre.local ([90.63.244.31]) by smtp.googlemail.com with ESMTPSA id s12-v6sm17598252wmc.2.2018.07.17.08.43.27 (version=TLS1_2 cipher=ECDHE-RSA-CHACHA20-POLY1305 bits=256/256); Tue, 17 Jul 2018 08:43:27 -0700 (PDT) From: Jerome Brunet To: Mark Brown , Liam Girdwood , Kevin Hilman , Carlo Caione Cc: Jerome Brunet , alsa-devel@alsa-project.org, devicetree@vger.kernel.org, linux-kernel@vger.kernel.org, linux-amlogic@lists.infradead.org Subject: [PATCH RESEND 14/15] ASoC: meson: add axg sound card DT bindings documentation Date: Tue, 17 Jul 2018 17:43:03 +0200 Message-Id: <20180717154304.9973-15-jbrunet@baylibre.com> X-Mailer: git-send-email 2.14.4 In-Reply-To: <20180717154304.9973-1-jbrunet@baylibre.com> References: <20180717154304.9973-1-jbrunet@baylibre.com> Sender: devicetree-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: devicetree@vger.kernel.org Add the DT bindings documentation for axg sound card Signed-off-by: Jerome Brunet --- .../bindings/sound/amlogic,axg-sound-card.txt | 124 +++++++++++++++++++++ 1 file changed, 124 insertions(+) create mode 100644 Documentation/devicetree/bindings/sound/amlogic,axg-sound-card.txt -- 2.14.4 -- To unsubscribe from this list: send the line "unsubscribe devicetree" in the body of a message to majordomo@vger.kernel.org More majordomo info at http://vger.kernel.org/majordomo-info.html diff --git a/Documentation/devicetree/bindings/sound/amlogic,axg-sound-card.txt b/Documentation/devicetree/bindings/sound/amlogic,axg-sound-card.txt new file mode 100644 index 000000000000..39e005da0407 --- /dev/null +++ b/Documentation/devicetree/bindings/sound/amlogic,axg-sound-card.txt @@ -0,0 +1,124 @@ +Amlogic AXG sound card: + +Required properties: + +- compatible: "amlogic,axg-sound-card" +- amlogic,name : User specified audio sound card name, one string + +Optional properties: + +- amlogic,aux-devs : List of phandles pointing to auxiliary devices +- amlogic,widgets : Please refer to widgets.txt. +- amlogic,routing : A list of the connections between audio components. + +Subnodes: + +- amlogic,dai-link: Container for dai-link level properties and the + CODEC sub-nodes. There should be at least one (and + probably) subnode of this type. + +Required dai-link properties: + +- sound-dai: phandle and port of the CPU DAI. + +Required TDM Backend dai-link properties: +- dai-format : CPU/CODEC common audio format + +Optional TDM Backend dai-link properties: +- dai-tdm-slot-rx-mask-{0,1,2,3}: Receive direction slot masks +- dai-tdm-slot-tx-mask-{0,1,2,3}: Transmit direction slot masks + When omitted, mask is assumed to have to no + slots. A valid must have at one slot, so at + least one these mask should be provided with + an enabled slot. +- dai-tdm-slot-num : Please refer to tdm-slot.txt. + If omitted, slot number is set to accommodate the largest + mask provided. +- dai-tdm-slot-width : Please refer to tdm-slot.txt. default to 32 if omitted. +- mclk-fs : Multiplication factor between stream rate and mclk + +Backend dai-link subnodes: + +- codec: dai-link representing backend links should have at least one subnode. + One subnode for each codec of the dai-link. + dai-link representing frontend links have no codec, therefore have no + subnodes + +Required codec subnodes properties: + +- sound-dai: phandle and port of the CODEC DAI. + +Optional codec subnodes properties: + +- dai-tdm-slot-tx-mask : Please refer to tdm-slot.txt. +- dai-tdm-slot-rx-mask : Please refer to tdm-slot.txt. + +Example: + +sound { + compatible = "amlogic,axg-sound-card"; + amlogic,name = "AXG-S420"; + amlogic,aux-devs = <&tdmin_a>, <&tdmout_c>; + amlogic,widgets = "Line", "Lineout", + "Line", "Linein", + "Speaker", "Speaker1 Left", + "Speaker", "Speaker1 Right"; + "Speaker", "Speaker2 Left", + "Speaker", "Speaker2 Right"; + amlogic,routing = "TDMOUT_C IN 0", "FRDDR_A OUT 2", + "SPDIFOUT IN 0", "FRDDR_A OUT 3", + "TDM_C Playback", "TDMOUT_C OUT", + "TDMIN_A IN 2", "TDM_C Capture", + "TDMIN_A IN 5", "TDM_C Loopback", + "TODDR_A IN 0", "TDMIN_A OUT", + "Lineout", "Lineout AOUTL", + "Lineout", "Lineout AOUTR", + "Speaker1 Left", "SPK1 OUT_A", + "Speaker2 Left", "SPK2 OUT_A", + "Speaker1 Right", "SPK1 OUT_B", + "Speaker2 Right", "SPK2 OUT_B", + "Linein AINL", "Linein", + "Linein AINR", "Linein"; + + amlogic,dai-link@0 { + sound-dai = <&frddr_a>; + }; + + amlogic,dai-link@1 { + sound-dai = <&toddr_a>; + }; + + amlogic,dai-link@2 { + sound-dai = <&tdmif_c>; + dai-format = "i2s"; + dai-tdm-slot-tx-mask-2 = <1 1>; + dai-tdm-slot-tx-mask-3 = <1 1>; + dai-tdm-slot-rx-mask-1 = <1 1>; + mclk-fs = <256>; + + codec@0 { + sound-dai = <&lineout>; + }; + + codec@1 { + sound-dai = <&speaker_amp1>; + }; + + codec@2 { + sound-dai = <&speaker_amp2>; + }; + + codec@3 { + sound-dai = <&linein>; + }; + + }; + + amlogic,dai-link@4 { + sound-dai = <&spdifout>; + + codec { + sound-dai = <&spdif_dit>; + }; + }; +};