1 # Copyright (c) 2016 Google, Inc
2 # Written by Simon Glass <sjg@chromium.org>
4 # SPDX-License-Identifier: GPL-2.0+
6 # Creates binary images from input files controlled by a description
9 from collections import OrderedDict
18 from image import Image
21 # List of images we plan to create
22 # Make this global so that it can be referenced from tests
23 images = OrderedDict()
25 def _ReadImageDesc(binman_node):
26 """Read the image descriptions from the /binman node
28 This normally produces a single Image object called 'image'. But if
29 multiple images are present, they will all be returned.
32 binman_node: Node object of the /binman node
34 OrderedDict of Image objects, each of which describes an image
36 images = OrderedDict()
37 if 'multiple-images' in binman_node.props:
38 for node in binman_node.subnodes:
39 images[node.name] = Image(node.name, node)
41 images['image'] = Image('image', binman_node)
44 def _FindBinmanNode(dtb):
45 """Find the 'binman' node in the device tree
48 dtb: Fdt object to scan
50 Node object of /binman node, or None if not found
52 for node in dtb.GetRoot().subnodes:
53 if node.name == 'binman':
57 def Binman(options, args):
58 """The main control code for binman
60 This assumes that help and test options have already been dealt with. It
61 deals with the core task of building images.
64 options: Command line options object
65 args: Command line arguments (list of strings)
70 pager = os.getenv('PAGER')
73 fname = os.path.join(os.path.dirname(os.path.realpath(sys.argv[0])),
75 command.Run(pager, fname)
78 # Try to figure out which device tree contains our image description
80 dtb_fname = options.dt
84 raise ValueError('Must provide a board to process (use -b <board>)')
85 board_pathname = os.path.join(options.build_dir, board)
86 dtb_fname = os.path.join(board_pathname, 'u-boot.dtb')
89 options.indir.append(board_pathname)
92 tout.Init(options.verbosity)
93 elf.debug = options.debug
95 tools.SetInputDirs(options.indir)
96 tools.PrepareOutputDir(options.outdir, options.preserve)
97 dtb = fdt.FdtScan(dtb_fname)
98 node = _FindBinmanNode(dtb)
100 raise ValueError("Device tree '%s' does not have a 'binman' "
102 images = _ReadImageDesc(node)
103 for image in images.values():
104 # Perform all steps for this image, including checking and
105 # writing it. This means that errors found with a later
106 # image will be reported after earlier images are already
107 # completed and written, but that does not seem important.
108 image.GetEntryContents()
109 image.GetEntryPositions()
113 image.ProcessEntryContents()
117 tools.FinaliseOutputDir()