From: Rob Herring <robh-DgEjT+Ai2ygdnm+yROfE0A@public.gmane.org>
To: devicetree-u79uwXL29TY76Z2rM5mHXA@public.gmane.org,
devicetree-spec-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
Cc: Stephen Boyd <sboyd-sgV2jX0FEOL9JmXXK+q4OQ@public.gmane.org>,
Sylwester Nawrocki
<s.nawrocki-Sze3O3UU22JBDgjK7y7TUQ@public.gmane.org>,
Stephen Boyd <swboyd-F7+t8E8rja9g9hUCZPvPmw@public.gmane.org>
Subject: [PATCH] schemas: clock: Add assigned-clocks description
Date: Thu, 28 Apr 2022 10:26:33 -0500 [thread overview]
Message-ID: <20220428152633.2261979-1-robh@kernel.org> (raw)
Add description for assigned-clocks properties from clock-binding.txt in
the Linux kernel.
This is relicensed from GPL-2.0 (the default) to BSD-2-Clause. The Cc list
are the original authors.
Cc: Sylwester Nawrocki <s.nawrocki-Sze3O3UU22JBDgjK7y7TUQ@public.gmane.org>
Cc: Stephen Boyd <swboyd-F7+t8E8rja9g9hUCZPvPmw@public.gmane.org>
Signed-off-by: Rob Herring <robh-DgEjT+Ai2ygdnm+yROfE0A@public.gmane.org>
---
Please ack for the license change.
dtschema/schemas/clock/clock.yaml | 38 +++++++++++++++++++++++++++++++
1 file changed, 38 insertions(+)
diff --git a/dtschema/schemas/clock/clock.yaml b/dtschema/schemas/clock/clock.yaml
index 2416d046087c..5299653b80b6 100644
--- a/dtschema/schemas/clock/clock.yaml
+++ b/dtschema/schemas/clock/clock.yaml
@@ -19,6 +19,44 @@ description: |
output on a device. The length of a clock specifier is defined by the
value of a #clock-cells property in the clock provider node.
+ Assigned clock parents and rates
+ --------------------------------
+
+ Some platforms may require initial configuration of default parent clocks
+ and clock frequencies. Such a configuration can be specified in a device tree
+ node through assigned-clocks, assigned-clock-parents and assigned-clock-rates
+ properties. The assigned-clock-parents property should contain a list of parent
+ clocks in the form of a phandle and clock specifier pair and the
+ assigned-clock-rates property should contain a list of frequencies in Hz. Both
+ these properties should correspond to the clocks listed in the assigned-clocks
+ property.
+
+ To skip setting parent or rate of a clock its corresponding entry should be
+ set to 0, or can be omitted if it is not followed by any non-zero entry.
+
+ serial@a000 {
+ compatible = "fsl,imx-uart";
+ reg = <0xa000 0x1000>;
+ ...
+ clocks = <&osc 0>, <&pll 1>;
+ clock-names = "baud", "register";
+
+ assigned-clocks = <&clkcon 0>, <&pll 2>;
+ assigned-clock-parents = <&pll 2>;
+ assigned-clock-rates = <0>, <460800>;
+ };
+
+ In this example the <&pll 2> clock is set as parent of clock <&clkcon 0> and
+ the <&pll 2> clock is assigned a frequency value of 460800 Hz.
+
+ Configuring a clock's parent and rate through the device node that consumes
+ the clock can be done only for clocks that have a single user. Specifying
+ conflicting parent or rate configuration in multiple consumer nodes for
+ a shared clock is forbidden.
+
+ Configuration of common clocks, which affect multiple consumer devices can
+ be similarly specified in the clock provider node.
+
# always select the core schema
select: true
--
2.34.1
next reply other threads:[~2022-04-28 15:26 UTC|newest]
Thread overview: 3+ messages / expand[flat|nested] mbox.gz Atom feed top
[not found] <CGME20220428152638eucas1p11b7bbe5bcb8d36641b8328057a248789@eucas1p1.samsung.com>
2022-04-28 15:26 ` Rob Herring [this message]
[not found] ` <20220428152633.2261979-1-robh-DgEjT+Ai2ygdnm+yROfE0A@public.gmane.org>
2022-04-29 15:24 ` [PATCH] schemas: clock: Add assigned-clocks description Sylwester Nawrocki
2022-04-29 20:22 ` Stephen Boyd
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20220428152633.2261979-1-robh@kernel.org \
--to=robh-dgejt+ai2ygdnm+yrofe0a@public.gmane.org \
--cc=devicetree-spec-u79uwXL29TY76Z2rM5mHXA@public.gmane.org \
--cc=devicetree-u79uwXL29TY76Z2rM5mHXA@public.gmane.org \
--cc=s.nawrocki-Sze3O3UU22JBDgjK7y7TUQ@public.gmane.org \
--cc=sboyd-sgV2jX0FEOL9JmXXK+q4OQ@public.gmane.org \
--cc=swboyd-F7+t8E8rja9g9hUCZPvPmw@public.gmane.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).