2 * Copyright (c) 2013, Google Inc.
4 * (C) Copyright 2008 Semihalf
6 * (C) Copyright 2000-2006
7 * Wolfgang Denk, DENX Software Engineering, wd@denx.de.
9 * SPDX-License-Identifier: GPL-2.0+
16 #include <linux/compiler.h>
17 #include <linux/kconfig.h>
22 DECLARE_GLOBAL_DATA_PTR;
23 #endif /* !USE_HOSTCC*/
26 #include <bootstage.h>
27 #include <u-boot/crc.h>
28 #include <u-boot/md5.h>
29 #include <u-boot/sha1.h>
30 #include <u-boot/sha256.h>
32 /*****************************************************************************/
33 /* New uImage format routines */
34 /*****************************************************************************/
36 static int fit_parse_spec(const char *spec, char sepc, ulong addr_curr,
37 ulong *addr, const char **name)
44 sep = strchr(spec, sepc);
47 *addr = simple_strtoul(spec, NULL, 16);
57 * fit_parse_conf - parse FIT configuration spec
58 * @spec: input string, containing configuration spec
59 * @add_curr: current image address (to be used as a possible default)
60 * @addr: pointer to a ulong variable, will hold FIT image address of a given
62 * @conf_name double pointer to a char, will hold pointer to a configuration
65 * fit_parse_conf() expects configuration spec in the form of [<addr>]#<conf>,
66 * where <addr> is a FIT image address that contains configuration
67 * with a <conf> unit name.
69 * Address part is optional, and if omitted default add_curr will
73 * 1 if spec is a valid configuration string,
74 * addr and conf_name are set accordingly
77 int fit_parse_conf(const char *spec, ulong addr_curr,
78 ulong *addr, const char **conf_name)
80 return fit_parse_spec(spec, '#', addr_curr, addr, conf_name);
84 * fit_parse_subimage - parse FIT subimage spec
85 * @spec: input string, containing subimage spec
86 * @add_curr: current image address (to be used as a possible default)
87 * @addr: pointer to a ulong variable, will hold FIT image address of a given
89 * @image_name: double pointer to a char, will hold pointer to a subimage name
91 * fit_parse_subimage() expects subimage spec in the form of
92 * [<addr>]:<subimage>, where <addr> is a FIT image address that contains
93 * subimage with a <subimg> unit name.
95 * Address part is optional, and if omitted default add_curr will
99 * 1 if spec is a valid subimage string,
100 * addr and image_name are set accordingly
103 int fit_parse_subimage(const char *spec, ulong addr_curr,
104 ulong *addr, const char **image_name)
106 return fit_parse_spec(spec, ':', addr_curr, addr, image_name);
108 #endif /* !USE_HOSTCC */
110 static void fit_get_debug(const void *fit, int noffset,
111 char *prop_name, int err)
113 debug("Can't get '%s' property from FIT 0x%08lx, node: offset %d, name %s (%s)\n",
114 prop_name, (ulong)fit, noffset, fit_get_name(fit, noffset, NULL),
119 * fit_get_subimage_count - get component (sub-image) count
120 * @fit: pointer to the FIT format image header
121 * @images_noffset: offset of images node
124 * number of image components
126 int fit_get_subimage_count(const void *fit, int images_noffset)
132 /* Process its subnodes, print out component images details */
133 for (ndepth = 0, count = 0,
134 noffset = fdt_next_node(fit, images_noffset, &ndepth);
135 (noffset >= 0) && (ndepth > 0);
136 noffset = fdt_next_node(fit, noffset, &ndepth)) {
145 #if !defined(CONFIG_SPL_BUILD) || defined(CONFIG_FIT_SPL_PRINT)
147 * fit_print_contents - prints out the contents of the FIT format image
148 * @fit: pointer to the FIT format image header
149 * @p: pointer to prefix string
151 * fit_print_contents() formats a multi line FIT image contents description.
152 * The routine prints out FIT image properties (root node level) followed by
153 * the details of each component image.
156 * no returned results
158 void fit_print_contents(const void *fit)
171 /* Indent string is defined in header image.h */
172 p = IMAGE_INDENT_STRING;
174 /* Root node properties */
175 ret = fit_get_desc(fit, 0, &desc);
176 printf("%sFIT description: ", p);
178 printf("unavailable\n");
180 printf("%s\n", desc);
182 if (IMAGE_ENABLE_TIMESTAMP) {
183 ret = fit_get_timestamp(fit, 0, ×tamp);
184 printf("%sCreated: ", p);
186 printf("unavailable\n");
188 genimg_print_time(timestamp);
191 /* Find images parent node offset */
192 images_noffset = fdt_path_offset(fit, FIT_IMAGES_PATH);
193 if (images_noffset < 0) {
194 printf("Can't find images parent node '%s' (%s)\n",
195 FIT_IMAGES_PATH, fdt_strerror(images_noffset));
199 /* Process its subnodes, print out component images details */
200 for (ndepth = 0, count = 0,
201 noffset = fdt_next_node(fit, images_noffset, &ndepth);
202 (noffset >= 0) && (ndepth > 0);
203 noffset = fdt_next_node(fit, noffset, &ndepth)) {
206 * Direct child node of the images parent node,
207 * i.e. component image node.
209 printf("%s Image %u (%s)\n", p, count++,
210 fit_get_name(fit, noffset, NULL));
212 fit_image_print(fit, noffset, p);
216 /* Find configurations parent node offset */
217 confs_noffset = fdt_path_offset(fit, FIT_CONFS_PATH);
218 if (confs_noffset < 0) {
219 debug("Can't get configurations parent node '%s' (%s)\n",
220 FIT_CONFS_PATH, fdt_strerror(confs_noffset));
224 /* get default configuration unit name from default property */
225 uname = (char *)fdt_getprop(fit, noffset, FIT_DEFAULT_PROP, NULL);
227 printf("%s Default Configuration: '%s'\n", p, uname);
229 /* Process its subnodes, print out configurations details */
230 for (ndepth = 0, count = 0,
231 noffset = fdt_next_node(fit, confs_noffset, &ndepth);
232 (noffset >= 0) && (ndepth > 0);
233 noffset = fdt_next_node(fit, noffset, &ndepth)) {
236 * Direct child node of the configurations parent node,
237 * i.e. configuration node.
239 printf("%s Configuration %u (%s)\n", p, count++,
240 fit_get_name(fit, noffset, NULL));
242 fit_conf_print(fit, noffset, p);
248 * fit_image_print_data() - prints out the hash node details
249 * @fit: pointer to the FIT format image header
250 * @noffset: offset of the hash node
251 * @p: pointer to prefix string
252 * @type: Type of information to print ("hash" or "sign")
254 * fit_image_print_data() lists properties for the processed hash node
256 * This function avoid using puts() since it prints a newline on the host
257 * but does not in U-Boot.
260 * no returned results
262 static void fit_image_print_data(const void *fit, int noffset, const char *p,
272 debug("%s %s node: '%s'\n", p, type,
273 fit_get_name(fit, noffset, NULL));
274 printf("%s %s algo: ", p, type);
275 if (fit_image_hash_get_algo(fit, noffset, &algo)) {
276 printf("invalid/unsupported\n");
280 keyname = fdt_getprop(fit, noffset, "key-name-hint", NULL);
281 required = fdt_getprop(fit, noffset, "required", NULL) != NULL;
283 printf(":%s", keyname);
285 printf(" (required)");
288 ret = fit_image_hash_get_value(fit, noffset, &value,
290 printf("%s %s value: ", p, type);
292 printf("unavailable\n");
294 for (i = 0; i < value_len; i++)
295 printf("%02x", value[i]);
299 debug("%s %s len: %d\n", p, type, value_len);
301 /* Signatures have a time stamp */
302 if (IMAGE_ENABLE_TIMESTAMP && keyname) {
305 printf("%s Timestamp: ", p);
306 if (fit_get_timestamp(fit, noffset, ×tamp))
307 printf("unavailable\n");
309 genimg_print_time(timestamp);
314 * fit_image_print_verification_data() - prints out the hash/signature details
315 * @fit: pointer to the FIT format image header
316 * @noffset: offset of the hash or signature node
317 * @p: pointer to prefix string
319 * This lists properties for the processed hash node
322 * no returned results
324 static void fit_image_print_verification_data(const void *fit, int noffset,
330 * Check subnode name, must be equal to "hash" or "signature".
331 * Multiple hash/signature nodes require unique unit node
332 * names, e.g. hash@1, hash@2, signature@1, signature@2, etc.
334 name = fit_get_name(fit, noffset, NULL);
335 if (!strncmp(name, FIT_HASH_NODENAME, strlen(FIT_HASH_NODENAME))) {
336 fit_image_print_data(fit, noffset, p, "Hash");
337 } else if (!strncmp(name, FIT_SIG_NODENAME,
338 strlen(FIT_SIG_NODENAME))) {
339 fit_image_print_data(fit, noffset, p, "Sign");
344 * fit_image_print - prints out the FIT component image details
345 * @fit: pointer to the FIT format image header
346 * @image_noffset: offset of the component image node
347 * @p: pointer to prefix string
349 * fit_image_print() lists all mandatory properties for the processed component
350 * image. If present, hash nodes are printed out as well. Load
351 * address for images of type firmware is also printed out. Since the load
352 * address is not mandatory for firmware images, it will be output as
353 * "unavailable" when not present.
356 * no returned results
358 void fit_image_print(const void *fit, int image_noffset, const char *p)
361 uint8_t type, arch, os, comp;
369 /* Mandatory properties */
370 ret = fit_get_desc(fit, image_noffset, &desc);
371 printf("%s Description: ", p);
373 printf("unavailable\n");
375 printf("%s\n", desc);
377 if (IMAGE_ENABLE_TIMESTAMP) {
380 ret = fit_get_timestamp(fit, 0, ×tamp);
381 printf("%s Created: ", p);
383 printf("unavailable\n");
385 genimg_print_time(timestamp);
388 fit_image_get_type(fit, image_noffset, &type);
389 printf("%s Type: %s\n", p, genimg_get_type_name(type));
391 fit_image_get_comp(fit, image_noffset, &comp);
392 printf("%s Compression: %s\n", p, genimg_get_comp_name(comp));
394 ret = fit_image_get_data(fit, image_noffset, &data, &size);
397 printf("%s Data Start: ", p);
399 printf("unavailable\n");
401 void *vdata = (void *)data;
403 printf("0x%08lx\n", (ulong)map_to_sysmem(vdata));
407 printf("%s Data Size: ", p);
409 printf("unavailable\n");
411 genimg_print_size(size);
413 /* Remaining, type dependent properties */
414 if ((type == IH_TYPE_KERNEL) || (type == IH_TYPE_STANDALONE) ||
415 (type == IH_TYPE_RAMDISK) || (type == IH_TYPE_FIRMWARE) ||
416 (type == IH_TYPE_FLATDT)) {
417 fit_image_get_arch(fit, image_noffset, &arch);
418 printf("%s Architecture: %s\n", p, genimg_get_arch_name(arch));
421 if ((type == IH_TYPE_KERNEL) || (type == IH_TYPE_RAMDISK)) {
422 fit_image_get_os(fit, image_noffset, &os);
423 printf("%s OS: %s\n", p, genimg_get_os_name(os));
426 if ((type == IH_TYPE_KERNEL) || (type == IH_TYPE_STANDALONE) ||
427 (type == IH_TYPE_FIRMWARE) || (type == IH_TYPE_RAMDISK) ||
428 (type == IH_TYPE_FPGA)) {
429 ret = fit_image_get_load(fit, image_noffset, &load);
430 printf("%s Load Address: ", p);
432 printf("unavailable\n");
434 printf("0x%08lx\n", load);
437 if ((type == IH_TYPE_KERNEL) || (type == IH_TYPE_STANDALONE) ||
438 (type == IH_TYPE_RAMDISK)) {
439 ret = fit_image_get_entry(fit, image_noffset, &entry);
440 printf("%s Entry Point: ", p);
442 printf("unavailable\n");
444 printf("0x%08lx\n", entry);
447 /* Process all hash subnodes of the component image node */
448 for (ndepth = 0, noffset = fdt_next_node(fit, image_noffset, &ndepth);
449 (noffset >= 0) && (ndepth > 0);
450 noffset = fdt_next_node(fit, noffset, &ndepth)) {
452 /* Direct child node of the component image node */
453 fit_image_print_verification_data(fit, noffset, p);
458 #endif /* !defined(CONFIG_SPL_BUILD) || defined(CONFIG_FIT_SPL_PRINT) */
461 * fit_get_desc - get node description property
462 * @fit: pointer to the FIT format image header
463 * @noffset: node offset
464 * @desc: double pointer to the char, will hold pointer to the description
466 * fit_get_desc() reads description property from a given node, if
467 * description is found pointer to it is returned in third call argument.
473 int fit_get_desc(const void *fit, int noffset, char **desc)
477 *desc = (char *)fdt_getprop(fit, noffset, FIT_DESC_PROP, &len);
479 fit_get_debug(fit, noffset, FIT_DESC_PROP, len);
487 * fit_get_timestamp - get node timestamp property
488 * @fit: pointer to the FIT format image header
489 * @noffset: node offset
490 * @timestamp: pointer to the time_t, will hold read timestamp
492 * fit_get_timestamp() reads timestamp property from given node, if timestamp
493 * is found and has a correct size its value is returned in third call
498 * -1, on property read failure
499 * -2, on wrong timestamp size
501 int fit_get_timestamp(const void *fit, int noffset, time_t *timestamp)
506 data = fdt_getprop(fit, noffset, FIT_TIMESTAMP_PROP, &len);
508 fit_get_debug(fit, noffset, FIT_TIMESTAMP_PROP, len);
511 if (len != sizeof(uint32_t)) {
512 debug("FIT timestamp with incorrect size of (%u)\n", len);
516 *timestamp = uimage_to_cpu(*((uint32_t *)data));
521 * fit_image_get_node - get node offset for component image of a given unit name
522 * @fit: pointer to the FIT format image header
523 * @image_uname: component image node unit name
525 * fit_image_get_node() finds a component image (within the '/images'
526 * node) of a provided unit name. If image is found its node offset is
527 * returned to the caller.
530 * image node offset when found (>=0)
531 * negative number on failure (FDT_ERR_* code)
533 int fit_image_get_node(const void *fit, const char *image_uname)
535 int noffset, images_noffset;
537 images_noffset = fdt_path_offset(fit, FIT_IMAGES_PATH);
538 if (images_noffset < 0) {
539 debug("Can't find images parent node '%s' (%s)\n",
540 FIT_IMAGES_PATH, fdt_strerror(images_noffset));
541 return images_noffset;
544 noffset = fdt_subnode_offset(fit, images_noffset, image_uname);
546 debug("Can't get node offset for image unit name: '%s' (%s)\n",
547 image_uname, fdt_strerror(noffset));
554 * fit_image_get_os - get os id for a given component image node
555 * @fit: pointer to the FIT format image header
556 * @noffset: component image node offset
557 * @os: pointer to the uint8_t, will hold os numeric id
559 * fit_image_get_os() finds os property in a given component image node.
560 * If the property is found, its (string) value is translated to the numeric
561 * id which is returned to the caller.
567 int fit_image_get_os(const void *fit, int noffset, uint8_t *os)
572 /* Get OS name from property data */
573 data = fdt_getprop(fit, noffset, FIT_OS_PROP, &len);
575 fit_get_debug(fit, noffset, FIT_OS_PROP, len);
580 /* Translate OS name to id */
581 *os = genimg_get_os_id(data);
586 * fit_image_get_arch - get arch id for a given component image node
587 * @fit: pointer to the FIT format image header
588 * @noffset: component image node offset
589 * @arch: pointer to the uint8_t, will hold arch numeric id
591 * fit_image_get_arch() finds arch property in a given component image node.
592 * If the property is found, its (string) value is translated to the numeric
593 * id which is returned to the caller.
599 int fit_image_get_arch(const void *fit, int noffset, uint8_t *arch)
604 /* Get architecture name from property data */
605 data = fdt_getprop(fit, noffset, FIT_ARCH_PROP, &len);
607 fit_get_debug(fit, noffset, FIT_ARCH_PROP, len);
612 /* Translate architecture name to id */
613 *arch = genimg_get_arch_id(data);
618 * fit_image_get_type - get type id for a given component image node
619 * @fit: pointer to the FIT format image header
620 * @noffset: component image node offset
621 * @type: pointer to the uint8_t, will hold type numeric id
623 * fit_image_get_type() finds type property in a given component image node.
624 * If the property is found, its (string) value is translated to the numeric
625 * id which is returned to the caller.
631 int fit_image_get_type(const void *fit, int noffset, uint8_t *type)
636 /* Get image type name from property data */
637 data = fdt_getprop(fit, noffset, FIT_TYPE_PROP, &len);
639 fit_get_debug(fit, noffset, FIT_TYPE_PROP, len);
644 /* Translate image type name to id */
645 *type = genimg_get_type_id(data);
650 * fit_image_get_comp - get comp id for a given component image node
651 * @fit: pointer to the FIT format image header
652 * @noffset: component image node offset
653 * @comp: pointer to the uint8_t, will hold comp numeric id
655 * fit_image_get_comp() finds comp property in a given component image node.
656 * If the property is found, its (string) value is translated to the numeric
657 * id which is returned to the caller.
663 int fit_image_get_comp(const void *fit, int noffset, uint8_t *comp)
668 /* Get compression name from property data */
669 data = fdt_getprop(fit, noffset, FIT_COMP_PROP, &len);
671 fit_get_debug(fit, noffset, FIT_COMP_PROP, len);
676 /* Translate compression name to id */
677 *comp = genimg_get_comp_id(data);
681 static int fit_image_get_address(const void *fit, int noffset, char *name,
688 cell = fdt_getprop(fit, noffset, name, &len);
690 fit_get_debug(fit, noffset, name, len);
694 if (len > sizeof(ulong)) {
695 printf("Unsupported %s address size\n", name);
700 /* Use load64 to avoid compiling warning for 32-bit target */
702 load64 = (load64 << 32) | uimage_to_cpu(*cell);
705 *load = (ulong)load64;
710 * fit_image_get_load() - get load addr property for given component image node
711 * @fit: pointer to the FIT format image header
712 * @noffset: component image node offset
713 * @load: pointer to the uint32_t, will hold load address
715 * fit_image_get_load() finds load address property in a given component
716 * image node. If the property is found, its value is returned to the caller.
722 int fit_image_get_load(const void *fit, int noffset, ulong *load)
724 return fit_image_get_address(fit, noffset, FIT_LOAD_PROP, load);
728 * fit_image_get_entry() - get entry point address property
729 * @fit: pointer to the FIT format image header
730 * @noffset: component image node offset
731 * @entry: pointer to the uint32_t, will hold entry point address
733 * This gets the entry point address property for a given component image
736 * fit_image_get_entry() finds entry point address property in a given
737 * component image node. If the property is found, its value is returned
744 int fit_image_get_entry(const void *fit, int noffset, ulong *entry)
746 return fit_image_get_address(fit, noffset, FIT_ENTRY_PROP, entry);
750 * fit_image_get_data - get data property and its size for a given component image node
751 * @fit: pointer to the FIT format image header
752 * @noffset: component image node offset
753 * @data: double pointer to void, will hold data property's data address
754 * @size: pointer to size_t, will hold data property's data size
756 * fit_image_get_data() finds data property in a given component image node.
757 * If the property is found its data start address and size are returned to
764 int fit_image_get_data(const void *fit, int noffset,
765 const void **data, size_t *size)
769 *data = fdt_getprop(fit, noffset, FIT_DATA_PROP, &len);
771 fit_get_debug(fit, noffset, FIT_DATA_PROP, len);
781 * fit_image_hash_get_algo - get hash algorithm name
782 * @fit: pointer to the FIT format image header
783 * @noffset: hash node offset
784 * @algo: double pointer to char, will hold pointer to the algorithm name
786 * fit_image_hash_get_algo() finds hash algorithm property in a given hash node.
787 * If the property is found its data start address is returned to the caller.
793 int fit_image_hash_get_algo(const void *fit, int noffset, char **algo)
797 *algo = (char *)fdt_getprop(fit, noffset, FIT_ALGO_PROP, &len);
799 fit_get_debug(fit, noffset, FIT_ALGO_PROP, len);
807 * fit_image_hash_get_value - get hash value and length
808 * @fit: pointer to the FIT format image header
809 * @noffset: hash node offset
810 * @value: double pointer to uint8_t, will hold address of a hash value data
811 * @value_len: pointer to an int, will hold hash data length
813 * fit_image_hash_get_value() finds hash value property in a given hash node.
814 * If the property is found its data start address and size are returned to
821 int fit_image_hash_get_value(const void *fit, int noffset, uint8_t **value,
826 *value = (uint8_t *)fdt_getprop(fit, noffset, FIT_VALUE_PROP, &len);
827 if (*value == NULL) {
828 fit_get_debug(fit, noffset, FIT_VALUE_PROP, len);
838 * fit_image_hash_get_ignore - get hash ignore flag
839 * @fit: pointer to the FIT format image header
840 * @noffset: hash node offset
841 * @ignore: pointer to an int, will hold hash ignore flag
843 * fit_image_hash_get_ignore() finds hash ignore property in a given hash node.
844 * If the property is found and non-zero, the hash algorithm is not verified by
845 * u-boot automatically.
848 * 0, on ignore not found
849 * value, on ignore found
851 static int fit_image_hash_get_ignore(const void *fit, int noffset, int *ignore)
856 value = (int *)fdt_getprop(fit, noffset, FIT_IGNORE_PROP, &len);
857 if (value == NULL || len != sizeof(int))
865 ulong fit_get_end(const void *fit)
867 return map_to_sysmem((void *)(fit + fdt_totalsize(fit)));
871 * fit_set_timestamp - set node timestamp property
872 * @fit: pointer to the FIT format image header
873 * @noffset: node offset
874 * @timestamp: timestamp value to be set
876 * fit_set_timestamp() attempts to set timestamp property in the requested
877 * node and returns operation status to the caller.
881 * -ENOSPC if no space in device tree, -1 for other error
883 int fit_set_timestamp(void *fit, int noffset, time_t timestamp)
888 t = cpu_to_uimage(timestamp);
889 ret = fdt_setprop(fit, noffset, FIT_TIMESTAMP_PROP, &t,
892 debug("Can't set '%s' property for '%s' node (%s)\n",
893 FIT_TIMESTAMP_PROP, fit_get_name(fit, noffset, NULL),
895 return ret == -FDT_ERR_NOSPACE ? -ENOSPC : -1;
902 * calculate_hash - calculate and return hash for provided input data
903 * @data: pointer to the input data
904 * @data_len: data length
905 * @algo: requested hash algorithm
906 * @value: pointer to the char, will hold hash value data (caller must
907 * allocate enough free space)
908 * value_len: length of the calculated hash
910 * calculate_hash() computes input data hash according to the requested
912 * Resulting hash value is placed in caller provided 'value' buffer, length
913 * of the calculated hash is returned via value_len pointer argument.
917 * -1, when algo is unsupported
919 int calculate_hash(const void *data, int data_len, const char *algo,
920 uint8_t *value, int *value_len)
922 if (IMAGE_ENABLE_CRC32 && strcmp(algo, "crc32") == 0) {
923 *((uint32_t *)value) = crc32_wd(0, data, data_len,
925 *((uint32_t *)value) = cpu_to_uimage(*((uint32_t *)value));
927 } else if (IMAGE_ENABLE_SHA1 && strcmp(algo, "sha1") == 0) {
928 sha1_csum_wd((unsigned char *)data, data_len,
929 (unsigned char *)value, CHUNKSZ_SHA1);
931 } else if (IMAGE_ENABLE_SHA256 && strcmp(algo, "sha256") == 0) {
932 sha256_csum_wd((unsigned char *)data, data_len,
933 (unsigned char *)value, CHUNKSZ_SHA256);
934 *value_len = SHA256_SUM_LEN;
935 } else if (IMAGE_ENABLE_MD5 && strcmp(algo, "md5") == 0) {
936 md5_wd((unsigned char *)data, data_len, value, CHUNKSZ_MD5);
939 debug("Unsupported hash alogrithm\n");
945 static int fit_image_check_hash(const void *fit, int noffset, const void *data,
946 size_t size, char **err_msgp)
948 uint8_t value[FIT_MAX_HASH_LEN];
957 if (fit_image_hash_get_algo(fit, noffset, &algo)) {
958 *err_msgp = "Can't get hash algo property";
963 if (IMAGE_ENABLE_IGNORE) {
964 fit_image_hash_get_ignore(fit, noffset, &ignore);
971 if (fit_image_hash_get_value(fit, noffset, &fit_value,
973 *err_msgp = "Can't get hash value property";
977 if (calculate_hash(data, size, algo, value, &value_len)) {
978 *err_msgp = "Unsupported hash algorithm";
982 if (value_len != fit_value_len) {
983 *err_msgp = "Bad hash value len";
985 } else if (memcmp(value, fit_value, value_len) != 0) {
986 *err_msgp = "Bad hash value";
994 * fit_image_verify - verify data integrity
995 * @fit: pointer to the FIT format image header
996 * @image_noffset: component image node offset
998 * fit_image_verify() goes over component image hash nodes,
999 * re-calculates each data hash and compares with the value stored in hash
1003 * 1, if all hashes are valid
1004 * 0, otherwise (or on error)
1006 int fit_image_verify(const void *fit, int image_noffset)
1015 /* Get image data and data length */
1016 if (fit_image_get_data(fit, image_noffset, &data, &size)) {
1017 err_msg = "Can't get image data/size";
1021 /* Verify all required signatures */
1022 if (IMAGE_ENABLE_VERIFY &&
1023 fit_image_verify_required_sigs(fit, image_noffset, data, size,
1024 gd_fdt_blob(), &verify_all)) {
1025 err_msg = "Unable to verify required signature";
1029 /* Process all hash subnodes of the component image node */
1030 fdt_for_each_subnode(noffset, fit, image_noffset) {
1031 const char *name = fit_get_name(fit, noffset, NULL);
1034 * Check subnode name, must be equal to "hash".
1035 * Multiple hash nodes require unique unit node
1036 * names, e.g. hash@1, hash@2, etc.
1038 if (!strncmp(name, FIT_HASH_NODENAME,
1039 strlen(FIT_HASH_NODENAME))) {
1040 if (fit_image_check_hash(fit, noffset, data, size,
1044 } else if (IMAGE_ENABLE_VERIFY && verify_all &&
1045 !strncmp(name, FIT_SIG_NODENAME,
1046 strlen(FIT_SIG_NODENAME))) {
1047 ret = fit_image_check_sig(fit, noffset, data,
1048 size, -1, &err_msg);
1051 * Show an indication on failure, but do not return
1052 * an error. Only keys marked 'required' can cause
1053 * an image validation failure. See the call to
1054 * fit_image_verify_required_sigs() above.
1063 if (noffset == -FDT_ERR_TRUNCATED || noffset == -FDT_ERR_BADSTRUCTURE) {
1064 err_msg = "Corrupted or truncated tree";
1071 printf(" error!\n%s for '%s' hash node in '%s' image node\n",
1072 err_msg, fit_get_name(fit, noffset, NULL),
1073 fit_get_name(fit, image_noffset, NULL));
1078 * fit_all_image_verify - verify data integrity for all images
1079 * @fit: pointer to the FIT format image header
1081 * fit_all_image_verify() goes over all images in the FIT and
1082 * for every images checks if all it's hashes are valid.
1085 * 1, if all hashes of all images are valid
1086 * 0, otherwise (or on error)
1088 int fit_all_image_verify(const void *fit)
1095 /* Find images parent node offset */
1096 images_noffset = fdt_path_offset(fit, FIT_IMAGES_PATH);
1097 if (images_noffset < 0) {
1098 printf("Can't find images parent node '%s' (%s)\n",
1099 FIT_IMAGES_PATH, fdt_strerror(images_noffset));
1103 /* Process all image subnodes, check hashes for each */
1104 printf("## Checking hash(es) for FIT Image at %08lx ...\n",
1106 for (ndepth = 0, count = 0,
1107 noffset = fdt_next_node(fit, images_noffset, &ndepth);
1108 (noffset >= 0) && (ndepth > 0);
1109 noffset = fdt_next_node(fit, noffset, &ndepth)) {
1112 * Direct child node of the images parent node,
1113 * i.e. component image node.
1115 printf(" Hash(es) for Image %u (%s): ", count,
1116 fit_get_name(fit, noffset, NULL));
1119 if (!fit_image_verify(fit, noffset))
1128 * fit_image_check_os - check whether image node is of a given os type
1129 * @fit: pointer to the FIT format image header
1130 * @noffset: component image node offset
1131 * @os: requested image os
1133 * fit_image_check_os() reads image os property and compares its numeric
1134 * id with the requested os. Comparison result is returned to the caller.
1137 * 1 if image is of given os type
1138 * 0 otherwise (or on error)
1140 int fit_image_check_os(const void *fit, int noffset, uint8_t os)
1144 if (fit_image_get_os(fit, noffset, &image_os))
1146 return (os == image_os);
1150 * fit_image_check_arch - check whether image node is of a given arch
1151 * @fit: pointer to the FIT format image header
1152 * @noffset: component image node offset
1153 * @arch: requested imagearch
1155 * fit_image_check_arch() reads image arch property and compares its numeric
1156 * id with the requested arch. Comparison result is returned to the caller.
1159 * 1 if image is of given arch
1160 * 0 otherwise (or on error)
1162 int fit_image_check_arch(const void *fit, int noffset, uint8_t arch)
1165 int aarch32_support = 0;
1167 #ifdef CONFIG_ARM64_SUPPORT_AARCH32
1168 aarch32_support = 1;
1171 if (fit_image_get_arch(fit, noffset, &image_arch))
1173 return (arch == image_arch) ||
1174 (arch == IH_ARCH_I386 && image_arch == IH_ARCH_X86_64) ||
1175 (arch == IH_ARCH_ARM64 && image_arch == IH_ARCH_ARM &&
1180 * fit_image_check_type - check whether image node is of a given type
1181 * @fit: pointer to the FIT format image header
1182 * @noffset: component image node offset
1183 * @type: requested image type
1185 * fit_image_check_type() reads image type property and compares its numeric
1186 * id with the requested type. Comparison result is returned to the caller.
1189 * 1 if image is of given type
1190 * 0 otherwise (or on error)
1192 int fit_image_check_type(const void *fit, int noffset, uint8_t type)
1196 if (fit_image_get_type(fit, noffset, &image_type))
1198 return (type == image_type);
1202 * fit_image_check_comp - check whether image node uses given compression
1203 * @fit: pointer to the FIT format image header
1204 * @noffset: component image node offset
1205 * @comp: requested image compression type
1207 * fit_image_check_comp() reads image compression property and compares its
1208 * numeric id with the requested compression type. Comparison result is
1209 * returned to the caller.
1212 * 1 if image uses requested compression
1213 * 0 otherwise (or on error)
1215 int fit_image_check_comp(const void *fit, int noffset, uint8_t comp)
1219 if (fit_image_get_comp(fit, noffset, &image_comp))
1221 return (comp == image_comp);
1225 * fit_check_format - sanity check FIT image format
1226 * @fit: pointer to the FIT format image header
1228 * fit_check_format() runs a basic sanity FIT image verification.
1229 * Routine checks for mandatory properties, nodes, etc.
1235 int fit_check_format(const void *fit)
1237 /* mandatory / node 'description' property */
1238 if (fdt_getprop(fit, 0, FIT_DESC_PROP, NULL) == NULL) {
1239 debug("Wrong FIT format: no description\n");
1243 if (IMAGE_ENABLE_TIMESTAMP) {
1244 /* mandatory / node 'timestamp' property */
1245 if (fdt_getprop(fit, 0, FIT_TIMESTAMP_PROP, NULL) == NULL) {
1246 debug("Wrong FIT format: no timestamp\n");
1251 /* mandatory subimages parent '/images' node */
1252 if (fdt_path_offset(fit, FIT_IMAGES_PATH) < 0) {
1253 debug("Wrong FIT format: no images parent node\n");
1262 * fit_conf_find_compat
1263 * @fit: pointer to the FIT format image header
1264 * @fdt: pointer to the device tree to compare against
1266 * fit_conf_find_compat() attempts to find the configuration whose fdt is the
1267 * most compatible with the passed in device tree.
1276 * |-o configurations
1284 * |-compatible = "foo,bar", "bim,bam"
1287 * |-compatible = "foo,bar",
1290 * |-compatible = "bim,bam", "baz,biz"
1292 * Configuration 1 would be picked because the first string in U-Boot's
1293 * compatible list, "foo,bar", matches a compatible string in the root of fdt1.
1294 * "bim,bam" in fdt2 matches the second string which isn't as good as fdt1.
1297 * offset to the configuration to use if one was found
1300 int fit_conf_find_compat(const void *fit, const void *fdt)
1303 int noffset, confs_noffset, images_noffset;
1304 const void *fdt_compat;
1306 int best_match_offset = 0;
1307 int best_match_pos = 0;
1309 confs_noffset = fdt_path_offset(fit, FIT_CONFS_PATH);
1310 images_noffset = fdt_path_offset(fit, FIT_IMAGES_PATH);
1311 if (confs_noffset < 0 || images_noffset < 0) {
1312 debug("Can't find configurations or images nodes.\n");
1316 fdt_compat = fdt_getprop(fdt, 0, "compatible", &fdt_compat_len);
1318 debug("Fdt for comparison has no \"compatible\" property.\n");
1323 * Loop over the configurations in the FIT image.
1325 for (noffset = fdt_next_node(fit, confs_noffset, &ndepth);
1326 (noffset >= 0) && (ndepth > 0);
1327 noffset = fdt_next_node(fit, noffset, &ndepth)) {
1329 const char *kfdt_name;
1331 const char *cur_fdt_compat;
1339 kfdt_name = fdt_getprop(fit, noffset, "fdt", &len);
1341 debug("No fdt property found.\n");
1344 kfdt_noffset = fdt_subnode_offset(fit, images_noffset,
1346 if (kfdt_noffset < 0) {
1347 debug("No image node named \"%s\" found.\n",
1352 * Get a pointer to this configuration's fdt.
1354 if (fit_image_get_data(fit, kfdt_noffset, &kfdt, &size)) {
1355 debug("Failed to get fdt \"%s\".\n", kfdt_name);
1359 len = fdt_compat_len;
1360 cur_fdt_compat = fdt_compat;
1362 * Look for a match for each U-Boot compatibility string in
1363 * turn in this configuration's fdt.
1365 for (i = 0; len > 0 &&
1366 (!best_match_offset || best_match_pos > i); i++) {
1367 int cur_len = strlen(cur_fdt_compat) + 1;
1369 if (!fdt_node_check_compatible(kfdt, 0,
1371 best_match_offset = noffset;
1376 cur_fdt_compat += cur_len;
1379 if (!best_match_offset) {
1380 debug("No match found.\n");
1384 return best_match_offset;
1388 * fit_conf_get_node - get node offset for configuration of a given unit name
1389 * @fit: pointer to the FIT format image header
1390 * @conf_uname: configuration node unit name
1392 * fit_conf_get_node() finds a configuration (within the '/configurations'
1393 * parent node) of a provided unit name. If configuration is found its node
1394 * offset is returned to the caller.
1396 * When NULL is provided in second argument fit_conf_get_node() will search
1397 * for a default configuration node instead. Default configuration node unit
1398 * name is retrieved from FIT_DEFAULT_PROP property of the '/configurations'
1402 * configuration node offset when found (>=0)
1403 * negative number on failure (FDT_ERR_* code)
1405 int fit_conf_get_node(const void *fit, const char *conf_uname)
1407 int noffset, confs_noffset;
1410 confs_noffset = fdt_path_offset(fit, FIT_CONFS_PATH);
1411 if (confs_noffset < 0) {
1412 debug("Can't find configurations parent node '%s' (%s)\n",
1413 FIT_CONFS_PATH, fdt_strerror(confs_noffset));
1414 return confs_noffset;
1417 if (conf_uname == NULL) {
1418 /* get configuration unit name from the default property */
1419 debug("No configuration specified, trying default...\n");
1420 conf_uname = (char *)fdt_getprop(fit, confs_noffset,
1421 FIT_DEFAULT_PROP, &len);
1422 if (conf_uname == NULL) {
1423 fit_get_debug(fit, confs_noffset, FIT_DEFAULT_PROP,
1427 debug("Found default configuration: '%s'\n", conf_uname);
1430 noffset = fdt_subnode_offset(fit, confs_noffset, conf_uname);
1432 debug("Can't get node offset for configuration unit name: '%s' (%s)\n",
1433 conf_uname, fdt_strerror(noffset));
1439 int fit_conf_get_prop_node(const void *fit, int noffset,
1440 const char *prop_name)
1445 /* get kernel image unit name from configuration kernel property */
1446 uname = (char *)fdt_getprop(fit, noffset, prop_name, &len);
1450 return fit_image_get_node(fit, uname);
1454 * fit_conf_print - prints out the FIT configuration details
1455 * @fit: pointer to the FIT format image header
1456 * @noffset: offset of the configuration node
1457 * @p: pointer to prefix string
1459 * fit_conf_print() lists all mandatory properties for the processed
1460 * configuration node.
1463 * no returned results
1465 void fit_conf_print(const void *fit, int noffset, const char *p)
1470 int loadables_index;
1472 /* Mandatory properties */
1473 ret = fit_get_desc(fit, noffset, &desc);
1474 printf("%s Description: ", p);
1476 printf("unavailable\n");
1478 printf("%s\n", desc);
1480 uname = fdt_getprop(fit, noffset, FIT_KERNEL_PROP, NULL);
1481 printf("%s Kernel: ", p);
1483 printf("unavailable\n");
1485 printf("%s\n", uname);
1487 /* Optional properties */
1488 uname = fdt_getprop(fit, noffset, FIT_RAMDISK_PROP, NULL);
1490 printf("%s Init Ramdisk: %s\n", p, uname);
1492 uname = fdt_getprop(fit, noffset, FIT_FDT_PROP, NULL);
1494 printf("%s FDT: %s\n", p, uname);
1496 uname = fdt_getprop(fit, noffset, FIT_FPGA_PROP, NULL);
1498 printf("%s FPGA: %s\n", p, uname);
1500 /* Print out all of the specified loadables */
1501 for (loadables_index = 0;
1502 uname = fdt_stringlist_get(fit, noffset, FIT_LOADABLE_PROP,
1503 loadables_index, NULL), uname;
1504 loadables_index++) {
1505 if (loadables_index == 0) {
1506 printf("%s Loadables: ", p);
1510 printf("%s\n", uname);
1514 static int fit_image_select(const void *fit, int rd_noffset, int verify)
1516 fit_image_print(fit, rd_noffset, " ");
1519 puts(" Verifying Hash Integrity ... ");
1520 if (!fit_image_verify(fit, rd_noffset)) {
1521 puts("Bad Data Hash\n");
1530 int fit_get_node_from_config(bootm_headers_t *images, const char *prop_name,
1537 debug("* %s: using config '%s' from image at 0x%08lx\n",
1538 prop_name, images->fit_uname_cfg, addr);
1540 /* Check whether configuration has this property defined */
1541 fit_hdr = map_sysmem(addr, 0);
1542 cfg_noffset = fit_conf_get_node(fit_hdr, images->fit_uname_cfg);
1543 if (cfg_noffset < 0) {
1544 debug("* %s: no such config\n", prop_name);
1548 noffset = fit_conf_get_prop_node(fit_hdr, cfg_noffset, prop_name);
1550 debug("* %s: no '%s' in config\n", prop_name, prop_name);
1558 * fit_get_image_type_property() - get property name for IH_TYPE_...
1560 * @return the properly name where we expect to find the image in the
1563 static const char *fit_get_image_type_property(int type)
1566 * This is sort-of available in the uimage_type[] table in image.c
1567 * but we don't have access to the short name, and "fdt" is different
1568 * anyway. So let's just keep it here.
1571 case IH_TYPE_FLATDT:
1572 return FIT_FDT_PROP;
1573 case IH_TYPE_KERNEL:
1574 return FIT_KERNEL_PROP;
1575 case IH_TYPE_RAMDISK:
1576 return FIT_RAMDISK_PROP;
1577 case IH_TYPE_X86_SETUP:
1578 return FIT_SETUP_PROP;
1579 case IH_TYPE_LOADABLE:
1580 return FIT_LOADABLE_PROP;
1582 return FIT_FPGA_PROP;
1588 int fit_image_load(bootm_headers_t *images, ulong addr,
1589 const char **fit_unamep, const char **fit_uname_configp,
1590 int arch, int image_type, int bootstage_id,
1591 enum fit_load_op load_op, ulong *datap, ulong *lenp)
1593 int cfg_noffset, noffset;
1594 const char *fit_uname;
1595 const char *fit_uname_config;
1600 ulong load, data, len;
1605 const char *prop_name;
1608 fit = map_sysmem(addr, 0);
1609 fit_uname = fit_unamep ? *fit_unamep : NULL;
1610 fit_uname_config = fit_uname_configp ? *fit_uname_configp : NULL;
1611 prop_name = fit_get_image_type_property(image_type);
1612 printf("## Loading %s from FIT Image at %08lx ...\n", prop_name, addr);
1614 bootstage_mark(bootstage_id + BOOTSTAGE_SUB_FORMAT);
1615 if (!fit_check_format(fit)) {
1616 printf("Bad FIT %s image format!\n", prop_name);
1617 bootstage_error(bootstage_id + BOOTSTAGE_SUB_FORMAT);
1620 bootstage_mark(bootstage_id + BOOTSTAGE_SUB_FORMAT_OK);
1622 /* get FIT component image node offset */
1623 bootstage_mark(bootstage_id + BOOTSTAGE_SUB_UNIT_NAME);
1624 noffset = fit_image_get_node(fit, fit_uname);
1627 * no image node unit name, try to get config
1628 * node first. If config unit node name is NULL
1629 * fit_conf_get_node() will try to find default config node
1631 bootstage_mark(bootstage_id + BOOTSTAGE_SUB_NO_UNIT_NAME);
1632 if (IMAGE_ENABLE_BEST_MATCH && !fit_uname_config) {
1633 cfg_noffset = fit_conf_find_compat(fit, gd_fdt_blob());
1635 cfg_noffset = fit_conf_get_node(fit,
1638 if (cfg_noffset < 0) {
1639 puts("Could not find configuration node\n");
1640 bootstage_error(bootstage_id +
1641 BOOTSTAGE_SUB_NO_UNIT_NAME);
1644 fit_uname_config = fdt_get_name(fit, cfg_noffset, NULL);
1645 printf(" Using '%s' configuration\n", fit_uname_config);
1646 if (image_type == IH_TYPE_KERNEL) {
1647 /* Remember (and possibly verify) this config */
1648 images->fit_uname_cfg = fit_uname_config;
1649 if (IMAGE_ENABLE_VERIFY && images->verify) {
1650 puts(" Verifying Hash Integrity ... ");
1651 if (fit_config_verify(fit, cfg_noffset)) {
1652 puts("Bad Data Hash\n");
1653 bootstage_error(bootstage_id +
1654 BOOTSTAGE_SUB_HASH);
1659 bootstage_mark(BOOTSTAGE_ID_FIT_CONFIG);
1662 noffset = fit_conf_get_prop_node(fit, cfg_noffset,
1664 fit_uname = fit_get_name(fit, noffset, NULL);
1667 puts("Could not find subimage node\n");
1668 bootstage_error(bootstage_id + BOOTSTAGE_SUB_SUBNODE);
1672 printf(" Trying '%s' %s subimage\n", fit_uname, prop_name);
1674 ret = fit_image_select(fit, noffset, images->verify);
1676 bootstage_error(bootstage_id + BOOTSTAGE_SUB_HASH);
1680 bootstage_mark(bootstage_id + BOOTSTAGE_SUB_CHECK_ARCH);
1681 #if !defined(USE_HOSTCC) && !defined(CONFIG_SANDBOX)
1682 if (!fit_image_check_target_arch(fit, noffset)) {
1683 puts("Unsupported Architecture\n");
1684 bootstage_error(bootstage_id + BOOTSTAGE_SUB_CHECK_ARCH);
1690 fit_image_get_arch(fit, noffset, &os_arch);
1691 images->os.arch = os_arch;
1694 if (image_type == IH_TYPE_FLATDT &&
1695 !fit_image_check_comp(fit, noffset, IH_COMP_NONE)) {
1696 puts("FDT image is compressed");
1697 return -EPROTONOSUPPORT;
1700 bootstage_mark(bootstage_id + BOOTSTAGE_SUB_CHECK_ALL);
1701 type_ok = fit_image_check_type(fit, noffset, image_type) ||
1702 fit_image_check_type(fit, noffset, IH_TYPE_FIRMWARE) ||
1703 (image_type == IH_TYPE_KERNEL &&
1704 fit_image_check_type(fit, noffset, IH_TYPE_KERNEL_NOLOAD));
1706 os_ok = image_type == IH_TYPE_FLATDT ||
1707 image_type == IH_TYPE_FPGA ||
1708 fit_image_check_os(fit, noffset, IH_OS_LINUX) ||
1709 fit_image_check_os(fit, noffset, IH_OS_U_BOOT) ||
1710 fit_image_check_os(fit, noffset, IH_OS_OPENRTOS);
1713 * If either of the checks fail, we should report an error, but
1714 * if the image type is coming from the "loadables" field, we
1715 * don't care what it is
1717 if ((!type_ok || !os_ok) && image_type != IH_TYPE_LOADABLE) {
1718 fit_image_get_os(fit, noffset, &os);
1719 printf("No %s %s %s Image\n",
1720 genimg_get_os_name(os),
1721 genimg_get_arch_name(arch),
1722 genimg_get_type_name(image_type));
1723 bootstage_error(bootstage_id + BOOTSTAGE_SUB_CHECK_ALL);
1727 bootstage_mark(bootstage_id + BOOTSTAGE_SUB_CHECK_ALL_OK);
1729 /* get image data address and length */
1730 if (fit_image_get_data(fit, noffset, &buf, &size)) {
1731 printf("Could not find %s subimage data!\n", prop_name);
1732 bootstage_error(bootstage_id + BOOTSTAGE_SUB_GET_DATA);
1736 #if !defined(USE_HOSTCC) && defined(CONFIG_FIT_IMAGE_POST_PROCESS)
1737 /* perform any post-processing on the image data */
1738 board_fit_image_post_process((void **)&buf, &size);
1743 /* verify that image data is a proper FDT blob */
1744 if (image_type == IH_TYPE_FLATDT && fdt_check_header(buf)) {
1745 puts("Subimage data is not a FDT");
1749 bootstage_mark(bootstage_id + BOOTSTAGE_SUB_GET_DATA_OK);
1752 * Work-around for eldk-4.2 which gives this warning if we try to
1753 * cast in the unmap_sysmem() call:
1754 * warning: initialization discards qualifiers from pointer target type
1757 void *vbuf = (void *)buf;
1759 data = map_to_sysmem(vbuf);
1762 if (load_op == FIT_LOAD_IGNORED) {
1764 } else if (fit_image_get_load(fit, noffset, &load)) {
1765 if (load_op == FIT_LOAD_REQUIRED) {
1766 printf("Can't get %s subimage load address!\n",
1768 bootstage_error(bootstage_id + BOOTSTAGE_SUB_LOAD);
1771 } else if (load_op != FIT_LOAD_OPTIONAL_NON_ZERO || load) {
1772 ulong image_start, image_end;
1777 * move image data to the load address,
1778 * make sure we don't overwrite initial image
1781 image_end = addr + fit_get_size(fit);
1783 load_end = load + len;
1784 if (image_type != IH_TYPE_KERNEL &&
1785 load < image_end && load_end > image_start) {
1786 printf("Error: %s overwritten\n", prop_name);
1790 printf(" Loading %s from 0x%08lx to 0x%08lx\n",
1791 prop_name, data, load);
1793 dst = map_sysmem(load, len);
1794 memmove(dst, buf, len);
1797 bootstage_mark(bootstage_id + BOOTSTAGE_SUB_LOAD);
1802 *fit_unamep = (char *)fit_uname;
1803 if (fit_uname_configp)
1804 *fit_uname_configp = (char *)fit_uname_config;
1809 int boot_get_setup_fit(bootm_headers_t *images, uint8_t arch,
1810 ulong *setup_start, ulong *setup_len)
1817 addr = map_to_sysmem(images->fit_hdr_os);
1818 noffset = fit_get_node_from_config(images, FIT_SETUP_PROP, addr);
1822 ret = fit_image_load(images, addr, NULL, NULL, arch,
1823 IH_TYPE_X86_SETUP, BOOTSTAGE_ID_FIT_SETUP_START,
1824 FIT_LOAD_REQUIRED, setup_start, &len);