of.h 25 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865
  1. #ifndef _LINUX_OF_H
  2. #define _LINUX_OF_H
  3. /*
  4. * Definitions for talking to the Open Firmware PROM on
  5. * Power Macintosh and other computers.
  6. *
  7. * Copyright (C) 1996-2005 Paul Mackerras.
  8. *
  9. * Updates for PPC64 by Peter Bergner & David Engebretsen, IBM Corp.
  10. * Updates for SPARC64 by David S. Miller
  11. * Derived from PowerPC and Sparc prom.h files by Stephen Rothwell, IBM Corp.
  12. *
  13. * This program is free software; you can redistribute it and/or
  14. * modify it under the terms of the GNU General Public License
  15. * as published by the Free Software Foundation; either version
  16. * 2 of the License, or (at your option) any later version.
  17. */
  18. #include <linux/types.h>
  19. #include <linux/bitops.h>
  20. #include <linux/errno.h>
  21. #include <linux/kobject.h>
  22. #include <linux/mod_devicetable.h>
  23. #include <linux/spinlock.h>
  24. #include <linux/topology.h>
  25. #include <linux/notifier.h>
  26. #include <asm/byteorder.h>
  27. #include <asm/errno.h>
  28. typedef u32 phandle;
  29. typedef u32 ihandle;
  30. struct property {
  31. char *name;
  32. int length;
  33. void *value;
  34. struct property *next;
  35. unsigned long _flags;
  36. unsigned int unique_id;
  37. struct bin_attribute attr;
  38. };
  39. #if defined(CONFIG_SPARC)
  40. struct of_irq_controller;
  41. #endif
  42. struct device_node {
  43. const char *name;
  44. const char *type;
  45. phandle phandle;
  46. const char *full_name;
  47. struct property *properties;
  48. struct property *deadprops; /* removed properties */
  49. struct device_node *parent;
  50. struct device_node *child;
  51. struct device_node *sibling;
  52. struct device_node *next; /* next device of same type */
  53. struct device_node *allnext; /* next in list of all nodes */
  54. struct kobject kobj;
  55. unsigned long _flags;
  56. void *data;
  57. #if defined(CONFIG_SPARC)
  58. const char *path_component_name;
  59. unsigned int unique_id;
  60. struct of_irq_controller *irq_trans;
  61. #endif
  62. };
  63. #define MAX_PHANDLE_ARGS 16
  64. struct of_phandle_args {
  65. struct device_node *np;
  66. int args_count;
  67. uint32_t args[MAX_PHANDLE_ARGS];
  68. };
  69. /* initialize a node */
  70. extern struct kobj_type of_node_ktype;
  71. static inline void of_node_init(struct device_node *node)
  72. {
  73. kobject_init(&node->kobj, &of_node_ktype);
  74. }
  75. /* true when node is initialized */
  76. static inline int of_node_is_initialized(struct device_node *node)
  77. {
  78. return node && node->kobj.state_initialized;
  79. }
  80. /* true when node is attached (i.e. present on sysfs) */
  81. static inline int of_node_is_attached(struct device_node *node)
  82. {
  83. return node && node->kobj.state_in_sysfs;
  84. }
  85. #ifdef CONFIG_OF_DYNAMIC
  86. extern struct device_node *of_node_get(struct device_node *node);
  87. extern void of_node_put(struct device_node *node);
  88. #else /* CONFIG_OF_DYNAMIC */
  89. /* Dummy ref counting routines - to be implemented later */
  90. static inline struct device_node *of_node_get(struct device_node *node)
  91. {
  92. return node;
  93. }
  94. static inline void of_node_put(struct device_node *node) { }
  95. #endif /* !CONFIG_OF_DYNAMIC */
  96. #ifdef CONFIG_OF
  97. /* Pointer for first entry in chain of all nodes. */
  98. extern struct device_node *of_allnodes;
  99. extern struct device_node *of_chosen;
  100. extern struct device_node *of_aliases;
  101. extern raw_spinlock_t devtree_lock;
  102. static inline bool of_have_populated_dt(void)
  103. {
  104. return of_allnodes != NULL;
  105. }
  106. static inline bool of_node_is_root(const struct device_node *node)
  107. {
  108. return node && (node->parent == NULL);
  109. }
  110. static inline int of_node_check_flag(struct device_node *n, unsigned long flag)
  111. {
  112. return test_bit(flag, &n->_flags);
  113. }
  114. static inline int of_node_test_and_set_flag(struct device_node *n,
  115. unsigned long flag)
  116. {
  117. return test_and_set_bit(flag, &n->_flags);
  118. }
  119. static inline void of_node_set_flag(struct device_node *n, unsigned long flag)
  120. {
  121. set_bit(flag, &n->_flags);
  122. }
  123. static inline void of_node_clear_flag(struct device_node *n, unsigned long flag)
  124. {
  125. clear_bit(flag, &n->_flags);
  126. }
  127. static inline int of_property_check_flag(struct property *p, unsigned long flag)
  128. {
  129. return test_bit(flag, &p->_flags);
  130. }
  131. static inline void of_property_set_flag(struct property *p, unsigned long flag)
  132. {
  133. set_bit(flag, &p->_flags);
  134. }
  135. static inline void of_property_clear_flag(struct property *p, unsigned long flag)
  136. {
  137. clear_bit(flag, &p->_flags);
  138. }
  139. extern struct device_node *of_find_all_nodes(struct device_node *prev);
  140. /*
  141. * OF address retrieval & translation
  142. */
  143. /* Helper to read a big number; size is in cells (not bytes) */
  144. static inline u64 of_read_number(const __be32 *cell, int size)
  145. {
  146. u64 r = 0;
  147. while (size--)
  148. r = (r << 32) | be32_to_cpu(*(cell++));
  149. return r;
  150. }
  151. /* Like of_read_number, but we want an unsigned long result */
  152. static inline unsigned long of_read_ulong(const __be32 *cell, int size)
  153. {
  154. /* toss away upper bits if unsigned long is smaller than u64 */
  155. return of_read_number(cell, size);
  156. }
  157. #if defined(CONFIG_SPARC)
  158. #include <asm/prom.h>
  159. #endif
  160. /* Default #address and #size cells. Allow arch asm/prom.h to override */
  161. #if !defined(OF_ROOT_NODE_ADDR_CELLS_DEFAULT)
  162. #define OF_ROOT_NODE_ADDR_CELLS_DEFAULT 1
  163. #define OF_ROOT_NODE_SIZE_CELLS_DEFAULT 1
  164. #endif
  165. /* Default string compare functions, Allow arch asm/prom.h to override */
  166. #if !defined(of_compat_cmp)
  167. #define of_compat_cmp(s1, s2, l) strcasecmp((s1), (s2))
  168. #define of_prop_cmp(s1, s2) strcmp((s1), (s2))
  169. #define of_node_cmp(s1, s2) strcasecmp((s1), (s2))
  170. #endif
  171. /* flag descriptions */
  172. #define OF_DYNAMIC 1 /* node and properties were allocated via kmalloc */
  173. #define OF_DETACHED 2 /* node has been detached from the device tree */
  174. #define OF_POPULATED 3 /* device already created for the node */
  175. #define OF_POPULATED_BUS 4 /* of_platform_populate recursed to children of this node */
  176. #define OF_IS_DYNAMIC(x) test_bit(OF_DYNAMIC, &x->_flags)
  177. #define OF_MARK_DYNAMIC(x) set_bit(OF_DYNAMIC, &x->_flags)
  178. #define OF_BAD_ADDR ((u64)-1)
  179. static inline const char *of_node_full_name(const struct device_node *np)
  180. {
  181. return np ? np->full_name : "<no-node>";
  182. }
  183. #define for_each_of_allnodes(dn) \
  184. for (dn = of_allnodes; dn; dn = dn->allnext)
  185. extern struct device_node *of_find_node_by_name(struct device_node *from,
  186. const char *name);
  187. extern struct device_node *of_find_node_by_type(struct device_node *from,
  188. const char *type);
  189. extern struct device_node *of_find_compatible_node(struct device_node *from,
  190. const char *type, const char *compat);
  191. extern struct device_node *of_find_matching_node_and_match(
  192. struct device_node *from,
  193. const struct of_device_id *matches,
  194. const struct of_device_id **match);
  195. extern struct device_node *of_find_node_by_path(const char *path);
  196. extern struct device_node *of_find_node_by_phandle(phandle handle);
  197. extern struct device_node *of_get_parent(const struct device_node *node);
  198. extern struct device_node *of_get_next_parent(struct device_node *node);
  199. extern struct device_node *of_get_next_child(const struct device_node *node,
  200. struct device_node *prev);
  201. extern struct device_node *of_get_next_available_child(
  202. const struct device_node *node, struct device_node *prev);
  203. extern struct device_node *of_get_child_by_name(const struct device_node *node,
  204. const char *name);
  205. /* cache lookup */
  206. extern struct device_node *of_find_next_cache_node(const struct device_node *);
  207. extern struct device_node *of_find_node_with_property(
  208. struct device_node *from, const char *prop_name);
  209. extern struct property *of_find_property(const struct device_node *np,
  210. const char *name,
  211. int *lenp);
  212. extern int of_property_count_elems_of_size(const struct device_node *np,
  213. const char *propname, int elem_size);
  214. extern int of_property_read_u32_index(const struct device_node *np,
  215. const char *propname,
  216. u32 index, u32 *out_value);
  217. extern int of_property_read_u8_array(const struct device_node *np,
  218. const char *propname, u8 *out_values, size_t sz);
  219. extern int of_property_read_u16_array(const struct device_node *np,
  220. const char *propname, u16 *out_values, size_t sz);
  221. extern int of_property_read_u32_array(const struct device_node *np,
  222. const char *propname,
  223. u32 *out_values,
  224. size_t sz);
  225. extern int of_property_read_u64(const struct device_node *np,
  226. const char *propname, u64 *out_value);
  227. extern int of_property_read_string(struct device_node *np,
  228. const char *propname,
  229. const char **out_string);
  230. extern int of_property_read_string_index(struct device_node *np,
  231. const char *propname,
  232. int index, const char **output);
  233. extern int of_property_match_string(struct device_node *np,
  234. const char *propname,
  235. const char *string);
  236. extern int of_property_count_strings(struct device_node *np,
  237. const char *propname);
  238. extern int of_device_is_compatible(const struct device_node *device,
  239. const char *);
  240. extern int of_device_is_available(const struct device_node *device);
  241. extern const void *of_get_property(const struct device_node *node,
  242. const char *name,
  243. int *lenp);
  244. extern struct device_node *of_get_cpu_node(int cpu, unsigned int *thread);
  245. #define for_each_property_of_node(dn, pp) \
  246. for (pp = dn->properties; pp != NULL; pp = pp->next)
  247. extern int of_n_addr_cells(struct device_node *np);
  248. extern int of_n_size_cells(struct device_node *np);
  249. extern const struct of_device_id *of_match_node(
  250. const struct of_device_id *matches, const struct device_node *node);
  251. extern int of_modalias_node(struct device_node *node, char *modalias, int len);
  252. extern void of_print_phandle_args(const char *msg, const struct of_phandle_args *args);
  253. extern struct device_node *of_parse_phandle(const struct device_node *np,
  254. const char *phandle_name,
  255. int index);
  256. extern int of_parse_phandle_with_args(const struct device_node *np,
  257. const char *list_name, const char *cells_name, int index,
  258. struct of_phandle_args *out_args);
  259. extern int of_parse_phandle_with_fixed_args(const struct device_node *np,
  260. const char *list_name, int cells_count, int index,
  261. struct of_phandle_args *out_args);
  262. extern int of_count_phandle_with_args(const struct device_node *np,
  263. const char *list_name, const char *cells_name);
  264. extern void of_alias_scan(void * (*dt_alloc)(u64 size, u64 align));
  265. extern int of_alias_get_id(struct device_node *np, const char *stem);
  266. extern int of_machine_is_compatible(const char *compat);
  267. extern int of_add_property(struct device_node *np, struct property *prop);
  268. extern int of_remove_property(struct device_node *np, struct property *prop);
  269. extern int of_update_property(struct device_node *np, struct property *newprop);
  270. /* For updating the device tree at runtime */
  271. #define OF_RECONFIG_ATTACH_NODE 0x0001
  272. #define OF_RECONFIG_DETACH_NODE 0x0002
  273. #define OF_RECONFIG_ADD_PROPERTY 0x0003
  274. #define OF_RECONFIG_REMOVE_PROPERTY 0x0004
  275. #define OF_RECONFIG_UPDATE_PROPERTY 0x0005
  276. struct of_prop_reconfig {
  277. struct device_node *dn;
  278. struct property *prop;
  279. struct property *old_prop;
  280. };
  281. extern int of_reconfig_notifier_register(struct notifier_block *);
  282. extern int of_reconfig_notifier_unregister(struct notifier_block *);
  283. extern int of_reconfig_notify(unsigned long, void *);
  284. extern int of_attach_node(struct device_node *);
  285. extern int of_detach_node(struct device_node *);
  286. #define of_match_ptr(_ptr) (_ptr)
  287. /*
  288. * struct property *prop;
  289. * const __be32 *p;
  290. * u32 u;
  291. *
  292. * of_property_for_each_u32(np, "propname", prop, p, u)
  293. * printk("U32 value: %x\n", u);
  294. */
  295. const __be32 *of_prop_next_u32(struct property *prop, const __be32 *cur,
  296. u32 *pu);
  297. /*
  298. * struct property *prop;
  299. * const char *s;
  300. *
  301. * of_property_for_each_string(np, "propname", prop, s)
  302. * printk("String value: %s\n", s);
  303. */
  304. const char *of_prop_next_string(struct property *prop, const char *cur);
  305. int of_device_is_stdout_path(struct device_node *dn);
  306. #else /* CONFIG_OF */
  307. static inline const char* of_node_full_name(const struct device_node *np)
  308. {
  309. return "<no-node>";
  310. }
  311. static inline struct device_node *of_find_node_by_name(struct device_node *from,
  312. const char *name)
  313. {
  314. return NULL;
  315. }
  316. static inline struct device_node *of_find_node_by_type(struct device_node *from,
  317. const char *type)
  318. {
  319. return NULL;
  320. }
  321. static inline struct device_node *of_find_matching_node_and_match(
  322. struct device_node *from,
  323. const struct of_device_id *matches,
  324. const struct of_device_id **match)
  325. {
  326. return NULL;
  327. }
  328. static inline struct device_node *of_find_node_by_path(const char *path)
  329. {
  330. return NULL;
  331. }
  332. static inline struct device_node *of_get_parent(const struct device_node *node)
  333. {
  334. return NULL;
  335. }
  336. static inline struct device_node *of_get_next_child(
  337. const struct device_node *node, struct device_node *prev)
  338. {
  339. return NULL;
  340. }
  341. static inline struct device_node *of_get_next_available_child(
  342. const struct device_node *node, struct device_node *prev)
  343. {
  344. return NULL;
  345. }
  346. static inline struct device_node *of_find_node_with_property(
  347. struct device_node *from, const char *prop_name)
  348. {
  349. return NULL;
  350. }
  351. static inline bool of_have_populated_dt(void)
  352. {
  353. return false;
  354. }
  355. static inline struct device_node *of_get_child_by_name(
  356. const struct device_node *node,
  357. const char *name)
  358. {
  359. return NULL;
  360. }
  361. static inline int of_device_is_compatible(const struct device_node *device,
  362. const char *name)
  363. {
  364. return 0;
  365. }
  366. static inline int of_device_is_available(const struct device_node *device)
  367. {
  368. return 0;
  369. }
  370. static inline struct property *of_find_property(const struct device_node *np,
  371. const char *name,
  372. int *lenp)
  373. {
  374. return NULL;
  375. }
  376. static inline struct device_node *of_find_compatible_node(
  377. struct device_node *from,
  378. const char *type,
  379. const char *compat)
  380. {
  381. return NULL;
  382. }
  383. static inline int of_property_count_elems_of_size(const struct device_node *np,
  384. const char *propname, int elem_size)
  385. {
  386. return -ENOSYS;
  387. }
  388. static inline int of_property_read_u32_index(const struct device_node *np,
  389. const char *propname, u32 index, u32 *out_value)
  390. {
  391. return -ENOSYS;
  392. }
  393. static inline int of_property_read_u8_array(const struct device_node *np,
  394. const char *propname, u8 *out_values, size_t sz)
  395. {
  396. return -ENOSYS;
  397. }
  398. static inline int of_property_read_u16_array(const struct device_node *np,
  399. const char *propname, u16 *out_values, size_t sz)
  400. {
  401. return -ENOSYS;
  402. }
  403. static inline int of_property_read_u32_array(const struct device_node *np,
  404. const char *propname,
  405. u32 *out_values, size_t sz)
  406. {
  407. return -ENOSYS;
  408. }
  409. static inline int of_property_read_string(struct device_node *np,
  410. const char *propname,
  411. const char **out_string)
  412. {
  413. return -ENOSYS;
  414. }
  415. static inline int of_property_read_string_index(struct device_node *np,
  416. const char *propname, int index,
  417. const char **out_string)
  418. {
  419. return -ENOSYS;
  420. }
  421. static inline int of_property_count_strings(struct device_node *np,
  422. const char *propname)
  423. {
  424. return -ENOSYS;
  425. }
  426. static inline const void *of_get_property(const struct device_node *node,
  427. const char *name,
  428. int *lenp)
  429. {
  430. return NULL;
  431. }
  432. static inline struct device_node *of_get_cpu_node(int cpu,
  433. unsigned int *thread)
  434. {
  435. return NULL;
  436. }
  437. static inline int of_property_read_u64(const struct device_node *np,
  438. const char *propname, u64 *out_value)
  439. {
  440. return -ENOSYS;
  441. }
  442. static inline int of_property_match_string(struct device_node *np,
  443. const char *propname,
  444. const char *string)
  445. {
  446. return -ENOSYS;
  447. }
  448. static inline struct device_node *of_parse_phandle(const struct device_node *np,
  449. const char *phandle_name,
  450. int index)
  451. {
  452. return NULL;
  453. }
  454. static inline int of_parse_phandle_with_args(struct device_node *np,
  455. const char *list_name,
  456. const char *cells_name,
  457. int index,
  458. struct of_phandle_args *out_args)
  459. {
  460. return -ENOSYS;
  461. }
  462. static inline int of_parse_phandle_with_fixed_args(const struct device_node *np,
  463. const char *list_name, int cells_count, int index,
  464. struct of_phandle_args *out_args)
  465. {
  466. return -ENOSYS;
  467. }
  468. static inline int of_count_phandle_with_args(struct device_node *np,
  469. const char *list_name,
  470. const char *cells_name)
  471. {
  472. return -ENOSYS;
  473. }
  474. static inline int of_alias_get_id(struct device_node *np, const char *stem)
  475. {
  476. return -ENOSYS;
  477. }
  478. static inline int of_machine_is_compatible(const char *compat)
  479. {
  480. return 0;
  481. }
  482. static inline int of_device_is_stdout_path(struct device_node *dn)
  483. {
  484. return 0;
  485. }
  486. static inline const __be32 *of_prop_next_u32(struct property *prop,
  487. const __be32 *cur, u32 *pu)
  488. {
  489. return NULL;
  490. }
  491. static inline const char *of_prop_next_string(struct property *prop,
  492. const char *cur)
  493. {
  494. return NULL;
  495. }
  496. #define of_match_ptr(_ptr) NULL
  497. #define of_match_node(_matches, _node) NULL
  498. #endif /* CONFIG_OF */
  499. #if defined(CONFIG_OF) && defined(CONFIG_NUMA)
  500. extern int of_node_to_nid(struct device_node *np);
  501. #else
  502. static inline int of_node_to_nid(struct device_node *device) { return 0; }
  503. #endif
  504. static inline struct device_node *of_find_matching_node(
  505. struct device_node *from,
  506. const struct of_device_id *matches)
  507. {
  508. return of_find_matching_node_and_match(from, matches, NULL);
  509. }
  510. /**
  511. * of_property_count_u8_elems - Count the number of u8 elements in a property
  512. *
  513. * @np: device node from which the property value is to be read.
  514. * @propname: name of the property to be searched.
  515. *
  516. * Search for a property in a device node and count the number of u8 elements
  517. * in it. Returns number of elements on sucess, -EINVAL if the property does
  518. * not exist or its length does not match a multiple of u8 and -ENODATA if the
  519. * property does not have a value.
  520. */
  521. static inline int of_property_count_u8_elems(const struct device_node *np,
  522. const char *propname)
  523. {
  524. return of_property_count_elems_of_size(np, propname, sizeof(u8));
  525. }
  526. /**
  527. * of_property_count_u16_elems - Count the number of u16 elements in a property
  528. *
  529. * @np: device node from which the property value is to be read.
  530. * @propname: name of the property to be searched.
  531. *
  532. * Search for a property in a device node and count the number of u16 elements
  533. * in it. Returns number of elements on sucess, -EINVAL if the property does
  534. * not exist or its length does not match a multiple of u16 and -ENODATA if the
  535. * property does not have a value.
  536. */
  537. static inline int of_property_count_u16_elems(const struct device_node *np,
  538. const char *propname)
  539. {
  540. return of_property_count_elems_of_size(np, propname, sizeof(u16));
  541. }
  542. /**
  543. * of_property_count_u32_elems - Count the number of u32 elements in a property
  544. *
  545. * @np: device node from which the property value is to be read.
  546. * @propname: name of the property to be searched.
  547. *
  548. * Search for a property in a device node and count the number of u32 elements
  549. * in it. Returns number of elements on sucess, -EINVAL if the property does
  550. * not exist or its length does not match a multiple of u32 and -ENODATA if the
  551. * property does not have a value.
  552. */
  553. static inline int of_property_count_u32_elems(const struct device_node *np,
  554. const char *propname)
  555. {
  556. return of_property_count_elems_of_size(np, propname, sizeof(u32));
  557. }
  558. /**
  559. * of_property_count_u64_elems - Count the number of u64 elements in a property
  560. *
  561. * @np: device node from which the property value is to be read.
  562. * @propname: name of the property to be searched.
  563. *
  564. * Search for a property in a device node and count the number of u64 elements
  565. * in it. Returns number of elements on sucess, -EINVAL if the property does
  566. * not exist or its length does not match a multiple of u64 and -ENODATA if the
  567. * property does not have a value.
  568. */
  569. static inline int of_property_count_u64_elems(const struct device_node *np,
  570. const char *propname)
  571. {
  572. return of_property_count_elems_of_size(np, propname, sizeof(u64));
  573. }
  574. /**
  575. * of_property_read_bool - Findfrom a property
  576. * @np: device node from which the property value is to be read.
  577. * @propname: name of the property to be searched.
  578. *
  579. * Search for a property in a device node.
  580. * Returns true if the property exist false otherwise.
  581. */
  582. static inline bool of_property_read_bool(const struct device_node *np,
  583. const char *propname)
  584. {
  585. struct property *prop = of_find_property(np, propname, NULL);
  586. return prop ? true : false;
  587. }
  588. static inline int of_property_read_u8(const struct device_node *np,
  589. const char *propname,
  590. u8 *out_value)
  591. {
  592. return of_property_read_u8_array(np, propname, out_value, 1);
  593. }
  594. static inline int of_property_read_u16(const struct device_node *np,
  595. const char *propname,
  596. u16 *out_value)
  597. {
  598. return of_property_read_u16_array(np, propname, out_value, 1);
  599. }
  600. static inline int of_property_read_u32(const struct device_node *np,
  601. const char *propname,
  602. u32 *out_value)
  603. {
  604. return of_property_read_u32_array(np, propname, out_value, 1);
  605. }
  606. #define of_property_for_each_u32(np, propname, prop, p, u) \
  607. for (prop = of_find_property(np, propname, NULL), \
  608. p = of_prop_next_u32(prop, NULL, &u); \
  609. p; \
  610. p = of_prop_next_u32(prop, p, &u))
  611. #define of_property_for_each_string(np, propname, prop, s) \
  612. for (prop = of_find_property(np, propname, NULL), \
  613. s = of_prop_next_string(prop, NULL); \
  614. s; \
  615. s = of_prop_next_string(prop, s))
  616. #define for_each_node_by_name(dn, name) \
  617. for (dn = of_find_node_by_name(NULL, name); dn; \
  618. dn = of_find_node_by_name(dn, name))
  619. #define for_each_node_by_type(dn, type) \
  620. for (dn = of_find_node_by_type(NULL, type); dn; \
  621. dn = of_find_node_by_type(dn, type))
  622. #define for_each_compatible_node(dn, type, compatible) \
  623. for (dn = of_find_compatible_node(NULL, type, compatible); dn; \
  624. dn = of_find_compatible_node(dn, type, compatible))
  625. #define for_each_matching_node(dn, matches) \
  626. for (dn = of_find_matching_node(NULL, matches); dn; \
  627. dn = of_find_matching_node(dn, matches))
  628. #define for_each_matching_node_and_match(dn, matches, match) \
  629. for (dn = of_find_matching_node_and_match(NULL, matches, match); \
  630. dn; dn = of_find_matching_node_and_match(dn, matches, match))
  631. #define for_each_child_of_node(parent, child) \
  632. for (child = of_get_next_child(parent, NULL); child != NULL; \
  633. child = of_get_next_child(parent, child))
  634. #define for_each_available_child_of_node(parent, child) \
  635. for (child = of_get_next_available_child(parent, NULL); child != NULL; \
  636. child = of_get_next_available_child(parent, child))
  637. #define for_each_node_with_property(dn, prop_name) \
  638. for (dn = of_find_node_with_property(NULL, prop_name); dn; \
  639. dn = of_find_node_with_property(dn, prop_name))
  640. static inline int of_get_child_count(const struct device_node *np)
  641. {
  642. struct device_node *child;
  643. int num = 0;
  644. for_each_child_of_node(np, child)
  645. num++;
  646. return num;
  647. }
  648. static inline int of_get_available_child_count(const struct device_node *np)
  649. {
  650. struct device_node *child;
  651. int num = 0;
  652. for_each_available_child_of_node(np, child)
  653. num++;
  654. return num;
  655. }
  656. #ifdef CONFIG_OF
  657. #define _OF_DECLARE(table, name, compat, fn, fn_type) \
  658. static const struct of_device_id __of_table_##name \
  659. __used __section(__##table##_of_table) \
  660. = { .compatible = compat, \
  661. .data = (fn == (fn_type)NULL) ? fn : fn }
  662. #else
  663. #define _OF_DECLARE(table, name, compat, fn, fn_type) \
  664. static const struct of_device_id __of_table_##name \
  665. __attribute__((unused)) \
  666. = { .compatible = compat, \
  667. .data = (fn == (fn_type)NULL) ? fn : fn }
  668. #endif
  669. typedef int (*of_init_fn_2)(struct device_node *, struct device_node *);
  670. typedef void (*of_init_fn_1)(struct device_node *);
  671. #define OF_DECLARE_1(table, name, compat, fn) \
  672. _OF_DECLARE(table, name, compat, fn, of_init_fn_1)
  673. #define OF_DECLARE_2(table, name, compat, fn) \
  674. _OF_DECLARE(table, name, compat, fn, of_init_fn_2)
  675. /**
  676. * struct of_changeset_entry - Holds a changeset entry
  677. *
  678. * @node: list_head for the log list
  679. * @action: notifier action
  680. * @np: pointer to the device node affected
  681. * @prop: pointer to the property affected
  682. * @old_prop: hold a pointer to the original property
  683. *
  684. * Every modification of the device tree during a changeset
  685. * is held in a list of of_changeset_entry structures.
  686. * That way we can recover from a partial application, or we can
  687. * revert the changeset
  688. */
  689. struct of_changeset_entry {
  690. struct list_head node;
  691. unsigned long action;
  692. struct device_node *np;
  693. struct property *prop;
  694. struct property *old_prop;
  695. };
  696. /**
  697. * struct of_changeset - changeset tracker structure
  698. *
  699. * @entries: list_head for the changeset entries
  700. *
  701. * changesets are a convenient way to apply bulk changes to the
  702. * live tree. In case of an error, changes are rolled-back.
  703. * changesets live on after initial application, and if not
  704. * destroyed after use, they can be reverted in one single call.
  705. */
  706. struct of_changeset {
  707. struct list_head entries;
  708. };
  709. #ifdef CONFIG_OF_DYNAMIC
  710. extern void of_changeset_init(struct of_changeset *ocs);
  711. extern void of_changeset_destroy(struct of_changeset *ocs);
  712. extern int of_changeset_apply(struct of_changeset *ocs);
  713. extern int of_changeset_revert(struct of_changeset *ocs);
  714. extern int of_changeset_action(struct of_changeset *ocs,
  715. unsigned long action, struct device_node *np,
  716. struct property *prop);
  717. static inline int of_changeset_attach_node(struct of_changeset *ocs,
  718. struct device_node *np)
  719. {
  720. return of_changeset_action(ocs, OF_RECONFIG_ATTACH_NODE, np, NULL);
  721. }
  722. static inline int of_changeset_detach_node(struct of_changeset *ocs,
  723. struct device_node *np)
  724. {
  725. return of_changeset_action(ocs, OF_RECONFIG_DETACH_NODE, np, NULL);
  726. }
  727. static inline int of_changeset_add_property(struct of_changeset *ocs,
  728. struct device_node *np, struct property *prop)
  729. {
  730. return of_changeset_action(ocs, OF_RECONFIG_ADD_PROPERTY, np, prop);
  731. }
  732. static inline int of_changeset_remove_property(struct of_changeset *ocs,
  733. struct device_node *np, struct property *prop)
  734. {
  735. return of_changeset_action(ocs, OF_RECONFIG_REMOVE_PROPERTY, np, prop);
  736. }
  737. static inline int of_changeset_update_property(struct of_changeset *ocs,
  738. struct device_node *np, struct property *prop)
  739. {
  740. return of_changeset_action(ocs, OF_RECONFIG_UPDATE_PROPERTY, np, prop);
  741. }
  742. #endif
  743. #endif /* _LINUX_OF_H */