scripts/mkits.sh

   1 #!/bin/bash
   2 #
   3 # Licensed under the terms of the GNU GPL License version 2 or later.
   4 #
   5 # Author: Peter Tyser <ptyser@xes-inc.com>
   6 #
   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.
  15 #
  16
  17 usage() {
  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'"
  29         exit 1
  30 }
  31
  32 while getopts ":A:a:C:D:d:e:k:o:v:" OPTION
  33 do
  34         case $OPTION in
  35                 A ) ARCH=$OPTARG;;
  36                 a ) LOAD_ADDR=$OPTARG;;
  37                 C ) COMPRESS=$OPTARG;;
  38                 D ) DEVICE=$OPTARG;;
  39                 d ) DTB=$OPTARG;;
  40                 e ) ENTRY_ADDR=$OPTARG;;
  41                 k ) KERNEL=$OPTARG;;
  42                 o ) OUTPUT=$OPTARG;;
  43                 v ) VERSION=$OPTARG;;
  44                 * ) echo "Invalid option passed to '$0' (options:$@)"
  45                 usage;;
  46         esac
  47 done
  48
  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
  53         usage
  54 fi
  55
  56 ARCH_UPPER=`echo $ARCH | tr '[:lower:]' '[:upper:]'`
  57
  58 # Create a default, fully populated DTS file
  59 DATA="/dts-v1/;
  60
  61 / {
  62         description = \"${ARCH_UPPER} OpenWrt FIT (Flattened Image Tree)\";
  63         #address-cells = <1>;
  64
  65         images {
  66                 kernel@1 {
  67                         description = \"${ARCH_UPPER} OpenWrt Linux-${VERSION}\";
  68                         data = /incbin/(\"${KERNEL}\");
  69                         type = \"kernel\";
  70                         arch = \"${ARCH}\";
  71                         os = \"linux\";
  72                         compression = \"${COMPRESS}\";
  73                         load = <${LOAD_ADDR}>;
  74                         entry = <${ENTRY_ADDR}>;
  75                         hash@1 {
  76                                 algo = \"crc32\";
  77                         };
  78                         hash@2 {
  79                                 algo = \"sha1\";
  80                         };
  81                 };
  82
  83                 fdt@1 {
  84                         description = \"${ARCH_UPPER} OpenWrt ${DEVICE} device tree blob\";
  85                         data = /incbin/(\"${DTB}\");
  86                         type = \"flat_dt\";
  87                         arch = \"${ARCH}\";
  88                         compression = \"none\";
  89                         hash@1 {
  90                                 algo = \"crc32\";
  91                         };
  92                         hash@2 {
  93                                 algo = \"sha1\";
  94                         };
  95                 };
  96         };
  97
  98         configurations {
  99                 default = \"config@1\";
 100                 config@1 {
 101                         description = \"OpenWrt\";
 102                         kernel = \"kernel@1\";
 103                         fdt = \"fdt@1\";
 104                 };
 105         };
 106 };"
 107
 108 # Conditionally strip fdt information out of tree
 109 if [ -z "${DTB}" ]; then
 110         DATA=`echo "$DATA" | sed '/start fdt/,/end fdt/d'`
 111         DATA=`echo "$DATA" | sed '/fdt/d'`
 112 fi
 113
 114 # Write .its file to disk
 115 echo "$DATA" > ${OUTPUT}