1 // SPDX-License-Identifier: GPL-2.0
3 * Self tests for device tree subsystem
6 #define pr_fmt(fmt) "### dt-test ### " fmt
8 #include <linux/memblock.h>
10 #include <linux/dma-direct.h> /* to test phys_to_dma/dma_to_phys */
11 #include <linux/err.h>
12 #include <linux/errno.h>
13 #include <linux/hashtable.h>
14 #include <linux/libfdt.h>
16 #include <linux/of_address.h>
17 #include <linux/of_fdt.h>
18 #include <linux/of_irq.h>
19 #include <linux/of_platform.h>
20 #include <linux/list.h>
21 #include <linux/mutex.h>
22 #include <linux/slab.h>
23 #include <linux/device.h>
24 #include <linux/platform_device.h>
25 #include <linux/kernel.h>
27 #include <linux/i2c.h>
28 #include <linux/i2c-mux.h>
29 #include <linux/gpio/driver.h>
31 #include <linux/bitops.h>
33 #include "of_private.h"
35 static struct unittest_results {
40 #define unittest(result, fmt, ...) ({ \
41 bool failed = !(result); \
43 unittest_results.failed++; \
44 pr_err("FAIL %s():%i " fmt, __func__, __LINE__, ##__VA_ARGS__); \
46 unittest_results.passed++; \
47 pr_info("pass %s():%i\n", __func__, __LINE__); \
53 * Expected message may have a message level other than KERN_INFO.
54 * Print the expected message only if the current loglevel will allow
55 * the actual message to print.
57 * Do not use EXPECT_BEGIN(), EXPECT_END(), EXPECT_NOT_BEGIN(), or
58 * EXPECT_NOT_END() to report messages expected to be reported or not
59 * reported by pr_debug().
61 #define EXPECT_BEGIN(level, fmt, ...) \
62 printk(level pr_fmt("EXPECT \\ : ") fmt, ##__VA_ARGS__)
64 #define EXPECT_END(level, fmt, ...) \
65 printk(level pr_fmt("EXPECT / : ") fmt, ##__VA_ARGS__)
67 #define EXPECT_NOT_BEGIN(level, fmt, ...) \
68 printk(level pr_fmt("EXPECT_NOT \\ : ") fmt, ##__VA_ARGS__)
70 #define EXPECT_NOT_END(level, fmt, ...) \
71 printk(level pr_fmt("EXPECT_NOT / : ") fmt, ##__VA_ARGS__)
73 static void __init of_unittest_find_node_by_name(void)
75 struct device_node *np;
76 const char *options, *name;
78 np = of_find_node_by_path("/testcase-data");
79 name = kasprintf(GFP_KERNEL, "%pOF", np);
80 unittest(np && !strcmp("/testcase-data", name),
81 "find /testcase-data failed\n");
85 /* Test if trailing '/' works */
86 np = of_find_node_by_path("/testcase-data/");
87 unittest(!np, "trailing '/' on /testcase-data/ should fail\n");
89 np = of_find_node_by_path("/testcase-data/phandle-tests/consumer-a");
90 name = kasprintf(GFP_KERNEL, "%pOF", np);
91 unittest(np && !strcmp("/testcase-data/phandle-tests/consumer-a", name),
92 "find /testcase-data/phandle-tests/consumer-a failed\n");
96 np = of_find_node_by_path("testcase-alias");
97 name = kasprintf(GFP_KERNEL, "%pOF", np);
98 unittest(np && !strcmp("/testcase-data", name),
99 "find testcase-alias failed\n");
103 /* Test if trailing '/' works on aliases */
104 np = of_find_node_by_path("testcase-alias/");
105 unittest(!np, "trailing '/' on testcase-alias/ should fail\n");
107 np = of_find_node_by_path("testcase-alias/phandle-tests/consumer-a");
108 name = kasprintf(GFP_KERNEL, "%pOF", np);
109 unittest(np && !strcmp("/testcase-data/phandle-tests/consumer-a", name),
110 "find testcase-alias/phandle-tests/consumer-a failed\n");
114 np = of_find_node_by_path("/testcase-data/missing-path");
115 unittest(!np, "non-existent path returned node %pOF\n", np);
118 np = of_find_node_by_path("missing-alias");
119 unittest(!np, "non-existent alias returned node %pOF\n", np);
122 np = of_find_node_by_path("testcase-alias/missing-path");
123 unittest(!np, "non-existent alias with relative path returned node %pOF\n", np);
126 np = of_find_node_opts_by_path("/testcase-data:testoption", &options);
127 unittest(np && !strcmp("testoption", options),
128 "option path test failed\n");
131 np = of_find_node_opts_by_path("/testcase-data:test/option", &options);
132 unittest(np && !strcmp("test/option", options),
133 "option path test, subcase #1 failed\n");
136 np = of_find_node_opts_by_path("/testcase-data/testcase-device1:test/option", &options);
137 unittest(np && !strcmp("test/option", options),
138 "option path test, subcase #2 failed\n");
141 np = of_find_node_opts_by_path("/testcase-data:testoption", NULL);
142 unittest(np, "NULL option path test failed\n");
145 np = of_find_node_opts_by_path("testcase-alias:testaliasoption",
147 unittest(np && !strcmp("testaliasoption", options),
148 "option alias path test failed\n");
151 np = of_find_node_opts_by_path("testcase-alias:test/alias/option",
153 unittest(np && !strcmp("test/alias/option", options),
154 "option alias path test, subcase #1 failed\n");
157 np = of_find_node_opts_by_path("testcase-alias:testaliasoption", NULL);
158 unittest(np, "NULL option alias path test failed\n");
161 options = "testoption";
162 np = of_find_node_opts_by_path("testcase-alias", &options);
163 unittest(np && !options, "option clearing test failed\n");
166 options = "testoption";
167 np = of_find_node_opts_by_path("/", &options);
168 unittest(np && !options, "option clearing root node test failed\n");
172 static void __init of_unittest_dynamic(void)
174 struct device_node *np;
175 struct property *prop;
177 np = of_find_node_by_path("/testcase-data");
179 pr_err("missing testcase data\n");
183 /* Array of 4 properties for the purpose of testing */
184 prop = kcalloc(4, sizeof(*prop), GFP_KERNEL);
186 unittest(0, "kzalloc() failed\n");
190 /* Add a new property - should pass*/
191 prop->name = "new-property";
192 prop->value = "new-property-data";
193 prop->length = strlen(prop->value) + 1;
194 unittest(of_add_property(np, prop) == 0, "Adding a new property failed\n");
196 /* Try to add an existing property - should fail */
198 prop->name = "new-property";
199 prop->value = "new-property-data-should-fail";
200 prop->length = strlen(prop->value) + 1;
201 unittest(of_add_property(np, prop) != 0,
202 "Adding an existing property should have failed\n");
204 /* Try to modify an existing property - should pass */
205 prop->value = "modify-property-data-should-pass";
206 prop->length = strlen(prop->value) + 1;
207 unittest(of_update_property(np, prop) == 0,
208 "Updating an existing property should have passed\n");
210 /* Try to modify non-existent property - should pass*/
212 prop->name = "modify-property";
213 prop->value = "modify-missing-property-data-should-pass";
214 prop->length = strlen(prop->value) + 1;
215 unittest(of_update_property(np, prop) == 0,
216 "Updating a missing property should have passed\n");
218 /* Remove property - should pass */
219 unittest(of_remove_property(np, prop) == 0,
220 "Removing a property should have passed\n");
222 /* Adding very large property - should pass */
224 prop->name = "large-property-PAGE_SIZEx8";
225 prop->length = PAGE_SIZE * 8;
226 prop->value = kzalloc(prop->length, GFP_KERNEL);
227 unittest(prop->value != NULL, "Unable to allocate large buffer\n");
229 unittest(of_add_property(np, prop) == 0,
230 "Adding a large property should have passed\n");
233 static int __init of_unittest_check_node_linkage(struct device_node *np)
235 struct device_node *child;
238 for_each_child_of_node(np, child) {
239 if (child->parent != np) {
240 pr_err("Child node %pOFn links to wrong parent %pOFn\n",
246 rc = of_unittest_check_node_linkage(child);
258 static void __init of_unittest_check_tree_linkage(void)
260 struct device_node *np;
261 int allnode_count = 0, child_count;
266 for_each_of_allnodes(np)
268 child_count = of_unittest_check_node_linkage(of_root);
270 unittest(child_count > 0, "Device node data structure is corrupted\n");
271 unittest(child_count == allnode_count,
272 "allnodes list size (%i) doesn't match sibling lists size (%i)\n",
273 allnode_count, child_count);
274 pr_debug("allnodes list size (%i); sibling lists size (%i)\n", allnode_count, child_count);
277 static void __init of_unittest_printf_one(struct device_node *np, const char *fmt,
278 const char *expected)
284 buf_size = strlen(expected) + 10;
285 buf = kmalloc(buf_size, GFP_KERNEL);
289 /* Baseline; check conversion with a large size limit */
290 memset(buf, 0xff, buf_size);
291 size = snprintf(buf, buf_size - 2, fmt, np);
293 /* use strcmp() instead of strncmp() here to be absolutely sure strings match */
294 unittest((strcmp(buf, expected) == 0) && (buf[size+1] == 0xff),
295 "sprintf failed; fmt='%s' expected='%s' rslt='%s'\n",
298 /* Make sure length limits work */
300 for (i = 0; i < 2; i++, size--) {
301 /* Clear the buffer, and make sure it works correctly still */
302 memset(buf, 0xff, buf_size);
303 snprintf(buf, size+1, fmt, np);
304 unittest(strncmp(buf, expected, size) == 0 && (buf[size+1] == 0xff),
305 "snprintf failed; size=%i fmt='%s' expected='%s' rslt='%s'\n",
306 size, fmt, expected, buf);
311 static void __init of_unittest_printf(void)
313 struct device_node *np;
314 const char *full_name = "/testcase-data/platform-tests/test-device@1/dev@100";
315 char phandle_str[16] = "";
317 np = of_find_node_by_path(full_name);
319 unittest(np, "testcase data missing\n");
323 num_to_str(phandle_str, sizeof(phandle_str), np->phandle, 0);
325 of_unittest_printf_one(np, "%pOF", full_name);
326 of_unittest_printf_one(np, "%pOFf", full_name);
327 of_unittest_printf_one(np, "%pOFn", "dev");
328 of_unittest_printf_one(np, "%2pOFn", "dev");
329 of_unittest_printf_one(np, "%5pOFn", " dev");
330 of_unittest_printf_one(np, "%pOFnc", "dev:test-sub-device");
331 of_unittest_printf_one(np, "%pOFp", phandle_str);
332 of_unittest_printf_one(np, "%pOFP", "dev@100");
333 of_unittest_printf_one(np, "ABC %pOFP ABC", "ABC dev@100 ABC");
334 of_unittest_printf_one(np, "%10pOFP", " dev@100");
335 of_unittest_printf_one(np, "%-10pOFP", "dev@100 ");
336 of_unittest_printf_one(of_root, "%pOFP", "/");
337 of_unittest_printf_one(np, "%pOFF", "----");
338 of_unittest_printf_one(np, "%pOFPF", "dev@100:----");
339 of_unittest_printf_one(np, "%pOFPFPc", "dev@100:----:dev@100:test-sub-device");
340 of_unittest_printf_one(np, "%pOFc", "test-sub-device");
341 of_unittest_printf_one(np, "%pOFC",
342 "\"test-sub-device\",\"test-compat2\",\"test-compat3\"");
346 struct hlist_node node;
347 struct device_node *np;
350 static DEFINE_HASHTABLE(phandle_ht, 8);
351 static void __init of_unittest_check_phandles(void)
353 struct device_node *np;
354 struct node_hash *nh;
355 struct hlist_node *tmp;
356 int i, dup_count = 0, phandle_count = 0;
358 for_each_of_allnodes(np) {
362 hash_for_each_possible(phandle_ht, nh, node, np->phandle) {
363 if (nh->np->phandle == np->phandle) {
364 pr_info("Duplicate phandle! %i used by %pOF and %pOF\n",
365 np->phandle, nh->np, np);
371 nh = kzalloc(sizeof(*nh), GFP_KERNEL);
376 hash_add(phandle_ht, &nh->node, np->phandle);
379 unittest(dup_count == 0, "Found %i duplicates in %i phandles\n",
380 dup_count, phandle_count);
383 hash_for_each_safe(phandle_ht, i, tmp, nh, node) {
389 static void __init of_unittest_parse_phandle_with_args(void)
391 struct device_node *np;
392 struct of_phandle_args args;
395 np = of_find_node_by_path("/testcase-data/phandle-tests/consumer-a");
397 pr_err("missing testcase data\n");
401 rc = of_count_phandle_with_args(np, "phandle-list", "#phandle-cells");
402 unittest(rc == 7, "of_count_phandle_with_args() returned %i, expected 7\n", rc);
404 for (i = 0; i < 8; i++) {
407 memset(&args, 0, sizeof(args));
408 rc = of_parse_phandle_with_args(np, "phandle-list",
409 "#phandle-cells", i, &args);
411 /* Test the values from tests-phandle.dtsi */
415 passed &= (args.args_count == 1);
416 passed &= (args.args[0] == (i + 1));
420 passed &= (args.args_count == 2);
421 passed &= (args.args[0] == (i + 1));
422 passed &= (args.args[1] == 0);
425 passed &= (rc == -ENOENT);
429 passed &= (args.args_count == 3);
430 passed &= (args.args[0] == (i + 1));
431 passed &= (args.args[1] == 4);
432 passed &= (args.args[2] == 3);
436 passed &= (args.args_count == 2);
437 passed &= (args.args[0] == (i + 1));
438 passed &= (args.args[1] == 100);
442 passed &= (args.args_count == 0);
446 passed &= (args.args_count == 1);
447 passed &= (args.args[0] == (i + 1));
450 passed &= (rc == -ENOENT);
456 unittest(passed, "index %i - data error on node %pOF rc=%i\n",
460 /* Check for missing list property */
461 memset(&args, 0, sizeof(args));
462 rc = of_parse_phandle_with_args(np, "phandle-list-missing",
463 "#phandle-cells", 0, &args);
464 unittest(rc == -ENOENT, "expected:%i got:%i\n", -ENOENT, rc);
465 rc = of_count_phandle_with_args(np, "phandle-list-missing",
467 unittest(rc == -ENOENT, "expected:%i got:%i\n", -ENOENT, rc);
469 /* Check for missing cells property */
470 memset(&args, 0, sizeof(args));
472 EXPECT_BEGIN(KERN_INFO,
473 "OF: /testcase-data/phandle-tests/consumer-a: could not get #phandle-cells-missing for /testcase-data/phandle-tests/provider1");
475 rc = of_parse_phandle_with_args(np, "phandle-list",
476 "#phandle-cells-missing", 0, &args);
478 EXPECT_END(KERN_INFO,
479 "OF: /testcase-data/phandle-tests/consumer-a: could not get #phandle-cells-missing for /testcase-data/phandle-tests/provider1");
481 unittest(rc == -EINVAL, "expected:%i got:%i\n", -EINVAL, rc);
483 EXPECT_BEGIN(KERN_INFO,
484 "OF: /testcase-data/phandle-tests/consumer-a: could not get #phandle-cells-missing for /testcase-data/phandle-tests/provider1");
486 rc = of_count_phandle_with_args(np, "phandle-list",
487 "#phandle-cells-missing");
489 EXPECT_END(KERN_INFO,
490 "OF: /testcase-data/phandle-tests/consumer-a: could not get #phandle-cells-missing for /testcase-data/phandle-tests/provider1");
492 unittest(rc == -EINVAL, "expected:%i got:%i\n", -EINVAL, rc);
494 /* Check for bad phandle in list */
495 memset(&args, 0, sizeof(args));
497 EXPECT_BEGIN(KERN_INFO,
498 "OF: /testcase-data/phandle-tests/consumer-a: could not find phandle");
500 rc = of_parse_phandle_with_args(np, "phandle-list-bad-phandle",
501 "#phandle-cells", 0, &args);
503 EXPECT_END(KERN_INFO,
504 "OF: /testcase-data/phandle-tests/consumer-a: could not find phandle");
506 unittest(rc == -EINVAL, "expected:%i got:%i\n", -EINVAL, rc);
508 EXPECT_BEGIN(KERN_INFO,
509 "OF: /testcase-data/phandle-tests/consumer-a: could not find phandle");
511 rc = of_count_phandle_with_args(np, "phandle-list-bad-phandle",
514 EXPECT_END(KERN_INFO,
515 "OF: /testcase-data/phandle-tests/consumer-a: could not find phandle");
517 unittest(rc == -EINVAL, "expected:%i got:%i\n", -EINVAL, rc);
519 /* Check for incorrectly formed argument list */
520 memset(&args, 0, sizeof(args));
522 EXPECT_BEGIN(KERN_INFO,
523 "OF: /testcase-data/phandle-tests/consumer-a: #phandle-cells = 3 found 1");
525 rc = of_parse_phandle_with_args(np, "phandle-list-bad-args",
526 "#phandle-cells", 1, &args);
528 EXPECT_END(KERN_INFO,
529 "OF: /testcase-data/phandle-tests/consumer-a: #phandle-cells = 3 found 1");
531 unittest(rc == -EINVAL, "expected:%i got:%i\n", -EINVAL, rc);
533 EXPECT_BEGIN(KERN_INFO,
534 "OF: /testcase-data/phandle-tests/consumer-a: #phandle-cells = 3 found 1");
536 rc = of_count_phandle_with_args(np, "phandle-list-bad-args",
539 EXPECT_END(KERN_INFO,
540 "OF: /testcase-data/phandle-tests/consumer-a: #phandle-cells = 3 found 1");
542 unittest(rc == -EINVAL, "expected:%i got:%i\n", -EINVAL, rc);
545 static void __init of_unittest_parse_phandle_with_args_map(void)
547 struct device_node *np, *p0, *p1, *p2, *p3;
548 struct of_phandle_args args;
551 np = of_find_node_by_path("/testcase-data/phandle-tests/consumer-b");
553 pr_err("missing testcase data\n");
557 p0 = of_find_node_by_path("/testcase-data/phandle-tests/provider0");
559 pr_err("missing testcase data\n");
563 p1 = of_find_node_by_path("/testcase-data/phandle-tests/provider1");
565 pr_err("missing testcase data\n");
569 p2 = of_find_node_by_path("/testcase-data/phandle-tests/provider2");
571 pr_err("missing testcase data\n");
575 p3 = of_find_node_by_path("/testcase-data/phandle-tests/provider3");
577 pr_err("missing testcase data\n");
581 rc = of_count_phandle_with_args(np, "phandle-list", "#phandle-cells");
582 unittest(rc == 7, "of_count_phandle_with_args() returned %i, expected 7\n", rc);
584 for (i = 0; i < 8; i++) {
587 memset(&args, 0, sizeof(args));
588 rc = of_parse_phandle_with_args_map(np, "phandle-list",
589 "phandle", i, &args);
591 /* Test the values from tests-phandle.dtsi */
595 passed &= (args.np == p1);
596 passed &= (args.args_count == 1);
597 passed &= (args.args[0] == 1);
601 passed &= (args.np == p3);
602 passed &= (args.args_count == 3);
603 passed &= (args.args[0] == 2);
604 passed &= (args.args[1] == 5);
605 passed &= (args.args[2] == 3);
608 passed &= (rc == -ENOENT);
612 passed &= (args.np == p0);
613 passed &= (args.args_count == 0);
617 passed &= (args.np == p1);
618 passed &= (args.args_count == 1);
619 passed &= (args.args[0] == 3);
623 passed &= (args.np == p0);
624 passed &= (args.args_count == 0);
628 passed &= (args.np == p2);
629 passed &= (args.args_count == 2);
630 passed &= (args.args[0] == 15);
631 passed &= (args.args[1] == 0x20);
634 passed &= (rc == -ENOENT);
640 unittest(passed, "index %i - data error on node %s rc=%i\n",
641 i, args.np->full_name, rc);
644 /* Check for missing list property */
645 memset(&args, 0, sizeof(args));
646 rc = of_parse_phandle_with_args_map(np, "phandle-list-missing",
647 "phandle", 0, &args);
648 unittest(rc == -ENOENT, "expected:%i got:%i\n", -ENOENT, rc);
650 /* Check for missing cells,map,mask property */
651 memset(&args, 0, sizeof(args));
653 EXPECT_BEGIN(KERN_INFO,
654 "OF: /testcase-data/phandle-tests/consumer-b: could not get #phandle-missing-cells for /testcase-data/phandle-tests/provider1");
656 rc = of_parse_phandle_with_args_map(np, "phandle-list",
657 "phandle-missing", 0, &args);
658 EXPECT_END(KERN_INFO,
659 "OF: /testcase-data/phandle-tests/consumer-b: could not get #phandle-missing-cells for /testcase-data/phandle-tests/provider1");
661 unittest(rc == -EINVAL, "expected:%i got:%i\n", -EINVAL, rc);
663 /* Check for bad phandle in list */
664 memset(&args, 0, sizeof(args));
666 EXPECT_BEGIN(KERN_INFO,
667 "OF: /testcase-data/phandle-tests/consumer-b: could not find phandle");
669 rc = of_parse_phandle_with_args_map(np, "phandle-list-bad-phandle",
670 "phandle", 0, &args);
671 EXPECT_END(KERN_INFO,
672 "OF: /testcase-data/phandle-tests/consumer-b: could not find phandle");
674 unittest(rc == -EINVAL, "expected:%i got:%i\n", -EINVAL, rc);
676 /* Check for incorrectly formed argument list */
677 memset(&args, 0, sizeof(args));
679 EXPECT_BEGIN(KERN_INFO,
680 "OF: /testcase-data/phandle-tests/consumer-b: #phandle-cells = 2 found 1");
682 rc = of_parse_phandle_with_args_map(np, "phandle-list-bad-args",
683 "phandle", 1, &args);
684 EXPECT_END(KERN_INFO,
685 "OF: /testcase-data/phandle-tests/consumer-b: #phandle-cells = 2 found 1");
687 unittest(rc == -EINVAL, "expected:%i got:%i\n", -EINVAL, rc);
690 static void __init of_unittest_property_string(void)
692 const char *strings[4];
693 struct device_node *np;
696 np = of_find_node_by_path("/testcase-data/phandle-tests/consumer-a");
698 pr_err("No testcase data in device tree\n");
702 rc = of_property_match_string(np, "phandle-list-names", "first");
703 unittest(rc == 0, "first expected:0 got:%i\n", rc);
704 rc = of_property_match_string(np, "phandle-list-names", "second");
705 unittest(rc == 1, "second expected:1 got:%i\n", rc);
706 rc = of_property_match_string(np, "phandle-list-names", "third");
707 unittest(rc == 2, "third expected:2 got:%i\n", rc);
708 rc = of_property_match_string(np, "phandle-list-names", "fourth");
709 unittest(rc == -ENODATA, "unmatched string; rc=%i\n", rc);
710 rc = of_property_match_string(np, "missing-property", "blah");
711 unittest(rc == -EINVAL, "missing property; rc=%i\n", rc);
712 rc = of_property_match_string(np, "empty-property", "blah");
713 unittest(rc == -ENODATA, "empty property; rc=%i\n", rc);
714 rc = of_property_match_string(np, "unterminated-string", "blah");
715 unittest(rc == -EILSEQ, "unterminated string; rc=%i\n", rc);
717 /* of_property_count_strings() tests */
718 rc = of_property_count_strings(np, "string-property");
719 unittest(rc == 1, "Incorrect string count; rc=%i\n", rc);
720 rc = of_property_count_strings(np, "phandle-list-names");
721 unittest(rc == 3, "Incorrect string count; rc=%i\n", rc);
722 rc = of_property_count_strings(np, "unterminated-string");
723 unittest(rc == -EILSEQ, "unterminated string; rc=%i\n", rc);
724 rc = of_property_count_strings(np, "unterminated-string-list");
725 unittest(rc == -EILSEQ, "unterminated string array; rc=%i\n", rc);
727 /* of_property_read_string_index() tests */
728 rc = of_property_read_string_index(np, "string-property", 0, strings);
729 unittest(rc == 0 && !strcmp(strings[0], "foobar"), "of_property_read_string_index() failure; rc=%i\n", rc);
731 rc = of_property_read_string_index(np, "string-property", 1, strings);
732 unittest(rc == -ENODATA && strings[0] == NULL, "of_property_read_string_index() failure; rc=%i\n", rc);
733 rc = of_property_read_string_index(np, "phandle-list-names", 0, strings);
734 unittest(rc == 0 && !strcmp(strings[0], "first"), "of_property_read_string_index() failure; rc=%i\n", rc);
735 rc = of_property_read_string_index(np, "phandle-list-names", 1, strings);
736 unittest(rc == 0 && !strcmp(strings[0], "second"), "of_property_read_string_index() failure; rc=%i\n", rc);
737 rc = of_property_read_string_index(np, "phandle-list-names", 2, strings);
738 unittest(rc == 0 && !strcmp(strings[0], "third"), "of_property_read_string_index() failure; rc=%i\n", rc);
740 rc = of_property_read_string_index(np, "phandle-list-names", 3, strings);
741 unittest(rc == -ENODATA && strings[0] == NULL, "of_property_read_string_index() failure; rc=%i\n", rc);
743 rc = of_property_read_string_index(np, "unterminated-string", 0, strings);
744 unittest(rc == -EILSEQ && strings[0] == NULL, "of_property_read_string_index() failure; rc=%i\n", rc);
745 rc = of_property_read_string_index(np, "unterminated-string-list", 0, strings);
746 unittest(rc == 0 && !strcmp(strings[0], "first"), "of_property_read_string_index() failure; rc=%i\n", rc);
748 rc = of_property_read_string_index(np, "unterminated-string-list", 2, strings); /* should fail */
749 unittest(rc == -EILSEQ && strings[0] == NULL, "of_property_read_string_index() failure; rc=%i\n", rc);
752 /* of_property_read_string_array() tests */
753 rc = of_property_read_string_array(np, "string-property", strings, 4);
754 unittest(rc == 1, "Incorrect string count; rc=%i\n", rc);
755 rc = of_property_read_string_array(np, "phandle-list-names", strings, 4);
756 unittest(rc == 3, "Incorrect string count; rc=%i\n", rc);
757 rc = of_property_read_string_array(np, "unterminated-string", strings, 4);
758 unittest(rc == -EILSEQ, "unterminated string; rc=%i\n", rc);
759 /* -- An incorrectly formed string should cause a failure */
760 rc = of_property_read_string_array(np, "unterminated-string-list", strings, 4);
761 unittest(rc == -EILSEQ, "unterminated string array; rc=%i\n", rc);
762 /* -- parsing the correctly formed strings should still work: */
764 rc = of_property_read_string_array(np, "unterminated-string-list", strings, 2);
765 unittest(rc == 2 && strings[2] == NULL, "of_property_read_string_array() failure; rc=%i\n", rc);
767 rc = of_property_read_string_array(np, "phandle-list-names", strings, 1);
768 unittest(rc == 1 && strings[1] == NULL, "Overwrote end of string array; rc=%i, str='%s'\n", rc, strings[1]);
771 #define propcmp(p1, p2) (((p1)->length == (p2)->length) && \
772 (p1)->value && (p2)->value && \
773 !memcmp((p1)->value, (p2)->value, (p1)->length) && \
774 !strcmp((p1)->name, (p2)->name))
775 static void __init of_unittest_property_copy(void)
777 #ifdef CONFIG_OF_DYNAMIC
778 struct property p1 = { .name = "p1", .length = 0, .value = "" };
779 struct property p2 = { .name = "p2", .length = 5, .value = "abcd" };
780 struct property *new;
782 new = __of_prop_dup(&p1, GFP_KERNEL);
783 unittest(new && propcmp(&p1, new), "empty property didn't copy correctly\n");
788 new = __of_prop_dup(&p2, GFP_KERNEL);
789 unittest(new && propcmp(&p2, new), "non-empty property didn't copy correctly\n");
796 static void __init of_unittest_changeset(void)
798 #ifdef CONFIG_OF_DYNAMIC
799 struct property *ppadd, padd = { .name = "prop-add", .length = 1, .value = "" };
800 struct property *ppname_n1, pname_n1 = { .name = "name", .length = 3, .value = "n1" };
801 struct property *ppname_n2, pname_n2 = { .name = "name", .length = 3, .value = "n2" };
802 struct property *ppname_n21, pname_n21 = { .name = "name", .length = 3, .value = "n21" };
803 struct property *ppupdate, pupdate = { .name = "prop-update", .length = 5, .value = "abcd" };
804 struct property *ppremove;
805 struct device_node *n1, *n2, *n21, *nchangeset, *nremove, *parent, *np;
806 struct of_changeset chgset;
808 n1 = __of_node_dup(NULL, "n1");
809 unittest(n1, "testcase setup failure\n");
811 n2 = __of_node_dup(NULL, "n2");
812 unittest(n2, "testcase setup failure\n");
814 n21 = __of_node_dup(NULL, "n21");
815 unittest(n21, "testcase setup failure %p\n", n21);
817 nchangeset = of_find_node_by_path("/testcase-data/changeset");
818 nremove = of_get_child_by_name(nchangeset, "node-remove");
819 unittest(nremove, "testcase setup failure\n");
821 ppadd = __of_prop_dup(&padd, GFP_KERNEL);
822 unittest(ppadd, "testcase setup failure\n");
824 ppname_n1 = __of_prop_dup(&pname_n1, GFP_KERNEL);
825 unittest(ppname_n1, "testcase setup failure\n");
827 ppname_n2 = __of_prop_dup(&pname_n2, GFP_KERNEL);
828 unittest(ppname_n2, "testcase setup failure\n");
830 ppname_n21 = __of_prop_dup(&pname_n21, GFP_KERNEL);
831 unittest(ppname_n21, "testcase setup failure\n");
833 ppupdate = __of_prop_dup(&pupdate, GFP_KERNEL);
834 unittest(ppupdate, "testcase setup failure\n");
841 ppremove = of_find_property(parent, "prop-remove", NULL);
842 unittest(ppremove, "failed to find removal prop");
844 of_changeset_init(&chgset);
846 unittest(!of_changeset_attach_node(&chgset, n1), "fail attach n1\n");
847 unittest(!of_changeset_add_property(&chgset, n1, ppname_n1), "fail add prop name\n");
849 unittest(!of_changeset_attach_node(&chgset, n2), "fail attach n2\n");
850 unittest(!of_changeset_add_property(&chgset, n2, ppname_n2), "fail add prop name\n");
852 unittest(!of_changeset_detach_node(&chgset, nremove), "fail remove node\n");
853 unittest(!of_changeset_add_property(&chgset, n21, ppname_n21), "fail add prop name\n");
855 unittest(!of_changeset_attach_node(&chgset, n21), "fail attach n21\n");
857 unittest(!of_changeset_add_property(&chgset, parent, ppadd), "fail add prop prop-add\n");
858 unittest(!of_changeset_update_property(&chgset, parent, ppupdate), "fail update prop\n");
859 unittest(!of_changeset_remove_property(&chgset, parent, ppremove), "fail remove prop\n");
861 unittest(!of_changeset_apply(&chgset), "apply failed\n");
863 of_node_put(nchangeset);
865 /* Make sure node names are constructed correctly */
866 unittest((np = of_find_node_by_path("/testcase-data/changeset/n2/n21")),
867 "'%pOF' not added\n", n21);
870 unittest(!of_changeset_revert(&chgset), "revert failed\n");
872 of_changeset_destroy(&chgset);
880 static void __init of_unittest_dma_get_max_cpu_address(void)
882 struct device_node *np;
883 phys_addr_t cpu_addr;
885 if (!IS_ENABLED(CONFIG_OF_ADDRESS))
888 np = of_find_node_by_path("/testcase-data/address-tests");
890 pr_err("missing testcase data\n");
894 cpu_addr = of_dma_get_max_cpu_address(np);
895 unittest(cpu_addr == 0x4fffffff,
896 "of_dma_get_max_cpu_address: wrong CPU addr %pad (expecting %x)\n",
897 &cpu_addr, 0x4fffffff);
900 static void __init of_unittest_dma_ranges_one(const char *path,
901 u64 expect_dma_addr, u64 expect_paddr)
903 #ifdef CONFIG_HAS_DMA
904 struct device_node *np;
905 const struct bus_dma_region *map = NULL;
908 np = of_find_node_by_path(path);
910 pr_err("missing testcase data\n");
914 rc = of_dma_get_range(np, &map);
916 unittest(!rc, "of_dma_get_range failed on node %pOF rc=%i\n", np, rc);
921 struct device *dev_bogus;
923 dev_bogus = kzalloc(sizeof(struct device), GFP_KERNEL);
925 unittest(0, "kzalloc() failed\n");
930 dev_bogus->dma_range_map = map;
931 paddr = dma_to_phys(dev_bogus, expect_dma_addr);
932 dma_addr = phys_to_dma(dev_bogus, expect_paddr);
934 unittest(paddr == expect_paddr,
935 "of_dma_get_range: wrong phys addr %pap (expecting %llx) on node %pOF\n",
936 &paddr, expect_paddr, np);
937 unittest(dma_addr == expect_dma_addr,
938 "of_dma_get_range: wrong DMA addr %pad (expecting %llx) on node %pOF\n",
939 &dma_addr, expect_dma_addr, np);
948 static void __init of_unittest_parse_dma_ranges(void)
950 of_unittest_dma_ranges_one("/testcase-data/address-tests/device@70000000",
952 if (IS_ENABLED(CONFIG_ARCH_DMA_ADDR_T_64BIT))
953 of_unittest_dma_ranges_one("/testcase-data/address-tests/bus@80000000/device@1000",
954 0x100000000, 0x20000000);
955 of_unittest_dma_ranges_one("/testcase-data/address-tests/pci@90000000",
956 0x80000000, 0x20000000);
959 static void __init of_unittest_pci_dma_ranges(void)
961 struct device_node *np;
962 struct of_pci_range range;
963 struct of_pci_range_parser parser;
966 if (!IS_ENABLED(CONFIG_PCI))
969 np = of_find_node_by_path("/testcase-data/address-tests/pci@90000000");
971 pr_err("missing testcase data\n");
975 if (of_pci_dma_range_parser_init(&parser, np)) {
976 pr_err("missing dma-ranges property\n");
981 * Get the dma-ranges from the device tree
983 for_each_of_pci_range(&parser, &range) {
985 unittest(range.size == 0x10000000,
986 "for_each_of_pci_range wrong size on node %pOF size=%llx\n",
988 unittest(range.cpu_addr == 0x20000000,
989 "for_each_of_pci_range wrong CPU addr (%llx) on node %pOF",
991 unittest(range.pci_addr == 0x80000000,
992 "for_each_of_pci_range wrong DMA addr (%llx) on node %pOF",
995 unittest(range.size == 0x10000000,
996 "for_each_of_pci_range wrong size on node %pOF size=%llx\n",
998 unittest(range.cpu_addr == 0x40000000,
999 "for_each_of_pci_range wrong CPU addr (%llx) on node %pOF",
1000 range.cpu_addr, np);
1001 unittest(range.pci_addr == 0xc0000000,
1002 "for_each_of_pci_range wrong DMA addr (%llx) on node %pOF",
1003 range.pci_addr, np);
1011 static void __init of_unittest_bus_ranges(void)
1013 struct device_node *np;
1014 struct of_range range;
1015 struct of_range_parser parser;
1016 struct resource res;
1017 int ret, count, i = 0;
1019 np = of_find_node_by_path("/testcase-data/address-tests");
1021 pr_err("missing testcase data\n");
1025 if (of_range_parser_init(&parser, np)) {
1026 pr_err("missing ranges property\n");
1030 ret = of_range_to_resource(np, 1, &res);
1031 unittest(!ret, "of_range_to_resource returned error (%d) node %pOF\n",
1033 unittest(resource_type(&res) == IORESOURCE_MEM,
1034 "of_range_to_resource wrong resource type on node %pOF res=%pR\n",
1036 unittest(res.start == 0xd0000000,
1037 "of_range_to_resource wrong resource start address on node %pOF res=%pR\n",
1039 unittest(resource_size(&res) == 0x20000000,
1040 "of_range_to_resource wrong resource start address on node %pOF res=%pR\n",
1043 count = of_range_count(&parser);
1044 unittest(count == 2,
1045 "of_range_count wrong size on node %pOF count=%d\n",
1049 * Get the "ranges" from the device tree
1051 for_each_of_range(&parser, &range) {
1052 unittest(range.flags == IORESOURCE_MEM,
1053 "for_each_of_range wrong flags on node %pOF flags=%x (expected %x)\n",
1054 np, range.flags, IORESOURCE_MEM);
1056 unittest(range.size == 0x50000000,
1057 "for_each_of_range wrong size on node %pOF size=%llx\n",
1059 unittest(range.cpu_addr == 0x70000000,
1060 "for_each_of_range wrong CPU addr (%llx) on node %pOF",
1061 range.cpu_addr, np);
1062 unittest(range.bus_addr == 0x70000000,
1063 "for_each_of_range wrong bus addr (%llx) on node %pOF",
1064 range.pci_addr, np);
1066 unittest(range.size == 0x20000000,
1067 "for_each_of_range wrong size on node %pOF size=%llx\n",
1069 unittest(range.cpu_addr == 0xd0000000,
1070 "for_each_of_range wrong CPU addr (%llx) on node %pOF",
1071 range.cpu_addr, np);
1072 unittest(range.bus_addr == 0x00000000,
1073 "for_each_of_range wrong bus addr (%llx) on node %pOF",
1074 range.pci_addr, np);
1082 static void __init of_unittest_bus_3cell_ranges(void)
1084 struct device_node *np;
1085 struct of_range range;
1086 struct of_range_parser parser;
1089 np = of_find_node_by_path("/testcase-data/address-tests/bus@a0000000");
1091 pr_err("missing testcase data\n");
1095 if (of_range_parser_init(&parser, np)) {
1096 pr_err("missing ranges property\n");
1101 * Get the "ranges" from the device tree
1103 for_each_of_range(&parser, &range) {
1105 unittest(range.flags == 0xf00baa,
1106 "for_each_of_range wrong flags on node %pOF flags=%x\n",
1108 unittest(range.size == 0x100000,
1109 "for_each_of_range wrong size on node %pOF size=%llx\n",
1111 unittest(range.cpu_addr == 0xa0000000,
1112 "for_each_of_range wrong CPU addr (%llx) on node %pOF",
1113 range.cpu_addr, np);
1114 unittest(range.bus_addr == 0x0,
1115 "for_each_of_range wrong bus addr (%llx) on node %pOF",
1116 range.pci_addr, np);
1118 unittest(range.flags == 0xf00bee,
1119 "for_each_of_range wrong flags on node %pOF flags=%x\n",
1121 unittest(range.size == 0x200000,
1122 "for_each_of_range wrong size on node %pOF size=%llx\n",
1124 unittest(range.cpu_addr == 0xb0000000,
1125 "for_each_of_range wrong CPU addr (%llx) on node %pOF",
1126 range.cpu_addr, np);
1127 unittest(range.bus_addr == 0x100000000,
1128 "for_each_of_range wrong bus addr (%llx) on node %pOF",
1129 range.pci_addr, np);
1137 static void __init of_unittest_reg(void)
1139 struct device_node *np;
1143 np = of_find_node_by_path("/testcase-data/address-tests/bus@80000000/device@1000");
1145 pr_err("missing testcase data\n");
1149 ret = of_property_read_reg(np, 0, &addr, &size);
1150 unittest(!ret, "of_property_read_reg(%pOF) returned error %d\n",
1152 unittest(addr == 0x1000, "of_property_read_reg(%pOF) untranslated address (%llx) incorrect\n",
1158 static void __init of_unittest_parse_interrupts(void)
1160 struct device_node *np;
1161 struct of_phandle_args args;
1164 if (of_irq_workarounds & OF_IMAP_OLDWORLD_MAC)
1167 np = of_find_node_by_path("/testcase-data/interrupts/interrupts0");
1169 pr_err("missing testcase data\n");
1173 for (i = 0; i < 4; i++) {
1176 memset(&args, 0, sizeof(args));
1177 rc = of_irq_parse_one(np, i, &args);
1180 passed &= (args.args_count == 1);
1181 passed &= (args.args[0] == (i + 1));
1183 unittest(passed, "index %i - data error on node %pOF rc=%i\n",
1188 np = of_find_node_by_path("/testcase-data/interrupts/interrupts1");
1190 pr_err("missing testcase data\n");
1194 for (i = 0; i < 4; i++) {
1197 memset(&args, 0, sizeof(args));
1198 rc = of_irq_parse_one(np, i, &args);
1200 /* Test the values from tests-phandle.dtsi */
1204 passed &= (args.args_count == 1);
1205 passed &= (args.args[0] == 9);
1209 passed &= (args.args_count == 3);
1210 passed &= (args.args[0] == 10);
1211 passed &= (args.args[1] == 11);
1212 passed &= (args.args[2] == 12);
1216 passed &= (args.args_count == 2);
1217 passed &= (args.args[0] == 13);
1218 passed &= (args.args[1] == 14);
1222 passed &= (args.args_count == 2);
1223 passed &= (args.args[0] == 15);
1224 passed &= (args.args[1] == 16);
1229 unittest(passed, "index %i - data error on node %pOF rc=%i\n",
1235 static void __init of_unittest_parse_interrupts_extended(void)
1237 struct device_node *np;
1238 struct of_phandle_args args;
1241 if (of_irq_workarounds & OF_IMAP_OLDWORLD_MAC)
1244 np = of_find_node_by_path("/testcase-data/interrupts/interrupts-extended0");
1246 pr_err("missing testcase data\n");
1250 for (i = 0; i < 7; i++) {
1253 memset(&args, 0, sizeof(args));
1254 rc = of_irq_parse_one(np, i, &args);
1256 /* Test the values from tests-phandle.dtsi */
1260 passed &= (args.args_count == 1);
1261 passed &= (args.args[0] == 1);
1265 passed &= (args.args_count == 3);
1266 passed &= (args.args[0] == 2);
1267 passed &= (args.args[1] == 3);
1268 passed &= (args.args[2] == 4);
1272 passed &= (args.args_count == 2);
1273 passed &= (args.args[0] == 5);
1274 passed &= (args.args[1] == 6);
1278 passed &= (args.args_count == 1);
1279 passed &= (args.args[0] == 9);
1283 passed &= (args.args_count == 3);
1284 passed &= (args.args[0] == 10);
1285 passed &= (args.args[1] == 11);
1286 passed &= (args.args[2] == 12);
1290 passed &= (args.args_count == 2);
1291 passed &= (args.args[0] == 13);
1292 passed &= (args.args[1] == 14);
1296 * Tests child node that is missing property
1297 * #address-cells. See the comments in
1298 * drivers/of/unittest-data/tests-interrupts.dtsi
1299 * nodes intmap1 and interrupts-extended0
1302 passed &= (args.args_count == 1);
1303 passed &= (args.args[0] == 15);
1309 unittest(passed, "index %i - data error on node %pOF rc=%i\n",
1315 static const struct of_device_id match_node_table[] = {
1316 { .data = "A", .name = "name0", }, /* Name alone is lowest priority */
1317 { .data = "B", .type = "type1", }, /* followed by type alone */
1319 { .data = "Ca", .name = "name2", .type = "type1", }, /* followed by both together */
1320 { .data = "Cb", .name = "name2", }, /* Only match when type doesn't match */
1321 { .data = "Cc", .name = "name2", .type = "type2", },
1323 { .data = "E", .compatible = "compat3" },
1324 { .data = "G", .compatible = "compat2", },
1325 { .data = "H", .compatible = "compat2", .name = "name5", },
1326 { .data = "I", .compatible = "compat2", .type = "type1", },
1327 { .data = "J", .compatible = "compat2", .type = "type1", .name = "name8", },
1328 { .data = "K", .compatible = "compat2", .name = "name9", },
1335 } match_node_tests[] = {
1336 { .path = "/testcase-data/match-node/name0", .data = "A", },
1337 { .path = "/testcase-data/match-node/name1", .data = "B", },
1338 { .path = "/testcase-data/match-node/a/name2", .data = "Ca", },
1339 { .path = "/testcase-data/match-node/b/name2", .data = "Cb", },
1340 { .path = "/testcase-data/match-node/c/name2", .data = "Cc", },
1341 { .path = "/testcase-data/match-node/name3", .data = "E", },
1342 { .path = "/testcase-data/match-node/name4", .data = "G", },
1343 { .path = "/testcase-data/match-node/name5", .data = "H", },
1344 { .path = "/testcase-data/match-node/name6", .data = "G", },
1345 { .path = "/testcase-data/match-node/name7", .data = "I", },
1346 { .path = "/testcase-data/match-node/name8", .data = "J", },
1347 { .path = "/testcase-data/match-node/name9", .data = "K", },
1350 static void __init of_unittest_match_node(void)
1352 struct device_node *np;
1353 const struct of_device_id *match;
1356 for (i = 0; i < ARRAY_SIZE(match_node_tests); i++) {
1357 np = of_find_node_by_path(match_node_tests[i].path);
1359 unittest(0, "missing testcase node %s\n",
1360 match_node_tests[i].path);
1364 match = of_match_node(match_node_table, np);
1366 unittest(0, "%s didn't match anything\n",
1367 match_node_tests[i].path);
1371 if (strcmp(match->data, match_node_tests[i].data) != 0) {
1372 unittest(0, "%s got wrong match. expected %s, got %s\n",
1373 match_node_tests[i].path, match_node_tests[i].data,
1374 (const char *)match->data);
1377 unittest(1, "passed");
1381 static struct resource test_bus_res = DEFINE_RES_MEM(0xfffffff8, 2);
1382 static const struct platform_device_info test_bus_info = {
1383 .name = "unittest-bus",
1385 static void __init of_unittest_platform_populate(void)
1388 struct device_node *np, *child, *grandchild;
1389 struct platform_device *pdev, *test_bus;
1390 const struct of_device_id match[] = {
1391 { .compatible = "test-device", },
1395 np = of_find_node_by_path("/testcase-data");
1396 of_platform_default_populate(np, NULL, NULL);
1398 /* Test that a missing irq domain returns -EPROBE_DEFER */
1399 np = of_find_node_by_path("/testcase-data/testcase-device1");
1400 pdev = of_find_device_by_node(np);
1401 unittest(pdev, "device 1 creation failed\n");
1403 if (!(of_irq_workarounds & OF_IMAP_OLDWORLD_MAC)) {
1404 irq = platform_get_irq(pdev, 0);
1405 unittest(irq == -EPROBE_DEFER,
1406 "device deferred probe failed - %d\n", irq);
1408 /* Test that a parsing failure does not return -EPROBE_DEFER */
1409 np = of_find_node_by_path("/testcase-data/testcase-device2");
1410 pdev = of_find_device_by_node(np);
1411 unittest(pdev, "device 2 creation failed\n");
1413 EXPECT_BEGIN(KERN_INFO,
1414 "platform testcase-data:testcase-device2: error -ENXIO: IRQ index 0 not found");
1416 irq = platform_get_irq(pdev, 0);
1418 EXPECT_END(KERN_INFO,
1419 "platform testcase-data:testcase-device2: error -ENXIO: IRQ index 0 not found");
1421 unittest(irq < 0 && irq != -EPROBE_DEFER,
1422 "device parsing error failed - %d\n", irq);
1425 np = of_find_node_by_path("/testcase-data/platform-tests");
1426 unittest(np, "No testcase data in device tree\n");
1430 test_bus = platform_device_register_full(&test_bus_info);
1431 rc = PTR_ERR_OR_ZERO(test_bus);
1432 unittest(!rc, "testbus registration failed; rc=%i\n", rc);
1437 test_bus->dev.of_node = np;
1440 * Add a dummy resource to the test bus node after it is
1441 * registered to catch problems with un-inserted resources. The
1442 * DT code doesn't insert the resources, and it has caused the
1443 * kernel to oops in the past. This makes sure the same bug
1444 * doesn't crop up again.
1446 platform_device_add_resources(test_bus, &test_bus_res, 1);
1448 of_platform_populate(np, match, NULL, &test_bus->dev);
1449 for_each_child_of_node(np, child) {
1450 for_each_child_of_node(child, grandchild) {
1451 pdev = of_find_device_by_node(grandchild);
1453 "Could not create device for node '%pOFn'\n",
1455 platform_device_put(pdev);
1459 of_platform_depopulate(&test_bus->dev);
1460 for_each_child_of_node(np, child) {
1461 for_each_child_of_node(child, grandchild)
1462 unittest(!of_find_device_by_node(grandchild),
1463 "device didn't get destroyed '%pOFn'\n",
1467 platform_device_unregister(test_bus);
1472 * update_node_properties - adds the properties
1473 * of np into dup node (present in live tree) and
1474 * updates parent of children of np to dup.
1476 * @np: node whose properties are being added to the live tree
1477 * @dup: node present in live tree to be updated
1479 static void update_node_properties(struct device_node *np,
1480 struct device_node *dup)
1482 struct property *prop;
1483 struct property *save_next;
1484 struct device_node *child;
1487 for_each_child_of_node(np, child)
1488 child->parent = dup;
1491 * "unittest internal error: unable to add testdata property"
1493 * If this message reports a property in node '/__symbols__' then
1494 * the respective unittest overlay contains a label that has the
1495 * same name as a label in the live devicetree. The label will
1496 * be in the live devicetree only if the devicetree source was
1497 * compiled with the '-@' option. If you encounter this error,
1498 * please consider renaming __all__ of the labels in the unittest
1499 * overlay dts files with an odd prefix that is unlikely to be
1500 * used in a real devicetree.
1504 * open code for_each_property_of_node() because of_add_property()
1505 * sets prop->next to NULL
1507 for (prop = np->properties; prop != NULL; prop = save_next) {
1508 save_next = prop->next;
1509 ret = of_add_property(dup, prop);
1511 if (ret == -EEXIST && !strcmp(prop->name, "name"))
1513 pr_err("unittest internal error: unable to add testdata property %pOF/%s",
1520 * attach_node_and_children - attaches nodes
1521 * and its children to live tree.
1522 * CAUTION: misleading function name - if node @np already exists in
1523 * the live tree then children of @np are *not* attached to the live
1524 * tree. This works for the current test devicetree nodes because such
1525 * nodes do not have child nodes.
1527 * @np: Node to attach to live tree
1529 static void attach_node_and_children(struct device_node *np)
1531 struct device_node *next, *dup, *child;
1532 unsigned long flags;
1533 const char *full_name;
1535 full_name = kasprintf(GFP_KERNEL, "%pOF", np);
1537 if (!strcmp(full_name, "/__local_fixups__") ||
1538 !strcmp(full_name, "/__fixups__")) {
1543 dup = of_find_node_by_path(full_name);
1546 update_node_properties(np, dup);
1553 mutex_lock(&of_mutex);
1554 raw_spin_lock_irqsave(&devtree_lock, flags);
1555 np->sibling = np->parent->child;
1556 np->parent->child = np;
1557 of_node_clear_flag(np, OF_DETACHED);
1558 raw_spin_unlock_irqrestore(&devtree_lock, flags);
1560 __of_attach_node_sysfs(np);
1561 mutex_unlock(&of_mutex);
1564 next = child->sibling;
1565 attach_node_and_children(child);
1571 * unittest_data_add - Reads, copies data from
1572 * linked tree and attaches it to the live tree
1574 static int __init unittest_data_add(void)
1576 void *unittest_data;
1577 void *unittest_data_align;
1578 struct device_node *unittest_data_node = NULL, *np;
1580 * __dtbo_testcases_begin[] and __dtbo_testcases_end[] are magically
1581 * created by cmd_dt_S_dtbo in scripts/Makefile.lib
1583 extern uint8_t __dtbo_testcases_begin[];
1584 extern uint8_t __dtbo_testcases_end[];
1585 const int size = __dtbo_testcases_end - __dtbo_testcases_begin;
1590 pr_warn("%s: testcases is empty\n", __func__);
1595 unittest_data = kmalloc(size + FDT_ALIGN_SIZE, GFP_KERNEL);
1599 unittest_data_align = PTR_ALIGN(unittest_data, FDT_ALIGN_SIZE);
1600 memcpy(unittest_data_align, __dtbo_testcases_begin, size);
1602 ret = of_fdt_unflatten_tree(unittest_data_align, NULL, &unittest_data_node);
1604 pr_warn("%s: unflatten testcases tree failed\n", __func__);
1605 kfree(unittest_data);
1608 if (!unittest_data_node) {
1609 pr_warn("%s: testcases tree is empty\n", __func__);
1610 kfree(unittest_data);
1615 * This lock normally encloses of_resolve_phandles()
1617 of_overlay_mutex_lock();
1619 rc = of_resolve_phandles(unittest_data_node);
1621 pr_err("%s: Failed to resolve phandles (rc=%i)\n", __func__, rc);
1622 of_overlay_mutex_unlock();
1627 of_root = unittest_data_node;
1628 for_each_of_allnodes(np)
1629 __of_attach_node_sysfs(np);
1630 of_aliases = of_find_node_by_path("/aliases");
1631 of_chosen = of_find_node_by_path("/chosen");
1632 of_overlay_mutex_unlock();
1636 EXPECT_BEGIN(KERN_INFO,
1637 "Duplicate name in testcase-data, renamed to \"duplicate-name#1\"");
1639 /* attach the sub-tree to live tree */
1640 np = unittest_data_node->child;
1642 struct device_node *next = np->sibling;
1644 np->parent = of_root;
1645 /* this will clear OF_DETACHED in np and children */
1646 attach_node_and_children(np);
1650 EXPECT_END(KERN_INFO,
1651 "Duplicate name in testcase-data, renamed to \"duplicate-name#1\"");
1653 of_overlay_mutex_unlock();
1658 #ifdef CONFIG_OF_OVERLAY
1659 static int __init overlay_data_apply(const char *overlay_name, int *ovcs_id);
1661 static int unittest_probe(struct platform_device *pdev)
1663 struct device *dev = &pdev->dev;
1664 struct device_node *np = dev->of_node;
1667 dev_err(dev, "No OF data for device\n");
1672 dev_dbg(dev, "%s for node @%pOF\n", __func__, np);
1674 of_platform_populate(np, NULL, NULL, &pdev->dev);
1679 static void unittest_remove(struct platform_device *pdev)
1681 struct device *dev = &pdev->dev;
1682 struct device_node *np = dev->of_node;
1684 dev_dbg(dev, "%s for node @%pOF\n", __func__, np);
1687 static const struct of_device_id unittest_match[] = {
1688 { .compatible = "unittest", },
1692 static struct platform_driver unittest_driver = {
1693 .probe = unittest_probe,
1694 .remove_new = unittest_remove,
1697 .of_match_table = of_match_ptr(unittest_match),
1701 /* get the platform device instantiated at the path */
1702 static struct platform_device *of_path_to_platform_device(const char *path)
1704 struct device_node *np;
1705 struct platform_device *pdev;
1707 np = of_find_node_by_path(path);
1711 pdev = of_find_device_by_node(np);
1717 /* find out if a platform device exists at that path */
1718 static int of_path_platform_device_exists(const char *path)
1720 struct platform_device *pdev;
1722 pdev = of_path_to_platform_device(path);
1723 platform_device_put(pdev);
1724 return pdev != NULL;
1727 #ifdef CONFIG_OF_GPIO
1729 struct unittest_gpio_dev {
1730 struct gpio_chip chip;
1733 static int unittest_gpio_chip_request_count;
1734 static int unittest_gpio_probe_count;
1735 static int unittest_gpio_probe_pass_count;
1737 static int unittest_gpio_chip_request(struct gpio_chip *chip, unsigned int offset)
1739 unittest_gpio_chip_request_count++;
1741 pr_debug("%s(): %s %d %d\n", __func__, chip->label, offset,
1742 unittest_gpio_chip_request_count);
1746 static int unittest_gpio_probe(struct platform_device *pdev)
1748 struct unittest_gpio_dev *devptr;
1751 unittest_gpio_probe_count++;
1753 devptr = kzalloc(sizeof(*devptr), GFP_KERNEL);
1757 platform_set_drvdata(pdev, devptr);
1759 devptr->chip.fwnode = dev_fwnode(&pdev->dev);
1760 devptr->chip.label = "of-unittest-gpio";
1761 devptr->chip.base = -1; /* dynamic allocation */
1762 devptr->chip.ngpio = 5;
1763 devptr->chip.request = unittest_gpio_chip_request;
1765 ret = gpiochip_add_data(&devptr->chip, NULL);
1768 "gpiochip_add_data() for node @%pfw failed, ret = %d\n", devptr->chip.fwnode, ret);
1771 unittest_gpio_probe_pass_count++;
1775 static void unittest_gpio_remove(struct platform_device *pdev)
1777 struct unittest_gpio_dev *devptr = platform_get_drvdata(pdev);
1778 struct device *dev = &pdev->dev;
1780 dev_dbg(dev, "%s for node @%pfw\n", __func__, devptr->chip.fwnode);
1782 if (devptr->chip.base != -1)
1783 gpiochip_remove(&devptr->chip);
1788 static const struct of_device_id unittest_gpio_id[] = {
1789 { .compatible = "unittest-gpio", },
1793 static struct platform_driver unittest_gpio_driver = {
1794 .probe = unittest_gpio_probe,
1795 .remove_new = unittest_gpio_remove,
1797 .name = "unittest-gpio",
1798 .of_match_table = of_match_ptr(unittest_gpio_id),
1802 static void __init of_unittest_overlay_gpio(void)
1804 int chip_request_count;
1805 int probe_pass_count;
1809 * tests: apply overlays before registering driver
1810 * Similar to installing a driver as a module, the
1811 * driver is registered after applying the overlays.
1813 * The overlays are applied by overlay_data_apply()
1814 * instead of of_unittest_apply_overlay() so that they
1815 * will not be tracked. Thus they will not be removed
1816 * by of_unittest_remove_tracked_overlays().
1818 * - apply overlay_gpio_01
1819 * - apply overlay_gpio_02a
1820 * - apply overlay_gpio_02b
1823 * register driver will result in
1824 * - probe and processing gpio hog for overlay_gpio_01
1825 * - probe for overlay_gpio_02a
1826 * - processing gpio for overlay_gpio_02b
1829 probe_pass_count = unittest_gpio_probe_pass_count;
1830 chip_request_count = unittest_gpio_chip_request_count;
1833 * overlay_gpio_01 contains gpio node and child gpio hog node
1834 * overlay_gpio_02a contains gpio node
1835 * overlay_gpio_02b contains child gpio hog node
1838 unittest(overlay_data_apply("overlay_gpio_01", NULL),
1839 "Adding overlay 'overlay_gpio_01' failed\n");
1841 unittest(overlay_data_apply("overlay_gpio_02a", NULL),
1842 "Adding overlay 'overlay_gpio_02a' failed\n");
1844 unittest(overlay_data_apply("overlay_gpio_02b", NULL),
1845 "Adding overlay 'overlay_gpio_02b' failed\n");
1847 ret = platform_driver_register(&unittest_gpio_driver);
1848 if (unittest(ret == 0, "could not register unittest gpio driver\n"))
1851 unittest(probe_pass_count + 2 == unittest_gpio_probe_pass_count,
1852 "unittest_gpio_probe() failed or not called\n");
1854 unittest(chip_request_count + 2 == unittest_gpio_chip_request_count,
1855 "unittest_gpio_chip_request() called %d times (expected 1 time)\n",
1856 unittest_gpio_chip_request_count - chip_request_count);
1859 * tests: apply overlays after registering driver
1861 * Similar to a driver built-in to the kernel, the
1862 * driver is registered before applying the overlays.
1864 * overlay_gpio_03 contains gpio node and child gpio hog node
1866 * - apply overlay_gpio_03
1868 * apply overlay will result in
1869 * - probe and processing gpio hog.
1872 probe_pass_count = unittest_gpio_probe_pass_count;
1873 chip_request_count = unittest_gpio_chip_request_count;
1875 /* overlay_gpio_03 contains gpio node and child gpio hog node */
1877 unittest(overlay_data_apply("overlay_gpio_03", NULL),
1878 "Adding overlay 'overlay_gpio_03' failed\n");
1880 unittest(probe_pass_count + 1 == unittest_gpio_probe_pass_count,
1881 "unittest_gpio_probe() failed or not called\n");
1883 unittest(chip_request_count + 1 == unittest_gpio_chip_request_count,
1884 "unittest_gpio_chip_request() called %d times (expected 1 time)\n",
1885 unittest_gpio_chip_request_count - chip_request_count);
1888 * overlay_gpio_04a contains gpio node
1890 * - apply overlay_gpio_04a
1892 * apply the overlay will result in
1893 * - probe for overlay_gpio_04a
1896 probe_pass_count = unittest_gpio_probe_pass_count;
1897 chip_request_count = unittest_gpio_chip_request_count;
1899 /* overlay_gpio_04a contains gpio node */
1901 unittest(overlay_data_apply("overlay_gpio_04a", NULL),
1902 "Adding overlay 'overlay_gpio_04a' failed\n");
1904 unittest(probe_pass_count + 1 == unittest_gpio_probe_pass_count,
1905 "unittest_gpio_probe() failed or not called\n");
1908 * overlay_gpio_04b contains child gpio hog node
1910 * - apply overlay_gpio_04b
1912 * apply the overlay will result in
1913 * - processing gpio for overlay_gpio_04b
1916 /* overlay_gpio_04b contains child gpio hog node */
1918 unittest(overlay_data_apply("overlay_gpio_04b", NULL),
1919 "Adding overlay 'overlay_gpio_04b' failed\n");
1921 unittest(chip_request_count + 1 == unittest_gpio_chip_request_count,
1922 "unittest_gpio_chip_request() called %d times (expected 1 time)\n",
1923 unittest_gpio_chip_request_count - chip_request_count);
1928 static void __init of_unittest_overlay_gpio(void)
1935 #if IS_BUILTIN(CONFIG_I2C)
1937 /* get the i2c client device instantiated at the path */
1938 static struct i2c_client *of_path_to_i2c_client(const char *path)
1940 struct device_node *np;
1941 struct i2c_client *client;
1943 np = of_find_node_by_path(path);
1947 client = of_find_i2c_device_by_node(np);
1953 /* find out if a i2c client device exists at that path */
1954 static int of_path_i2c_client_exists(const char *path)
1956 struct i2c_client *client;
1958 client = of_path_to_i2c_client(path);
1960 put_device(&client->dev);
1961 return client != NULL;
1964 static int of_path_i2c_client_exists(const char *path)
1975 static int of_path_device_type_exists(const char *path,
1976 enum overlay_type ovtype)
1980 return of_path_platform_device_exists(path);
1982 return of_path_i2c_client_exists(path);
1987 static const char *unittest_path(int nr, enum overlay_type ovtype)
1990 static char buf[256];
1994 base = "/testcase-data/overlay-node/test-bus";
1997 base = "/testcase-data/overlay-node/test-bus/i2c-test-bus";
2003 snprintf(buf, sizeof(buf) - 1, "%s/test-unittest%d", base, nr);
2004 buf[sizeof(buf) - 1] = '\0';
2008 static int of_unittest_device_exists(int unittest_nr, enum overlay_type ovtype)
2012 path = unittest_path(unittest_nr, ovtype);
2016 return of_path_platform_device_exists(path);
2018 return of_path_i2c_client_exists(path);
2023 static const char *overlay_name_from_nr(int nr)
2025 static char buf[256];
2027 snprintf(buf, sizeof(buf) - 1,
2029 buf[sizeof(buf) - 1] = '\0';
2034 static const char *bus_path = "/testcase-data/overlay-node/test-bus";
2036 #define MAX_TRACK_OVCS_IDS 256
2038 static int track_ovcs_id[MAX_TRACK_OVCS_IDS];
2039 static int track_ovcs_id_overlay_nr[MAX_TRACK_OVCS_IDS];
2040 static int track_ovcs_id_cnt;
2042 static void of_unittest_track_overlay(int ovcs_id, int overlay_nr)
2044 if (WARN_ON(track_ovcs_id_cnt >= MAX_TRACK_OVCS_IDS))
2047 track_ovcs_id[track_ovcs_id_cnt] = ovcs_id;
2048 track_ovcs_id_overlay_nr[track_ovcs_id_cnt] = overlay_nr;
2049 track_ovcs_id_cnt++;
2052 static void of_unittest_untrack_overlay(int ovcs_id)
2054 if (WARN_ON(track_ovcs_id_cnt < 1))
2057 track_ovcs_id_cnt--;
2059 /* If out of synch then test is broken. Do not try to recover. */
2060 WARN_ON(track_ovcs_id[track_ovcs_id_cnt] != ovcs_id);
2063 static void of_unittest_remove_tracked_overlays(void)
2065 int ret, ovcs_id, overlay_nr, save_ovcs_id;
2066 const char *overlay_name;
2068 while (track_ovcs_id_cnt > 0) {
2070 ovcs_id = track_ovcs_id[track_ovcs_id_cnt - 1];
2071 overlay_nr = track_ovcs_id_overlay_nr[track_ovcs_id_cnt - 1];
2072 save_ovcs_id = ovcs_id;
2073 ret = of_overlay_remove(&ovcs_id);
2074 if (ret == -ENODEV) {
2075 overlay_name = overlay_name_from_nr(overlay_nr);
2076 pr_warn("%s: of_overlay_remove() for overlay \"%s\" failed, ret = %d\n",
2077 __func__, overlay_name, ret);
2079 of_unittest_untrack_overlay(save_ovcs_id);
2084 static int __init of_unittest_apply_overlay(int overlay_nr, int *ovcs_id)
2087 * The overlay will be tracked, thus it will be removed
2088 * by of_unittest_remove_tracked_overlays().
2091 const char *overlay_name;
2093 overlay_name = overlay_name_from_nr(overlay_nr);
2095 if (!overlay_data_apply(overlay_name, ovcs_id)) {
2096 unittest(0, "could not apply overlay \"%s\"\n", overlay_name);
2099 of_unittest_track_overlay(*ovcs_id, overlay_nr);
2104 /* apply an overlay while checking before and after states */
2105 static int __init of_unittest_apply_overlay_check(int overlay_nr,
2106 int unittest_nr, int before, int after,
2107 enum overlay_type ovtype)
2111 /* unittest device must not be in before state */
2112 if (of_unittest_device_exists(unittest_nr, ovtype) != before) {
2113 unittest(0, "%s with device @\"%s\" %s\n",
2114 overlay_name_from_nr(overlay_nr),
2115 unittest_path(unittest_nr, ovtype),
2116 !before ? "enabled" : "disabled");
2121 ret = of_unittest_apply_overlay(overlay_nr, &ovcs_id);
2123 /* of_unittest_apply_overlay already called unittest() */
2127 /* unittest device must be to set to after state */
2128 if (of_unittest_device_exists(unittest_nr, ovtype) != after) {
2129 unittest(0, "%s failed to create @\"%s\" %s\n",
2130 overlay_name_from_nr(overlay_nr),
2131 unittest_path(unittest_nr, ovtype),
2132 !after ? "enabled" : "disabled");
2139 /* apply an overlay and then revert it while checking before, after states */
2140 static int __init of_unittest_apply_revert_overlay_check(int overlay_nr,
2141 int unittest_nr, int before, int after,
2142 enum overlay_type ovtype)
2144 int ret, ovcs_id, save_ovcs_id;
2146 /* unittest device must be in before state */
2147 if (of_unittest_device_exists(unittest_nr, ovtype) != before) {
2148 unittest(0, "%s with device @\"%s\" %s\n",
2149 overlay_name_from_nr(overlay_nr),
2150 unittest_path(unittest_nr, ovtype),
2151 !before ? "enabled" : "disabled");
2155 /* apply the overlay */
2157 ret = of_unittest_apply_overlay(overlay_nr, &ovcs_id);
2159 /* of_unittest_apply_overlay already called unittest() */
2163 /* unittest device must be in after state */
2164 if (of_unittest_device_exists(unittest_nr, ovtype) != after) {
2165 unittest(0, "%s failed to create @\"%s\" %s\n",
2166 overlay_name_from_nr(overlay_nr),
2167 unittest_path(unittest_nr, ovtype),
2168 !after ? "enabled" : "disabled");
2172 save_ovcs_id = ovcs_id;
2173 ret = of_overlay_remove(&ovcs_id);
2175 unittest(0, "%s failed to be destroyed @\"%s\"\n",
2176 overlay_name_from_nr(overlay_nr),
2177 unittest_path(unittest_nr, ovtype));
2180 of_unittest_untrack_overlay(save_ovcs_id);
2182 /* unittest device must be again in before state */
2183 if (of_unittest_device_exists(unittest_nr, PDEV_OVERLAY) != before) {
2184 unittest(0, "%s with device @\"%s\" %s\n",
2185 overlay_name_from_nr(overlay_nr),
2186 unittest_path(unittest_nr, ovtype),
2187 !before ? "enabled" : "disabled");
2194 /* test activation of device */
2195 static void __init of_unittest_overlay_0(void)
2199 EXPECT_BEGIN(KERN_INFO,
2200 "OF: overlay: WARNING: memory leak will occur if overlay removed, property: /testcase-data/overlay-node/test-bus/test-unittest0/status");
2202 /* device should enable */
2203 ret = of_unittest_apply_overlay_check(0, 0, 0, 1, PDEV_OVERLAY);
2205 EXPECT_END(KERN_INFO,
2206 "OF: overlay: WARNING: memory leak will occur if overlay removed, property: /testcase-data/overlay-node/test-bus/test-unittest0/status");
2211 unittest(1, "overlay test %d passed\n", 0);
2214 /* test deactivation of device */
2215 static void __init of_unittest_overlay_1(void)
2219 EXPECT_BEGIN(KERN_INFO,
2220 "OF: overlay: WARNING: memory leak will occur if overlay removed, property: /testcase-data/overlay-node/test-bus/test-unittest1/status");
2222 /* device should disable */
2223 ret = of_unittest_apply_overlay_check(1, 1, 1, 0, PDEV_OVERLAY);
2225 EXPECT_END(KERN_INFO,
2226 "OF: overlay: WARNING: memory leak will occur if overlay removed, property: /testcase-data/overlay-node/test-bus/test-unittest1/status");
2231 unittest(1, "overlay test %d passed\n", 1);
2235 /* test activation of device */
2236 static void __init of_unittest_overlay_2(void)
2240 EXPECT_BEGIN(KERN_INFO,
2241 "OF: overlay: WARNING: memory leak will occur if overlay removed, property: /testcase-data/overlay-node/test-bus/test-unittest2/status");
2243 /* device should enable */
2244 ret = of_unittest_apply_overlay_check(2, 2, 0, 1, PDEV_OVERLAY);
2246 EXPECT_END(KERN_INFO,
2247 "OF: overlay: WARNING: memory leak will occur if overlay removed, property: /testcase-data/overlay-node/test-bus/test-unittest2/status");
2251 unittest(1, "overlay test %d passed\n", 2);
2254 /* test deactivation of device */
2255 static void __init of_unittest_overlay_3(void)
2259 EXPECT_BEGIN(KERN_INFO,
2260 "OF: overlay: WARNING: memory leak will occur if overlay removed, property: /testcase-data/overlay-node/test-bus/test-unittest3/status");
2262 /* device should disable */
2263 ret = of_unittest_apply_overlay_check(3, 3, 1, 0, PDEV_OVERLAY);
2265 EXPECT_END(KERN_INFO,
2266 "OF: overlay: WARNING: memory leak will occur if overlay removed, property: /testcase-data/overlay-node/test-bus/test-unittest3/status");
2271 unittest(1, "overlay test %d passed\n", 3);
2274 /* test activation of a full device node */
2275 static void __init of_unittest_overlay_4(void)
2277 /* device should disable */
2278 if (of_unittest_apply_overlay_check(4, 4, 0, 1, PDEV_OVERLAY))
2281 unittest(1, "overlay test %d passed\n", 4);
2284 /* test overlay apply/revert sequence */
2285 static void __init of_unittest_overlay_5(void)
2289 EXPECT_BEGIN(KERN_INFO,
2290 "OF: overlay: WARNING: memory leak will occur if overlay removed, property: /testcase-data/overlay-node/test-bus/test-unittest5/status");
2292 /* device should disable */
2293 ret = of_unittest_apply_revert_overlay_check(5, 5, 0, 1, PDEV_OVERLAY);
2295 EXPECT_END(KERN_INFO,
2296 "OF: overlay: WARNING: memory leak will occur if overlay removed, property: /testcase-data/overlay-node/test-bus/test-unittest5/status");
2301 unittest(1, "overlay test %d passed\n", 5);
2304 /* test overlay application in sequence */
2305 static void __init of_unittest_overlay_6(void)
2307 int i, save_ovcs_id[2], ovcs_id;
2308 int overlay_nr = 6, unittest_nr = 6;
2309 int before = 0, after = 1;
2310 const char *overlay_name;
2314 /* unittest device must be in before state */
2315 for (i = 0; i < 2; i++) {
2316 if (of_unittest_device_exists(unittest_nr + i, PDEV_OVERLAY)
2318 unittest(0, "%s with device @\"%s\" %s\n",
2319 overlay_name_from_nr(overlay_nr + i),
2320 unittest_path(unittest_nr + i,
2322 !before ? "enabled" : "disabled");
2327 /* apply the overlays */
2329 EXPECT_BEGIN(KERN_INFO,
2330 "OF: overlay: WARNING: memory leak will occur if overlay removed, property: /testcase-data/overlay-node/test-bus/test-unittest6/status");
2332 overlay_name = overlay_name_from_nr(overlay_nr + 0);
2334 ret = overlay_data_apply(overlay_name, &ovcs_id);
2337 unittest(0, "could not apply overlay \"%s\"\n", overlay_name);
2340 save_ovcs_id[0] = ovcs_id;
2341 of_unittest_track_overlay(ovcs_id, overlay_nr + 0);
2343 EXPECT_END(KERN_INFO,
2344 "OF: overlay: WARNING: memory leak will occur if overlay removed, property: /testcase-data/overlay-node/test-bus/test-unittest6/status");
2346 EXPECT_BEGIN(KERN_INFO,
2347 "OF: overlay: WARNING: memory leak will occur if overlay removed, property: /testcase-data/overlay-node/test-bus/test-unittest7/status");
2349 overlay_name = overlay_name_from_nr(overlay_nr + 1);
2351 ret = overlay_data_apply(overlay_name, &ovcs_id);
2354 unittest(0, "could not apply overlay \"%s\"\n", overlay_name);
2357 save_ovcs_id[1] = ovcs_id;
2358 of_unittest_track_overlay(ovcs_id, overlay_nr + 1);
2360 EXPECT_END(KERN_INFO,
2361 "OF: overlay: WARNING: memory leak will occur if overlay removed, property: /testcase-data/overlay-node/test-bus/test-unittest7/status");
2364 for (i = 0; i < 2; i++) {
2365 /* unittest device must be in after state */
2366 if (of_unittest_device_exists(unittest_nr + i, PDEV_OVERLAY)
2368 unittest(0, "overlay @\"%s\" failed @\"%s\" %s\n",
2369 overlay_name_from_nr(overlay_nr + i),
2370 unittest_path(unittest_nr + i,
2372 !after ? "enabled" : "disabled");
2377 for (i = 1; i >= 0; i--) {
2378 ovcs_id = save_ovcs_id[i];
2379 if (of_overlay_remove(&ovcs_id)) {
2380 unittest(0, "%s failed destroy @\"%s\"\n",
2381 overlay_name_from_nr(overlay_nr + i),
2382 unittest_path(unittest_nr + i,
2386 of_unittest_untrack_overlay(save_ovcs_id[i]);
2389 for (i = 0; i < 2; i++) {
2390 /* unittest device must be again in before state */
2391 if (of_unittest_device_exists(unittest_nr + i, PDEV_OVERLAY)
2393 unittest(0, "%s with device @\"%s\" %s\n",
2394 overlay_name_from_nr(overlay_nr + i),
2395 unittest_path(unittest_nr + i,
2397 !before ? "enabled" : "disabled");
2402 unittest(1, "overlay test %d passed\n", 6);
2406 /* test overlay application in sequence */
2407 static void __init of_unittest_overlay_8(void)
2409 int i, save_ovcs_id[2], ovcs_id;
2410 int overlay_nr = 8, unittest_nr = 8;
2411 const char *overlay_name;
2414 /* we don't care about device state in this test */
2416 EXPECT_BEGIN(KERN_INFO,
2417 "OF: overlay: WARNING: memory leak will occur if overlay removed, property: /testcase-data/overlay-node/test-bus/test-unittest8/status");
2419 overlay_name = overlay_name_from_nr(overlay_nr + 0);
2421 ret = overlay_data_apply(overlay_name, &ovcs_id);
2423 unittest(0, "could not apply overlay \"%s\"\n", overlay_name);
2425 EXPECT_END(KERN_INFO,
2426 "OF: overlay: WARNING: memory leak will occur if overlay removed, property: /testcase-data/overlay-node/test-bus/test-unittest8/status");
2431 save_ovcs_id[0] = ovcs_id;
2432 of_unittest_track_overlay(ovcs_id, overlay_nr + 0);
2434 overlay_name = overlay_name_from_nr(overlay_nr + 1);
2436 EXPECT_BEGIN(KERN_INFO,
2437 "OF: overlay: WARNING: memory leak will occur if overlay removed, property: /testcase-data/overlay-node/test-bus/test-unittest8/property-foo");
2439 /* apply the overlays */
2440 ret = overlay_data_apply(overlay_name, &ovcs_id);
2442 EXPECT_END(KERN_INFO,
2443 "OF: overlay: WARNING: memory leak will occur if overlay removed, property: /testcase-data/overlay-node/test-bus/test-unittest8/property-foo");
2446 unittest(0, "could not apply overlay \"%s\"\n", overlay_name);
2450 save_ovcs_id[1] = ovcs_id;
2451 of_unittest_track_overlay(ovcs_id, overlay_nr + 1);
2453 /* now try to remove first overlay (it should fail) */
2454 ovcs_id = save_ovcs_id[0];
2456 EXPECT_BEGIN(KERN_INFO,
2457 "OF: overlay: node_overlaps_later_cs: #6 overlaps with #7 @/testcase-data/overlay-node/test-bus/test-unittest8");
2459 EXPECT_BEGIN(KERN_INFO,
2460 "OF: overlay: overlay #6 is not topmost");
2462 ret = of_overlay_remove(&ovcs_id);
2464 EXPECT_END(KERN_INFO,
2465 "OF: overlay: overlay #6 is not topmost");
2467 EXPECT_END(KERN_INFO,
2468 "OF: overlay: node_overlaps_later_cs: #6 overlaps with #7 @/testcase-data/overlay-node/test-bus/test-unittest8");
2472 * Should never get here. If we do, expect a lot of
2473 * subsequent tracking and overlay removal related errors.
2475 unittest(0, "%s was destroyed @\"%s\"\n",
2476 overlay_name_from_nr(overlay_nr + 0),
2477 unittest_path(unittest_nr,
2482 /* removing them in order should work */
2483 for (i = 1; i >= 0; i--) {
2484 ovcs_id = save_ovcs_id[i];
2485 if (of_overlay_remove(&ovcs_id)) {
2486 unittest(0, "%s not destroyed @\"%s\"\n",
2487 overlay_name_from_nr(overlay_nr + i),
2488 unittest_path(unittest_nr,
2492 of_unittest_untrack_overlay(save_ovcs_id[i]);
2495 unittest(1, "overlay test %d passed\n", 8);
2498 /* test insertion of a bus with parent devices */
2499 static void __init of_unittest_overlay_10(void)
2504 /* device should disable */
2505 ret = of_unittest_apply_overlay_check(10, 10, 0, 1, PDEV_OVERLAY);
2507 if (unittest(ret == 0,
2508 "overlay test %d failed; overlay application\n", 10))
2511 child_path = kasprintf(GFP_KERNEL, "%s/test-unittest101",
2512 unittest_path(10, PDEV_OVERLAY));
2513 if (unittest(child_path, "overlay test %d failed; kasprintf\n", 10))
2516 ret = of_path_device_type_exists(child_path, PDEV_OVERLAY);
2519 unittest(ret, "overlay test %d failed; no child device\n", 10);
2522 /* test insertion of a bus with parent devices (and revert) */
2523 static void __init of_unittest_overlay_11(void)
2527 /* device should disable */
2528 ret = of_unittest_apply_revert_overlay_check(11, 11, 0, 1,
2531 unittest(ret == 0, "overlay test %d failed; overlay apply\n", 11);
2534 #if IS_BUILTIN(CONFIG_I2C) && IS_ENABLED(CONFIG_OF_OVERLAY)
2536 struct unittest_i2c_bus_data {
2537 struct platform_device *pdev;
2538 struct i2c_adapter adap;
2541 static int unittest_i2c_master_xfer(struct i2c_adapter *adap,
2542 struct i2c_msg *msgs, int num)
2544 struct unittest_i2c_bus_data *std = i2c_get_adapdata(adap);
2551 static u32 unittest_i2c_functionality(struct i2c_adapter *adap)
2553 return I2C_FUNC_I2C | I2C_FUNC_SMBUS_EMUL;
2556 static const struct i2c_algorithm unittest_i2c_algo = {
2557 .master_xfer = unittest_i2c_master_xfer,
2558 .functionality = unittest_i2c_functionality,
2561 static int unittest_i2c_bus_probe(struct platform_device *pdev)
2563 struct device *dev = &pdev->dev;
2564 struct device_node *np = dev->of_node;
2565 struct unittest_i2c_bus_data *std;
2566 struct i2c_adapter *adap;
2570 dev_err(dev, "No OF data for device\n");
2575 dev_dbg(dev, "%s for node @%pOF\n", __func__, np);
2577 std = devm_kzalloc(dev, sizeof(*std), GFP_KERNEL);
2581 /* link them together */
2583 platform_set_drvdata(pdev, std);
2586 i2c_set_adapdata(adap, std);
2588 strscpy(adap->name, pdev->name, sizeof(adap->name));
2589 adap->class = I2C_CLASS_DEPRECATED;
2590 adap->algo = &unittest_i2c_algo;
2591 adap->dev.parent = dev;
2592 adap->dev.of_node = dev->of_node;
2593 adap->timeout = 5 * HZ;
2596 ret = i2c_add_numbered_adapter(adap);
2598 dev_err(dev, "Failed to add I2C adapter\n");
2605 static void unittest_i2c_bus_remove(struct platform_device *pdev)
2607 struct device *dev = &pdev->dev;
2608 struct device_node *np = dev->of_node;
2609 struct unittest_i2c_bus_data *std = platform_get_drvdata(pdev);
2611 dev_dbg(dev, "%s for node @%pOF\n", __func__, np);
2612 i2c_del_adapter(&std->adap);
2615 static const struct of_device_id unittest_i2c_bus_match[] = {
2616 { .compatible = "unittest-i2c-bus", },
2620 static struct platform_driver unittest_i2c_bus_driver = {
2621 .probe = unittest_i2c_bus_probe,
2622 .remove_new = unittest_i2c_bus_remove,
2624 .name = "unittest-i2c-bus",
2625 .of_match_table = of_match_ptr(unittest_i2c_bus_match),
2629 static int unittest_i2c_dev_probe(struct i2c_client *client)
2631 struct device *dev = &client->dev;
2632 struct device_node *np = client->dev.of_node;
2635 dev_err(dev, "No OF node\n");
2639 dev_dbg(dev, "%s for node @%pOF\n", __func__, np);
2644 static void unittest_i2c_dev_remove(struct i2c_client *client)
2646 struct device *dev = &client->dev;
2647 struct device_node *np = client->dev.of_node;
2649 dev_dbg(dev, "%s for node @%pOF\n", __func__, np);
2652 static const struct i2c_device_id unittest_i2c_dev_id[] = {
2653 { .name = "unittest-i2c-dev" },
2657 static struct i2c_driver unittest_i2c_dev_driver = {
2659 .name = "unittest-i2c-dev",
2661 .probe = unittest_i2c_dev_probe,
2662 .remove = unittest_i2c_dev_remove,
2663 .id_table = unittest_i2c_dev_id,
2666 #if IS_BUILTIN(CONFIG_I2C_MUX)
2668 static int unittest_i2c_mux_select_chan(struct i2c_mux_core *muxc, u32 chan)
2673 static int unittest_i2c_mux_probe(struct i2c_client *client)
2676 struct device *dev = &client->dev;
2677 struct i2c_adapter *adap = client->adapter;
2678 struct device_node *np = client->dev.of_node, *child;
2679 struct i2c_mux_core *muxc;
2682 dev_dbg(dev, "%s for node @%pOF\n", __func__, np);
2685 dev_err(dev, "No OF node\n");
2690 for_each_child_of_node(np, child) {
2691 if (of_property_read_u32(child, "reg", ®))
2693 if (max_reg == (u32)-1 || reg > max_reg)
2696 nchans = max_reg == (u32)-1 ? 0 : max_reg + 1;
2698 dev_err(dev, "No channels\n");
2702 muxc = i2c_mux_alloc(adap, dev, nchans, 0, 0,
2703 unittest_i2c_mux_select_chan, NULL);
2706 for (i = 0; i < nchans; i++) {
2707 if (i2c_mux_add_adapter(muxc, 0, i, 0)) {
2708 dev_err(dev, "Failed to register mux #%d\n", i);
2709 i2c_mux_del_adapters(muxc);
2714 i2c_set_clientdata(client, muxc);
2719 static void unittest_i2c_mux_remove(struct i2c_client *client)
2721 struct device *dev = &client->dev;
2722 struct device_node *np = client->dev.of_node;
2723 struct i2c_mux_core *muxc = i2c_get_clientdata(client);
2725 dev_dbg(dev, "%s for node @%pOF\n", __func__, np);
2726 i2c_mux_del_adapters(muxc);
2729 static const struct i2c_device_id unittest_i2c_mux_id[] = {
2730 { .name = "unittest-i2c-mux" },
2734 static struct i2c_driver unittest_i2c_mux_driver = {
2736 .name = "unittest-i2c-mux",
2738 .probe = unittest_i2c_mux_probe,
2739 .remove = unittest_i2c_mux_remove,
2740 .id_table = unittest_i2c_mux_id,
2745 static int of_unittest_overlay_i2c_init(void)
2749 ret = i2c_add_driver(&unittest_i2c_dev_driver);
2750 if (unittest(ret == 0,
2751 "could not register unittest i2c device driver\n"))
2754 ret = platform_driver_register(&unittest_i2c_bus_driver);
2756 if (unittest(ret == 0,
2757 "could not register unittest i2c bus driver\n"))
2760 #if IS_BUILTIN(CONFIG_I2C_MUX)
2762 EXPECT_BEGIN(KERN_INFO,
2763 "i2c i2c-1: Added multiplexed i2c bus 2");
2765 ret = i2c_add_driver(&unittest_i2c_mux_driver);
2767 EXPECT_END(KERN_INFO,
2768 "i2c i2c-1: Added multiplexed i2c bus 2");
2770 if (unittest(ret == 0,
2771 "could not register unittest i2c mux driver\n"))
2778 static void of_unittest_overlay_i2c_cleanup(void)
2780 #if IS_BUILTIN(CONFIG_I2C_MUX)
2781 i2c_del_driver(&unittest_i2c_mux_driver);
2783 platform_driver_unregister(&unittest_i2c_bus_driver);
2784 i2c_del_driver(&unittest_i2c_dev_driver);
2787 static void __init of_unittest_overlay_i2c_12(void)
2791 /* device should enable */
2792 EXPECT_BEGIN(KERN_INFO,
2793 "OF: overlay: WARNING: memory leak will occur if overlay removed, property: /testcase-data/overlay-node/test-bus/i2c-test-bus/test-unittest12/status");
2795 ret = of_unittest_apply_overlay_check(12, 12, 0, 1, I2C_OVERLAY);
2797 EXPECT_END(KERN_INFO,
2798 "OF: overlay: WARNING: memory leak will occur if overlay removed, property: /testcase-data/overlay-node/test-bus/i2c-test-bus/test-unittest12/status");
2803 unittest(1, "overlay test %d passed\n", 12);
2806 /* test deactivation of device */
2807 static void __init of_unittest_overlay_i2c_13(void)
2811 EXPECT_BEGIN(KERN_INFO,
2812 "OF: overlay: WARNING: memory leak will occur if overlay removed, property: /testcase-data/overlay-node/test-bus/i2c-test-bus/test-unittest13/status");
2814 /* device should disable */
2815 ret = of_unittest_apply_overlay_check(13, 13, 1, 0, I2C_OVERLAY);
2817 EXPECT_END(KERN_INFO,
2818 "OF: overlay: WARNING: memory leak will occur if overlay removed, property: /testcase-data/overlay-node/test-bus/i2c-test-bus/test-unittest13/status");
2823 unittest(1, "overlay test %d passed\n", 13);
2826 /* just check for i2c mux existence */
2827 static void of_unittest_overlay_i2c_14(void)
2831 static void __init of_unittest_overlay_i2c_15(void)
2835 /* device should enable */
2836 EXPECT_BEGIN(KERN_INFO,
2837 "i2c i2c-1: Added multiplexed i2c bus 3");
2839 ret = of_unittest_apply_overlay_check(15, 15, 0, 1, I2C_OVERLAY);
2841 EXPECT_END(KERN_INFO,
2842 "i2c i2c-1: Added multiplexed i2c bus 3");
2847 unittest(1, "overlay test %d passed\n", 15);
2852 static inline void of_unittest_overlay_i2c_14(void) { }
2853 static inline void of_unittest_overlay_i2c_15(void) { }
2857 static int of_notify(struct notifier_block *nb, unsigned long action,
2860 struct of_overlay_notify_data *nd = arg;
2861 struct device_node *found;
2865 * For overlay_16 .. overlay_19, check that returning an error
2866 * works for each of the actions by setting an arbitrary return
2867 * error number that matches the test number. e.g. for unittest16,
2868 * ret = -EBUSY which is -16.
2870 * OVERLAY_INFO() for the overlays is declared to expect the same
2871 * error number, so overlay_data_apply() will return no error.
2873 * overlay_20 will return NOTIFY_DONE
2877 of_node_get(nd->overlay);
2881 case OF_OVERLAY_PRE_APPLY:
2882 found = of_find_node_by_name(nd->overlay, "test-unittest16");
2889 case OF_OVERLAY_POST_APPLY:
2890 found = of_find_node_by_name(nd->overlay, "test-unittest17");
2897 case OF_OVERLAY_PRE_REMOVE:
2898 found = of_find_node_by_name(nd->overlay, "test-unittest18");
2905 case OF_OVERLAY_POST_REMOVE:
2906 found = of_find_node_by_name(nd->overlay, "test-unittest19");
2913 default: /* should not happen */
2914 of_node_put(nd->overlay);
2920 return notifier_from_errno(ret);
2925 static struct notifier_block of_nb = {
2926 .notifier_call = of_notify,
2929 static void __init of_unittest_overlay_notify(void)
2934 ret = of_overlay_notifier_register(&of_nb);
2936 "of_overlay_notifier_register() failed, ret = %d\n", ret);
2941 * The overlays are applied by overlay_data_apply()
2942 * instead of of_unittest_apply_overlay() so that they
2943 * will not be tracked. Thus they will not be removed
2944 * by of_unittest_remove_tracked_overlays().
2946 * Applying overlays 16 - 19 will each trigger an error for a
2947 * different action in of_notify().
2949 * Applying overlay 20 will not trigger any error in of_notify().
2952 /* --- overlay 16 --- */
2954 EXPECT_BEGIN(KERN_INFO, "OF: overlay: overlay changeset pre-apply notifier error -16, target: /testcase-data/overlay-node/test-bus");
2956 unittest(overlay_data_apply("overlay_16", &ovcs_id),
2957 "test OF_OVERLAY_PRE_APPLY notify injected error\n");
2959 EXPECT_END(KERN_INFO, "OF: overlay: overlay changeset pre-apply notifier error -16, target: /testcase-data/overlay-node/test-bus");
2961 unittest(ovcs_id, "ovcs_id not created for overlay_16\n");
2963 /* --- overlay 17 --- */
2965 EXPECT_BEGIN(KERN_INFO, "OF: overlay: overlay changeset post-apply notifier error -17, target: /testcase-data/overlay-node/test-bus");
2967 unittest(overlay_data_apply("overlay_17", &ovcs_id),
2968 "test OF_OVERLAY_POST_APPLY notify injected error\n");
2970 EXPECT_END(KERN_INFO, "OF: overlay: overlay changeset post-apply notifier error -17, target: /testcase-data/overlay-node/test-bus");
2972 unittest(ovcs_id, "ovcs_id not created for overlay_17\n");
2975 ret = of_overlay_remove(&ovcs_id);
2977 "overlay_17 of_overlay_remove(), ret = %d\n", ret);
2980 /* --- overlay 18 --- */
2982 unittest(overlay_data_apply("overlay_18", &ovcs_id),
2983 "OF_OVERLAY_PRE_REMOVE notify injected error\n");
2985 unittest(ovcs_id, "ovcs_id not created for overlay_18\n");
2988 EXPECT_BEGIN(KERN_INFO, "OF: overlay: overlay changeset pre-remove notifier error -18, target: /testcase-data/overlay-node/test-bus");
2990 ret = of_overlay_remove(&ovcs_id);
2991 EXPECT_END(KERN_INFO, "OF: overlay: overlay changeset pre-remove notifier error -18, target: /testcase-data/overlay-node/test-bus");
2992 if (ret == -EXDEV) {
2994 * change set ovcs_id should still exist
2996 unittest(1, "overlay_18 of_overlay_remove() injected error for OF_OVERLAY_PRE_REMOVE\n");
2998 unittest(0, "overlay_18 of_overlay_remove() injected error for OF_OVERLAY_PRE_REMOVE not returned\n");
3001 unittest(1, "ovcs_id not created for overlay_18\n");
3004 unittest(ovcs_id, "ovcs_id removed for overlay_18\n");
3006 /* --- overlay 19 --- */
3008 unittest(overlay_data_apply("overlay_19", &ovcs_id),
3009 "OF_OVERLAY_POST_REMOVE notify injected error\n");
3011 unittest(ovcs_id, "ovcs_id not created for overlay_19\n");
3014 EXPECT_BEGIN(KERN_INFO, "OF: overlay: overlay changeset post-remove notifier error -19, target: /testcase-data/overlay-node/test-bus");
3015 ret = of_overlay_remove(&ovcs_id);
3016 EXPECT_END(KERN_INFO, "OF: overlay: overlay changeset post-remove notifier error -19, target: /testcase-data/overlay-node/test-bus");
3018 unittest(1, "overlay_19 of_overlay_remove() injected error for OF_OVERLAY_POST_REMOVE\n");
3020 unittest(0, "overlay_19 of_overlay_remove() injected error for OF_OVERLAY_POST_REMOVE not returned\n");
3022 unittest(1, "ovcs_id removed for overlay_19\n");
3025 unittest(!ovcs_id, "changeset ovcs_id = %d not removed for overlay_19\n",
3028 /* --- overlay 20 --- */
3030 unittest(overlay_data_apply("overlay_20", &ovcs_id),
3031 "overlay notify no injected error\n");
3034 ret = of_overlay_remove(&ovcs_id);
3036 unittest(1, "overlay_20 failed to be destroyed, ret = %d\n",
3039 unittest(1, "ovcs_id not created for overlay_20\n");
3042 unittest(!of_overlay_notifier_unregister(&of_nb),
3043 "of_overlay_notifier_unregister() failed, ret = %d\n", ret);
3046 static void __init of_unittest_overlay(void)
3048 struct device_node *bus_np = NULL;
3050 if (platform_driver_register(&unittest_driver)) {
3051 unittest(0, "could not register unittest driver\n");
3055 bus_np = of_find_node_by_path(bus_path);
3056 if (bus_np == NULL) {
3057 unittest(0, "could not find bus_path \"%s\"\n", bus_path);
3061 if (of_platform_default_populate(bus_np, NULL, NULL)) {
3062 unittest(0, "could not populate bus @ \"%s\"\n", bus_path);
3066 if (!of_unittest_device_exists(100, PDEV_OVERLAY)) {
3067 unittest(0, "could not find unittest0 @ \"%s\"\n",
3068 unittest_path(100, PDEV_OVERLAY));
3072 if (of_unittest_device_exists(101, PDEV_OVERLAY)) {
3073 unittest(0, "unittest1 @ \"%s\" should not exist\n",
3074 unittest_path(101, PDEV_OVERLAY));
3078 unittest(1, "basic infrastructure of overlays passed");
3080 /* tests in sequence */
3081 of_unittest_overlay_0();
3082 of_unittest_overlay_1();
3083 of_unittest_overlay_2();
3084 of_unittest_overlay_3();
3085 of_unittest_overlay_4();
3086 of_unittest_overlay_5();
3087 of_unittest_overlay_6();
3088 of_unittest_overlay_8();
3090 of_unittest_overlay_10();
3091 of_unittest_overlay_11();
3093 #if IS_BUILTIN(CONFIG_I2C)
3094 if (unittest(of_unittest_overlay_i2c_init() == 0, "i2c init failed\n"))
3097 of_unittest_overlay_i2c_12();
3098 of_unittest_overlay_i2c_13();
3099 of_unittest_overlay_i2c_14();
3100 of_unittest_overlay_i2c_15();
3102 of_unittest_overlay_i2c_cleanup();
3105 of_unittest_overlay_gpio();
3107 of_unittest_remove_tracked_overlays();
3109 of_unittest_overlay_notify();
3112 of_node_put(bus_np);
3116 static inline void __init of_unittest_overlay(void) { }
3119 static void __init of_unittest_lifecycle(void)
3121 #ifdef CONFIG_OF_DYNAMIC
3122 unsigned int refcount;
3123 int found_refcount_one = 0;
3125 struct device_node *np;
3126 struct device_node *prev_sibling, *next_sibling;
3127 const char *refcount_path = "/testcase-data/refcount-node";
3128 const char *refcount_parent_path = "/testcase-data";
3131 * Node lifecycle tests, non-dynamic node:
3133 * - Decrementing refcount to zero via of_node_put() should cause the
3134 * attempt to free the node memory by of_node_release() to fail
3135 * because the node is not a dynamic node.
3137 * - Decrementing refcount past zero should result in additional
3141 np = of_find_node_by_path(refcount_path);
3142 unittest(np, "find refcount_path \"%s\"\n", refcount_path);
3144 goto out_skip_tests;
3146 while (!found_refcount_one) {
3148 if (put_count++ > 10) {
3149 unittest(0, "guardrail to avoid infinite loop\n");
3150 goto out_skip_tests;
3153 refcount = kref_read(&np->kobj.kref);
3155 found_refcount_one = 1;
3160 EXPECT_BEGIN(KERN_INFO, "OF: ERROR: of_node_release() detected bad of_node_put() on /testcase-data/refcount-node");
3163 * refcount is now one, decrementing to zero will result in a call to
3164 * of_node_release() to free the node's memory, which should result
3167 unittest(1, "/testcase-data/refcount-node is one");
3170 EXPECT_END(KERN_INFO, "OF: ERROR: of_node_release() detected bad of_node_put() on /testcase-data/refcount-node");
3174 * expect stack trace for subsequent of_node_put():
3175 * __refcount_sub_and_test() calls:
3176 * refcount_warn_saturate(r, REFCOUNT_SUB_UAF)
3178 * Not capturing entire WARN_ONCE() trace with EXPECT_*(), just
3179 * the first three lines, and the last line.
3181 EXPECT_BEGIN(KERN_INFO, "------------[ cut here ]------------");
3182 EXPECT_BEGIN(KERN_INFO, "WARNING: <<all>>");
3183 EXPECT_BEGIN(KERN_INFO, "refcount_t: underflow; use-after-free.");
3184 EXPECT_BEGIN(KERN_INFO, "---[ end trace <<int>> ]---");
3186 /* refcount is now zero, this should fail */
3187 unittest(1, "/testcase-data/refcount-node is zero");
3190 EXPECT_END(KERN_INFO, "---[ end trace <<int>> ]---");
3191 EXPECT_END(KERN_INFO, "refcount_t: underflow; use-after-free.");
3192 EXPECT_END(KERN_INFO, "WARNING: <<all>>");
3193 EXPECT_END(KERN_INFO, "------------[ cut here ]------------");
3196 * Q. do we expect to get yet another warning?
3197 * A. no, the WARNING is from WARN_ONCE()
3199 EXPECT_NOT_BEGIN(KERN_INFO, "------------[ cut here ]------------");
3200 EXPECT_NOT_BEGIN(KERN_INFO, "WARNING: <<all>>");
3201 EXPECT_NOT_BEGIN(KERN_INFO, "refcount_t: underflow; use-after-free.");
3202 EXPECT_NOT_BEGIN(KERN_INFO, "---[ end trace <<int>> ]---");
3204 unittest(1, "/testcase-data/refcount-node is zero, second time");
3207 EXPECT_NOT_END(KERN_INFO, "---[ end trace <<int>> ]---");
3208 EXPECT_NOT_END(KERN_INFO, "refcount_t: underflow; use-after-free.");
3209 EXPECT_NOT_END(KERN_INFO, "WARNING: <<all>>");
3210 EXPECT_NOT_END(KERN_INFO, "------------[ cut here ]------------");
3213 * refcount of zero will trigger stack traces from any further
3214 * attempt to of_node_get() node "refcount-node". One example of
3215 * this is where of_unittest_check_node_linkage() will recursively
3216 * scan the tree, with 'for_each_child_of_node()' doing an
3217 * of_node_get() of the children of a node.
3219 * Prevent the stack trace by removing node "refcount-node" from
3220 * its parent's child list.
3222 * WARNING: EVIL, EVIL, EVIL:
3224 * Directly manipulate the child list of node /testcase-data to
3225 * remove child refcount-node. This is ignoring all proper methods
3226 * of removing a child and will leak a small amount of memory.
3229 np = of_find_node_by_path(refcount_parent_path);
3230 unittest(np, "find refcount_parent_path \"%s\"\n", refcount_parent_path);
3231 unittest(np, "ERROR: devicetree live tree left in a 'bad state' if test fail\n");
3235 prev_sibling = np->child;
3236 next_sibling = prev_sibling->sibling;
3237 if (!strcmp(prev_sibling->full_name, "refcount-node")) {
3238 np->child = next_sibling;
3239 next_sibling = next_sibling->sibling;
3241 while (next_sibling) {
3242 if (!strcmp(next_sibling->full_name, "refcount-node"))
3243 prev_sibling->sibling = next_sibling->sibling;
3244 prev_sibling = next_sibling;
3245 next_sibling = next_sibling->sibling;
3253 unittest(0, "One or more lifecycle tests skipped\n");
3256 #ifdef CONFIG_OF_OVERLAY
3259 * __dtbo_##overlay_name##_begin[] and __dtbo_##overlay_name##_end[] are
3260 * created by cmd_dt_S_dtbo in scripts/Makefile.lib
3263 #define OVERLAY_INFO_EXTERN(overlay_name) \
3264 extern uint8_t __dtbo_##overlay_name##_begin[]; \
3265 extern uint8_t __dtbo_##overlay_name##_end[]
3267 #define OVERLAY_INFO(overlay_name, expected) \
3268 { .dtbo_begin = __dtbo_##overlay_name##_begin, \
3269 .dtbo_end = __dtbo_##overlay_name##_end, \
3270 .expected_result = expected, \
3271 .name = #overlay_name, \
3274 struct overlay_info {
3275 uint8_t *dtbo_begin;
3277 int expected_result;
3282 OVERLAY_INFO_EXTERN(overlay_base);
3283 OVERLAY_INFO_EXTERN(overlay);
3284 OVERLAY_INFO_EXTERN(overlay_0);
3285 OVERLAY_INFO_EXTERN(overlay_1);
3286 OVERLAY_INFO_EXTERN(overlay_2);
3287 OVERLAY_INFO_EXTERN(overlay_3);
3288 OVERLAY_INFO_EXTERN(overlay_4);
3289 OVERLAY_INFO_EXTERN(overlay_5);
3290 OVERLAY_INFO_EXTERN(overlay_6);
3291 OVERLAY_INFO_EXTERN(overlay_7);
3292 OVERLAY_INFO_EXTERN(overlay_8);
3293 OVERLAY_INFO_EXTERN(overlay_9);
3294 OVERLAY_INFO_EXTERN(overlay_10);
3295 OVERLAY_INFO_EXTERN(overlay_11);
3296 OVERLAY_INFO_EXTERN(overlay_12);
3297 OVERLAY_INFO_EXTERN(overlay_13);
3298 OVERLAY_INFO_EXTERN(overlay_15);
3299 OVERLAY_INFO_EXTERN(overlay_16);
3300 OVERLAY_INFO_EXTERN(overlay_17);
3301 OVERLAY_INFO_EXTERN(overlay_18);
3302 OVERLAY_INFO_EXTERN(overlay_19);
3303 OVERLAY_INFO_EXTERN(overlay_20);
3304 OVERLAY_INFO_EXTERN(overlay_gpio_01);
3305 OVERLAY_INFO_EXTERN(overlay_gpio_02a);
3306 OVERLAY_INFO_EXTERN(overlay_gpio_02b);
3307 OVERLAY_INFO_EXTERN(overlay_gpio_03);
3308 OVERLAY_INFO_EXTERN(overlay_gpio_04a);
3309 OVERLAY_INFO_EXTERN(overlay_gpio_04b);
3310 OVERLAY_INFO_EXTERN(overlay_bad_add_dup_node);
3311 OVERLAY_INFO_EXTERN(overlay_bad_add_dup_prop);
3312 OVERLAY_INFO_EXTERN(overlay_bad_phandle);
3313 OVERLAY_INFO_EXTERN(overlay_bad_symbol);
3315 /* entries found by name */
3316 static struct overlay_info overlays[] = {
3317 OVERLAY_INFO(overlay_base, -9999),
3318 OVERLAY_INFO(overlay, 0),
3319 OVERLAY_INFO(overlay_0, 0),
3320 OVERLAY_INFO(overlay_1, 0),
3321 OVERLAY_INFO(overlay_2, 0),
3322 OVERLAY_INFO(overlay_3, 0),
3323 OVERLAY_INFO(overlay_4, 0),
3324 OVERLAY_INFO(overlay_5, 0),
3325 OVERLAY_INFO(overlay_6, 0),
3326 OVERLAY_INFO(overlay_7, 0),
3327 OVERLAY_INFO(overlay_8, 0),
3328 OVERLAY_INFO(overlay_9, 0),
3329 OVERLAY_INFO(overlay_10, 0),
3330 OVERLAY_INFO(overlay_11, 0),
3331 OVERLAY_INFO(overlay_12, 0),
3332 OVERLAY_INFO(overlay_13, 0),
3333 OVERLAY_INFO(overlay_15, 0),
3334 OVERLAY_INFO(overlay_16, -EBUSY),
3335 OVERLAY_INFO(overlay_17, -EEXIST),
3336 OVERLAY_INFO(overlay_18, 0),
3337 OVERLAY_INFO(overlay_19, 0),
3338 OVERLAY_INFO(overlay_20, 0),
3339 OVERLAY_INFO(overlay_gpio_01, 0),
3340 OVERLAY_INFO(overlay_gpio_02a, 0),
3341 OVERLAY_INFO(overlay_gpio_02b, 0),
3342 OVERLAY_INFO(overlay_gpio_03, 0),
3343 OVERLAY_INFO(overlay_gpio_04a, 0),
3344 OVERLAY_INFO(overlay_gpio_04b, 0),
3345 OVERLAY_INFO(overlay_bad_add_dup_node, -EINVAL),
3346 OVERLAY_INFO(overlay_bad_add_dup_prop, -EINVAL),
3347 OVERLAY_INFO(overlay_bad_phandle, -EINVAL),
3348 OVERLAY_INFO(overlay_bad_symbol, -EINVAL),
3350 {.dtbo_begin = NULL, .dtbo_end = NULL, .expected_result = 0, .name = NULL}
3353 static struct device_node *overlay_base_root;
3355 static void * __init dt_alloc_memory(u64 size, u64 align)
3357 void *ptr = memblock_alloc(size, align);
3360 panic("%s: Failed to allocate %llu bytes align=0x%llx\n",
3361 __func__, size, align);
3367 * Create base device tree for the overlay unittest.
3369 * This is called from very early boot code.
3371 * Do as much as possible the same way as done in __unflatten_device_tree
3372 * and other early boot steps for the normal FDT so that the overlay base
3373 * unflattened tree will have the same characteristics as the real tree
3374 * (such as having memory allocated by the early allocator). The goal
3375 * is to test "the real thing" as much as possible, and test "test setup
3376 * code" as little as possible.
3378 * Have to stop before resolving phandles, because that uses kmalloc.
3380 void __init unittest_unflatten_overlay_base(void)
3382 struct overlay_info *info;
3387 const char *overlay_name = "overlay_base";
3389 for (info = overlays; info && info->name; info++) {
3390 if (!strcmp(overlay_name, info->name)) {
3396 pr_err("no overlay data for %s\n", overlay_name);
3400 info = &overlays[0];
3402 if (info->expected_result != -9999) {
3403 pr_err("No dtb 'overlay_base' to attach\n");
3407 data_size = info->dtbo_end - info->dtbo_begin;
3409 pr_err("No dtb 'overlay_base' to attach\n");
3413 size = fdt_totalsize(info->dtbo_begin);
3414 if (size != data_size) {
3415 pr_err("dtb 'overlay_base' header totalsize != actual size");
3419 new_fdt = dt_alloc_memory(size, roundup_pow_of_two(FDT_V17_SIZE));
3421 pr_err("alloc for dtb 'overlay_base' failed");
3425 memcpy(new_fdt, info->dtbo_begin, size);
3427 __unflatten_device_tree(new_fdt, NULL, &overlay_base_root,
3428 dt_alloc_memory, true);
3432 * The purpose of of_unittest_overlay_data_add is to add an
3433 * overlay in the normal fashion. This is a test of the whole
3434 * picture, instead of testing individual elements.
3436 * A secondary purpose is to be able to verify that the contents of
3437 * /proc/device-tree/ contains the updated structure and values from
3438 * the overlay. That must be verified separately in user space.
3440 * Return 0 on unexpected error.
3442 static int __init overlay_data_apply(const char *overlay_name, int *ovcs_id)
3444 struct overlay_info *info;
3449 for (info = overlays; info && info->name; info++) {
3450 if (!strcmp(overlay_name, info->name)) {
3456 pr_err("no overlay data for %s\n", overlay_name);
3460 size = info->dtbo_end - info->dtbo_begin;
3462 pr_err("no overlay data for %s\n", overlay_name);
3464 ret = of_overlay_fdt_apply(info->dtbo_begin, size, &info->ovcs_id);
3466 *ovcs_id = info->ovcs_id;
3470 pr_debug("%s applied\n", overlay_name);
3473 if (ret != info->expected_result)
3474 pr_err("of_overlay_fdt_apply() expected %d, ret=%d, %s\n",
3475 info->expected_result, ret, overlay_name);
3477 return (ret == info->expected_result);
3481 * The purpose of of_unittest_overlay_high_level is to add an overlay
3482 * in the normal fashion. This is a test of the whole picture,
3483 * instead of individual elements.
3485 * The first part of the function is _not_ normal overlay usage; it is
3486 * finishing splicing the base overlay device tree into the live tree.
3488 static __init void of_unittest_overlay_high_level(void)
3490 struct device_node *last_sibling;
3491 struct device_node *np;
3492 struct device_node *of_symbols;
3493 struct device_node *overlay_base_symbols;
3494 struct device_node **pprev;
3495 struct property *prop;
3498 if (!overlay_base_root) {
3499 unittest(0, "overlay_base_root not initialized\n");
3504 * Could not fixup phandles in unittest_unflatten_overlay_base()
3505 * because kmalloc() was not yet available.
3507 of_overlay_mutex_lock();
3508 of_resolve_phandles(overlay_base_root);
3509 of_overlay_mutex_unlock();
3513 * do not allow overlay_base to duplicate any node already in
3514 * tree, this greatly simplifies the code
3518 * remove overlay_base_root node "__local_fixups", after
3519 * being used by of_resolve_phandles()
3521 pprev = &overlay_base_root->child;
3522 for (np = overlay_base_root->child; np; np = np->sibling) {
3523 if (of_node_name_eq(np, "__local_fixups__")) {
3524 *pprev = np->sibling;
3527 pprev = &np->sibling;
3530 /* remove overlay_base_root node "__symbols__" if in live tree */
3531 of_symbols = of_get_child_by_name(of_root, "__symbols__");
3533 /* will have to graft properties from node into live tree */
3534 pprev = &overlay_base_root->child;
3535 for (np = overlay_base_root->child; np; np = np->sibling) {
3536 if (of_node_name_eq(np, "__symbols__")) {
3537 overlay_base_symbols = np;
3538 *pprev = np->sibling;
3541 pprev = &np->sibling;
3545 for_each_child_of_node(overlay_base_root, np) {
3546 struct device_node *base_child;
3547 for_each_child_of_node(of_root, base_child) {
3548 if (!strcmp(np->full_name, base_child->full_name)) {
3549 unittest(0, "illegal node name in overlay_base %pOFn",
3552 of_node_put(base_child);
3559 * overlay 'overlay_base' is not allowed to have root
3560 * properties, so only need to splice nodes into main device tree.
3562 * root node of *overlay_base_root will not be freed, it is lost
3566 for (np = overlay_base_root->child; np; np = np->sibling)
3567 np->parent = of_root;
3569 mutex_lock(&of_mutex);
3571 for (last_sibling = np = of_root->child; np; np = np->sibling)
3575 last_sibling->sibling = overlay_base_root->child;
3577 of_root->child = overlay_base_root->child;
3579 for_each_of_allnodes_from(overlay_base_root, np)
3580 __of_attach_node_sysfs(np);
3583 struct property *new_prop;
3584 for_each_property_of_node(overlay_base_symbols, prop) {
3586 new_prop = __of_prop_dup(prop, GFP_KERNEL);
3588 unittest(0, "__of_prop_dup() of '%s' from overlay_base node __symbols__",
3592 if (__of_add_property(of_symbols, new_prop)) {
3593 kfree(new_prop->name);
3594 kfree(new_prop->value);
3596 /* "name" auto-generated by unflatten */
3597 if (!strcmp(prop->name, "name"))
3599 unittest(0, "duplicate property '%s' in overlay_base node __symbols__",
3603 if (__of_add_property_sysfs(of_symbols, new_prop)) {
3604 unittest(0, "unable to add property '%s' in overlay_base node __symbols__ to sysfs",
3611 mutex_unlock(&of_mutex);
3614 /* now do the normal overlay usage test */
3616 EXPECT_BEGIN(KERN_ERR,
3617 "OF: overlay: WARNING: memory leak will occur if overlay removed, property: /testcase-data-2/substation@100/status");
3618 EXPECT_BEGIN(KERN_ERR,
3619 "OF: overlay: WARNING: memory leak will occur if overlay removed, property: /testcase-data-2/fairway-1/status");
3620 EXPECT_BEGIN(KERN_ERR,
3621 "OF: overlay: WARNING: memory leak will occur if overlay removed, property: /testcase-data-2/fairway-1/ride@100/track@30/incline-up");
3622 EXPECT_BEGIN(KERN_ERR,
3623 "OF: overlay: WARNING: memory leak will occur if overlay removed, property: /testcase-data-2/fairway-1/ride@100/track@40/incline-up");
3624 EXPECT_BEGIN(KERN_ERR,
3625 "OF: overlay: WARNING: memory leak will occur if overlay removed, property: /testcase-data-2/lights@40000/status");
3626 EXPECT_BEGIN(KERN_ERR,
3627 "OF: overlay: WARNING: memory leak will occur if overlay removed, property: /testcase-data-2/lights@40000/color");
3628 EXPECT_BEGIN(KERN_ERR,
3629 "OF: overlay: WARNING: memory leak will occur if overlay removed, property: /testcase-data-2/lights@40000/rate");
3630 EXPECT_BEGIN(KERN_ERR,
3631 "OF: overlay: WARNING: memory leak will occur if overlay removed, property: /__symbols__/hvac_2");
3632 EXPECT_BEGIN(KERN_ERR,
3633 "OF: overlay: WARNING: memory leak will occur if overlay removed, property: /__symbols__/ride_200");
3634 EXPECT_BEGIN(KERN_ERR,
3635 "OF: overlay: WARNING: memory leak will occur if overlay removed, property: /__symbols__/ride_200_left");
3636 EXPECT_BEGIN(KERN_ERR,
3637 "OF: overlay: WARNING: memory leak will occur if overlay removed, property: /__symbols__/ride_200_right");
3639 ret = overlay_data_apply("overlay", NULL);
3641 EXPECT_END(KERN_ERR,
3642 "OF: overlay: WARNING: memory leak will occur if overlay removed, property: /__symbols__/ride_200_right");
3643 EXPECT_END(KERN_ERR,
3644 "OF: overlay: WARNING: memory leak will occur if overlay removed, property: /__symbols__/ride_200_left");
3645 EXPECT_END(KERN_ERR,
3646 "OF: overlay: WARNING: memory leak will occur if overlay removed, property: /__symbols__/ride_200");
3647 EXPECT_END(KERN_ERR,
3648 "OF: overlay: WARNING: memory leak will occur if overlay removed, property: /__symbols__/hvac_2");
3649 EXPECT_END(KERN_ERR,
3650 "OF: overlay: WARNING: memory leak will occur if overlay removed, property: /testcase-data-2/lights@40000/rate");
3651 EXPECT_END(KERN_ERR,
3652 "OF: overlay: WARNING: memory leak will occur if overlay removed, property: /testcase-data-2/lights@40000/color");
3653 EXPECT_END(KERN_ERR,
3654 "OF: overlay: WARNING: memory leak will occur if overlay removed, property: /testcase-data-2/lights@40000/status");
3655 EXPECT_END(KERN_ERR,
3656 "OF: overlay: WARNING: memory leak will occur if overlay removed, property: /testcase-data-2/fairway-1/ride@100/track@40/incline-up");
3657 EXPECT_END(KERN_ERR,
3658 "OF: overlay: WARNING: memory leak will occur if overlay removed, property: /testcase-data-2/fairway-1/ride@100/track@30/incline-up");
3659 EXPECT_END(KERN_ERR,
3660 "OF: overlay: WARNING: memory leak will occur if overlay removed, property: /testcase-data-2/fairway-1/status");
3661 EXPECT_END(KERN_ERR,
3662 "OF: overlay: WARNING: memory leak will occur if overlay removed, property: /testcase-data-2/substation@100/status");
3664 unittest(ret, "Adding overlay 'overlay' failed\n");
3666 EXPECT_BEGIN(KERN_ERR,
3667 "OF: overlay: ERROR: multiple fragments add and/or delete node /testcase-data-2/substation@100/motor-1/controller");
3668 EXPECT_BEGIN(KERN_ERR,
3669 "OF: overlay: ERROR: multiple fragments add, update, and/or delete property /testcase-data-2/substation@100/motor-1/controller/name");
3671 unittest(overlay_data_apply("overlay_bad_add_dup_node", NULL),
3672 "Adding overlay 'overlay_bad_add_dup_node' failed\n");
3674 EXPECT_END(KERN_ERR,
3675 "OF: overlay: ERROR: multiple fragments add, update, and/or delete property /testcase-data-2/substation@100/motor-1/controller/name");
3676 EXPECT_END(KERN_ERR,
3677 "OF: overlay: ERROR: multiple fragments add and/or delete node /testcase-data-2/substation@100/motor-1/controller");
3679 EXPECT_BEGIN(KERN_ERR,
3680 "OF: overlay: ERROR: multiple fragments add and/or delete node /testcase-data-2/substation@100/motor-1/electric");
3681 EXPECT_BEGIN(KERN_ERR,
3682 "OF: overlay: ERROR: multiple fragments add, update, and/or delete property /testcase-data-2/substation@100/motor-1/electric/rpm_avail");
3683 EXPECT_BEGIN(KERN_ERR,
3684 "OF: overlay: ERROR: multiple fragments add, update, and/or delete property /testcase-data-2/substation@100/motor-1/electric/name");
3686 unittest(overlay_data_apply("overlay_bad_add_dup_prop", NULL),
3687 "Adding overlay 'overlay_bad_add_dup_prop' failed\n");
3689 EXPECT_END(KERN_ERR,
3690 "OF: overlay: ERROR: multiple fragments add, update, and/or delete property /testcase-data-2/substation@100/motor-1/electric/name");
3691 EXPECT_END(KERN_ERR,
3692 "OF: overlay: ERROR: multiple fragments add, update, and/or delete property /testcase-data-2/substation@100/motor-1/electric/rpm_avail");
3693 EXPECT_END(KERN_ERR,
3694 "OF: overlay: ERROR: multiple fragments add and/or delete node /testcase-data-2/substation@100/motor-1/electric");
3696 unittest(overlay_data_apply("overlay_bad_phandle", NULL),
3697 "Adding overlay 'overlay_bad_phandle' failed\n");
3699 unittest(overlay_data_apply("overlay_bad_symbol", NULL),
3700 "Adding overlay 'overlay_bad_symbol' failed\n");
3705 mutex_unlock(&of_mutex);
3710 static inline __init void of_unittest_overlay_high_level(void) {}
3714 static int __init of_unittest(void)
3716 struct device_node *np;
3719 pr_info("start of unittest - you will see error messages\n");
3721 /* Taint the kernel so we know we've run tests. */
3722 add_taint(TAINT_TEST, LOCKDEP_STILL_OK);
3724 /* adding data for unittest */
3726 if (IS_ENABLED(CONFIG_UML))
3727 unittest_unflatten_overlay_base();
3729 res = unittest_data_add();
3733 of_aliases = of_find_node_by_path("/aliases");
3735 np = of_find_node_by_path("/testcase-data/phandle-tests/consumer-a");
3737 pr_info("No testcase data in device tree; not running tests\n");
3742 of_unittest_check_tree_linkage();
3743 of_unittest_check_phandles();
3744 of_unittest_find_node_by_name();
3745 of_unittest_dynamic();
3746 of_unittest_parse_phandle_with_args();
3747 of_unittest_parse_phandle_with_args_map();
3748 of_unittest_printf();
3749 of_unittest_property_string();
3750 of_unittest_property_copy();
3751 of_unittest_changeset();
3752 of_unittest_parse_interrupts();
3753 of_unittest_parse_interrupts_extended();
3754 of_unittest_dma_get_max_cpu_address();
3755 of_unittest_parse_dma_ranges();
3756 of_unittest_pci_dma_ranges();
3757 of_unittest_bus_ranges();
3758 of_unittest_bus_3cell_ranges();
3760 of_unittest_match_node();
3761 of_unittest_platform_populate();
3762 of_unittest_overlay();
3763 of_unittest_lifecycle();
3765 /* Double check linkage after removing testcase data */
3766 of_unittest_check_tree_linkage();
3768 of_unittest_overlay_high_level();
3770 pr_info("end of unittest - %i passed, %i failed\n",
3771 unittest_results.passed, unittest_results.failed);
3775 late_initcall(of_unittest);