221 lines
5.2 KiB
Bash
Executable File

#!/bin/sh
#
# Licensed under the terms of the GNU GPL License version 2 or later.
#
# Author: Peter Tyser <ptyser@xes-inc.com>
#
# U-Boot firmware supports the booting of images in the Flattened Image
# Tree (FIT) format. The FIT format uses a device tree structure to
# describe a kernel image, device tree blob, ramdisk, etc. This script
# creates an Image Tree Source (.its file) which can be passed to the
# 'mkimage' utility to generate an Image Tree Blob (.itb file). The .itb
# file can then be booted by U-Boot (or other bootloaders which support
# FIT images). See doc/uImage.FIT/howto.txt in U-Boot source code for
# additional information on FIT images.
#
usage() {
printf "Usage: %s -A arch -C comp -a addr -e entry" "$(basename "$0")"
printf " -v version -k kernel [-D name -n address -d dtb] -o its_file"
printf " [-s script] [-S key_name_hint] [-r ar_ver] [-R rootfs]"
printf "\n\t-A ==> set architecture to 'arch'"
printf "\n\t-C ==> set compression type 'comp'"
printf "\n\t-c ==> set config name 'config'"
printf "\n\t-a ==> set load address to 'addr' (hex)"
printf "\n\t-e ==> set entry point to 'entry' (hex)"
printf "\n\t-v ==> set kernel version to 'version'"
printf "\n\t-k ==> include kernel image 'kernel'"
printf "\n\t-D ==> human friendly Device Tree Blob 'name'"
printf "\n\t-n ==> fdt unit-address 'address'"
printf "\n\t-d ==> include Device Tree Blob 'dtb'"
printf "\n\t-o ==> create output file 'its_file'"
printf "\n\t-s ==> include u-boot script 'script'"
printf "\n\t-S ==> add signature at configurations and assign its key_name_hint by 'key_name_hint'"
printf "\n\t-r ==> set anti-rollback version to 'fw_ar_ver' (dec)"
printf "\n\t-R ==> specify rootfs file for embedding hash\n"
exit 1
}
FDTNUM=1
while getopts ":A:a:c:C:D:d:e:k:n:o:v:s:S:r:R:" OPTION
do
case $OPTION in
A ) ARCH=$OPTARG;;
a ) LOAD_ADDR=$OPTARG;;
c ) CONFIG=$OPTARG;;
C ) COMPRESS=$OPTARG;;
D ) DEVICE=$OPTARG;;
d ) DTB=$OPTARG;;
e ) ENTRY_ADDR=$OPTARG;;
k ) KERNEL=$OPTARG;;
n ) FDTNUM=$OPTARG;;
o ) OUTPUT=$OPTARG;;
v ) VERSION=$OPTARG;;
s ) UBOOT_SCRIPT=$OPTARG;;
S ) KEY_NAME_HINT=$OPTARG;;
r ) AR_VER=$OPTARG;;
R ) ROOTFS_FILE=$OPTARG;;
* ) echo "Invalid option passed to '$0' (options:$*)"
usage;;
esac
done
# Make sure user entered all required parameters
if [ -z "${ARCH}" ] || [ -z "${COMPRESS}" ] || [ -z "${LOAD_ADDR}" ] || \
[ -z "${ENTRY_ADDR}" ] || [ -z "${VERSION}" ] || [ -z "${KERNEL}" ] || \
[ -z "${OUTPUT}" ] || [ -z "${CONFIG}" ]; then
usage
fi
ARCH_UPPER=$(echo "$ARCH" | tr '[:lower:]' '[:upper:]')
# Conditionally create fdt information
if [ -n "${DTB}" ]; then
FDT_NODE="
fdt-$FDTNUM {
description = \"${ARCH_UPPER} OpenWrt ${DEVICE} device tree blob\";
data = /incbin/(\"${DTB}\");
type = \"flat_dt\";
arch = \"${ARCH}\";
compression = \"none\";
hash-1 {
algo = \"crc32\";
};
hash-2 {
algo = \"sha1\";
};
};
"
FDT_PROP="fdt = \"fdt-$FDTNUM\";"
fi
# Conditionally create rootfs hash information
if [ -f "${ROOTFS_FILE}" ]; then
ROOTFS_SIZE=$(stat -c %s ${ROOTFS_FILE})
ROOTFS_SHA1=$(sha1sum ${ROOTFS_FILE} | awk '{print "<0x"substr($0,1,8) " 0x"substr($0,9,8) " 0x"substr($0,17,8) " 0x"substr($0,25,8) " 0x"substr($0,33,8) ">"}')
ROOTFS_CRC32=$(crc32sum ${ROOTFS_FILE})
ROOTFS="
rootfs {
size = <${ROOTFS_SIZE}>;
hash-1 {
value = <0x${ROOTFS_CRC32}>;
algo = \"crc32\";
};
hash-2 {
value = ${ROOTFS_SHA1};
algo = \"sha1\";
};
};
"
ROOTFS_EXTRA_INFO="
rootfs_crc32 = \"${ROOTFS_CRC32}\";
rootfs_size = \"${ROOTFS_SIZE}\";
image_time = \"$(date +%s)\";
"
fi
# Conditionally create script information
if [ -n "${UBOOT_SCRIPT}" ]; then
SCRIPT="\
script-1 {
description = \"U-Boot Script\";
data = /incbin/(\"${UBOOT_SCRIPT}\");
type = \"script\";
arch = \"${ARCH}\";
os = \"linux\";
load = <0>;
entry = <0>;
compression = \"none\";
hash-1 {
algo = \"crc32\";
};
hash-2 {
algo = \"sha1\";
};
};\
"
LOADABLES="\
loadables = \"script-1\";\
"
SIGN_IMAGES="\
sign-images = \"fdt\", \"kernel\", \"loadables\";\
"
else
SIGN_IMAGES="\
sign-images = \"fdt\", \"kernel\";\
"
fi
# Conditionally create signature information
if [ -n "${KEY_NAME_HINT}" ]; then
SIGNATURE="\
signature {
algo = \"sha1,rsa2048\";
key-name-hint = \"${KEY_NAME_HINT}\";
${SIGN_IMAGES}
};\
"
fi
# Conditionally create anti-rollback version information
if [ -n "${AR_VER}" ]; then
FW_AR_VER="\
fw_ar_ver = <${AR_VER}>;\
"
fi
# Create a default, fully populated DTS file
DATA="/dts-v1/;
/ {
description = \"${ARCH_UPPER} OpenWrt FIT (Flattened Image Tree)\";
#address-cells = <1>;
${ROOTFS_EXTRA_INFO}
images {
kernel-1 {
description = \"${ARCH_UPPER} OpenWrt Linux-${VERSION}\";
data = /incbin/(\"${KERNEL}\");
type = \"kernel\";
arch = \"${ARCH}\";
os = \"linux\";
compression = \"${COMPRESS}\";
load = <${LOAD_ADDR}>;
entry = <${ENTRY_ADDR}>;
hash-1 {
algo = \"crc32\";
};
hash-2 {
algo = \"sha1\";
};
};
${FDT_NODE}
${SCRIPT}
};
${ROOTFS}
configurations {
default = \"${CONFIG}\";
${CONFIG} {
description = \"OpenWrt\";
${FW_AR_VER}
${LOADABLES}
kernel = \"kernel-1\";
${FDT_PROP}
${SIGNATURE}
};
};
};"
# Write .its file to disk
echo "$DATA" > "${OUTPUT}"