aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorWang Long <long.wanglong@huawei.com>2015-03-08 22:35:24 -0400
committerRob Herring <robh@kernel.org>2015-03-25 01:44:54 -0400
commit7a39086d23218dc85c744525f1653cd90197a971 (patch)
tree9e9f2009325b20ce9b6af931241a5db54fdc49bd
parentf0570d91ce8493883daa234ffdafb5c5620a1128 (diff)
Documentation: update the of_selftest.txt
Since the directory "drivers/of/testcase-data" is renamed to "drivers/of/unittest-data". so we should update the path in the of_selftest.txt. When the kernel is built with OF_SELFUNIT enabled, the output dtb is testcases.dtb instead of testcase.dtb, also update it (s/testcase/testcases/). Signed-off-by: Wang Long <long.wanglong@huawei.com> Signed-off-by: Rob Herring <robh@kernel.org>
-rw-r--r--Documentation/devicetree/of_selftest.txt28
1 files changed, 14 insertions, 14 deletions
diff --git a/Documentation/devicetree/of_selftest.txt b/Documentation/devicetree/of_selftest.txt
index 57a808b588bf..3e4e7d48ae93 100644
--- a/Documentation/devicetree/of_selftest.txt
+++ b/Documentation/devicetree/of_selftest.txt
@@ -1,11 +1,11 @@
1Open Firmware Device Tree Selftest 1Open Firmware Device Tree Unittest
2---------------------------------- 2----------------------------------
3 3
4Author: Gaurav Minocha <gaurav.minocha.os@gmail.com> 4Author: Gaurav Minocha <gaurav.minocha.os@gmail.com>
5 5
61. Introduction 61. Introduction
7 7
8This document explains how the test data required for executing OF selftest 8This document explains how the test data required for executing OF unittest
9is attached to the live tree dynamically, independent of the machine's 9is attached to the live tree dynamically, independent of the machine's
10architecture. 10architecture.
11 11
@@ -22,31 +22,31 @@ most of the device drivers in various use cases.
22 22
232. Test-data 232. Test-data
24 24
25The Device Tree Source file (drivers/of/testcase-data/testcases.dts) contains 25The Device Tree Source file (drivers/of/unittest-data/testcases.dts) contains
26the test data required for executing the unit tests automated in 26the test data required for executing the unit tests automated in
27drivers/of/selftests.c. Currently, following Device Tree Source Include files 27drivers/of/unittest.c. Currently, following Device Tree Source Include files
28(.dtsi) are included in testcase.dts: 28(.dtsi) are included in testcases.dts:
29 29
30drivers/of/testcase-data/tests-interrupts.dtsi 30drivers/of/unittest-data/tests-interrupts.dtsi
31drivers/of/testcase-data/tests-platform.dtsi 31drivers/of/unittest-data/tests-platform.dtsi
32drivers/of/testcase-data/tests-phandle.dtsi 32drivers/of/unittest-data/tests-phandle.dtsi
33drivers/of/testcase-data/tests-match.dtsi 33drivers/of/unittest-data/tests-match.dtsi
34 34
35When the kernel is build with OF_SELFTEST enabled, then the following make rule 35When the kernel is build with OF_SELFTEST enabled, then the following make rule
36 36
37$(obj)/%.dtb: $(src)/%.dts FORCE 37$(obj)/%.dtb: $(src)/%.dts FORCE
38 $(call if_changed_dep, dtc) 38 $(call if_changed_dep, dtc)
39 39
40is used to compile the DT source file (testcase.dts) into a binary blob 40is used to compile the DT source file (testcases.dts) into a binary blob
41(testcase.dtb), also referred as flattened DT. 41(testcases.dtb), also referred as flattened DT.
42 42
43After that, using the following rule the binary blob above is wrapped as an 43After that, using the following rule the binary blob above is wrapped as an
44assembly file (testcase.dtb.S). 44assembly file (testcases.dtb.S).
45 45
46$(obj)/%.dtb.S: $(obj)/%.dtb 46$(obj)/%.dtb.S: $(obj)/%.dtb
47 $(call cmd, dt_S_dtb) 47 $(call cmd, dt_S_dtb)
48 48
49The assembly file is compiled into an object file (testcase.dtb.o), and is 49The assembly file is compiled into an object file (testcases.dtb.o), and is
50linked into the kernel image. 50linked into the kernel image.
51 51
52 52
@@ -98,7 +98,7 @@ child11 -> sibling12 -> sibling13 -> sibling14 -> null
98Figure 1: Generic structure of un-flattened device tree 98Figure 1: Generic structure of un-flattened device tree
99 99
100 100
101Before executing OF selftest, it is required to attach the test data to 101Before executing OF unittest, it is required to attach the test data to
102machine's device tree (if present). So, when selftest_data_add() is called, 102machine's device tree (if present). So, when selftest_data_add() is called,
103at first it reads the flattened device tree data linked into the kernel image 103at first it reads the flattened device tree data linked into the kernel image
104via the following kernel symbols: 104via the following kernel symbols: