2 # SPDX-License-Identifier: GPL-2.0+
4 # Copyright (C) 2016 Google, Inc
5 # Written by Simon Glass <sjg@chromium.org>
8 """Device tree to C tool
10 This tool converts a device tree binary file (.dtb) into two C files. The
11 indent is to allow a C program to access data from the device tree without
12 having to link against libfdt. By putting the data from the device tree into
13 C structures, normal C code can be used. This helps to reduce the size of the
16 Dtoc produces two output files:
18 dt-structs.h - contains struct definitions
19 dt-platdata.c - contains data from the device tree using the struct
20 definitions, as well as U-Boot driver definitions.
22 This tool is used in U-Boot to provide device tree data to SPL without
23 increasing the code size of SPL. This supports the CONFIG_SPL_OF_PLATDATA
24 options. For more information about the use of this options and tool please
25 see doc/driver-model/of-plat.txt
28 from optparse import OptionParser
33 # Bring in the patman libraries
34 our_path = os.path.dirname(os.path.realpath(__file__))
35 sys.path.append(os.path.join(our_path, '../patman'))
37 # Bring in the libfdt module
38 sys.path.insert(0, 'scripts/dtc/pylibfdt')
39 sys.path.insert(0, os.path.join(our_path,
40 '../../build-sandbox_spl/scripts/dtc/pylibfdt'))
46 """Run all the test we have for dtoc
49 args: List of positional args provided to dtoc. This can hold a test
50 name to execute (as in 'dtoc -t test_empty_file', for example)
54 result = unittest.TestResult()
55 sys.argv = [sys.argv[0]]
56 test_name = args and args[0] or None
57 for module in (test_dtoc.TestDtoc,):
60 suite = unittest.TestLoader().loadTestsFromName(test_name, module)
61 except AttributeError:
64 suite = unittest.TestLoader().loadTestsFromTestCase(module)
68 for _, err in result.errors:
70 for _, err in result.failures:
73 def RunTestCoverage():
74 """Run the tests and check that we get 100% coverage"""
75 sys.argv = [sys.argv[0]]
76 test_util.RunTestCoverage('tools/dtoc/dtoc.py', '/dtoc.py',
77 ['tools/patman/*.py', '*/fdt*', '*test*'], options.build_dir)
80 if __name__ != '__main__':
83 parser = OptionParser()
84 parser.add_option('-B', '--build-dir', type='string', default='b',
85 help='Directory containing the build output')
86 parser.add_option('-d', '--dtb-file', action='store',
87 help='Specify the .dtb input file')
88 parser.add_option('--include-disabled', action='store_true',
89 help='Include disabled nodes')
90 parser.add_option('-o', '--output', action='store', default='-',
91 help='Select output filename')
92 parser.add_option('-t', '--test', action='store_true', dest='test',
93 default=False, help='run tests')
94 parser.add_option('-T', '--test-coverage', action='store_true',
95 default=False, help='run tests and check for 100% coverage')
96 (options, args) = parser.parse_args()
98 # Run our meagre tests
102 elif options.test_coverage:
106 dtb_platdata.run_steps(args, options.dtb_file, options.include_disabled,