1#!/usr/bin/env python2 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 10This tool converts a device tree binary file (.dtb) into two C files. The 11indent is to allow a C program to access data from the device tree without 12having to link against libfdt. By putting the data from the device tree into 13C structures, normal C code can be used. This helps to reduce the size of the 14compiled program. 15 16Dtoc produces two output files: 17 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. 21 22This tool is used in U-Boot to provide device tree data to SPL without 23increasing the code size of SPL. This supports the CONFIG_SPL_OF_PLATDATA 24options. For more information about the use of this options and tool please 25see doc/driver-model/of-plat.txt 26""" 27 28from optparse import OptionParser 29import os 30import sys 31import unittest 32 33# Bring in the patman libraries 34our_path = os.path.dirname(os.path.realpath(__file__)) 35sys.path.append(os.path.join(our_path, '../patman')) 36 37import dtb_platdata 38 39def run_tests(): 40 """Run all the test we have for dtoc""" 41 import test_dtoc 42 43 result = unittest.TestResult() 44 sys.argv = [sys.argv[0]] 45 for module in (test_dtoc.TestDtoc,): 46 suite = unittest.TestLoader().loadTestsFromTestCase(module) 47 suite.run(result) 48 49 print result 50 for _, err in result.errors: 51 print err 52 for _, err in result.failures: 53 print err 54 55if __name__ != '__main__': 56 sys.exit(1) 57 58parser = OptionParser() 59parser.add_option('-d', '--dtb-file', action='store', 60 help='Specify the .dtb input file') 61parser.add_option('--include-disabled', action='store_true', 62 help='Include disabled nodes') 63parser.add_option('-o', '--output', action='store', default='-', 64 help='Select output filename') 65parser.add_option('-t', '--test', action='store_true', dest='test', 66 default=False, help='run tests') 67(options, args) = parser.parse_args() 68 69# Run our meagre tests 70if options.test: 71 run_tests() 72 73else: 74 dtb_platdata.run_steps(args, options.dtb_file, options.include_disabled, 75 options.output) 76