2 * Self tests for device tree subsystem
5 #define pr_fmt(fmt) "### dt-test ### " fmt
9 #include <linux/errno.h>
10 #include <linux/hashtable.h>
11 #include <linux/module.h>
13 #include <linux/of_fdt.h>
14 #include <linux/of_irq.h>
15 #include <linux/of_platform.h>
16 #include <linux/list.h>
17 #include <linux/mutex.h>
18 #include <linux/slab.h>
19 #include <linux/device.h>
20 #include <linux/platform_device.h>
21 #include <linux/of_platform.h>
23 #include "of_private.h"
25 static struct selftest_results
{
31 static struct device_node
*nodes
[NO_OF_NODES
];
32 static int last_node_index
;
33 static bool selftest_live_tree
;
35 #define selftest(result, fmt, ...) ({ \
36 bool failed = !(result); \
38 selftest_results.failed++; \
39 pr_err("FAIL %s():%i " fmt, __func__, __LINE__, ##__VA_ARGS__); \
41 selftest_results.passed++; \
42 pr_debug("pass %s():%i\n", __func__, __LINE__); \
47 static void __init
of_selftest_find_node_by_name(void)
49 struct device_node
*np
;
52 np
= of_find_node_by_path("/testcase-data");
53 selftest(np
&& !strcmp("/testcase-data", np
->full_name
),
54 "find /testcase-data failed\n");
57 /* Test if trailing '/' works */
58 np
= of_find_node_by_path("/testcase-data/");
59 selftest(!np
, "trailing '/' on /testcase-data/ should fail\n");
61 np
= of_find_node_by_path("/testcase-data/phandle-tests/consumer-a");
62 selftest(np
&& !strcmp("/testcase-data/phandle-tests/consumer-a", np
->full_name
),
63 "find /testcase-data/phandle-tests/consumer-a failed\n");
66 np
= of_find_node_by_path("testcase-alias");
67 selftest(np
&& !strcmp("/testcase-data", np
->full_name
),
68 "find testcase-alias failed\n");
71 /* Test if trailing '/' works on aliases */
72 np
= of_find_node_by_path("testcase-alias/");
73 selftest(!np
, "trailing '/' on testcase-alias/ should fail\n");
75 np
= of_find_node_by_path("testcase-alias/phandle-tests/consumer-a");
76 selftest(np
&& !strcmp("/testcase-data/phandle-tests/consumer-a", np
->full_name
),
77 "find testcase-alias/phandle-tests/consumer-a failed\n");
80 np
= of_find_node_by_path("/testcase-data/missing-path");
81 selftest(!np
, "non-existent path returned node %s\n", np
->full_name
);
84 np
= of_find_node_by_path("missing-alias");
85 selftest(!np
, "non-existent alias returned node %s\n", np
->full_name
);
88 np
= of_find_node_by_path("testcase-alias/missing-path");
89 selftest(!np
, "non-existent alias with relative path returned node %s\n", np
->full_name
);
92 np
= of_find_node_opts_by_path("/testcase-data:testoption", &options
);
93 selftest(np
&& !strcmp("testoption", options
),
94 "option path test failed\n");
97 np
= of_find_node_opts_by_path("/testcase-data:testoption", NULL
);
98 selftest(np
, "NULL option path test failed\n");
101 np
= of_find_node_opts_by_path("testcase-alias:testaliasoption",
103 selftest(np
&& !strcmp("testaliasoption", options
),
104 "option alias path test failed\n");
107 np
= of_find_node_opts_by_path("testcase-alias:testaliasoption", NULL
);
108 selftest(np
, "NULL option alias path test failed\n");
111 options
= "testoption";
112 np
= of_find_node_opts_by_path("testcase-alias", &options
);
113 selftest(np
&& !options
, "option clearing test failed\n");
116 options
= "testoption";
117 np
= of_find_node_opts_by_path("/", &options
);
118 selftest(np
&& !options
, "option clearing root node test failed\n");
122 static void __init
of_selftest_dynamic(void)
124 struct device_node
*np
;
125 struct property
*prop
;
127 np
= of_find_node_by_path("/testcase-data");
129 pr_err("missing testcase data\n");
133 /* Array of 4 properties for the purpose of testing */
134 prop
= kzalloc(sizeof(*prop
) * 4, GFP_KERNEL
);
136 selftest(0, "kzalloc() failed\n");
140 /* Add a new property - should pass*/
141 prop
->name
= "new-property";
142 prop
->value
= "new-property-data";
143 prop
->length
= strlen(prop
->value
);
144 selftest(of_add_property(np
, prop
) == 0, "Adding a new property failed\n");
146 /* Try to add an existing property - should fail */
148 prop
->name
= "new-property";
149 prop
->value
= "new-property-data-should-fail";
150 prop
->length
= strlen(prop
->value
);
151 selftest(of_add_property(np
, prop
) != 0,
152 "Adding an existing property should have failed\n");
154 /* Try to modify an existing property - should pass */
155 prop
->value
= "modify-property-data-should-pass";
156 prop
->length
= strlen(prop
->value
);
157 selftest(of_update_property(np
, prop
) == 0,
158 "Updating an existing property should have passed\n");
160 /* Try to modify non-existent property - should pass*/
162 prop
->name
= "modify-property";
163 prop
->value
= "modify-missing-property-data-should-pass";
164 prop
->length
= strlen(prop
->value
);
165 selftest(of_update_property(np
, prop
) == 0,
166 "Updating a missing property should have passed\n");
168 /* Remove property - should pass */
169 selftest(of_remove_property(np
, prop
) == 0,
170 "Removing a property should have passed\n");
172 /* Adding very large property - should pass */
174 prop
->name
= "large-property-PAGE_SIZEx8";
175 prop
->length
= PAGE_SIZE
* 8;
176 prop
->value
= kzalloc(prop
->length
, GFP_KERNEL
);
177 selftest(prop
->value
!= NULL
, "Unable to allocate large buffer\n");
179 selftest(of_add_property(np
, prop
) == 0,
180 "Adding a large property should have passed\n");
183 static int __init
of_selftest_check_node_linkage(struct device_node
*np
)
185 struct device_node
*child
;
188 for_each_child_of_node(np
, child
) {
189 if (child
->parent
!= np
) {
190 pr_err("Child node %s links to wrong parent %s\n",
191 child
->name
, np
->name
);
195 rc
= of_selftest_check_node_linkage(child
);
204 static void __init
of_selftest_check_tree_linkage(void)
206 struct device_node
*np
;
207 int allnode_count
= 0, child_count
;
212 for_each_of_allnodes(np
)
214 child_count
= of_selftest_check_node_linkage(of_root
);
216 selftest(child_count
> 0, "Device node data structure is corrupted\n");
217 selftest(child_count
== allnode_count
, "allnodes list size (%i) doesn't match"
218 "sibling lists size (%i)\n", allnode_count
, child_count
);
219 pr_debug("allnodes list size (%i); sibling lists size (%i)\n", allnode_count
, child_count
);
223 struct hlist_node node
;
224 struct device_node
*np
;
227 static DEFINE_HASHTABLE(phandle_ht
, 8);
228 static void __init
of_selftest_check_phandles(void)
230 struct device_node
*np
;
231 struct node_hash
*nh
;
232 struct hlist_node
*tmp
;
233 int i
, dup_count
= 0, phandle_count
= 0;
235 for_each_of_allnodes(np
) {
239 hash_for_each_possible(phandle_ht
, nh
, node
, np
->phandle
) {
240 if (nh
->np
->phandle
== np
->phandle
) {
241 pr_info("Duplicate phandle! %i used by %s and %s\n",
242 np
->phandle
, nh
->np
->full_name
, np
->full_name
);
248 nh
= kzalloc(sizeof(*nh
), GFP_KERNEL
);
253 hash_add(phandle_ht
, &nh
->node
, np
->phandle
);
256 selftest(dup_count
== 0, "Found %i duplicates in %i phandles\n",
257 dup_count
, phandle_count
);
260 hash_for_each_safe(phandle_ht
, i
, tmp
, nh
, node
) {
266 static void __init
of_selftest_parse_phandle_with_args(void)
268 struct device_node
*np
;
269 struct of_phandle_args args
;
272 np
= of_find_node_by_path("/testcase-data/phandle-tests/consumer-a");
274 pr_err("missing testcase data\n");
278 rc
= of_count_phandle_with_args(np
, "phandle-list", "#phandle-cells");
279 selftest(rc
== 7, "of_count_phandle_with_args() returned %i, expected 7\n", rc
);
281 for (i
= 0; i
< 8; i
++) {
283 rc
= of_parse_phandle_with_args(np
, "phandle-list",
284 "#phandle-cells", i
, &args
);
286 /* Test the values from tests-phandle.dtsi */
290 passed
&= (args
.args_count
== 1);
291 passed
&= (args
.args
[0] == (i
+ 1));
295 passed
&= (args
.args_count
== 2);
296 passed
&= (args
.args
[0] == (i
+ 1));
297 passed
&= (args
.args
[1] == 0);
300 passed
&= (rc
== -ENOENT
);
304 passed
&= (args
.args_count
== 3);
305 passed
&= (args
.args
[0] == (i
+ 1));
306 passed
&= (args
.args
[1] == 4);
307 passed
&= (args
.args
[2] == 3);
311 passed
&= (args
.args_count
== 2);
312 passed
&= (args
.args
[0] == (i
+ 1));
313 passed
&= (args
.args
[1] == 100);
317 passed
&= (args
.args_count
== 0);
321 passed
&= (args
.args_count
== 1);
322 passed
&= (args
.args
[0] == (i
+ 1));
325 passed
&= (rc
== -ENOENT
);
331 selftest(passed
, "index %i - data error on node %s rc=%i\n",
332 i
, args
.np
->full_name
, rc
);
335 /* Check for missing list property */
336 rc
= of_parse_phandle_with_args(np
, "phandle-list-missing",
337 "#phandle-cells", 0, &args
);
338 selftest(rc
== -ENOENT
, "expected:%i got:%i\n", -ENOENT
, rc
);
339 rc
= of_count_phandle_with_args(np
, "phandle-list-missing",
341 selftest(rc
== -ENOENT
, "expected:%i got:%i\n", -ENOENT
, rc
);
343 /* Check for missing cells property */
344 rc
= of_parse_phandle_with_args(np
, "phandle-list",
345 "#phandle-cells-missing", 0, &args
);
346 selftest(rc
== -EINVAL
, "expected:%i got:%i\n", -EINVAL
, rc
);
347 rc
= of_count_phandle_with_args(np
, "phandle-list",
348 "#phandle-cells-missing");
349 selftest(rc
== -EINVAL
, "expected:%i got:%i\n", -EINVAL
, rc
);
351 /* Check for bad phandle in list */
352 rc
= of_parse_phandle_with_args(np
, "phandle-list-bad-phandle",
353 "#phandle-cells", 0, &args
);
354 selftest(rc
== -EINVAL
, "expected:%i got:%i\n", -EINVAL
, rc
);
355 rc
= of_count_phandle_with_args(np
, "phandle-list-bad-phandle",
357 selftest(rc
== -EINVAL
, "expected:%i got:%i\n", -EINVAL
, rc
);
359 /* Check for incorrectly formed argument list */
360 rc
= of_parse_phandle_with_args(np
, "phandle-list-bad-args",
361 "#phandle-cells", 1, &args
);
362 selftest(rc
== -EINVAL
, "expected:%i got:%i\n", -EINVAL
, rc
);
363 rc
= of_count_phandle_with_args(np
, "phandle-list-bad-args",
365 selftest(rc
== -EINVAL
, "expected:%i got:%i\n", -EINVAL
, rc
);
368 static void __init
of_selftest_property_string(void)
370 const char *strings
[4];
371 struct device_node
*np
;
374 np
= of_find_node_by_path("/testcase-data/phandle-tests/consumer-a");
376 pr_err("No testcase data in device tree\n");
380 rc
= of_property_match_string(np
, "phandle-list-names", "first");
381 selftest(rc
== 0, "first expected:0 got:%i\n", rc
);
382 rc
= of_property_match_string(np
, "phandle-list-names", "second");
383 selftest(rc
== 1, "second expected:0 got:%i\n", rc
);
384 rc
= of_property_match_string(np
, "phandle-list-names", "third");
385 selftest(rc
== 2, "third expected:0 got:%i\n", rc
);
386 rc
= of_property_match_string(np
, "phandle-list-names", "fourth");
387 selftest(rc
== -ENODATA
, "unmatched string; rc=%i\n", rc
);
388 rc
= of_property_match_string(np
, "missing-property", "blah");
389 selftest(rc
== -EINVAL
, "missing property; rc=%i\n", rc
);
390 rc
= of_property_match_string(np
, "empty-property", "blah");
391 selftest(rc
== -ENODATA
, "empty property; rc=%i\n", rc
);
392 rc
= of_property_match_string(np
, "unterminated-string", "blah");
393 selftest(rc
== -EILSEQ
, "unterminated string; rc=%i\n", rc
);
395 /* of_property_count_strings() tests */
396 rc
= of_property_count_strings(np
, "string-property");
397 selftest(rc
== 1, "Incorrect string count; rc=%i\n", rc
);
398 rc
= of_property_count_strings(np
, "phandle-list-names");
399 selftest(rc
== 3, "Incorrect string count; rc=%i\n", rc
);
400 rc
= of_property_count_strings(np
, "unterminated-string");
401 selftest(rc
== -EILSEQ
, "unterminated string; rc=%i\n", rc
);
402 rc
= of_property_count_strings(np
, "unterminated-string-list");
403 selftest(rc
== -EILSEQ
, "unterminated string array; rc=%i\n", rc
);
405 /* of_property_read_string_index() tests */
406 rc
= of_property_read_string_index(np
, "string-property", 0, strings
);
407 selftest(rc
== 0 && !strcmp(strings
[0], "foobar"), "of_property_read_string_index() failure; rc=%i\n", rc
);
409 rc
= of_property_read_string_index(np
, "string-property", 1, strings
);
410 selftest(rc
== -ENODATA
&& strings
[0] == NULL
, "of_property_read_string_index() failure; rc=%i\n", rc
);
411 rc
= of_property_read_string_index(np
, "phandle-list-names", 0, strings
);
412 selftest(rc
== 0 && !strcmp(strings
[0], "first"), "of_property_read_string_index() failure; rc=%i\n", rc
);
413 rc
= of_property_read_string_index(np
, "phandle-list-names", 1, strings
);
414 selftest(rc
== 0 && !strcmp(strings
[0], "second"), "of_property_read_string_index() failure; rc=%i\n", rc
);
415 rc
= of_property_read_string_index(np
, "phandle-list-names", 2, strings
);
416 selftest(rc
== 0 && !strcmp(strings
[0], "third"), "of_property_read_string_index() failure; rc=%i\n", rc
);
418 rc
= of_property_read_string_index(np
, "phandle-list-names", 3, strings
);
419 selftest(rc
== -ENODATA
&& strings
[0] == NULL
, "of_property_read_string_index() failure; rc=%i\n", rc
);
421 rc
= of_property_read_string_index(np
, "unterminated-string", 0, strings
);
422 selftest(rc
== -EILSEQ
&& strings
[0] == NULL
, "of_property_read_string_index() failure; rc=%i\n", rc
);
423 rc
= of_property_read_string_index(np
, "unterminated-string-list", 0, strings
);
424 selftest(rc
== 0 && !strcmp(strings
[0], "first"), "of_property_read_string_index() failure; rc=%i\n", rc
);
426 rc
= of_property_read_string_index(np
, "unterminated-string-list", 2, strings
); /* should fail */
427 selftest(rc
== -EILSEQ
&& strings
[0] == NULL
, "of_property_read_string_index() failure; rc=%i\n", rc
);
430 /* of_property_read_string_array() tests */
431 rc
= of_property_read_string_array(np
, "string-property", strings
, 4);
432 selftest(rc
== 1, "Incorrect string count; rc=%i\n", rc
);
433 rc
= of_property_read_string_array(np
, "phandle-list-names", strings
, 4);
434 selftest(rc
== 3, "Incorrect string count; rc=%i\n", rc
);
435 rc
= of_property_read_string_array(np
, "unterminated-string", strings
, 4);
436 selftest(rc
== -EILSEQ
, "unterminated string; rc=%i\n", rc
);
437 /* -- An incorrectly formed string should cause a failure */
438 rc
= of_property_read_string_array(np
, "unterminated-string-list", strings
, 4);
439 selftest(rc
== -EILSEQ
, "unterminated string array; rc=%i\n", rc
);
440 /* -- parsing the correctly formed strings should still work: */
442 rc
= of_property_read_string_array(np
, "unterminated-string-list", strings
, 2);
443 selftest(rc
== 2 && strings
[2] == NULL
, "of_property_read_string_array() failure; rc=%i\n", rc
);
445 rc
= of_property_read_string_array(np
, "phandle-list-names", strings
, 1);
446 selftest(rc
== 1 && strings
[1] == NULL
, "Overwrote end of string array; rc=%i, str='%s'\n", rc
, strings
[1]);
449 #define propcmp(p1, p2) (((p1)->length == (p2)->length) && \
450 (p1)->value && (p2)->value && \
451 !memcmp((p1)->value, (p2)->value, (p1)->length) && \
452 !strcmp((p1)->name, (p2)->name))
453 static void __init
of_selftest_property_copy(void)
455 #ifdef CONFIG_OF_DYNAMIC
456 struct property p1
= { .name
= "p1", .length
= 0, .value
= "" };
457 struct property p2
= { .name
= "p2", .length
= 5, .value
= "abcd" };
458 struct property
*new;
460 new = __of_prop_dup(&p1
, GFP_KERNEL
);
461 selftest(new && propcmp(&p1
, new), "empty property didn't copy correctly\n");
466 new = __of_prop_dup(&p2
, GFP_KERNEL
);
467 selftest(new && propcmp(&p2
, new), "non-empty property didn't copy correctly\n");
474 static void __init
of_selftest_changeset(void)
476 #ifdef CONFIG_OF_DYNAMIC
477 struct property
*ppadd
, padd
= { .name
= "prop-add", .length
= 0, .value
= "" };
478 struct property
*ppupdate
, pupdate
= { .name
= "prop-update", .length
= 5, .value
= "abcd" };
479 struct property
*ppremove
;
480 struct device_node
*n1
, *n2
, *n21
, *nremove
, *parent
, *np
;
481 struct of_changeset chgset
;
483 of_changeset_init(&chgset
);
484 n1
= __of_node_dup(NULL
, "/testcase-data/changeset/n1");
485 selftest(n1
, "testcase setup failure\n");
486 n2
= __of_node_dup(NULL
, "/testcase-data/changeset/n2");
487 selftest(n2
, "testcase setup failure\n");
488 n21
= __of_node_dup(NULL
, "%s/%s", "/testcase-data/changeset/n2", "n21");
489 selftest(n21
, "testcase setup failure %p\n", n21
);
490 nremove
= of_find_node_by_path("/testcase-data/changeset/node-remove");
491 selftest(nremove
, "testcase setup failure\n");
492 ppadd
= __of_prop_dup(&padd
, GFP_KERNEL
);
493 selftest(ppadd
, "testcase setup failure\n");
494 ppupdate
= __of_prop_dup(&pupdate
, GFP_KERNEL
);
495 selftest(ppupdate
, "testcase setup failure\n");
496 parent
= nremove
->parent
;
501 ppremove
= of_find_property(parent
, "prop-remove", NULL
);
502 selftest(ppremove
, "failed to find removal prop");
504 of_changeset_init(&chgset
);
505 selftest(!of_changeset_attach_node(&chgset
, n1
), "fail attach n1\n");
506 selftest(!of_changeset_attach_node(&chgset
, n2
), "fail attach n2\n");
507 selftest(!of_changeset_detach_node(&chgset
, nremove
), "fail remove node\n");
508 selftest(!of_changeset_attach_node(&chgset
, n21
), "fail attach n21\n");
509 selftest(!of_changeset_add_property(&chgset
, parent
, ppadd
), "fail add prop\n");
510 selftest(!of_changeset_update_property(&chgset
, parent
, ppupdate
), "fail update prop\n");
511 selftest(!of_changeset_remove_property(&chgset
, parent
, ppremove
), "fail remove prop\n");
512 mutex_lock(&of_mutex
);
513 selftest(!of_changeset_apply(&chgset
), "apply failed\n");
514 mutex_unlock(&of_mutex
);
516 /* Make sure node names are constructed correctly */
517 selftest((np
= of_find_node_by_path("/testcase-data/changeset/n2/n21")),
518 "'%s' not added\n", n21
->full_name
);
522 mutex_lock(&of_mutex
);
523 selftest(!of_changeset_revert(&chgset
), "revert failed\n");
524 mutex_unlock(&of_mutex
);
526 of_changeset_destroy(&chgset
);
530 static void __init
of_selftest_parse_interrupts(void)
532 struct device_node
*np
;
533 struct of_phandle_args args
;
536 np
= of_find_node_by_path("/testcase-data/interrupts/interrupts0");
538 pr_err("missing testcase data\n");
542 for (i
= 0; i
< 4; i
++) {
545 rc
= of_irq_parse_one(np
, i
, &args
);
548 passed
&= (args
.args_count
== 1);
549 passed
&= (args
.args
[0] == (i
+ 1));
551 selftest(passed
, "index %i - data error on node %s rc=%i\n",
552 i
, args
.np
->full_name
, rc
);
556 np
= of_find_node_by_path("/testcase-data/interrupts/interrupts1");
558 pr_err("missing testcase data\n");
562 for (i
= 0; i
< 4; i
++) {
565 rc
= of_irq_parse_one(np
, i
, &args
);
567 /* Test the values from tests-phandle.dtsi */
571 passed
&= (args
.args_count
== 1);
572 passed
&= (args
.args
[0] == 9);
576 passed
&= (args
.args_count
== 3);
577 passed
&= (args
.args
[0] == 10);
578 passed
&= (args
.args
[1] == 11);
579 passed
&= (args
.args
[2] == 12);
583 passed
&= (args
.args_count
== 2);
584 passed
&= (args
.args
[0] == 13);
585 passed
&= (args
.args
[1] == 14);
589 passed
&= (args
.args_count
== 2);
590 passed
&= (args
.args
[0] == 15);
591 passed
&= (args
.args
[1] == 16);
596 selftest(passed
, "index %i - data error on node %s rc=%i\n",
597 i
, args
.np
->full_name
, rc
);
602 static void __init
of_selftest_parse_interrupts_extended(void)
604 struct device_node
*np
;
605 struct of_phandle_args args
;
608 np
= of_find_node_by_path("/testcase-data/interrupts/interrupts-extended0");
610 pr_err("missing testcase data\n");
614 for (i
= 0; i
< 7; i
++) {
616 rc
= of_irq_parse_one(np
, i
, &args
);
618 /* Test the values from tests-phandle.dtsi */
622 passed
&= (args
.args_count
== 1);
623 passed
&= (args
.args
[0] == 1);
627 passed
&= (args
.args_count
== 3);
628 passed
&= (args
.args
[0] == 2);
629 passed
&= (args
.args
[1] == 3);
630 passed
&= (args
.args
[2] == 4);
634 passed
&= (args
.args_count
== 2);
635 passed
&= (args
.args
[0] == 5);
636 passed
&= (args
.args
[1] == 6);
640 passed
&= (args
.args_count
== 1);
641 passed
&= (args
.args
[0] == 9);
645 passed
&= (args
.args_count
== 3);
646 passed
&= (args
.args
[0] == 10);
647 passed
&= (args
.args
[1] == 11);
648 passed
&= (args
.args
[2] == 12);
652 passed
&= (args
.args_count
== 2);
653 passed
&= (args
.args
[0] == 13);
654 passed
&= (args
.args
[1] == 14);
658 passed
&= (args
.args_count
== 1);
659 passed
&= (args
.args
[0] == 15);
665 selftest(passed
, "index %i - data error on node %s rc=%i\n",
666 i
, args
.np
->full_name
, rc
);
671 static struct of_device_id match_node_table
[] = {
672 { .data
= "A", .name
= "name0", }, /* Name alone is lowest priority */
673 { .data
= "B", .type
= "type1", }, /* followed by type alone */
675 { .data
= "Ca", .name
= "name2", .type
= "type1", }, /* followed by both together */
676 { .data
= "Cb", .name
= "name2", }, /* Only match when type doesn't match */
677 { .data
= "Cc", .name
= "name2", .type
= "type2", },
679 { .data
= "E", .compatible
= "compat3" },
680 { .data
= "G", .compatible
= "compat2", },
681 { .data
= "H", .compatible
= "compat2", .name
= "name5", },
682 { .data
= "I", .compatible
= "compat2", .type
= "type1", },
683 { .data
= "J", .compatible
= "compat2", .type
= "type1", .name
= "name8", },
684 { .data
= "K", .compatible
= "compat2", .name
= "name9", },
691 } match_node_tests
[] = {
692 { .path
= "/testcase-data/match-node/name0", .data
= "A", },
693 { .path
= "/testcase-data/match-node/name1", .data
= "B", },
694 { .path
= "/testcase-data/match-node/a/name2", .data
= "Ca", },
695 { .path
= "/testcase-data/match-node/b/name2", .data
= "Cb", },
696 { .path
= "/testcase-data/match-node/c/name2", .data
= "Cc", },
697 { .path
= "/testcase-data/match-node/name3", .data
= "E", },
698 { .path
= "/testcase-data/match-node/name4", .data
= "G", },
699 { .path
= "/testcase-data/match-node/name5", .data
= "H", },
700 { .path
= "/testcase-data/match-node/name6", .data
= "G", },
701 { .path
= "/testcase-data/match-node/name7", .data
= "I", },
702 { .path
= "/testcase-data/match-node/name8", .data
= "J", },
703 { .path
= "/testcase-data/match-node/name9", .data
= "K", },
706 static void __init
of_selftest_match_node(void)
708 struct device_node
*np
;
709 const struct of_device_id
*match
;
712 for (i
= 0; i
< ARRAY_SIZE(match_node_tests
); i
++) {
713 np
= of_find_node_by_path(match_node_tests
[i
].path
);
715 selftest(0, "missing testcase node %s\n",
716 match_node_tests
[i
].path
);
720 match
= of_match_node(match_node_table
, np
);
722 selftest(0, "%s didn't match anything\n",
723 match_node_tests
[i
].path
);
727 if (strcmp(match
->data
, match_node_tests
[i
].data
) != 0) {
728 selftest(0, "%s got wrong match. expected %s, got %s\n",
729 match_node_tests
[i
].path
, match_node_tests
[i
].data
,
730 (const char *)match
->data
);
733 selftest(1, "passed");
737 struct device test_bus
= {
738 .init_name
= "unittest-bus",
740 static void __init
of_selftest_platform_populate(void)
743 struct device_node
*np
, *child
, *grandchild
;
744 struct platform_device
*pdev
;
745 struct of_device_id match
[] = {
746 { .compatible
= "test-device", },
750 np
= of_find_node_by_path("/testcase-data");
751 of_platform_populate(np
, of_default_bus_match_table
, NULL
, NULL
);
753 /* Test that a missing irq domain returns -EPROBE_DEFER */
754 np
= of_find_node_by_path("/testcase-data/testcase-device1");
755 pdev
= of_find_device_by_node(np
);
756 selftest(pdev
, "device 1 creation failed\n");
758 irq
= platform_get_irq(pdev
, 0);
759 selftest(irq
== -EPROBE_DEFER
, "device deferred probe failed - %d\n", irq
);
761 /* Test that a parsing failure does not return -EPROBE_DEFER */
762 np
= of_find_node_by_path("/testcase-data/testcase-device2");
763 pdev
= of_find_device_by_node(np
);
764 selftest(pdev
, "device 2 creation failed\n");
765 irq
= platform_get_irq(pdev
, 0);
766 selftest(irq
< 0 && irq
!= -EPROBE_DEFER
, "device parsing error failed - %d\n", irq
);
768 if (selftest(np
= of_find_node_by_path("/testcase-data/platform-tests"),
769 "No testcase data in device tree\n"));
772 if (selftest(!(rc
= device_register(&test_bus
)),
773 "testbus registration failed; rc=%i\n", rc
));
776 for_each_child_of_node(np
, child
) {
777 of_platform_populate(child
, match
, NULL
, &test_bus
);
778 for_each_child_of_node(child
, grandchild
)
779 selftest(of_find_device_by_node(grandchild
),
780 "Could not create device for node '%s'\n",
784 of_platform_depopulate(&test_bus
);
785 for_each_child_of_node(np
, child
) {
786 for_each_child_of_node(child
, grandchild
)
787 selftest(!of_find_device_by_node(grandchild
),
788 "device didn't get destroyed '%s'\n",
792 device_unregister(&test_bus
);
797 * update_node_properties - adds the properties
798 * of np into dup node (present in live tree) and
799 * updates parent of children of np to dup.
801 * @np: node already present in live tree
802 * @dup: node present in live tree to be updated
804 static void update_node_properties(struct device_node
*np
,
805 struct device_node
*dup
)
807 struct property
*prop
;
808 struct device_node
*child
;
810 for_each_property_of_node(np
, prop
)
811 of_add_property(dup
, prop
);
813 for_each_child_of_node(np
, child
)
818 * attach_node_and_children - attaches nodes
819 * and its children to live tree
821 * @np: Node to attach to live tree
823 static int attach_node_and_children(struct device_node
*np
)
825 struct device_node
*next
, *dup
, *child
;
827 dup
= of_find_node_by_path(np
->full_name
);
829 update_node_properties(np
, dup
);
833 /* Children of the root need to be remembered for removal */
834 if (np
->parent
== of_root
) {
835 if (WARN_ON(last_node_index
>= NO_OF_NODES
))
837 nodes
[last_node_index
++] = np
;
845 next
= child
->sibling
;
846 attach_node_and_children(child
);
854 * selftest_data_add - Reads, copies data from
855 * linked tree and attaches it to the live tree
857 static int __init
selftest_data_add(void)
860 struct device_node
*selftest_data_node
, *np
;
861 extern uint8_t __dtb_testcases_begin
[];
862 extern uint8_t __dtb_testcases_end
[];
863 const int size
= __dtb_testcases_end
- __dtb_testcases_begin
;
867 pr_warn("%s: No testcase data to attach; not running tests\n",
873 selftest_data
= kmemdup(__dtb_testcases_begin
, size
, GFP_KERNEL
);
875 if (!selftest_data
) {
876 pr_warn("%s: Failed to allocate memory for selftest_data; "
877 "not running tests\n", __func__
);
880 of_fdt_unflatten_tree(selftest_data
, &selftest_data_node
);
881 if (!selftest_data_node
) {
882 pr_warn("%s: No tree to attach; not running tests\n", __func__
);
885 of_node_set_flag(selftest_data_node
, OF_DETACHED
);
886 rc
= of_resolve_phandles(selftest_data_node
);
888 pr_err("%s: Failed to resolve phandles (rc=%i)\n", __func__
, rc
);
893 /* enabling flag for removing nodes */
894 selftest_live_tree
= true;
895 of_root
= selftest_data_node
;
897 for_each_of_allnodes(np
)
898 __of_attach_node_sysfs(np
);
899 of_aliases
= of_find_node_by_path("/aliases");
900 of_chosen
= of_find_node_by_path("/chosen");
904 /* attach the sub-tree to live tree */
905 np
= selftest_data_node
->child
;
907 struct device_node
*next
= np
->sibling
;
908 np
->parent
= of_root
;
909 attach_node_and_children(np
);
916 * detach_node_and_children - detaches node
917 * and its children from live tree
919 * @np: Node to detach from live tree
921 static void detach_node_and_children(struct device_node
*np
)
924 detach_node_and_children(np
->child
);
929 * selftest_data_remove - removes the selftest data
930 * nodes from the live tree
932 static void selftest_data_remove(void)
934 struct device_node
*np
;
935 struct property
*prop
;
937 if (selftest_live_tree
) {
938 of_node_put(of_aliases
);
939 of_node_put(of_chosen
);
942 for_each_child_of_node(of_root
, np
)
943 detach_node_and_children(np
);
944 __of_detach_node_sysfs(of_root
);
949 while (last_node_index
-- > 0) {
950 if (nodes
[last_node_index
]) {
951 np
= of_find_node_by_path(nodes
[last_node_index
]->full_name
);
952 if (np
== nodes
[last_node_index
]) {
953 if (of_aliases
== np
) {
954 of_node_put(of_aliases
);
957 detach_node_and_children(np
);
959 for_each_property_of_node(np
, prop
) {
960 if (strcmp(prop
->name
, "testcase-alias") == 0)
961 of_remove_property(np
, prop
);
968 #ifdef CONFIG_OF_OVERLAY
970 static int selftest_probe(struct platform_device
*pdev
)
972 struct device
*dev
= &pdev
->dev
;
973 struct device_node
*np
= dev
->of_node
;
976 dev_err(dev
, "No OF data for device\n");
981 dev_dbg(dev
, "%s for node @%s\n", __func__
, np
->full_name
);
985 static int selftest_remove(struct platform_device
*pdev
)
987 struct device
*dev
= &pdev
->dev
;
988 struct device_node
*np
= dev
->of_node
;
990 dev_dbg(dev
, "%s for node @%s\n", __func__
, np
->full_name
);
994 static struct of_device_id selftest_match
[] = {
995 { .compatible
= "selftest", },
999 static struct platform_driver selftest_driver
= {
1000 .probe
= selftest_probe
,
1001 .remove
= selftest_remove
,
1004 .owner
= THIS_MODULE
,
1005 .of_match_table
= of_match_ptr(selftest_match
),
1009 /* get the platform device instantiated at the path */
1010 static struct platform_device
*of_path_to_platform_device(const char *path
)
1012 struct device_node
*np
;
1013 struct platform_device
*pdev
;
1015 np
= of_find_node_by_path(path
);
1019 pdev
= of_find_device_by_node(np
);
1025 /* find out if a platform device exists at that path */
1026 static int of_path_platform_device_exists(const char *path
)
1028 struct platform_device
*pdev
;
1030 pdev
= of_path_to_platform_device(path
);
1031 platform_device_put(pdev
);
1032 return pdev
!= NULL
;
1035 static const char *selftest_path(int nr
)
1037 static char buf
[256];
1039 snprintf(buf
, sizeof(buf
) - 1,
1040 "/testcase-data/overlay-node/test-bus/test-selftest%d", nr
);
1041 buf
[sizeof(buf
) - 1] = '\0';
1046 static const char *overlay_path(int nr
)
1048 static char buf
[256];
1050 snprintf(buf
, sizeof(buf
) - 1,
1051 "/testcase-data/overlay%d", nr
);
1052 buf
[sizeof(buf
) - 1] = '\0';
1057 static const char *bus_path
= "/testcase-data/overlay-node/test-bus";
1059 static int of_selftest_apply_overlay(int selftest_nr
, int overlay_nr
,
1062 struct device_node
*np
= NULL
;
1065 np
= of_find_node_by_path(overlay_path(overlay_nr
));
1067 selftest(0, "could not find overlay node @\"%s\"\n",
1068 overlay_path(overlay_nr
));
1073 ret
= of_overlay_create(np
);
1075 selftest(0, "could not create overlay from \"%s\"\n",
1076 overlay_path(overlay_nr
));
1092 /* apply an overlay while checking before and after states */
1093 static int of_selftest_apply_overlay_check(int overlay_nr
, int selftest_nr
,
1094 int before
, int after
)
1098 /* selftest device must not be in before state */
1099 if (of_path_platform_device_exists(selftest_path(selftest_nr
))
1101 selftest(0, "overlay @\"%s\" with device @\"%s\" %s\n",
1102 overlay_path(overlay_nr
),
1103 selftest_path(selftest_nr
),
1104 !before
? "enabled" : "disabled");
1108 ret
= of_selftest_apply_overlay(overlay_nr
, selftest_nr
, NULL
);
1110 /* of_selftest_apply_overlay already called selftest() */
1114 /* selftest device must be to set to after state */
1115 if (of_path_platform_device_exists(selftest_path(selftest_nr
))
1117 selftest(0, "overlay @\"%s\" failed to create @\"%s\" %s\n",
1118 overlay_path(overlay_nr
),
1119 selftest_path(selftest_nr
),
1120 !after
? "enabled" : "disabled");
1127 /* apply an overlay and then revert it while checking before, after states */
1128 static int of_selftest_apply_revert_overlay_check(int overlay_nr
,
1129 int selftest_nr
, int before
, int after
)
1133 /* selftest device must be in before state */
1134 if (of_path_platform_device_exists(selftest_path(selftest_nr
))
1136 selftest(0, "overlay @\"%s\" with device @\"%s\" %s\n",
1137 overlay_path(overlay_nr
),
1138 selftest_path(selftest_nr
),
1139 !before
? "enabled" : "disabled");
1143 /* apply the overlay */
1144 ret
= of_selftest_apply_overlay(overlay_nr
, selftest_nr
, &ov_id
);
1146 /* of_selftest_apply_overlay already called selftest() */
1150 /* selftest device must be in after state */
1151 if (of_path_platform_device_exists(selftest_path(selftest_nr
))
1153 selftest(0, "overlay @\"%s\" failed to create @\"%s\" %s\n",
1154 overlay_path(overlay_nr
),
1155 selftest_path(selftest_nr
),
1156 !after
? "enabled" : "disabled");
1160 ret
= of_overlay_destroy(ov_id
);
1162 selftest(0, "overlay @\"%s\" failed to be destroyed @\"%s\"\n",
1163 overlay_path(overlay_nr
),
1164 selftest_path(selftest_nr
));
1168 /* selftest device must be again in before state */
1169 if (of_path_platform_device_exists(selftest_path(selftest_nr
))
1171 selftest(0, "overlay @\"%s\" with device @\"%s\" %s\n",
1172 overlay_path(overlay_nr
),
1173 selftest_path(selftest_nr
),
1174 !before
? "enabled" : "disabled");
1181 /* test activation of device */
1182 static void of_selftest_overlay_0(void)
1186 /* device should enable */
1187 ret
= of_selftest_apply_overlay_check(0, 0, 0, 1);
1191 selftest(1, "overlay test %d passed\n", 0);
1194 /* test deactivation of device */
1195 static void of_selftest_overlay_1(void)
1199 /* device should disable */
1200 ret
= of_selftest_apply_overlay_check(1, 1, 1, 0);
1204 selftest(1, "overlay test %d passed\n", 1);
1207 /* test activation of device */
1208 static void of_selftest_overlay_2(void)
1212 /* device should enable */
1213 ret
= of_selftest_apply_overlay_check(2, 2, 0, 1);
1217 selftest(1, "overlay test %d passed\n", 2);
1220 /* test deactivation of device */
1221 static void of_selftest_overlay_3(void)
1225 /* device should disable */
1226 ret
= of_selftest_apply_overlay_check(3, 3, 1, 0);
1230 selftest(1, "overlay test %d passed\n", 3);
1233 /* test activation of a full device node */
1234 static void of_selftest_overlay_4(void)
1238 /* device should disable */
1239 ret
= of_selftest_apply_overlay_check(4, 4, 0, 1);
1243 selftest(1, "overlay test %d passed\n", 4);
1246 /* test overlay apply/revert sequence */
1247 static void of_selftest_overlay_5(void)
1251 /* device should disable */
1252 ret
= of_selftest_apply_revert_overlay_check(5, 5, 0, 1);
1256 selftest(1, "overlay test %d passed\n", 5);
1259 /* test overlay application in sequence */
1260 static void of_selftest_overlay_6(void)
1262 struct device_node
*np
;
1263 int ret
, i
, ov_id
[2];
1264 int overlay_nr
= 6, selftest_nr
= 6;
1265 int before
= 0, after
= 1;
1267 /* selftest device must be in before state */
1268 for (i
= 0; i
< 2; i
++) {
1269 if (of_path_platform_device_exists(
1270 selftest_path(selftest_nr
+ i
))
1272 selftest(0, "overlay @\"%s\" with device @\"%s\" %s\n",
1273 overlay_path(overlay_nr
+ i
),
1274 selftest_path(selftest_nr
+ i
),
1275 !before
? "enabled" : "disabled");
1280 /* apply the overlays */
1281 for (i
= 0; i
< 2; i
++) {
1283 np
= of_find_node_by_path(overlay_path(overlay_nr
+ i
));
1285 selftest(0, "could not find overlay node @\"%s\"\n",
1286 overlay_path(overlay_nr
+ i
));
1290 ret
= of_overlay_create(np
);
1292 selftest(0, "could not create overlay from \"%s\"\n",
1293 overlay_path(overlay_nr
+ i
));
1299 for (i
= 0; i
< 2; i
++) {
1300 /* selftest device must be in after state */
1301 if (of_path_platform_device_exists(
1302 selftest_path(selftest_nr
+ i
))
1304 selftest(0, "overlay @\"%s\" failed @\"%s\" %s\n",
1305 overlay_path(overlay_nr
+ i
),
1306 selftest_path(selftest_nr
+ i
),
1307 !after
? "enabled" : "disabled");
1312 for (i
= 1; i
>= 0; i
--) {
1313 ret
= of_overlay_destroy(ov_id
[i
]);
1315 selftest(0, "overlay @\"%s\" failed destroy @\"%s\"\n",
1316 overlay_path(overlay_nr
+ i
),
1317 selftest_path(selftest_nr
+ i
));
1322 for (i
= 0; i
< 2; i
++) {
1323 /* selftest device must be again in before state */
1324 if (of_path_platform_device_exists(
1325 selftest_path(selftest_nr
+ i
))
1327 selftest(0, "overlay @\"%s\" with device @\"%s\" %s\n",
1328 overlay_path(overlay_nr
+ i
),
1329 selftest_path(selftest_nr
+ i
),
1330 !before
? "enabled" : "disabled");
1335 selftest(1, "overlay test %d passed\n", 6);
1338 /* test overlay application in sequence */
1339 static void of_selftest_overlay_8(void)
1341 struct device_node
*np
;
1342 int ret
, i
, ov_id
[2];
1343 int overlay_nr
= 8, selftest_nr
= 8;
1345 /* we don't care about device state in this test */
1347 /* apply the overlays */
1348 for (i
= 0; i
< 2; i
++) {
1350 np
= of_find_node_by_path(overlay_path(overlay_nr
+ i
));
1352 selftest(0, "could not find overlay node @\"%s\"\n",
1353 overlay_path(overlay_nr
+ i
));
1357 ret
= of_overlay_create(np
);
1359 selftest(0, "could not create overlay from \"%s\"\n",
1360 overlay_path(overlay_nr
+ i
));
1366 /* now try to remove first overlay (it should fail) */
1367 ret
= of_overlay_destroy(ov_id
[0]);
1369 selftest(0, "overlay @\"%s\" was destroyed @\"%s\"\n",
1370 overlay_path(overlay_nr
+ 0),
1371 selftest_path(selftest_nr
));
1375 /* removing them in order should work */
1376 for (i
= 1; i
>= 0; i
--) {
1377 ret
= of_overlay_destroy(ov_id
[i
]);
1379 selftest(0, "overlay @\"%s\" not destroyed @\"%s\"\n",
1380 overlay_path(overlay_nr
+ i
),
1381 selftest_path(selftest_nr
));
1386 selftest(1, "overlay test %d passed\n", 8);
1389 static void __init
of_selftest_overlay(void)
1391 struct device_node
*bus_np
= NULL
;
1394 ret
= platform_driver_register(&selftest_driver
);
1396 selftest(0, "could not register selftest driver\n");
1400 bus_np
= of_find_node_by_path(bus_path
);
1401 if (bus_np
== NULL
) {
1402 selftest(0, "could not find bus_path \"%s\"\n", bus_path
);
1406 ret
= of_platform_populate(bus_np
, of_default_bus_match_table
,
1409 selftest(0, "could not populate bus @ \"%s\"\n", bus_path
);
1413 if (!of_path_platform_device_exists(selftest_path(100))) {
1414 selftest(0, "could not find selftest0 @ \"%s\"\n",
1415 selftest_path(100));
1419 if (of_path_platform_device_exists(selftest_path(101))) {
1420 selftest(0, "selftest1 @ \"%s\" should not exist\n",
1421 selftest_path(101));
1425 selftest(1, "basic infrastructure of overlays passed");
1427 /* tests in sequence */
1428 of_selftest_overlay_0();
1429 of_selftest_overlay_1();
1430 of_selftest_overlay_2();
1431 of_selftest_overlay_3();
1432 of_selftest_overlay_4();
1433 of_selftest_overlay_5();
1434 of_selftest_overlay_6();
1435 of_selftest_overlay_8();
1438 of_node_put(bus_np
);
1442 static inline void __init
of_selftest_overlay(void) { }
1445 static int __init
of_selftest(void)
1447 struct device_node
*np
;
1450 /* adding data for selftest */
1451 res
= selftest_data_add();
1455 of_aliases
= of_find_node_by_path("/aliases");
1457 np
= of_find_node_by_path("/testcase-data/phandle-tests/consumer-a");
1459 pr_info("No testcase data in device tree; not running tests\n");
1464 pr_info("start of selftest - you will see error messages\n");
1465 of_selftest_check_tree_linkage();
1466 of_selftest_check_phandles();
1467 of_selftest_find_node_by_name();
1468 of_selftest_dynamic();
1469 of_selftest_parse_phandle_with_args();
1470 of_selftest_property_string();
1471 of_selftest_property_copy();
1472 of_selftest_changeset();
1473 of_selftest_parse_interrupts();
1474 of_selftest_parse_interrupts_extended();
1475 of_selftest_match_node();
1476 of_selftest_platform_populate();
1477 of_selftest_overlay();
1479 /* removing selftest data from live tree */
1480 selftest_data_remove();
1482 /* Double check linkage after removing testcase data */
1483 of_selftest_check_tree_linkage();
1485 pr_info("end of selftest - %i passed, %i failed\n",
1486 selftest_results
.passed
, selftest_results
.failed
);
1490 late_initcall(of_selftest
);