Message ID | 20240828-topic-amlogic-upstream-bindings-fixes-audio-snd-card-v2-2-58159abf0779@linaro.org (mailing list archive) |
---|---|
State | New, archived |
Headers | show
Return-Path: <linux-arm-kernel-bounces+linux-arm-kernel=archiver.kernel.org@lists.infradead.org> X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from bombadil.infradead.org (bombadil.infradead.org [198.137.202.133]) (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 065F0C54FAA for <linux-arm-kernel@archiver.kernel.org>; Wed, 28 Aug 2024 13:57:30 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=lists.infradead.org; s=bombadil.20210309; h=Sender:List-Subscribe:List-Help :List-Post:List-Archive:List-Unsubscribe:List-Id:Cc:To:In-Reply-To:References :Message-Id:Content-Transfer-Encoding:Content-Type:MIME-Version:Subject:Date: From:Reply-To:Content-ID:Content-Description:Resent-Date:Resent-From: Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID:List-Owner; bh=TTWHuW86NTs+103uuN2zaYjUY11Ov5iBD80i8ni2ivs=; b=NysFt+5ANzLlmB0MssIbMFlGhS rEUWqdb3tCBWjcBDroyAya638dyxiRcQ/bIQ5oRLu3SD5eQCL82mTtx7h9xWqkQdFR9FPVaAUi+BO bFpVTtOygcRex8Ai1V9WHDQcUGuJ5POIUq1mpOAV57dKfR29K6nIE/JNAoUdoYretQCNdJPyn2siY ee18pIl8iCxNNyI0+Jjpw2gx4PELjwY34POZMLwL/nyksR5cyymFk1LrNPWXgYRe8sRx1+tLwIhtr nmHRCmcQJUkA5cmPA8gOGRmKEPxTk8HI8SurO8xDy869Mz0FclG3yKEwuduqd6696wBbzWXd/MiMd 0UZNF8Ow==; Received: from localhost ([::1] helo=bombadil.infradead.org) by bombadil.infradead.org with esmtp (Exim 4.97.1 #2 (Red Hat Linux)) id 1sjJAl-0000000FcqS-1mlp; Wed, 28 Aug 2024 13:57:19 +0000 Received: from mail-wr1-x42c.google.com ([2a00:1450:4864:20::42c]) by bombadil.infradead.org with esmtps (Exim 4.97.1 #2 (Red Hat Linux)) id 1sjJ7d-0000000FbcJ-0f6u for linux-arm-kernel@lists.infradead.org; Wed, 28 Aug 2024 13:54:07 +0000 Received: by mail-wr1-x42c.google.com with SMTP id ffacd0b85a97d-371ba7e46easo3944178f8f.0 for <linux-arm-kernel@lists.infradead.org>; Wed, 28 Aug 2024 06:54:04 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=linaro.org; s=google; t=1724853243; x=1725458043; darn=lists.infradead.org; h=cc:to:in-reply-to:references:message-id:content-transfer-encoding :mime-version:subject:date:from:from:to:cc:subject:date:message-id :reply-to; bh=TTWHuW86NTs+103uuN2zaYjUY11Ov5iBD80i8ni2ivs=; b=wZKmmpZoqPe6lcPzf8+Hqq7tyNjXAqAwdmiUUsAxuK8oiuDr/M4l7H/AHCnqvsH1Mk juWZP2UDMW1yOUx2ug+tAvdcQPe9F8cWQUYh7S1AWnRSs+TOzOkVr+78fcLTFLGX5K8T VzrG3RkNLFeMXXRNYOBBY/wXnNttly3lFMNlw3wnFXMO6UVptx63vT9JGmEGjyKoeng8 Kw45k8w4n3Ks2y6mapdHN4wcG91A36t/kpX3BHTmwPWlTbRfMO6aAJH8HsVwt25WAuGT Dwgcno4svKU9jdfHJ8fOVYQrMp+fUPFCsYtPzTdPEIU4xDyiwSAqP5Whm0gC6z3MGh2h VFcA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1724853243; x=1725458043; h=cc:to:in-reply-to:references:message-id:content-transfer-encoding :mime-version:subject:date:from:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=TTWHuW86NTs+103uuN2zaYjUY11Ov5iBD80i8ni2ivs=; b=cyoUJhPiSxm3jwqgscCGpg7moZgUUwrjuv01+3TAsYnwCrtZmeAB9sZDAYosYA0d/7 OG2iMMXceDaL8SyZtD0FKbFHnrLbjYcWRz+dU29ws5Ro56X1KqtlRd5sEvoe45E4IDXo wpibdSDGmgDj1OxrFD3OHmcK+6YCl6ztaHtnp/YlU3JCRKGhnjxbQrqsFL3Vcg02toDf UStYCPe3VquvcWRz4nPgUEh1Yze6JGCz/3bTDRZXFD6ir5V9s+QUFJpDQ5hRTT0Miq7/ sxWrRNiMn5b7d596qZrLkaHmzfOxwRK8hip+rSXeIzWZC5NXhn2nWgEV1IbB0pH+iwLq FB2A== X-Forwarded-Encrypted: i=1; AJvYcCX3g+z3yt3asDhmcNvTJGIVZiAanE1l8eNBqECux+I7FZZGpMpDqZYgDguig/dVoMQngqaH2bMADxPcBmTYVTX9@lists.infradead.org X-Gm-Message-State: AOJu0YwiDoT6e5oK0EH5yPGeWZZpenVYiTVBaPmIpUgCNdVSFXs2pSnb jaitD2M9SdQ+dFEYe5b+jmrsYAuIN/RYx4iw3C0pOFvvFct/1qJpKQLctX0ZzTkpBLV4atYhK/M 4 X-Google-Smtp-Source: AGHT+IEIRP7AywU7RW8H7GuK91sm441qq/B1K30YGS/4flS761qiJ+wLNYFmEH4P9KhRRx0bXPBEsg== X-Received: by 2002:adf:a416:0:b0:371:8d47:c174 with SMTP id ffacd0b85a97d-37311865093mr10293637f8f.30.1724853242544; Wed, 28 Aug 2024 06:54:02 -0700 (PDT) Received: from arrakeen.starnux.net ([2a01:e0a:982:cbb0:52eb:f6ff:feb3:451a]) by smtp.gmail.com with ESMTPSA id ffacd0b85a97d-3730813c44asm15613395f8f.34.2024.08.28.06.54.01 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 28 Aug 2024 06:54:02 -0700 (PDT) From: Neil Armstrong <neil.armstrong@linaro.org> Date: Wed, 28 Aug 2024 15:53:55 +0200 Subject: [PATCH v2 2/3] ASoC: dt-bindings: amlogic,gx-sound-card: document clocks property MIME-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: 7bit Message-Id: <20240828-topic-amlogic-upstream-bindings-fixes-audio-snd-card-v2-2-58159abf0779@linaro.org> References: <20240828-topic-amlogic-upstream-bindings-fixes-audio-snd-card-v2-0-58159abf0779@linaro.org> In-Reply-To: <20240828-topic-amlogic-upstream-bindings-fixes-audio-snd-card-v2-0-58159abf0779@linaro.org> To: Jerome Brunet <jbrunet@baylibre.com>, Liam Girdwood <lgirdwood@gmail.com>, Mark Brown <broonie@kernel.org>, Rob Herring <robh@kernel.org>, Krzysztof Kozlowski <krzk+dt@kernel.org>, Conor Dooley <conor+dt@kernel.org>, Kevin Hilman <khilman@baylibre.com>, Martin Blumenstingl <martin.blumenstingl@googlemail.com> Cc: alsa-devel@alsa-project.org, linux-sound@vger.kernel.org, devicetree@vger.kernel.org, linux-kernel@vger.kernel.org, linux-arm-kernel@lists.infradead.org, linux-amlogic@lists.infradead.org, Neil Armstrong <neil.armstrong@linaro.org> X-Mailer: b4 0.14.0 X-Developer-Signature: v=1; a=openpgp-sha256; l=1722; i=neil.armstrong@linaro.org; h=from:subject:message-id; bh=H+G0uR0uGtkQ/5/97rdsSRom5F7Ggvn+WvWc7nnJ2JY=; b=owEBbQKS/ZANAwAKAXfc29rIyEnRAcsmYgBmzyv2GqTu1q87S0Q2rSDxbQeeYYgHw/Riu2gqWSyE 6fyZXPGJAjMEAAEKAB0WIQQ9U8YmyFYF/h30LIt33NvayMhJ0QUCZs8r9gAKCRB33NvayMhJ0QPDD/ 9WZk9izqKs6sRDdw/RiFAlLH3jgXyr8Oen2cHF65E/3nU+f0raTKs8LFYUXB4keLMiIPjka4JMJ+qT Kq7U0XPlmrLBw+975gaJMTgvS347fDb9Lyy5925kgoniTSsUiQ7dFxSC8jHi8ag/FRTAE7hVDsy344 pYCtFpDbcGbdFIqe4XiIBasUsV5d4cr0aMpde+pWil+jzt0fV3vUw4m0ZHO8u54FxV8vFApmMuqIpv oeOQdoUIzP3hmOFDjwV5N/CeX2fEB5YOcHupvL1toZyr1Z9cG1ih1IGQg4okSvoxeP/u9o1/hB5GX6 atENd4NA66+Aa/uDTzZZS+VNIhkDxrhtLiA1RV1kgnnZ3TyeZogfz+hlTRLrWK1L6AM8s9A+DMtCHW zp4lL22MVI0tobGLNnzUAFdoF79ywKYXF8hGJj50NUOOSWWXddV/5I5mbDDi+kWUi+1WeUemaGeqTy O5e1X90OQP8GwSQ+1O1pLSSTHGPfVABg/NWSOzKytNNK8CVbTrMmLPHwAZTp2gssbn3Z06fayAKDxg GuTpXrh0m2b/gWmrqxaYDOz30LO2OrZnAZGufIpgiEZhou0WRyh4FmFdGOMeOsIe3mP9H5oKGaHesx WgrGpPI7vhohkcivoGL9ksfQ7YFP+fBABfp2a8u97oT2ZJJTqcASilQYZiYw== X-Developer-Key: i=neil.armstrong@linaro.org; a=openpgp; fpr=89EC3D058446217450F22848169AB7B1A4CFF8AE X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20240828_065405_245282_C6E112D0 X-CRM114-Status: GOOD ( 12.60 ) X-BeenThere: linux-arm-kernel@lists.infradead.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: <linux-arm-kernel.lists.infradead.org> List-Unsubscribe: <http://lists.infradead.org/mailman/options/linux-arm-kernel>, <mailto:linux-arm-kernel-request@lists.infradead.org?subject=unsubscribe> List-Archive: <http://lists.infradead.org/pipermail/linux-arm-kernel/> List-Post: <mailto:linux-arm-kernel@lists.infradead.org> List-Help: <mailto:linux-arm-kernel-request@lists.infradead.org?subject=help> List-Subscribe: <http://lists.infradead.org/mailman/listinfo/linux-arm-kernel>, <mailto:linux-arm-kernel-request@lists.infradead.org?subject=subscribe> Sender: "linux-arm-kernel" <linux-arm-kernel-bounces@lists.infradead.org> Errors-To: linux-arm-kernel-bounces+linux-arm-kernel=archiver.kernel.org@lists.infradead.org |
Series |
ASoC: dt-bindings: amlogic-sound-cards: document clocks property
|
expand
|
diff --git a/Documentation/devicetree/bindings/sound/amlogic,gx-sound-card.yaml b/Documentation/devicetree/bindings/sound/amlogic,gx-sound-card.yaml index 0ecdaf7190e9..413b47778181 100644 --- a/Documentation/devicetree/bindings/sound/amlogic,gx-sound-card.yaml +++ b/Documentation/devicetree/bindings/sound/amlogic,gx-sound-card.yaml @@ -27,6 +27,13 @@ properties: A list off component DAPM widget. Each entry is a pair of strings, the first being the widget type, the second being the widget name + clocks: + minItems: 1 + maxItems: 3 + description: + Base PLL clocks of audio susbsytem, used to configure base clock + frequencies for different audio use-cases. + patternProperties: "^dai-link-[0-9]+$": type: object
The sound card design is based on reference PLL frequencies that are the root of all clock rates calculations. Today, those frequencies are currently specified in DT via assigned-clocks, because they correspond to the basic audio use-case. It makes no sense to setup clock rates for a sound card without referencing the clocks for the sound card, mainly because at some point more complex audio use cases will be supported and those root rates would need to change. To solve this situation, let's legitimize the presence of assigned-clocks in the sound card by documenting those clocks, as it describes a true dependency of the sound card and paths the way of more complex audio uses-cases involving those root frequencies. Signed-off-by: Neil Armstrong <neil.armstrong@linaro.org> --- Documentation/devicetree/bindings/sound/amlogic,gx-sound-card.yaml | 7 +++++++ 1 file changed, 7 insertions(+)