3 # Licensed under the terms of the GNU GPL License version 2 or later.
5 # Author: Peter Tyser <ptyser@xes-inc.com>
7 # U-Boot firmware supports the booting of images in the Flattened Image
8 # Tree (FIT) format. The FIT format uses a device tree structure to
9 # describe a kernel image, device tree blob, ramdisk, etc. This script
10 # creates an Image Tree Source (.its file) which can be passed to the
11 # 'mkimage' utility to generate an Image Tree Blob (.itb file). The .itb
12 # file can then be booted by U-Boot (or other bootloaders which support
13 # FIT images). See doc/uImage.FIT/howto.txt in U-Boot source code for
14 # additional information on FIT images.
18 echo "Usage: `basename $0` -A arch -C comp -a addr -e entry" \
19 "-v version -k kernel [-D name -d dtb] -o its_file"
20 echo -e "\t-A ==> set architecture to 'arch'"
21 echo -e "\t-C ==> set compression type 'comp'"
22 echo -e "\t-a ==> set load address to 'addr' (hex)"
23 echo -e "\t-e ==> set entry point to 'entry' (hex)"
24 echo -e "\t-v ==> set kernel version to 'version'"
25 echo -e "\t-k ==> include kernel image 'kernel'"
26 echo -e "\t-D ==> human friendly Device Tree Blob 'name'"
27 echo -e "\t-d ==> include Device Tree Blob 'dtb'"
28 echo -e "\t-o ==> create output file 'its_file'"
32 while getopts ":A:a:C:D:d:e:k:o:v:" OPTION
36 a ) LOAD_ADDR=$OPTARG;;
37 C ) COMPRESS=$OPTARG;;
40 e ) ENTRY_ADDR=$OPTARG;;
44 * ) echo "Invalid option passed to '$0' (options:$@)"
49 # Make sure user entered all required parameters
50 if [ -z "${ARCH}" ] || [ -z "${COMPRESS}" ] || [ -z "${LOAD_ADDR}" ] || \
51 [ -z "${ENTRY_ADDR}" ] || [ -z "${VERSION}" ] || [ -z "${KERNEL}" ] || \
52 [ -z "${OUTPUT}" ]; then
56 ARCH_UPPER=`echo $ARCH | tr '[:lower:]' '[:upper:]'`
58 # Conditionally create fdt information
59 if [ -n "${DTB}" ]; then
62 description = \"${ARCH_UPPER} OpenWrt ${DEVICE} device tree blob\";
63 data = /incbin/(\"${DTB}\");
66 compression = \"none\";
77 # Create a default, fully populated DTS file
81 description = \"${ARCH_UPPER} OpenWrt FIT (Flattened Image Tree)\";
86 description = \"${ARCH_UPPER} OpenWrt Linux-${VERSION}\";
87 data = /incbin/(\"${KERNEL}\");
91 compression = \"${COMPRESS}\";
92 load = <${LOAD_ADDR}>;
93 entry = <${ENTRY_ADDR}>;
107 default = \"config@1\";
109 description = \"OpenWrt\";
110 kernel = \"kernel@1\";
116 # Write .its file to disk
117 echo "$DATA" > ${OUTPUT}