of_property_read_u32 函数

Vane Zhang

已于 2023-05-10 17:30:31 修改

阅读量4.8k

点赞数 2

分类专栏： linux自带的LED驱动分析文章标签： linux

于 2023-05-07 10:21:10 首次发布

本文链接：https://blog.csdn.net/qq_23174771/article/details/130539563

版权

linux自带的LED驱动分析专栏收录该内容

18 篇文章

订阅专栏

文章详细介绍了Linux内核4.14版本中与设备树相关的函数，特别是`of_property_read_u32`函数及其底层实现，包括`of_property_read_u32_array`和`of_property_read_variable_u32_array`等，这些函数用于从设备节点中读取指定属性的u32类型数值。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

Linux version: 4.14

Code link: Linux source code (v4.14) - Bootlin

（1）of_property_read_u32 函数

static inline int of_property_read_u32(const struct device_node *np,
				       const char *propname,
				       u32 *out_value)
{
	return of_property_read_u32_array(np, propname, out_value, 1);
}

（2）其中 of_property_read_u32_array

static inline int of_property_read_u32_array(const struct device_node *np,
					     const char *propname,
					     u32 *out_values, size_t sz)
{
	int ret = of_property_read_variable_u32_array(np, propname, out_values,
						      sz, 0);
	if (ret >= 0)
		return 0;
	else
		return ret;
}

（3）其中 of_property_read_variable_u32_array

int of_property_read_variable_u32_array(const struct device_node *np,
			       const char *propname, u32 *out_values,
			       size_t sz_min, size_t sz_max)
{
	size_t sz, count;
	const __be32 *val = of_find_property_value_of_size(np, propname,
						(sz_min * sizeof(*out_values)),
						(sz_max * sizeof(*out_values)),
						&sz);

	if (IS_ERR(val))
		return PTR_ERR(val);

	if (!sz_max)
		sz = sz_min;
	else
		sz /= sizeof(*out_values);

	count = sz;
	while (count--)
		*out_values++ = be32_to_cpup(val++);

	return sz;
}
EXPORT_SYMBOL_GPL(of_property_read_variable_u32_array);

（4）其中 of_find_property_value_of_size

static void *of_find_property_value_of_size(const struct device_node *np,
			const char *propname, u32 min, u32 max, size_t *len)
{
	struct property *prop = of_find_property(np, propname, NULL);

	if (!prop)
		return ERR_PTR(-EINVAL);
	if (!prop->value)
		return ERR_PTR(-ENODATA);
	if (prop->length < min)
		return ERR_PTR(-EOVERFLOW);
	if (max && prop->length > max)
		return ERR_PTR(-EOVERFLOW);

	if (len)
		*len = prop->length;

	return prop->value;
}

（5）其中 of_find_property

struct property *of_find_property(const struct device_node *np,
				  const char *name,
				  int *lenp)
{
	struct property *pp;
	unsigned long flags;

	raw_spin_lock_irqsave(&devtree_lock, flags);
	pp = __of_find_property(np, name, lenp);
	raw_spin_unlock_irqrestore(&devtree_lock, flags);

	return pp;
}
EXPORT_SYMBOL(of_find_property);

（6）其中 __of_find_property

static struct property *__of_find_property(const struct device_node *np,
					   const char *name, int *lenp)
{
	struct property *pp;

	if (!np)
		return NULL;

	for (pp = np->properties; pp; pp = pp->next) {
		if (of_prop_cmp(pp->name, name) == 0) {
			if (lenp)
				*lenp = pp->length;
			break;
		}
	}

	return pp;
}

其中 of_prop_cmp

#define of_prop_cmp(s1, s2)		strcmp((s1), (s2))

总结：

static inline int of_property_read_u32(const struct device_node *np,
				       const char *propname,
				       u32 *out_value)

of_property_read_u32 函数读取 np 结点中的 propname 属性的值，并将读取到的 u32 类型的值保存在 out_value 指向的内存中，函数的返回值表示读取到的 u32 类型的数据的个数。