diff options
author | Wang Long <long.wanglong@huawei.com> | 2015-03-08 22:35:24 -0400 |
---|---|---|
committer | Rob Herring <robh@kernel.org> | 2015-03-25 01:44:54 -0400 |
commit | 7a39086d23218dc85c744525f1653cd90197a971 (patch) | |
tree | 9e9f2009325b20ce9b6af931241a5db54fdc49bd | |
parent | f0570d91ce8493883daa234ffdafb5c5620a1128 (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.txt | 28 |
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 @@ | |||
1 | Open Firmware Device Tree Selftest | 1 | Open Firmware Device Tree Unittest |
2 | ---------------------------------- | 2 | ---------------------------------- |
3 | 3 | ||
4 | Author: Gaurav Minocha <gaurav.minocha.os@gmail.com> | 4 | Author: Gaurav Minocha <gaurav.minocha.os@gmail.com> |
5 | 5 | ||
6 | 1. Introduction | 6 | 1. Introduction |
7 | 7 | ||
8 | This document explains how the test data required for executing OF selftest | 8 | This document explains how the test data required for executing OF unittest |
9 | is attached to the live tree dynamically, independent of the machine's | 9 | is attached to the live tree dynamically, independent of the machine's |
10 | architecture. | 10 | architecture. |
11 | 11 | ||
@@ -22,31 +22,31 @@ most of the device drivers in various use cases. | |||
22 | 22 | ||
23 | 2. Test-data | 23 | 2. Test-data |
24 | 24 | ||
25 | The Device Tree Source file (drivers/of/testcase-data/testcases.dts) contains | 25 | The Device Tree Source file (drivers/of/unittest-data/testcases.dts) contains |
26 | the test data required for executing the unit tests automated in | 26 | the test data required for executing the unit tests automated in |
27 | drivers/of/selftests.c. Currently, following Device Tree Source Include files | 27 | drivers/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 | ||
30 | drivers/of/testcase-data/tests-interrupts.dtsi | 30 | drivers/of/unittest-data/tests-interrupts.dtsi |
31 | drivers/of/testcase-data/tests-platform.dtsi | 31 | drivers/of/unittest-data/tests-platform.dtsi |
32 | drivers/of/testcase-data/tests-phandle.dtsi | 32 | drivers/of/unittest-data/tests-phandle.dtsi |
33 | drivers/of/testcase-data/tests-match.dtsi | 33 | drivers/of/unittest-data/tests-match.dtsi |
34 | 34 | ||
35 | When the kernel is build with OF_SELFTEST enabled, then the following make rule | 35 | When 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 | ||
40 | is used to compile the DT source file (testcase.dts) into a binary blob | 40 | is 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 | ||
43 | After that, using the following rule the binary blob above is wrapped as an | 43 | After that, using the following rule the binary blob above is wrapped as an |
44 | assembly file (testcase.dtb.S). | 44 | assembly 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 | ||
49 | The assembly file is compiled into an object file (testcase.dtb.o), and is | 49 | The assembly file is compiled into an object file (testcases.dtb.o), and is |
50 | linked into the kernel image. | 50 | linked into the kernel image. |
51 | 51 | ||
52 | 52 | ||
@@ -98,7 +98,7 @@ child11 -> sibling12 -> sibling13 -> sibling14 -> null | |||
98 | Figure 1: Generic structure of un-flattened device tree | 98 | Figure 1: Generic structure of un-flattened device tree |
99 | 99 | ||
100 | 100 | ||
101 | Before executing OF selftest, it is required to attach the test data to | 101 | Before executing OF unittest, it is required to attach the test data to |
102 | machine's device tree (if present). So, when selftest_data_add() is called, | 102 | machine's device tree (if present). So, when selftest_data_add() is called, |
103 | at first it reads the flattened device tree data linked into the kernel image | 103 | at first it reads the flattened device tree data linked into the kernel image |
104 | via the following kernel symbols: | 104 | via the following kernel symbols: |