2 * property.h - Unified device property interface.
4 * Copyright (C) 2014, Intel Corporation
5 * Authors: Rafael J. Wysocki <rafael.j.wysocki@intel.com>
6 * Mika Westerberg <mika.westerberg@linux.intel.com>
8 * This program is free software; you can redistribute it and/or modify
9 * it under the terms of the GNU General Public License version 2 as
10 * published by the Free Software Foundation.
13 #ifndef _LINUX_PROPERTY_H_
14 #define _LINUX_PROPERTY_H_
16 #include <linux/fwnode.h>
17 #include <linux/types.h>
30 bool device_property_present(struct device *dev, const char *propname);
31 int device_property_read_u8_array(struct device *dev, const char *propname,
32 u8 *val, size_t nval);
33 int device_property_read_u16_array(struct device *dev, const char *propname,
34 u16 *val, size_t nval);
35 int device_property_read_u32_array(struct device *dev, const char *propname,
36 u32 *val, size_t nval);
37 int device_property_read_u64_array(struct device *dev, const char *propname,
38 u64 *val, size_t nval);
39 int device_property_read_string_array(struct device *dev, const char *propname,
40 const char **val, size_t nval);
41 int device_property_read_string(struct device *dev, const char *propname,
43 int device_property_match_string(struct device *dev,
44 const char *propname, const char *string);
46 bool fwnode_property_present(struct fwnode_handle *fwnode, const char *propname);
47 int fwnode_property_read_u8_array(struct fwnode_handle *fwnode,
48 const char *propname, u8 *val,
50 int fwnode_property_read_u16_array(struct fwnode_handle *fwnode,
51 const char *propname, u16 *val,
53 int fwnode_property_read_u32_array(struct fwnode_handle *fwnode,
54 const char *propname, u32 *val,
56 int fwnode_property_read_u64_array(struct fwnode_handle *fwnode,
57 const char *propname, u64 *val,
59 int fwnode_property_read_string_array(struct fwnode_handle *fwnode,
60 const char *propname, const char **val,
62 int fwnode_property_read_string(struct fwnode_handle *fwnode,
63 const char *propname, const char **val);
64 int fwnode_property_match_string(struct fwnode_handle *fwnode,
65 const char *propname, const char *string);
67 struct fwnode_handle *device_get_next_child_node(struct device *dev,
68 struct fwnode_handle *child);
70 #define device_for_each_child_node(dev, child) \
71 for (child = device_get_next_child_node(dev, NULL); child; \
72 child = device_get_next_child_node(dev, child))
74 void fwnode_handle_put(struct fwnode_handle *fwnode);
76 unsigned int device_get_child_node_count(struct device *dev);
78 static inline bool device_property_read_bool(struct device *dev,
81 return device_property_present(dev, propname);
84 static inline int device_property_read_u8(struct device *dev,
85 const char *propname, u8 *val)
87 return device_property_read_u8_array(dev, propname, val, 1);
90 static inline int device_property_read_u16(struct device *dev,
91 const char *propname, u16 *val)
93 return device_property_read_u16_array(dev, propname, val, 1);
96 static inline int device_property_read_u32(struct device *dev,
97 const char *propname, u32 *val)
99 return device_property_read_u32_array(dev, propname, val, 1);
102 static inline int device_property_read_u64(struct device *dev,
103 const char *propname, u64 *val)
105 return device_property_read_u64_array(dev, propname, val, 1);
108 static inline bool fwnode_property_read_bool(struct fwnode_handle *fwnode,
109 const char *propname)
111 return fwnode_property_present(fwnode, propname);
114 static inline int fwnode_property_read_u8(struct fwnode_handle *fwnode,
115 const char *propname, u8 *val)
117 return fwnode_property_read_u8_array(fwnode, propname, val, 1);
120 static inline int fwnode_property_read_u16(struct fwnode_handle *fwnode,
121 const char *propname, u16 *val)
123 return fwnode_property_read_u16_array(fwnode, propname, val, 1);
126 static inline int fwnode_property_read_u32(struct fwnode_handle *fwnode,
127 const char *propname, u32 *val)
129 return fwnode_property_read_u32_array(fwnode, propname, val, 1);
132 static inline int fwnode_property_read_u64(struct fwnode_handle *fwnode,
133 const char *propname, u64 *val)
135 return fwnode_property_read_u64_array(fwnode, propname, val, 1);
139 * struct property_entry - "Built-in" device property representation.
140 * @name: Name of the property.
141 * @type: Type of the property.
142 * @nval: Number of items of type @type making up the value.
143 * @value: Value of the property (an array of @nval items of type @type).
145 struct property_entry {
147 enum dev_prop_type type;
160 * struct property_set - Collection of "built-in" device properties.
161 * @fwnode: Handle to be pointed to by the fwnode field of struct device.
162 * @properties: Array of properties terminated with a null entry.
164 struct property_set {
165 struct fwnode_handle fwnode;
166 struct property_entry *properties;
169 void device_add_property_set(struct device *dev, struct property_set *pset);
171 bool device_dma_is_coherent(struct device *dev);
173 int device_get_phy_mode(struct device *dev);
175 void *device_get_mac_address(struct device *dev, char *addr, int alen);
177 #endif /* _LINUX_PROPERTY_H_ */