#!/usr/bin/env python2
|
#
|
# Copyright (C) 2016 Google, Inc
|
# Written by Simon Glass <sjg@chromium.org>
|
#
|
# SPDX-License-Identifier: GPL-2.0+
|
#
|
|
"""Device tree to C tool
|
|
This tool converts a device tree binary file (.dtb) into two C files. The
|
indent is to allow a C program to access data from the device tree without
|
having to link against libfdt. By putting the data from the device tree into
|
C structures, normal C code can be used. This helps to reduce the size of the
|
compiled program.
|
|
Dtoc produces two output files:
|
|
dt-structs.h - contains struct definitions
|
dt-platdata.c - contains data from the device tree using the struct
|
definitions, as well as U-Boot driver definitions.
|
|
This tool is used in U-Boot to provide device tree data to SPL without
|
increasing the code size of SPL. This supports the CONFIG_SPL_OF_PLATDATA
|
options. For more information about the use of this options and tool please
|
see doc/driver-model/of-plat.txt
|
"""
|
|
from optparse import OptionParser
|
import os
|
import sys
|
import unittest
|
|
# Bring in the patman libraries
|
our_path = os.path.dirname(os.path.realpath(__file__))
|
sys.path.append(os.path.join(our_path, '../patman'))
|
|
import dtb_platdata
|
|
def run_tests():
|
"""Run all the test we have for dtoc"""
|
import test_dtoc
|
|
result = unittest.TestResult()
|
sys.argv = [sys.argv[0]]
|
for module in (test_dtoc.TestDtoc,):
|
suite = unittest.TestLoader().loadTestsFromTestCase(module)
|
suite.run(result)
|
|
print result
|
for _, err in result.errors:
|
print err
|
for _, err in result.failures:
|
print err
|
|
if __name__ != '__main__':
|
sys.exit(1)
|
|
parser = OptionParser()
|
parser.add_option('-d', '--dtb-file', action='store',
|
help='Specify the .dtb input file')
|
parser.add_option('--include-disabled', action='store_true',
|
help='Include disabled nodes')
|
parser.add_option('-o', '--output', action='store', default='-',
|
help='Select output filename')
|
parser.add_option('-t', '--test', action='store_true', dest='test',
|
default=False, help='run tests')
|
(options, args) = parser.parse_args()
|
|
# Run our meagre tests
|
if options.test:
|
run_tests()
|
|
else:
|
dtb_platdata.run_steps(args, options.dtb_file, options.include_disabled,
|
options.output)
|
