Skip to contentSkip to conversation

clock helper for determining flags properties

RFC PATCH NAK Gabriel FERNANDEZ 5 participants 9 messages May 13, 2014 – May 15, 2014

Subsystems (2)
lore
Share & tools
lore
#0 lore raw

cover clock helper for determining flags properties

The first patch provides a helper to get flags properties of a clock node. This patch is limited to CLK_SET_RATE_PARENT flag for e.g.

The second patch provides an example of use of this clock helper.

Gabriel Fernandez (2):
clk: of: helper for determining flags properties
drivers: clk: st: authorize propagate rate change for clockgenD0

 arch/arm/boot/dts/stih407-clock.dtsi |  1 +
 drivers/clk/clk.c                    | 11 +++++++++++
 drivers/clk/st/clk-flexgen.c         |  2 ++
 include/linux/clk-provider.h         |  6 ++++++
 4 files changed, 20 insertions(+)
Signature · 1 line
1.9.1
#1 lore raw

PATCH 1/2 clk: of: helper for determining flags properties

The patch provides a helper to get flags properties of a clock node.

---
 drivers/clk/clk.c            | 11 +++++++++++
 include/linux/clk-provider.h |  6 ++++++
 2 files changed, 17 insertions(+)
drivers/clk/clk.c +11 -0
index 4d56220..cae8985 100644
@@ -2528,6 +2528,17 @@ const char *of_clk_get_parent_name(struct device_node *np, int index)
 }
 EXPORT_SYMBOL_GPL(of_clk_get_parent_name);
 
+unsigned long of_clk_get_flags(struct device_node *np)
+{
+	unsigned long flags = 0;
+
+	if (of_property_read_bool(np, "set-rate-parent"))
+		flags |= CLK_SET_RATE_PARENT;
+
+	return flags;
+}
+EXPORT_SYMBOL_GPL(of_clk_get_flags);
+
 struct clock_provider {
 	of_clk_init_cb_t clk_init_cb;
 	struct device_node *np;
include/linux/clk-provider.h +6 -0
index 59e2eb5..650bc10 100644
@@ -519,6 +519,7 @@ int of_clk_get_parent_count(struct device_node *np);
 const char *of_clk_get_parent_name(struct device_node *np, int index);
 
 void of_clk_init(const struct of_device_id *matches);
+unsigned long of_clk_get_flags(struct device_node *np);
 
 #else /* !CONFIG_OF */
 
@@ -546,6 +547,11 @@ static inline const char *of_clk_get_parent_name(struct device_node *np,
 {
 	return NULL;
 }
+static inline unsigned long of_clk_get_flags(struct device_node *np)
+{
+	return NULL;
+}
+
 #define of_clk_init(matches) \
 	{ while (0); }
 #endif /* CONFIG_OF */
Signature · 1 line
1.9.1
#2 lore raw

Re: [PATCH 1/2] clk: of: helper for determining flags properties

Quoted 14 lines · Gabriel FERNANDEZ

The patch provides a helper to get flags properties of a clock node.

---
 drivers/clk/clk.c            | 11 +++++++++++
 include/linux/clk-provider.h |  6 ++++++
 2 files changed, 17 insertions(+)
drivers/clk/clk.c +0 -0
index 4d56220..cae8985 100644

drivers/clk/clk.c const char *of_clk_get_parent_name(struct device_node *np, int index) · line 2536

Quoted 9 lines
drivers/clk/clk.c +6 -0
@@ -2528,6 +2528,17 @@ const char *of_clk_get_parent_name(struct device_node *np, int index)
 }
 EXPORT_SYMBOL_GPL(of_clk_get_parent_name);
 
+unsigned long of_clk_get_flags(struct device_node *np)
+{
+	unsigned long flags = 0;
+
+	if (of_property_read_bool(np, "set-rate-parent"))
+		flags |= CLK_SET_RATE_PARENT;

NAK.

This is _not_ a hardware property. This flag describes internals of the Linux clock framework, and is thus not suitable for DT.

You've also failed to document the property.

What are you trying to achieve here, and why do you think this is the best way of achieving that?

Cheers,
Mark.

Quoted 36 lines
drivers/clk/clk.c +5 -0
+
+	return flags;
+}
+EXPORT_SYMBOL_GPL(of_clk_get_flags);
+
 struct clock_provider {
 	of_clk_init_cb_t clk_init_cb;
 	struct device_node *np;
include/linux/clk-provider.h +6 -0
index 59e2eb5..650bc10 100644
@@ -519,6 +519,7 @@ int of_clk_get_parent_count(struct device_node *np);
 const char *of_clk_get_parent_name(struct device_node *np, int index);
 
 void of_clk_init(const struct of_device_id *matches);
+unsigned long of_clk_get_flags(struct device_node *np);
 
 #else /* !CONFIG_OF */
 
@@ -546,6 +547,11 @@ static inline const char *of_clk_get_parent_name(struct device_node *np,
 {
 	return NULL;
 }
+static inline unsigned long of_clk_get_flags(struct device_node *np)
+{
+	return NULL;
+}
+
 #define of_clk_init(matches) \
 	{ while (0); }
 #endif /* CONFIG_OF */
Signature · 1 line
1.9.1
#3 lore raw

Re: [PATCH 1/2] clk: of: helper for determining flags properties

Quoted 27 lines · Mark Rutland
Quoted 14 lines · Gabriel FERNANDEZ

The patch provides a helper to get flags properties of a clock node.

---
  drivers/clk/clk.c            | 11 +++++++++++
  include/linux/clk-provider.h |  6 ++++++
  2 files changed, 17 insertions(+)
drivers/clk/clk.c +0 -0
index 4d56220..cae8985 100644

drivers/clk/clk.c const char *of_clk_get_parent_name(struct device_node *np, int index) · line 2536

Quoted 9 lines
drivers/clk/clk.c +6 -0
@@ -2528,6 +2528,17 @@ const char *of_clk_get_parent_name(struct device_node *np, int index)
  }
  EXPORT_SYMBOL_GPL(of_clk_get_parent_name);
 
+unsigned long of_clk_get_flags(struct device_node *np)
+{
+	unsigned long flags = 0;
+
+	if (of_property_read_bool(np, "set-rate-parent"))
+		flags |= CLK_SET_RATE_PARENT;

NAK.

Quoted 2 lines

This is _not_ a hardware property. This flag describes internals of the Linux clock framework, and is thus not suitable for DT.

Mark,

while I agree above property is not a hardware property, it is at least some kind of use-case property. If not by DT, we will have to allow some way to describe master-slave relationships between clocks in a driver independent way.

Quoted 4 lines

You've also failed to document the property.

What are you trying to achieve here, and why do you think this is the best way of achieving that?

I cannot tell from the commit msgs, but consider clk-si5351 which is a driver for an external programmable clock with N PLLs and M outputs. Now connect a video clock consumer and an audio clock consumer to two different outputs and those to one PLL (as you want audio clock derived from video clock, typical HDMI scenario).

Now, there should be a way to tell the generic driver which outputs are allowed to change the PLLs rate and which don't. Otherwise, the clock chip would be pretty useless as e.g. your audio clock consumer will overwrite the rate the video clock consumer has chosen.

BTW, clk-si5351 has vendor-specific properties to specify which output clocks are pll-masters for some kernel cycles already.

Sebastian

Quoted 42 lines
Quoted 33 lines
drivers/clk/clk.c +5 -0
+
+	return flags;
+}
+EXPORT_SYMBOL_GPL(of_clk_get_flags);
+
  struct clock_provider {
  	of_clk_init_cb_t clk_init_cb;
  	struct device_node *np;
include/linux/clk-provider.h +6 -1
index 59e2eb5..650bc10 100644
@@ -519,6 +519,7 @@ int of_clk_get_parent_count(struct device_node *np);
  const char *of_clk_get_parent_name(struct device_node *np, int index);
 
  void of_clk_init(const struct of_device_id *matches);
+unsigned long of_clk_get_flags(struct device_node *np);
 
  #else /* !CONFIG_OF */
 
@@ -546,6 +547,11 @@ static inline const char *of_clk_get_parent_name(struct device_node *np,
  {
  	return NULL;
  }
+static inline unsigned long of_clk_get_flags(struct device_node *np)
+{
+	return NULL;
+}
+
  #define of_clk_init(matches) \
  	{ while (0); }
  #endif /* CONFIG_OF */
--
Quoted 3 lines

1.9.1

--
To unsubscribe from this list: send the line "unsubscribe linux-kernel" in the body of a message to majordomo at vger.kernel.org
More majordomo info at http://vger.kernel.org/majordomo-info.html
Please read the FAQ at http://www.tux.org/lkml/

#4 lore raw

Re: [PATCH 1/2] clk: of: helper for determining flags properties

Quoting Sebastian Hesselbarth (2014-05-13 08:11:55)

Quoted 31 lines · Mark Rutland
Quoted 27 lines · Gabriel FERNANDEZ
Quoted 14 lines

The patch provides a helper to get flags properties of a clock node.

---
  drivers/clk/clk.c            | 11 +++++++++++
  include/linux/clk-provider.h |  6 ++++++
  2 files changed, 17 insertions(+)
drivers/clk/clk.c +0 -0
index 4d56220..cae8985 100644

drivers/clk/clk.c const char *of_clk_get_parent_name(struct device_node *np, int index) · line 2536

Quoted 9 lines
drivers/clk/clk.c +6 -0
@@ -2528,6 +2528,17 @@ const char *of_clk_get_parent_name(struct device_node *np, int index)
  }
  EXPORT_SYMBOL_GPL(of_clk_get_parent_name);
 
+unsigned long of_clk_get_flags(struct device_node *np)
+{
+    unsigned long flags = 0;
+
+    if (of_property_read_bool(np, "set-rate-parent"))
+            flags |= CLK_SET_RATE_PARENT;

NAK.

Quoted 2 lines

This is _not_ a hardware property. This flag describes internals of the Linux clock framework, and is thus not suitable for DT.

Quoted 6 lines

Mark,

while I agree above property is not a hardware property, it is at least some kind of use-case property. If not by DT, we will have to allow some way to describe master-slave relationships between clocks in a driver independent way.

I agree with Mark.

Generally this stuff belongs in a clock driver. Of course there are the integration issues you pointed out. More on that below.

As an aside, CLK_SET_RATE_PARENT is a headache, since propagation of the operation up to the parent clock really should be the default behavior for .set_rate (and in fact this is the case for the new-ish .determine_rate op). Some history on those decisions can be found at [1] and [2].

Quoted 12 lines
Quoted 5 lines

You've also failed to document the property.

What are you trying to achieve here, and why do you think this is the best way of achieving that?

I cannot tell from the commit msgs, but consider clk-si5351 which is a driver for an external programmable clock with N PLLs and M outputs. Now connect a video clock consumer and an audio clock consumer to two different outputs and those to one PLL (as you want audio clock derived from video clock, typical HDMI scenario).

Quoted 4 lines

Now, there should be a way to tell the generic driver which outputs are allowed to change the PLLs rate and which don't. Otherwise, the clock chip would be pretty useless as e.g. your audio clock consumer will overwrite the rate the video clock consumer has chosen.

This is really a job for the "coordinated clock rate changes" that are currently in development. These specify clock sub-tree snapshots of parent and rate configurations that are predefined. These combinations can be specified in DT. That helps a lot with clock configurations that change per board, or for cases where many combinations of parents and dividers can yield the same output rate, but only a subset of those were validated by the silicon validation team or had proper timing closure so we don't want to rely on the "walk up the tree" algorithm.

Regards,
Mike

[1] http://marc.info/?l=linux-kernel&m=136847508109344&w=2
[2] http://marc.info/?l=linux-kernel&m=137477559110865&w=2

Quoted 49 lines

BTW, clk-si5351 has vendor-specific properties to specify which output clocks are pll-masters for some kernel cycles already.

Sebastian

Quoted 42 lines
Quoted 33 lines
drivers/clk/clk.c +5 -0
+
+    return flags;
+}
+EXPORT_SYMBOL_GPL(of_clk_get_flags);
+
  struct clock_provider {
     of_clk_init_cb_t clk_init_cb;
     struct device_node *np;
include/linux/clk-provider.h +6 -1
index 59e2eb5..650bc10 100644
@@ -519,6 +519,7 @@ int of_clk_get_parent_count(struct device_node *np);
  const char *of_clk_get_parent_name(struct device_node *np, int index);
 
  void of_clk_init(const struct of_device_id *matches);
+unsigned long of_clk_get_flags(struct device_node *np);
 
  #else /* !CONFIG_OF */
 
@@ -546,6 +547,11 @@ static inline const char *of_clk_get_parent_name(struct device_node *np,
  {
     return NULL;
  }
+static inline unsigned long of_clk_get_flags(struct device_node *np)
+{
+    return NULL;
+}
+
  #define of_clk_init(matches) \
     { while (0); }
  #endif /* CONFIG_OF */
--
Quoted 3 lines

1.9.1

--
To unsubscribe from this list: send the line "unsubscribe linux-kernel" in the body of a message to majordomo at vger.kernel.org
More majordomo info at http://vger.kernel.org/majordomo-info.html
Please read the FAQ at http://www.tux.org/lkml/

#5 lore raw

Re: [PATCH 1/2] clk: of: helper for determining flags properties

Quoted 18 lines · Mike Turquette

Quoting Sebastian Hesselbarth (2014-05-13 08:11:55)

Quoted 12 lines · Mark Rutland
Quoted 4 lines

You've also failed to document the property.

What are you trying to achieve here, and why do you think this is the best way of achieving that?

I cannot tell from the commit msgs, but consider clk-si5351 which is a driver for an external programmable clock with N PLLs and M outputs. Now connect a video clock consumer and an audio clock consumer to two different outputs and those to one PLL (as you want audio clock derived from video clock, typical HDMI scenario).

Quoted 4 lines

Now, there should be a way to tell the generic driver which outputs are allowed to change the PLLs rate and which don't. Otherwise, the clock chip would be pretty useless as e.g. your audio clock consumer will overwrite the rate the video clock consumer has chosen.

Quoted 8 lines

This is really a job for the "coordinated clock rate changes" that are currently in development. These specify clock sub-tree snapshots of parent and rate configurations that are predefined. These combinations can be specified in DT. That helps a lot with clock configurations that change per board, or for cases where many combinations of parents and dividers can yield the same output rate, but only a subset of those were validated by the silicon validation team or had proper timing closure so we don't want to rely on the "walk up the tree" algorithm.

Ah! Great to hear there is work on that already. Thanks for the heads up!

Sebastian

#6 lore raw

Re: [PATCH 1/2] clk: of: helper for determining flags properties

In reply to Mike Turquette

Hi,

Quoted 41 lines · Mike Turquette

Quoting Sebastian Hesselbarth (2014-05-13 08:11:55)

Quoted 31 lines · Mark Rutland
Quoted 27 lines · Gabriel FERNANDEZ
Quoted 14 lines

The patch provides a helper to get flags properties of a clock node.

---
  drivers/clk/clk.c            | 11 +++++++++++
  include/linux/clk-provider.h |  6 ++++++
  2 files changed, 17 insertions(+)
drivers/clk/clk.c +0 -0
index 4d56220..cae8985 100644

drivers/clk/clk.c const char *of_clk_get_parent_name(struct device_node *np, int index) · line 2536

Quoted 9 lines
drivers/clk/clk.c +6 -0
@@ -2528,6 +2528,17 @@ const char *of_clk_get_parent_name(struct device_node *np, int index)
  }
  EXPORT_SYMBOL_GPL(of_clk_get_parent_name);
 
+unsigned long of_clk_get_flags(struct device_node *np)
+{
+    unsigned long flags = 0;
+
+    if (of_property_read_bool(np, "set-rate-parent"))
+            flags |= CLK_SET_RATE_PARENT;

NAK.

Quoted 2 lines

This is _not_ a hardware property. This flag describes internals of the Linux clock framework, and is thus not suitable for DT.

Quoted 6 lines

Mark,

while I agree above property is not a hardware property, it is at least some kind of use-case property. If not by DT, we will have to allow some way to describe master-slave relationships between clocks in a driver independent way.

I agree with Mark.

Quoted 9 lines

Generally this stuff belongs in a clock driver. Of course there are the integration issues you pointed out. More on that below.

As an aside, CLK_SET_RATE_PARENT is a headache, since propagation of the operation up to the parent clock really should be the default behavior for .set_rate (and in fact this is the case for the new-ish .determine_rate op). Some history on those decisions can be found at [1] and [2].

My issue is exactly the same as Marc, it's for solve some case with PCM and HDMI clocks.

Quoted 26 lines
Quoted 12 lines
Quoted 5 lines

You've also failed to document the property.

What are you trying to achieve here, and why do you think this is the best way of achieving that?

I cannot tell from the commit msgs, but consider clk-si5351 which is a driver for an external programmable clock with N PLLs and M outputs. Now connect a video clock consumer and an audio clock consumer to two different outputs and those to one PLL (as you want audio clock derived from video clock, typical HDMI scenario).

Quoted 4 lines

Now, there should be a way to tell the generic driver which outputs are allowed to change the PLLs rate and which don't. Otherwise, the clock chip would be pretty useless as e.g. your audio clock consumer will overwrite the rate the video clock consumer has chosen.

This is really a job for the "coordinated clock rate changes" that are currently in development. These specify clock sub-tree snapshots of parent and rate configurations that are predefined. These combinations can be specified in DT. That helps a lot with clock configurations that change per board, or for cases where many combinations of parents and dividers can yield the same output rate, but only a subset of those were validated by the silicon validation team or had proper timing closure so we don't want to rely on the "walk up the tree" algorithm.

Quoted 2 lines

Regards,
Mike

Ok i think this work will be the best solutions for my issue.

Where i can find some threads about that ?

Thanks a lot.

Best Regards.

Gabriel.

#7 lore raw

PATCH 1/2 clk: of: helper for determining flags properties

Quoting Gabriel Fernandez (2014-05-14 00:53:58)

Quoted 84 lines

Hi,

Quoted 41 lines · Mike Turquette

Quoting Sebastian Hesselbarth (2014-05-13 08:11:55)

Quoted 31 lines · Mark Rutland
Quoted 27 lines · Gabriel FERNANDEZ
Quoted 14 lines

The patch provides a helper to get flags properties of a clock node.

---
  drivers/clk/clk.c            | 11 +++++++++++
  include/linux/clk-provider.h |  6 ++++++
  2 files changed, 17 insertions(+)
drivers/clk/clk.c +0 -0
index 4d56220..cae8985 100644

drivers/clk/clk.c const char *of_clk_get_parent_name(struct device_node *np, int index) · line 2536

Quoted 9 lines
drivers/clk/clk.c +6 -0
@@ -2528,6 +2528,17 @@ const char *of_clk_get_parent_name(struct device_node *np, int index)
  }
  EXPORT_SYMBOL_GPL(of_clk_get_parent_name);
 
+unsigned long of_clk_get_flags(struct device_node *np)
+{
+    unsigned long flags = 0;
+
+    if (of_property_read_bool(np, "set-rate-parent"))
+            flags |= CLK_SET_RATE_PARENT;

NAK.

Quoted 2 lines

This is _not_ a hardware property. This flag describes internals of the Linux clock framework, and is thus not suitable for DT.

Quoted 6 lines

Mark,

while I agree above property is not a hardware property, it is at least some kind of use-case property. If not by DT, we will have to allow some way to describe master-slave relationships between clocks in a driver independent way.

I agree with Mark.

Quoted 9 lines

Generally this stuff belongs in a clock driver. Of course there are the integration issues you pointed out. More on that below.

As an aside, CLK_SET_RATE_PARENT is a headache, since propagation of the operation up to the parent clock really should be the default behavior for .set_rate (and in fact this is the case for the new-ish .determine_rate op). Some history on those decisions can be found at [1] and [2].

My issue is exactly the same as Marc, it's for solve some case with PCM and HDMI clocks.

Quoted 26 lines
Quoted 12 lines
Quoted 5 lines

You've also failed to document the property.

What are you trying to achieve here, and why do you think this is the best way of achieving that?

I cannot tell from the commit msgs, but consider clk-si5351 which is a driver for an external programmable clock with N PLLs and M outputs. Now connect a video clock consumer and an audio clock consumer to two different outputs and those to one PLL (as you want audio clock derived from video clock, typical HDMI scenario).

Quoted 4 lines

Now, there should be a way to tell the generic driver which outputs are allowed to change the PLLs rate and which don't. Otherwise, the clock chip would be pretty useless as e.g. your audio clock consumer will overwrite the rate the video clock consumer has chosen.

This is really a job for the "coordinated clock rate changes" that are currently in development. These specify clock sub-tree snapshots of parent and rate configurations that are predefined. These combinations can be specified in DT. That helps a lot with clock configurations that change per board, or for cases where many combinations of parents and dividers can yield the same output rate, but only a subset of those were validated by the silicon validation team or had proper timing closure so we don't want to rely on the "walk up the tree" algorithm.

Quoted 6 lines
Quoted 2 lines

Regards,
Mike

Ok i think this work will be the best solutions for my issue.

Where i can find some threads about that ?

Hi Gabriel,

Glad that it sounds interesting to you. There isn't a dedicated discussion thread but I did outline some of the ideas earlier today on a separate thread[1]. It's being actively worked on and maybe an RFC can hit the list soon.

Regards,
Mike

[1] http://www.spinics.net/lists/arm-kernel/msg331462.html

Quoted 6 lines

Thanks a lot.

Best Regards.

Gabriel.

#8 lore raw

PATCH 2/2 drivers: clk: st: authorize propagate rate change for clockgenD0

In reply to Gabriel FERNANDEZ

This patch allows the spread of change rate only for clockgenD0 clocks.

---
 arch/arm/boot/dts/stih407-clock.dtsi | 1 +
 drivers/clk/st/clk-flexgen.c         | 2 ++
 2 files changed, 3 insertions(+)
arch/arm/boot/dts/stih407-clock.dtsi +1 -0
index 5f1c83c..7fad261 100644
@@ -204,6 +204,7 @@
 					"CLK_PCM_1",
 					"CLK_PCM_2",
 					"CLK_SPDIFF";
+				set-rate-parent;
 			};
 		};
 
drivers/clk/st/clk-flexgen.c +2 -0
index f3ed700..5629988 100644
@@ -306,6 +306,8 @@ void __init st_of_flexgen_setup(struct device_node *np)
 		if (*clk_name == '\0')
 			continue;
 
+		flex_flags = of_clk_get_flags(np);
+
 		clk = clk_register_flexgen(clk_name, parents, num_parents,
 					   reg, rlock, i, flex_flags);
 
Signature · 1 line
1.9.1