Combine Bitstreams at the Command Line

If you want to use a script to combine images at the command line, you can use the multi_image_merger.py script in the %EFINITY_HOME%\pgm\bin directory. The command is:

multi_image_merger.py [--help] [--mode MODE] [--type TYPE] [-ifile IFILE] [-iaddr IADDR]
    [--outfile OUTFILE]

Table 1. BRAM Initial Content Updater CLI Options
Option (long)	Option (short)	Input	Description
--help	-h	None	Show the help.
--mode	-m	generic_comb_image, daisy_chain, image, selectable_flash_image	Specifies which multi-image mode to use. Default: `selectable_flash_image`
--type	-t	internal, external	Specifies which type to use. For `selectable_flash_image` mode only. Default: `external`
--ifile	N/A	Filename	Image files. Can be specified multiple times; use this flag for each file you want to combine.
--iaddr	N/A	Hex number	Starting address. Can be specified multiple times.
--outfile	-o	Filename	Output bitstream file.

Combining Bitstream Images

multi_image_merger.py -m selectable_flash_image -t external -ifile file1.hex -iaddr 0x00
    -ifile file2.hex -iaddr 0x380000 -o output.bit
multi_image_merger.py -m selectable_flash_image -t internal -ifile file1.hex
    -ifile file2.hex -o output.bit
multi_image_merger.py -m daisy_chain_image -ifile file1.hex -ifile file2.hex -o output.bit
multi_image_merger.py -m generic_comb_image -ifile file1.hex -ifile file2.hex -iaddr 0x00
    -iaddr 0x380000 -o output.bit