From nobody Mon Sep 28 23:55:28 2026 Received: from mail-pj1-f47.google.com (mail-pj1-f47.google.com [209.85.216.47]) (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 BD56F3E8340 for ; Fri, 14 Aug 2026 21:21:40 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.216.47 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1786742503; cv=none; b=eNI6Ro6AfWX8VdrT7lCkueVG/Y6q9lC/NcAzxOQJQkb/pT0SBI/CTFUGBkOFYeoTn7vrwsochcKMpoQAIoud6KTxY79wBHCMWZJ5rmbgTzlVEVtvs5yotiskPaiGbtVnjs1ZAPw7zkC8wf7MjkvE7ZTyV1GFykXt+ubSI8uqv90= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1786742503; c=relaxed/simple; bh=u6r8H0pSqbZuRl447oiZjO+lUFL/LjDSOxn4d+FN7EQ=; h=From:Date:Subject:MIME-Version:Content-Type:Message-Id:References: In-Reply-To:To:Cc; b=kkXEgfndOLEFLCioMTgXATMaHbhEwhELpq1tWtdi2UukzGnWiqxg4dkMM0PLmIrFxbDjWBureX6nHZ0bmKhy2kUYmyzpJkH65eW+Nf7OUf7TZLZTuKjWeQpWWraMPtmhxukaKzcRwc8+itj3byarN1nSO18tATwidKug4fabBSE= 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=NmI4/gmS; arc=none smtp.client-ip=209.85.216.47 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="NmI4/gmS" Received: by mail-pj1-f47.google.com with SMTP id 98e67ed59e1d1-38fe113c792so148508a91.3 for ; Fri, 14 Aug 2026 14:21:39 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20251104; t=1786742498; x=1787347298; 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=0lip8n6xP9eOpioWoISckMOq1UctyXUT+/l6I9kdKKU=; b=NmI4/gmSTiLXYjP1qim4JIIR3WJhSUyOkVY9I9qKlHx/0W0TF5riNMIgSPHqYk06OR hAbthlhvse3OBVwfWwCWZKGeQflwxron7mFCYhiuEfeanjSeGMqpWvp/Bmuk5a5N7bW9 VAN1L37eHWXmPWN/SNXkmzfg7F3XKbquK3n0HwJXZ7pKnSTKKXsBT8ksV3ID5fR1wvfK S8nlTVJIACwqaq8F4xf5Ndypr3TF/p516MlSmnMT7ajeyykUPsKj9MnQMX5RDgRkgrJg eHQgz82VDJrrwd+WLYqi2JAcmzso71uNKNQsFUDTJlESgHxp3Zoe8xvk4vmjSTKqM9xb ebfA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20251104; t=1786742498; x=1787347298; 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=0lip8n6xP9eOpioWoISckMOq1UctyXUT+/l6I9kdKKU=; b=HQ5DMQWkEcpOHeNFNM6TAo2u4oZcB0Rq4OudQ1lMnWaoDTfYXk7pVplkvAa7zkuF6t 7b3yivGrpZWyaTwD0Zyja+BLpv2DfJGttf1YyYgMVl2TR/Z9G9UAT4Gc1D56KF3X+qEy ChrRIU7YzouNgUXR/quODo0dpqkMSmBr+Ae3v+YSZh1VkyEYYuUoFVSWAYhrwGJqBhjd SWWpULlgs7tBZt4eoqM/PVJ7w43zhjxKYv/S0L/jaIZLEO7znU5AE5KmVkmBkOUJCnMl bFZCx4X3e5FKPNuDXevk+IuSK1plw+1aPGPOIWyNi6zUqEnS5B7wbO5bvd6LT3u2IQJO mvsw== X-Forwarded-Encrypted: i=1; AHgh+RpXUJWa/4VEDXjA/c+i0r8tECY54th0tv4Jbk0LplclgPRITUMIfX7/InnjxSffpouASOa3O+OFtnjwIhw=@vger.kernel.org X-Gm-Message-State: AOJu0YwJxbw3/4e3IdphzasQlRxjCUgDTdigfucJX2TVqJHEzbAqQuzT dwuvn1cycFY0eiwgO4OVs0WqAL6vrHPaJVV4tufTg23k6mmCEhGQqht4 X-Gm-Gg: AR+sD10XnMdUCP8/iUkC1F1lN/dYH1zvdESs+xeddceXuVPuFtkAxzHVYxbMak9ri2g kPmwRI4DaRUcUf9Y+l+pw+9lIQ1/yoDU5l9Zn0sV56a+f4n/4R3EE2xeVHUgtspRnDb3jqAi5Rs 3efvOD4h0ZWHxBve/xvHAunPXa7lFCaJ0j3fnyOVLMtTItn2gQVLLTgCb//NVyZL++yKpaL4O56 /6jFDowpVefDwTRsHaIW0n/QIN/iJ1md3Iw0C+QboRCtOphf15MVYK7FCscOXlODnDfh/+630W4 X0oeZY2rmqo7GghqgXBVc/eHoqiJEaVzy9mdQ+pwMX0+kAtqLjDVorRdVp97rRrSra/izEfTrkE KKdmWq9kd1YFsuEsZr7wZdASIFtpxTAm7nug336oZY3D0bNElcPfP3M0MsicdoYipm8JSWhqvZC +kCy9xYKEGVTavlbGpcCwEzFXv1ETlbMgoc2ZA46llGAK/YZmkXlUHsjgXfAe1lRAuURj+AeFkc A== X-Received: by 2002:a17:90b:4c47:b0:381:28e0:6248 with SMTP id 98e67ed59e1d1-3933b6fa584mr7435398a91.1.1786742498536; Fri, 14 Aug 2026 14:21:38 -0700 (PDT) Received: from [10.112.173.252] ([2409:40c2:504f:ca49:504a:79dd:fd2b:ca2d]) by smtp.gmail.com with ESMTPSA id a92af1059eb24-141387c6f95sm16678893c88.6.2026.08.14.14.21.25 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 14 Aug 2026 14:21:37 -0700 (PDT) From: Bhargav Joshi Date: Sat, 15 Aug 2026 02:50:56 +0530 Subject: [PATCH v2 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: <20260815-ti-dra7-atl-v2-1-db64c147c2e2@gmail.com> References: <20260815-ti-dra7-atl-v2-0-db64c147c2e2@gmail.com> In-Reply-To: <20260815-ti-dra7-atl-v2-0-db64c147c2e2@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=1786742472; l=3650; i=j.bhargav.u@gmail.com; h=from:subject:message-id; bh=u6r8H0pSqbZuRl447oiZjO+lUFL/LjDSOxn4d+FN7EQ=; b=NxRGxjBC6lb3qhT51jyu5o5aj/7tuEIEWGRLSdfZMZtkOpncHoZvRHUUH1XfQNHXASuhnw3e1 b5++ip9N8jAB2G6TgmpLLhoZavWozwfFfJtlwxLXDeRmqTWIvQbzaK1 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. Reviewed-by: Rob Herring (Arm) Signed-off-by: Bhargav Joshi --- .../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 Mon Sep 28 23:55:28 2026 Received: from mail-pj1-f47.google.com (mail-pj1-f47.google.com [209.85.216.47]) (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 E39FE37A82C for ; Fri, 14 Aug 2026 21:21:52 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.216.47 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1786742514; cv=none; b=odqjXef9gHWDaEnZfdteel6IsHn3VdiJ6qwZ0QNfdm2c+RULJ4aH/wAuooFX9zART+YfthgBeFqKAeLUaLdmFoS0qA2L5hKZkBA5GRhy+k7Y5rOdyZeglM0watDmsNV0wdWnaubeugMB6+JlVN5zWQbwVPIRRSpRybRuNl/ShHo= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1786742514; c=relaxed/simple; bh=PVilgbHHs7aR8Qkx3HORWWvrIUgpzson356NM/5tNnY=; h=From:Date:Subject:MIME-Version:Content-Type:Message-Id:References: In-Reply-To:To:Cc; b=oe4VKl1PF4TRj1Hn2UQjG8czA9wHMTTIA53TPqQLZT9VQ42cIR0iO58cBFfGph5Q7QdD23ahyOs3xPpuKw9pBoie170qi8GZK0r8W16dd9rdJsGu6mSVoY2iA35tM444F6tz5fK8bRsM1Jk+w7wOJ3ZSInjjoOGJlWYJmAb6VHM= 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=L4fuQCF+; arc=none smtp.client-ip=209.85.216.47 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="L4fuQCF+" Received: by mail-pj1-f47.google.com with SMTP id 98e67ed59e1d1-38dd1cc8dc8so221465a91.0 for ; Fri, 14 Aug 2026 14:21:52 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20251104; t=1786742512; x=1787347312; 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=r+WACWGGRxnr7upWs/bzK9T7rZ+TwizKBmDY48I3U9o=; b=L4fuQCF+GUE0ZtJ9+srFqL316vSwFGdL+DfrTi1AVFevoL5sBXd+ic4gojRies/F1a Q0TPsjBVpSZj9llx5Craxbwf8hEh6+yvEFUtqao3/zlkd+0Gx26eRQ7zTHVPsdbXis9f YKFsWGzvzYiOTL9y8Y6GOeIdmQu3eiGRLnODcRUJCueXdWLZzki1KlHtCvCim47GXWbh H5lSqHc0x63mV/sVg1ujL2q3nIVB2ki0lZfoUbyM/qZytrUj60k6u8WUz+Ov3MTL6ORn n6oQUBil+rZ5VkkSq5pO2UdGwdKzX7/Hj0BBVqy62qm8G4ubAcDCXfH/3tTNM/5q4JWK QTaA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20251104; t=1786742512; x=1787347312; 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=r+WACWGGRxnr7upWs/bzK9T7rZ+TwizKBmDY48I3U9o=; b=HrIe4VmDQaNfVE3zWNH2HBwoc/X6r0sX3ZgXqk4f5uO9ygczMv/OUMIPBFe2uQxuvP rYasptaEvKRlraWPOFiTVXiwTfrBZdu64b2veYK3ryNegLi4iXs+X7lwDHD3AX5pEKTK F0NmFZTxUc9vua87Pf+WtASWNVxPI9frHM0In35ZwJaDuF54N1rvCbfoG7N0G2fnUxUW xkDGLBNBiJ5EfuotS7SP9Zkp+HDLswwQivvKAvyTJESSLmtikfuBdLcuZmfSctJROjCg 7SU4fvqatAcBiMoN1GQ2TGnkc1oqdR6imuCdfu2PrGgPVegqxdjcgNuOQ/J6FC2j6Edb l5Rw== X-Forwarded-Encrypted: i=1; AHgh+RpGk2z8kLrf6XSrFm+RrevaQFPpN1um/nzRMZLKWkjdMDEQRjTyPXtiTAqtSm1clT9iGbOnImXR8gSMADA=@vger.kernel.org X-Gm-Message-State: AOJu0YxX0EDi1k/2ZfnodXP/znyyivQ75wfF/9jXzRWuaEYUrGaFFxht uCKnFzZQwzKUgO3pcM73tFMbzIbTky4NJlP10UI8jUGIvT1Gn0DnSmhh X-Gm-Gg: AR+sD12qc0WrDdlq9BCjd2FWZB41CKE88+NC7LAfC6uh+KazpvpEUt5kG6G/o2KZbEE pRo1Vo6aP0zIy05PBVhFovTPDrqdTlRV2Bieu22X/xY4hQMYJ6dwX0YdgGufzvPKvq87hUN1ii3 nnoK1bGBhEVn/T/yRvnFIPSXi9LMGX2D+WEOm9NNhisKPrXFq/vse1lcoc4jpXH9axdOfitquCg yY4cys5GAV/7wmsOrVXSxsGNJpRXsM7tFBxh1IQn+CleuP8bGby2foAEuIdbuX+mRPZHnm83Dd9 BDFztjFY0548RwGQn6HO8vh8roDvW0TWwH1WPbg0KltGzQWQ1xLDqovCxY3DHnQsPMrr3m0ckb6 1pI4nDY/sJLkPy5uSpSUHVE+moLbeeDmLA+fmsWDxzg+zUvr9TpwpVCDPx1o/ijZPXsamOaRu1/ U5RuQI/PvTPaCUitbW8jn0IQpNtNQu8V4g5cQ4VnvB3SwSQEDLT1gi328t/7HIcKosy6pqTLoic Q== X-Received: by 2002:a17:90b:2d8e:b0:38e:6d4c:14df with SMTP id 98e67ed59e1d1-3933bd2c8bdmr6895808a91.1.1786742512207; Fri, 14 Aug 2026 14:21:52 -0700 (PDT) Received: from [10.112.173.252] ([2409:40c2:504f:ca49:504a:79dd:fd2b:ca2d]) by smtp.gmail.com with ESMTPSA id a92af1059eb24-141387c6f95sm16678893c88.6.2026.08.14.14.21.39 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 14 Aug 2026 14:21:51 -0700 (PDT) From: Bhargav Joshi Date: Sat, 15 Aug 2026 02:50:57 +0530 Subject: [PATCH v2 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: <20260815-ti-dra7-atl-v2-2-db64c147c2e2@gmail.com> References: <20260815-ti-dra7-atl-v2-0-db64c147c2e2@gmail.com> In-Reply-To: <20260815-ti-dra7-atl-v2-0-db64c147c2e2@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=1786742472; l=5776; i=j.bhargav.u@gmail.com; h=from:subject:message-id; bh=PVilgbHHs7aR8Qkx3HORWWvrIUgpzson356NM/5tNnY=; b=pgbT+SoflQx2pYJlN5Eq+wwiTUtYrprrXthMZ+Wmi4yObdI0CvdjckhrFyhWYWZb31tWNVhfc BTUMwhK2LCWAP8awTDZUuu11NCh9O0vbw1bbN1DL48mH1Fn5jL9o0pT 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. Reviewed-by: Rob Herring (Arm) Signed-off-by: Bhargav Joshi --- .../devicetree/bindings/clock/ti/dra7-atl.txt | 56 ------------ .../devicetree/bindings/clock/ti/ti,dra7-atl.yaml | 100 +++++++++++++++++= ++++ 2 files changed, 100 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..f4bb233be83d --- /dev/null +++ b/Documentation/devicetree/bindings/clock/ti/ti,dra7-atl.yaml @@ -0,0 +1,100 @@ +# 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 + description: + List of phandles to the clocks associated with the ATL. + minItems: 4 + maxItems: 4 + items: + maxItems: 1 + + 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