xref: /aosp_15_r20/system/libufdt/tests/README (revision 13e8728f0cffde9369df671f7b293a048a99c7ed)
1*13e8728fSAndroid Build Coastguard WorkerThis folder contains scripts and test data to test libufdt.
2*13e8728fSAndroid Build Coastguard Worker
3*13e8728fSAndroid Build Coastguard Worker# Test scripts
4*13e8728fSAndroid Build Coastguard Worker
5*13e8728fSAndroid Build Coastguard Worker* run_tests.sh: The main entry to run test cases. Using different
6*13e8728fSAndroid Build Coastguard Worker  test cases under testdata/*.
7*13e8728fSAndroid Build Coastguard Worker* gen_test.sh: The script to run a single test case.
8*13e8728fSAndroid Build Coastguard Worker* common.sh: A common lib containing several useful functions.
9*13e8728fSAndroid Build Coastguard Worker
10*13e8728fSAndroid Build Coastguard Worker# Test data
11*13e8728fSAndroid Build Coastguard Worker
12*13e8728fSAndroid Build Coastguard Workertestdata/${my_test_case}.base_dts
13*13e8728fSAndroid Build Coastguard Worker - Base device tree source.
14*13e8728fSAndroid Build Coastguard Worker - Sample format:
15*13e8728fSAndroid Build Coastguard Worker   ```
16*13e8728fSAndroid Build Coastguard Worker   /dts-v1/;
17*13e8728fSAndroid Build Coastguard Worker   / {
18*13e8728fSAndroid Build Coastguard Worker     a: a{};
19*13e8728fSAndroid Build Coastguard Worker   };
20*13e8728fSAndroid Build Coastguard Worker   ```
21*13e8728fSAndroid Build Coastguard Worker
22*13e8728fSAndroid Build Coastguard Workertestdata/${my_test_case}.add_dts
23*13e8728fSAndroid Build Coastguard Worker - Additional device tree source.
24*13e8728fSAndroid Build Coastguard Worker - Sample format:
25*13e8728fSAndroid Build Coastguard Worker   ```
26*13e8728fSAndroid Build Coastguard Worker   &a{ name = "a"; };
27*13e8728fSAndroid Build Coastguard Worker   ```
28*13e8728fSAndroid Build Coastguard Worker
29*13e8728fSAndroid Build Coastguard Workertestdata/${my_test_case}.add_ov_dts (optional)
30*13e8728fSAndroid Build Coastguard Worker - Additional device tree fragment source.
31*13e8728fSAndroid Build Coastguard Worker - Sample format:
32*13e8728fSAndroid Build Coastguard Worker   ```
33*13e8728fSAndroid Build Coastguard Worker   /dts-v1/ /plugin/;
34*13e8728fSAndroid Build Coastguard Worker   / {
35*13e8728fSAndroid Build Coastguard Worker     fragment@0{
36*13e8728fSAndroid Build Coastguard Worker        target = <&a>;
37*13e8728fSAndroid Build Coastguard Worker        __overlay__ {
38*13e8728fSAndroid Build Coastguard Worker          name = "a";
39*13e8728fSAndroid Build Coastguard Worker        };
40*13e8728fSAndroid Build Coastguard Worker     };
41*13e8728fSAndroid Build Coastguard Worker   };
42*13e8728fSAndroid Build Coastguard Worker   ```
43*13e8728fSAndroid Build Coastguard Worker
44*13e8728fSAndroid Build Coastguard Worker# Steps to run the test
45*13e8728fSAndroid Build Coastguard Worker
46*13e8728fSAndroid Build Coastguard WorkerSuppose you are at the root directory of your Android source.
47*13e8728fSAndroid Build Coastguard Worker
48*13e8728fSAndroid Build Coastguard Worker1. `source build/envsetup.sh`
49*13e8728fSAndroid Build Coastguard Worker2. `lunch`
50*13e8728fSAndroid Build Coastguard Worker3. `mmma system/libufdt`
51*13e8728fSAndroid Build Coastguard Worker4. `system/libufdt/tests/run_tests.sh`
52