Commit 9722c3b6 authored by Luca Ceresoli's avatar Luca Ceresoli Committed by Rob Herring (Arm)
Browse files

of: remove internal arguments from of_property_for_each_u32()



The of_property_for_each_u32() macro needs five parameters, two of which
are primarily meant as internal variables for the macro itself (in the
for() clause). Yet these two parameters are used by a few drivers, and this
can be considered misuse or at least bad practice.

Now that the kernel uses C11 to build, these two parameters can be avoided
by declaring them internally, thus changing this pattern:

  struct property *prop;
  const __be32 *p;
  u32 val;

  of_property_for_each_u32(np, "xyz", prop, p, val) { ... }

to this:

  u32 val;

  of_property_for_each_u32(np, "xyz", val) { ... }

However two variables cannot be declared in the for clause even with C11,
so declare one struct that contain the two variables we actually need. As
the variables inside this struct are not meant to be used by users of this
macro, give the struct instance the noticeable name "_it" so it is visible
during code reviews, helping to avoid new code to use it directly.

Most usages are trivially converted as they do not use those two
parameters, as expected. The non-trivial cases are:

 - drivers/clk/clk.c, of_clk_get_parent_name(): easily doable anyway
 - drivers/clk/clk-si5351.c, si5351_dt_parse(): this is more complex as the
   checks had to be replicated in a different way, making code more verbose
   and somewhat uglier, but I refrained from a full rework to keep as much
   of the original code untouched having no hardware to test my changes

All the changes have been build tested. The few for which I have the
hardware have been runtime-tested too.

Reviewed-by: Andre Przywara <andre.przywara@arm.com> # drivers/clk/sunxi/clk-simple-gates.c, drivers/clk/sunxi/clk-sun8i-bus-gates.c
Acked-by: Bartosz Golaszewski <bartosz.golaszewski@linaro.org> # drivers/gpio/gpio-brcmstb.c
Acked-by: Nicolas Ferre <nicolas.ferre@microchip.com> # drivers/irqchip/irq-atmel-aic-common.c
Acked-by: Jonathan Cameron <Jonathan.Cameron@huawei.com> # drivers/iio/adc/ti_am335x_adc.c
Acked-by: Uwe Kleine-König <u.kleine-koenig@baylibre.com> # drivers/pwm/pwm-samsung.c
Acked-by: Richard Leitner <richard.leitner@linux.dev> # drivers/usb/misc/usb251xb.c
Acked-by: Mark Brown <broonie@kernel.org> # sound/soc/codecs/arizona.c
Reviewed-by: Richard Fitzgerald <rf@opensource.cirrus.com> # sound/soc/codecs/arizona.c
Acked-by: Michael Ellerman <mpe@ellerman.id.au> # arch/powerpc/sysdev/xive/spapr.c
Acked-by: Stephen Boyd <sboyd@kernel.org> # clk
Signed-off-by: default avatarLuca Ceresoli <luca.ceresoli@bootlin.com>
Acked-by: default avatarLee Jones <lee@kernel.org>
Link: https://lore.kernel.org/r/20240724-of_property_for_each_u32-v3-1-bea82ce429e2@bootlin.com


Signed-off-by: default avatarRob Herring (Arm) <robh@kernel.org>
parent 7b52a9d9
Loading
Loading
Loading
Loading
+1 −3
Original line number Diff line number Diff line
@@ -559,9 +559,7 @@ bool __init xive_native_init(void)
	struct device_node *np;
	struct resource r;
	void __iomem *tima;
	struct property *prop;
	u8 max_prio = 7;
	const __be32 *p;
	u32 val, cpu;
	s64 rc;

@@ -592,7 +590,7 @@ bool __init xive_native_init(void)
		max_prio = val - 1;

	/* Iterate the EQ sizes and pick one */
	of_property_for_each_u32(np, "ibm,xive-eq-sizes", prop, p, val) {
	of_property_for_each_u32(np, "ibm,xive-eq-sizes", val) {
		xive_queue_shift = val;
		if (val == PAGE_SHIFT)
			break;
+1 −2
Original line number Diff line number Diff line
@@ -814,7 +814,6 @@ bool __init xive_spapr_init(void)
	struct device_node *np;
	struct resource r;
	void __iomem *tima;
	struct property *prop;
	u8 max_prio;
	u32 val;
	u32 len;
@@ -866,7 +865,7 @@ bool __init xive_spapr_init(void)
	}

	/* Iterate the EQ sizes and pick one */
	of_property_for_each_u32(np, "ibm,xive-eq-sizes", prop, reg, val) {
	of_property_for_each_u32(np, "ibm,xive-eq-sizes", val) {
		xive_queue_shift = val;
		if (val == PAGE_SHIFT)
			break;
+1 −3
Original line number Diff line number Diff line
@@ -2291,11 +2291,9 @@ static int sysc_init_idlemode(struct sysc *ddata, u8 *idlemodes,
			      const char *name)
{
	struct device_node *np = ddata->dev->of_node;
	struct property *prop;
	const __be32 *p;
	u32 val;

	of_property_for_each_u32(np, name, prop, p, val) {
	of_property_for_each_u32(np, name, val) {
		if (val >= SYSC_NR_IDLEMODES) {
			dev_err(ddata->dev, "invalid idlemode: %i\n", val);
			return -EINVAL;
+1 −3
Original line number Diff line number Diff line
@@ -81,13 +81,11 @@ static int __set_clk_parents(struct device_node *node, bool clk_supplier)
static int __set_clk_rates(struct device_node *node, bool clk_supplier)
{
	struct of_phandle_args clkspec;
	struct property	*prop;
	const __be32 *cur;
	int rc, index = 0;
	struct clk *clk;
	u32 rate;

	of_property_for_each_u32(node, "assigned-clock-rates", prop, cur, rate) {
	of_property_for_each_u32(node, "assigned-clock-rates", rate) {
		if (rate) {
			rc = of_parse_phandle_with_args(node, "assigned-clocks",
					"#clock-cells",	index, &clkspec);
+26 −17
Original line number Diff line number Diff line
@@ -1175,8 +1175,8 @@ static int si5351_dt_parse(struct i2c_client *client,
{
	struct device_node *child, *np = client->dev.of_node;
	struct si5351_platform_data *pdata;
	struct property *prop;
	const __be32 *p;
	u32 array[4];
	int sz, i;
	int num = 0;
	u32 val;

@@ -1191,20 +1191,24 @@ static int si5351_dt_parse(struct i2c_client *client,
	 * property silabs,pll-source : <num src>, [<..>]
	 * allow to selectively set pll source
	 */
	of_property_for_each_u32(np, "silabs,pll-source", prop, p, num) {
	sz = of_property_read_variable_u32_array(np, "silabs,pll-source", array, 2, 4);
	sz = (sz == -EINVAL) ? 0 : sz; /* Missing property is OK */
	if (sz < 0)
		return dev_err_probe(&client->dev, sz, "invalid pll-source\n");
	if (sz % 2)
		return dev_err_probe(&client->dev, -EINVAL,
				     "missing pll-source for pll %d\n", array[sz - 1]);

	for (i = 0; i < sz; i += 2) {
		num = array[i];
		val = array[i + 1];

		if (num >= 2) {
			dev_err(&client->dev,
				"invalid pll %d on pll-source prop\n", num);
			return -EINVAL;
		}

		p = of_prop_next_u32(prop, p, &val);
		if (!p) {
			dev_err(&client->dev,
				"missing pll-source for pll %d\n", num);
			return -EINVAL;
		}

		switch (val) {
		case 0:
			pdata->pll_src[num] = SI5351_PLL_SRC_XTAL;
@@ -1232,19 +1236,24 @@ static int si5351_dt_parse(struct i2c_client *client,
	pdata->pll_reset[0] = true;
	pdata->pll_reset[1] = true;

	of_property_for_each_u32(np, "silabs,pll-reset-mode", prop, p, num) {
	sz = of_property_read_variable_u32_array(np, "silabs,pll-reset-mode", array, 2, 4);
	sz = (sz == -EINVAL) ? 0 : sz; /* Missing property is OK */
	if (sz < 0)
		return dev_err_probe(&client->dev, sz, "invalid pll-reset-mode\n");
	if (sz % 2)
		return dev_err_probe(&client->dev, -EINVAL,
				     "missing pll-reset-mode for pll %d\n", array[sz - 1]);

	for (i = 0; i < sz; i += 2) {
		num = array[i];
		val = array[i + 1];

		if (num >= 2) {
			dev_err(&client->dev,
				"invalid pll %d on pll-reset-mode prop\n", num);
			return -EINVAL;
		}

		p = of_prop_next_u32(prop, p, &val);
		if (!p) {
			dev_err(&client->dev,
				"missing pll-reset-mode for pll %d\n", num);
			return -EINVAL;
		}

		switch (val) {
		case 0:
Loading