tools/dtoc/main.py

   1 #!/usr/bin/env python3
   2 # SPDX-License-Identifier: GPL-2.0+
   3 #
   4 # Copyright (C) 2016 Google, Inc
   5 # Written by Simon Glass <sjg@chromium.org>
   6 #
   7
   8 """Device tree to C tool
   9
  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
  14 compiled program.
  15
  16 Dtoc produces several output files - see OUTPUT_FILES in dtb_platdata.py
  17
  18 This tool is used in U-Boot to provide device tree data to SPL without
  19 increasing the code size of SPL. This supports the CONFIG_SPL_OF_PLATDATA
  20 options. For more information about the use of this options and tool please
  21 see doc/driver-model/of-plat.rst
  22 """
  23
  24 from optparse import OptionParser
  25 import os
  26 import sys
  27 import unittest
  28
  29 # Bring in the patman libraries
  30 our_path = os.path.dirname(os.path.realpath(__file__))
  31 sys.path.append(os.path.join(our_path, '..'))
  32
  33 # Bring in the libfdt module
  34 sys.path.insert(0, 'scripts/dtc/pylibfdt')
  35 sys.path.insert(0, os.path.join(our_path,
  36                 '../../build-sandbox_spl/scripts/dtc/pylibfdt'))
  37
  38 from dtoc import dtb_platdata
  39 from patman import test_util
  40
  41 def run_tests(processes, args):
  42     """Run all the test we have for dtoc
  43
  44     Args:
  45         processes: Number of processes to use to run tests (None=same as #CPUs)
  46         args: List of positional args provided to dtoc. This can hold a test
  47             name to execute (as in 'dtoc -t test_empty_file', for example)
  48     """
  49     from dtoc import test_src_scan
  50     from dtoc import test_dtoc
  51
  52     result = unittest.TestResult()
  53     sys.argv = [sys.argv[0]]
  54     test_name = args and args[0] or None
  55
  56     test_dtoc.setup()
  57
  58     test_util.RunTestSuites(
  59         result, debug=True, verbosity=1, test_preserve_dirs=False,
  60         processes=processes, test_name=test_name, toolpath=[],
  61         test_class_list=[test_dtoc.TestDtoc,test_src_scan.TestSrcScan])
  62
  63     return test_util.ReportResult('binman', test_name, result)
  64
  65 def RunTestCoverage():
  66     """Run the tests and check that we get 100% coverage"""
  67     sys.argv = [sys.argv[0]]
  68     test_util.RunTestCoverage('tools/dtoc/dtoc', '/main.py',
  69             ['tools/patman/*.py', '*/fdt*', '*test*'], options.build_dir)
  70
  71
  72 if __name__ != '__main__':
  73     sys.exit(1)
  74
  75 parser = OptionParser()
  76 parser.add_option('-B', '--build-dir', type='string', default='b',
  77         help='Directory containing the build output')
  78 parser.add_option('-c', '--c-output-dir', action='store',
  79                   help='Select output directory for C files')
  80 parser.add_option('-C', '--h-output-dir', action='store',
  81                   help='Select output directory for H files (defaults to --c-output-di)')
  82 parser.add_option('-d', '--dtb-file', action='store',
  83                   help='Specify the .dtb input file')
  84 parser.add_option('-i', '--instantiate', action='store_true', default=False,
  85                   help='Instantiate devices to avoid needing device_bind()')
  86 parser.add_option('--include-disabled', action='store_true',
  87                   help='Include disabled nodes')
  88 parser.add_option('-o', '--output', action='store',
  89                   help='Select output filename')
  90 parser.add_option('-p', '--phase', type=str,
  91                   help='set phase of U-Boot this invocation is for (spl/tpl)')
  92 parser.add_option('-P', '--processes', type=int,
  93                   help='set number of processes to use for running tests')
  94 parser.add_option('-t', '--test', action='store_true', dest='test',
  95                   default=False, help='run tests')
  96 parser.add_option('-T', '--test-coverage', action='store_true',
  97                 default=False, help='run tests and check for 100% coverage')
  98 (options, args) = parser.parse_args()
  99
 100 # Run our meagre tests
 101 if options.test:
 102     ret_code = run_tests(options.processes, args)
 103     sys.exit(ret_code)
 104
 105 elif options.test_coverage:
 106     RunTestCoverage()
 107
 108 else:
 109     dtb_platdata.run_steps(args, options.dtb_file, options.include_disabled,
 110                            options.output,
 111                            [options.c_output_dir, options.h_output_dir],
 112                            options.phase, instantiate=options.instantiate)