From nobody Tue Sep 29 04:13:33 2026 Received: from mail-pg1-f181.google.com (mail-pg1-f181.google.com [209.85.215.181]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 4D122343D8A for ; Wed, 12 Aug 2026 19:11:46 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.215.181 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1786561907; cv=none; b=denonc6uriNcvbukN33XAJ4U/aSzE4n3hdF8qW9TKeULDdoEFDthsSFMtye0h1+YUu3e7gP8lP+bT8JcO37K4KwueuSreHGVeLEyv+v36QJsruRpYweUD3hbhGK/eLPWydJ/S8qu44T73TpG2/CegtD7vELSamUW2227jXlVvbs= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1786561907; c=relaxed/simple; bh=QRPObjn0T2tfzHzHXODIwHCVbLKA/nQO3o1BxGgfRGw=; h=From:Date:Subject:MIME-Version:Content-Type:Message-Id:References: In-Reply-To:To:Cc; b=FwhlfUZFmFNUfkB/tOOh9utHBcZdM3HgU0cmmeTZENrz9/mqnpj4t7ndbSOJ1sUXgs4Pn3AU1lqvIaDYofwISkUyMu5W5Ld4XhaZ65nht+J6x5jUhqel3fyhz4mBZ0uN6T2bhZDgAg4uzYGI5i28l6t6EX08gWwhEUzG95hns4Q= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com; spf=pass smtp.mailfrom=gmail.com; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b=BwDYCRWh; arc=none smtp.client-ip=209.85.215.181 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=gmail.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b="BwDYCRWh" Received: by mail-pg1-f181.google.com with SMTP id 41be03b00d2f7-ca53979f8e8so110987a12.2 for ; Wed, 12 Aug 2026 12:11:46 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20251104; t=1786561905; x=1787166705; darn=vger.kernel.org; h=cc:to:in-reply-to:references:message-id:content-transfer-encoding :content-type:mime-version:subject:date:from:from:to:cc:subject:date :message-id:reply-to:content-type; bh=3B7kXto184IfdvkiNtrKwwTv2Mmp7EHyOrh+nVPdHPQ=; b=BwDYCRWhz7LcVgEMPmCNUjIiLv0NZj/wCUiXdNz0ddKIp0b1PzMsdzMuQt/S34jLAC iED5j9bDzZtP75M/UHPU3PzDYs1sxfDX7TWtTtxGZuotEjJrEpI74Zp3a5MYWePjwt5d ULnd5ojy2r1UdiYeFnOoVv/Qlym1M6/U+BO37FMif2lTLcGt+Stcr5UjF/xYY1vNmGLZ AL1u42ldmEHATHeaWVtQ7UziJXZ1/0nIrf2xB7HPwOb5MM+IKBb0oCcRr6c2a/Dl2GDr IjEjl+/OosCLCQ3kZeIEfFLlEPAgtw93k96Ft84a57DM2UH740e8Bp0+WooUNiur5HFJ Q6wA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20251104; t=1786561905; x=1787166705; h=cc:to:in-reply-to:references:message-id:content-transfer-encoding :content-type:mime-version:subject:date:from:x-gm-gg :x-gm-message-state:from:to:cc:subject:date:message-id:reply-to :content-type; bh=3B7kXto184IfdvkiNtrKwwTv2Mmp7EHyOrh+nVPdHPQ=; b=Ws9Z83I8RHeAQWXLD3wWuiYoGjDwSvJu0xxiTY59SaOAL4B3HrBnUk21/UUjeUio7I gE1xF/V9y1qNYnTg/+F41xkJmbuojoX9qo7k7WStZ5EANLEhdE2JHnQ3W96VBAFI3g1j Z2hqoJFa3hrjQ8hGFJyEJ3xvu24jhacu6ykVBUl7TC/mGg2K4rlLFb6SJ3WFqMXrIiXY z4TcrW9NkfMzuCuqF+l/YhgzpoqUlEhf9c/U8RCFb/x8gJZbRoEID7W+sXoUAjWbi5bv eN/qjbozpvxO5iwBKEZ/CTbMhfVikI8CNKjO7LJmCfHU4BPVybm21sOgI5gNQiENx6uc j/AA== X-Forwarded-Encrypted: i=1; AHgh+RqEpJ5lP4nF89Kj+nVVp60Hz9goR7uwUgoLH/skcK2F9+6E2XtldgQhFrtEb6R/kI5HvUEaNSkkPFJ52Jg=@vger.kernel.org X-Gm-Message-State: AOJu0YwkFRQcc6JVh6qd8eUHKneg8Rep94jCVWSMbCSV0nZl4gLFW4Co EI52L4lwHyOEbIN7o6Sa4YnJZfARgpfYYaNtANzFGzC+6+H47KRvcz8e X-Gm-Gg: AR+sD11MUn54+uxQOsAkqs8KFcoXmM572tcc//goknH+uWS/PrGFEvgxFC0s4pTif4w H6Zpauqyakw1e801MgcJKP07FAMlfqkb4xVLM7Y6W9DiGQ5XrZBvcVsG0jSn5RbF1HpUVgu67dl yNNK6pBtTb8G9SBRA3Ptw1wodEfVT6hnGD/dWGjt/TdQn/X5LAMB28LYTHF18OWsZBmEp34gcgb xvWVEwpVe+ejYoq7bkZbtRJdDpR4LjiT8YdlzebG6N0u9yj5lM7zyAkA2ZpgCwtvh4N9VGvK3uc RIYUxtNv7ULeUKUrwF/3nB85H+13vluzKfyn5KtkZkh/b8OwQ5bOxmjvH4k+wHBwskVAHCNDo5f K4DY9FG0kRPUZMnY+0hDnDQ/IyyqgTnLGb7F7AIdjdn+AvEvvN604EvSRcypY5odTS/AlVdMJKM ot9nzTM4q38idkYGPzHOJRguo1Bdkh/Y7aVMFtjV4QZLjo2tH4+uQkJefngCgiemtOqRtR+WQ= X-Received: by 2002:a17:903:184c:b0:2cb:2b50:d9da with SMTP id d9443c01a7336-2d37e8a68bdmr1263255ad.3.1786561905423; Wed, 12 Aug 2026 12:11:45 -0700 (PDT) Received: from [10.170.23.252] ([2409:40c2:5017:a6a2:eb70:cb11:a19e:bd5]) by smtp.gmail.com with ESMTPSA id 5a478bee46e88-31da7bf64b5sm9496947eec.10.2026.08.12.12.11.33 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 12 Aug 2026 12:11:44 -0700 (PDT) From: Bhargav Joshi Date: Thu, 13 Aug 2026 00:41:17 +0530 Subject: [PATCH 1/2] dt-bindings: clock: ti,dra7-atl-clock: convert to DT schema Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: quoted-printable Message-Id: <20260813-ti-dra7-atl-v1-1-27b691f4cdcf@gmail.com> References: <20260813-ti-dra7-atl-v1-0-27b691f4cdcf@gmail.com> In-Reply-To: <20260813-ti-dra7-atl-v1-0-27b691f4cdcf@gmail.com> To: Michael Turquette , Stephen Boyd , Brian Masney , Rob Herring , Krzysztof Kozlowski , Conor Dooley , Peter Ujfalusi Cc: linux-clk@vger.kernel.org, devicetree@vger.kernel.org, linux-kernel@vger.kernel.org, goledhruva@gmail.com, m-chawdhry@ti.com, daniel.baluta@gmail.com, simona.toaca@nxp.com, j.bhargav.u@gmail.com X-Mailer: b4 0.14.3 X-Developer-Signature: v=1; a=ed25519-sha256; t=1786561882; l=3600; i=j.bhargav.u@gmail.com; h=from:subject:message-id; bh=QRPObjn0T2tfzHzHXODIwHCVbLKA/nQO3o1BxGgfRGw=; b=DFOrPCV2VjEUWtlAtTbng/bANfNCYOgDCWkZnM4nWP5LqiHMaOnTiphppFuA7aTCGcfjId3YG mURMRC3JBIuAAxOJXKPEoHHpqFVq92gQ8VRK7Yu5QjNKYtWwPMrfPl3 X-Developer-Key: i=j.bhargav.u@gmail.com; a=ed25519; pk=IqNDwUZKECEA+n8wXctFLBbYL9NhFstZNbOznm/nX1k= Convert the clock output portion of the DRA7 ATL (Audio Tracking Logic) binding from text to DT schema. property clock-output-names is added that is used by existing dts/dtsi. Signed-off-by: Bhargav Joshi Reviewed-by: Rob Herring (Arm) --- .../devicetree/bindings/clock/ti/dra7-atl.txt | 38 ------------------= ---- .../bindings/clock/ti/ti,dra7-atl-clock.yaml | 38 ++++++++++++++++++= ++++ 2 files changed, 38 insertions(+), 38 deletions(-) diff --git a/Documentation/devicetree/bindings/clock/ti/dra7-atl.txt b/Docu= mentation/devicetree/bindings/clock/ti/dra7-atl.txt index 68504079f99f..e3c05844ae86 100644 --- a/Documentation/devicetree/bindings/clock/ti/dra7-atl.txt +++ b/Documentation/devicetree/bindings/clock/ti/dra7-atl.txt @@ -9,20 +9,6 @@ signals - can compensate the drift between the two ws sign= al. In order to provide the support for ATL and its output clocks (which can b= e used internally within the SoC or external components) two sets of bindings is = needed: =20 -Clock tree binding: -This binding uses the common clock binding[1]. -To be able to integrate the ATL clocks with DT clock tree. -Provides ccf level representation of the ATL clocks to be used by drivers. -Since the clock instances are part of a single IP this binding is used as = a node -for the DT clock tree, the IP driver is needed to handle the actual config= uration -of the IP. - -[1] Documentation/devicetree/bindings/clock/clock-bindings.txt - -Required properties: -- compatible : shall be "ti,dra7-atl-clock" -- #clock-cells : from common clock binding; shall be set to 0. -- clocks : link phandles to functional clock of ATL =20 Binding for the IP driver: This binding is used to configure the IP driver which is going to handle t= he @@ -47,30 +33,6 @@ For valid word select signals, see the dt-bindings/clock= /ti-dra7-atl.h include file. =20 Examples: -/* clock bindings for atl provided clocks */ -atl_clkin0_ck: atl_clkin0_ck { - #clock-cells =3D <0>; - compatible =3D "ti,dra7-atl-clock"; - clocks =3D <&atl_gfclk_mux>; -}; - -atl_clkin1_ck: atl_clkin1_ck { - #clock-cells =3D <0>; - compatible =3D "ti,dra7-atl-clock"; - clocks =3D <&atl_gfclk_mux>; -}; - -atl_clkin2_ck: atl_clkin2_ck { - #clock-cells =3D <0>; - compatible =3D "ti,dra7-atl-clock"; - clocks =3D <&atl_gfclk_mux>; -}; - -atl_clkin3_ck: atl_clkin3_ck { - #clock-cells =3D <0>; - compatible =3D "ti,dra7-atl-clock"; - clocks =3D <&atl_gfclk_mux>; -}; =20 /* binding for the IP */ atl: atl@4843c000 { diff --git a/Documentation/devicetree/bindings/clock/ti/ti,dra7-atl-clock.y= aml b/Documentation/devicetree/bindings/clock/ti/ti,dra7-atl-clock.yaml new file mode 100644 index 000000000000..c0795f4abcfa --- /dev/null +++ b/Documentation/devicetree/bindings/clock/ti/ti,dra7-atl-clock.yaml @@ -0,0 +1,38 @@ +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/clock/ti/ti,dra7-atl-clock.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: TI DRA7 ATL (Audio Tracking Logic) clock output + +maintainers: + - Peter Ujfalusi + +properties: + compatible: + const: ti,dra7-atl-clock + + "#clock-cells": + const: 0 + + clocks: + maxItems: 1 + + clock-output-names: + maxItems: 1 + +required: + - compatible + - "#clock-cells" + - clocks + +additionalProperties: false + +examples: + - | + atl_clkin0_ck { + compatible =3D "ti,dra7-atl-clock"; + #clock-cells =3D <0>; + clocks =3D <&atl_gfclk_mux>; + }; --=20 2.55.0 From nobody Tue Sep 29 04:13:33 2026 Received: from mail-pl1-f180.google.com (mail-pl1-f180.google.com [209.85.214.180]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 2F07C363C46 for ; Wed, 12 Aug 2026 19:11:57 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.214.180 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1786561919; cv=none; b=asaG2vSmxfvrnKIaltf87M5Hh/u/DXmy7rJJFfEK0WJl630CniCTR7bsu5e+JzhKHk5VgZ2K6Wjontpdj27tJRFQOwlvgrUQ0ke3TXaqjcNc2efikMmVFoDZUzSG5gkRSZKUugqwEEco8XySNiK6AOGEQJzpADaVaAW/ry9tfE8= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1786561919; c=relaxed/simple; bh=kLXwjiY0hk/bsIhaPf9r0kAxsBg3pdBby5bPIV/S2SI=; h=From:Date:Subject:MIME-Version:Content-Type:Message-Id:References: In-Reply-To:To:Cc; b=bNYw3B5AsQojiqqf28yHHGJPO+kgNFpdxlJtmFz0TJorJysxdrxlGZTaGG3WiKCrK8JJsVm40fb9HG+h+lO/BZto5Q7f3QqtoHiFxrnKU6qmHItG+0teUnz7RroFhfAVCS9K9zF++nM0GmOmG40qVCXN9ZlIjxVV2LHi9SkY0rs= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com; spf=pass smtp.mailfrom=gmail.com; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b=DsOppiIj; arc=none smtp.client-ip=209.85.214.180 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=gmail.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b="DsOppiIj" Received: by mail-pl1-f180.google.com with SMTP id d9443c01a7336-2ccae46de39so2407325ad.3 for ; Wed, 12 Aug 2026 12:11:57 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20251104; t=1786561917; x=1787166717; darn=vger.kernel.org; h=cc:to:in-reply-to:references:message-id:content-transfer-encoding :content-type:mime-version:subject:date:from:from:to:cc:subject:date :message-id:reply-to:content-type; bh=oJiMUkJNIcismpRf1bpQrDARo7GdrnubqNl+IT0MRWo=; b=DsOppiIjA3BN+VYLgosmph2W9Ta87Hy53KGU33aCQhMIy8XXrdis2gK5HX2PPHUSe+ mARJ4uyms/ELkcP3Whh4Rm40vKnLD+DXS7kpY13g9JjGUCN9iOTv/F5Zuo8cZggEB7HE NB9z8yP960hbAu1hApMXp8/d9vkqqDW7ZGFzAv6Kly2aJlhzuweFmf9OR86S86gBwlOF zjGcFKeoRa9LEZcvXHoyy284qQZiOshQn4jfS7I1SLhZazpzzQAtUAFySTGboBj/6u+R YI22aO4/1ZjSRzqVIholR9SokATT+DqL339Yoyko1SS0xRZ0ND7Oy1ze8qNAd/eEPmYx fMHg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20251104; t=1786561917; x=1787166717; h=cc:to:in-reply-to:references:message-id:content-transfer-encoding :content-type:mime-version:subject:date:from:x-gm-gg :x-gm-message-state:from:to:cc:subject:date:message-id:reply-to :content-type; bh=oJiMUkJNIcismpRf1bpQrDARo7GdrnubqNl+IT0MRWo=; b=E6yb6sHsvSZMeXQcNxS7Az9TKs/ZYhiQrVrkyETLnnOLp3ZYgsiNl2fHa3KB8ItGvr CyrNgcC5w2RI7Tdj4qWnZu3Pw7z67WzInd0rwRo7JPJm330Fp76vquDEX1VhL3fEtt8W uDVK5Q414RzozHiK9UU9I6YEbgFNJgUs5PFYOcCNpWncRkWaiE8H7ub+JepZyx4f+2Wv RxDIefrNOQIkHTgJzuTlTSD7q9LvdoW4m3eT6OYDtvk5EWtvlPr9/tBRX01YSn10IyvA sGhiu3GwqSBVVtSvH6/ufH42uFLIuZafTHcWtxIzmrDs+8aTMGgzRN1NbfqnUeaigDSm BYTQ== X-Forwarded-Encrypted: i=1; AHgh+RprdC/XiYVPPC89iu3R8/KCn3IL86166m9SzuwAmgY5vIyNTufS2RaoTOsIAK5vpLhgRIjKhlpr01uvd68=@vger.kernel.org X-Gm-Message-State: AOJu0Yw4Uxc7h/VL//6gLvwj+qk5ywOUm+oAtjkAFFtutUF41IGJs4Eg ntTQiTnEMgfy1MmGTgx05kxTFe4z/NfGirlp8/dazi9ed0R3GGsahurB X-Gm-Gg: AR+sD13beLo84At0zIo8GudyAocEbSKnuCqxWYRriylGuSIwBxKVaVOOFpvIq3JcOWl 4fAqslmoBV11k5HJk0PAcrNRgmfShclyEhiYUWkgobXfZ4GyJ9qHiWnB//zWYotbeqAYihIeO1H x52W/JAb4HzWv5YPSrNvtD0hKYd42fjTUnWj6uOEHmOzc3cIrSsE4q00y29Jw5zVlmu7pPUIAhk R20/lRh/VI9KAM+QbR76z5wSIRTLxh+hO+yYNPYbWsNOqU43rEbCTVA/xlzWZgYMnNmPiD4Iwjv VzNr9kLFDgoYfDdPAfq0ffeVz2OD9DsuJnW8zmzymuXVngaI1OSyttOfgbhCC7R3Q4mOdNl+uAh 2kaIcjA29oEe9RlABi1c89YQABHemImsuy1FS9zw0tAR6JAE/k2RriXaGZn+FTINbn2vGtrDhvi KupCPavIkJFpzqaIDNMyO/PvZ7grBgZxEDVUay/h1l/AbEMyxAHxygI3BUZu57Egh1g52erwQ= X-Received: by 2002:a17:903:2c50:b0:2c9:ed4a:c3a4 with SMTP id d9443c01a7336-2d37d19f10fmr2313385ad.0.1786561917109; Wed, 12 Aug 2026 12:11:57 -0700 (PDT) Received: from [10.170.23.252] ([2409:40c2:5017:a6a2:eb70:cb11:a19e:bd5]) by smtp.gmail.com with ESMTPSA id 5a478bee46e88-31da7bf64b5sm9496947eec.10.2026.08.12.12.11.46 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 12 Aug 2026 12:11:56 -0700 (PDT) From: Bhargav Joshi Date: Thu, 13 Aug 2026 00:41:18 +0530 Subject: [PATCH 2/2] dt-bindings: clock: ti,dra7-atl: convert to dt-schema Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: quoted-printable Message-Id: <20260813-ti-dra7-atl-v1-2-27b691f4cdcf@gmail.com> References: <20260813-ti-dra7-atl-v1-0-27b691f4cdcf@gmail.com> In-Reply-To: <20260813-ti-dra7-atl-v1-0-27b691f4cdcf@gmail.com> To: Michael Turquette , Stephen Boyd , Brian Masney , Rob Herring , Krzysztof Kozlowski , Conor Dooley , Peter Ujfalusi Cc: linux-clk@vger.kernel.org, devicetree@vger.kernel.org, linux-kernel@vger.kernel.org, goledhruva@gmail.com, m-chawdhry@ti.com, daniel.baluta@gmail.com, simona.toaca@nxp.com, j.bhargav.u@gmail.com X-Mailer: b4 0.14.3 X-Developer-Signature: v=1; a=ed25519-sha256; t=1786561882; l=5691; i=j.bhargav.u@gmail.com; h=from:subject:message-id; bh=kLXwjiY0hk/bsIhaPf9r0kAxsBg3pdBby5bPIV/S2SI=; b=0QTQcbNyTIX5a17UtIxWKdJFrDi0DszS/S6rRcvyljo3dUNRMj5133lIF3mQkE6updTaQHEmM WS9mfbNxj/0AEEQGmVOHFf27AK3Navr0TKm3tzPiogtUMhWHvm1j3uj X-Developer-Key: i=j.bhargav.u@gmail.com; a=ed25519; pk=IqNDwUZKECEA+n8wXctFLBbYL9NhFstZNbOznm/nX1k= Convert the IP driver portion of the DRA7 ATL (Audio Tracking Logic) binding from the freeform text binding to dt-schema. Together with ti,dra7-atl-clock.yaml this fully replaces dra7-atl.txt. ti,hwmods is marked deprecated as modern DTS uses ti,sysc target-module wrappers and the property is absent from current dra7-l4.dtsi. bws/aws maximum set to 15 per the 16 mux sources in dt-bindings/clock/ti-dra7-atl.h. Signed-off-by: Bhargav Joshi Reviewed-by: Rob Herring (Arm) --- .../devicetree/bindings/clock/ti/dra7-atl.txt | 56 ------------- .../devicetree/bindings/clock/ti/ti,dra7-atl.yaml | 98 ++++++++++++++++++= ++++ 2 files changed, 98 insertions(+), 56 deletions(-) diff --git a/Documentation/devicetree/bindings/clock/ti/dra7-atl.txt b/Docu= mentation/devicetree/bindings/clock/ti/dra7-atl.txt deleted file mode 100644 index e3c05844ae86..000000000000 --- a/Documentation/devicetree/bindings/clock/ti/dra7-atl.txt +++ /dev/null @@ -1,56 +0,0 @@ -Device Tree Clock bindings for ATL (Audio Tracking Logic) of DRA7 SoC. - -The ATL IP is used to generate clock to be used to synchronize baseband and -audio codec. A single ATL IP provides four ATL clock instances sharing the= same -functional clock but can be configured to provide different clocks. -ATL can maintain a clock averages to some desired frequency based on the b= ws/aws -signals - can compensate the drift between the two ws signal. - -In order to provide the support for ATL and its output clocks (which can b= e used -internally within the SoC or external components) two sets of bindings is = needed: - - -Binding for the IP driver: -This binding is used to configure the IP driver which is going to handle t= he -configuration of the IP for the ATL clock instances. - -Required properties: -- compatible : shall be "ti,dra7-atl" -- reg : base address for the ATL IP -- ti,provided-clocks : List of phandles to the clocks associated with the = ATL -- clocks : link phandles to functional clock of ATL -- clock-names : Shall be set to "fck" -- ti,hwmods : Shall be set to "atl" - -Optional properties: -Configuration of ATL instances: -- atl{0/1/2/3} { - - bws : Baseband word select signal selection - - aws : Audio word select signal selection -}; - -For valid word select signals, see the dt-bindings/clock/ti-dra7-atl.h inc= lude -file. - -Examples: - -/* binding for the IP */ -atl: atl@4843c000 { - compatible =3D "ti,dra7-atl"; - reg =3D <0x4843c000 0x3ff>; - ti,hwmods =3D "atl"; - ti,provided-clocks =3D <&atl_clkin0_ck>, <&atl_clkin1_ck>, - <&atl_clkin2_ck>, <&atl_clkin3_ck>; - clocks =3D <&atl_gfclk_mux>; - clock-names =3D "fck"; -}; - -#include - -&atl { - - atl2 { - bws =3D ; - aws =3D ; - }; -}; diff --git a/Documentation/devicetree/bindings/clock/ti/ti,dra7-atl.yaml b/= Documentation/devicetree/bindings/clock/ti/ti,dra7-atl.yaml new file mode 100644 index 000000000000..5460432219a5 --- /dev/null +++ b/Documentation/devicetree/bindings/clock/ti/ti,dra7-atl.yaml @@ -0,0 +1,98 @@ +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/clock/ti/ti,dra7-atl.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: TI DRA7 ATL (Audio Tracking Logic) Clock Controller + +maintainers: + - Peter Ujfalusi + +description: + The ATL IP is used to generate clock to be used to synchronize baseband = and + audio codec. A single ATL IP provides four ATL clock instances sharing t= he + same functional clock but can be configured to provide different clocks. + ATL can maintain a clock averages to some desired frequency based on the + bws/aws signals - can compensate the drift between the two ws signal. + + See also Documentation/devicetree/bindings/clock/ti/ti,dra7-atl-clock.ya= ml + +properties: + compatible: + const: ti,dra7-atl + + reg: + maxItems: 1 + + clocks: + maxItems: 1 + + clock-names: + items: + - const: fck + + ti,provided-clocks: + $ref: /schemas/types.yaml#/definitions/phandle-array + minItems: 4 + maxItems: 4 + description: + List of phandles to the clocks associated with the ATL. + + ti,hwmods: + $ref: /schemas/types.yaml#/definitions/string + description: + Name of the hwmod associated with the ATL. + deprecated: true + const: atl + +patternProperties: + "^atl[0-3]$": + type: object + additionalProperties: false + description: + Configuration of ATL instances. + + properties: + bws: + $ref: /schemas/types.yaml#/definitions/uint32 + description: + Baseband word select signal selection. + maximum: 15 + + aws: + $ref: /schemas/types.yaml#/definitions/uint32 + description: + Audio word select signal selection. + maximum: 15 + + required: + - bws + - aws + +required: + - compatible + - reg + - clocks + - clock-names + - ti,provided-clocks + +additionalProperties: false + +examples: + - | + #include + + atl@4843c000 { + compatible =3D "ti,dra7-atl"; + reg =3D <0x4843c000 0x3ff>; + clocks =3D <&atl_gfclk_mux>; + clock-names =3D "fck"; + ti,provided-clocks =3D <&atl_clkin0_ck>, <&atl_clkin1_ck>, + <&atl_clkin2_ck>, <&atl_clkin3_ck>; + + atl2 { + bws =3D ; + aws =3D ; + }; + }; --=20 2.55.0