1 // SPDX-License-Identifier: GPL-2.0+
3 * Copyright (c) 2013, Google Inc.
5 * (C) Copyright 2008 Semihalf
7 * (C) Copyright 2000-2006
11 #define LOG_CATEGORY LOGC_BOOT
16 #include <linux/libfdt.h>
17 #include <u-boot/crc.h>
18 #include <linux/kconfig.h>
20 #include <linux/compiler.h>
21 #include <linux/sizes.h>
28 #include <asm/global_data.h>
31 #include <u-boot/hash.h>
33 DECLARE_GLOBAL_DATA_PTR;
34 #endif /* !USE_HOSTCC*/
38 #include <bootstage.h>
39 #include <u-boot/crc.h>
40 #include <u-boot/md5.h>
41 #include <u-boot/sha1.h>
42 #include <u-boot/sha256.h>
43 #include <u-boot/sha512.h>
45 /*****************************************************************************/
46 /* New uImage format routines */
47 /*****************************************************************************/
49 static int fit_parse_spec(const char *spec, char sepc, ulong addr_curr,
50 ulong *addr, const char **name)
57 sep = strchr(spec, sepc);
60 *addr = hextoul(spec, NULL);
70 * fit_parse_conf - parse FIT configuration spec
71 * @spec: input string, containing configuration spec
72 * @add_curr: current image address (to be used as a possible default)
73 * @addr: pointer to a ulong variable, will hold FIT image address of a given
75 * @conf_name double pointer to a char, will hold pointer to a configuration
78 * fit_parse_conf() expects configuration spec in the form of [<addr>]#<conf>,
79 * where <addr> is a FIT image address that contains configuration
80 * with a <conf> unit name.
82 * Address part is optional, and if omitted default add_curr will
86 * 1 if spec is a valid configuration string,
87 * addr and conf_name are set accordingly
90 int fit_parse_conf(const char *spec, ulong addr_curr,
91 ulong *addr, const char **conf_name)
93 return fit_parse_spec(spec, '#', addr_curr, addr, conf_name);
97 * fit_parse_subimage - parse FIT subimage spec
98 * @spec: input string, containing subimage spec
99 * @add_curr: current image address (to be used as a possible default)
100 * @addr: pointer to a ulong variable, will hold FIT image address of a given
102 * @image_name: double pointer to a char, will hold pointer to a subimage name
104 * fit_parse_subimage() expects subimage spec in the form of
105 * [<addr>]:<subimage>, where <addr> is a FIT image address that contains
106 * subimage with a <subimg> unit name.
108 * Address part is optional, and if omitted default add_curr will
112 * 1 if spec is a valid subimage string,
113 * addr and image_name are set accordingly
116 int fit_parse_subimage(const char *spec, ulong addr_curr,
117 ulong *addr, const char **image_name)
119 return fit_parse_spec(spec, ':', addr_curr, addr, image_name);
121 #endif /* !USE_HOSTCC */
124 /* Host tools use these implementations for Cipher and Signature support */
125 static void *host_blob;
127 void image_set_host_blob(void *blob)
132 void *image_get_host_blob(void)
136 #endif /* USE_HOSTCC */
138 static void fit_get_debug(const void *fit, int noffset,
139 char *prop_name, int err)
141 debug("Can't get '%s' property from FIT 0x%08lx, node: offset %d, name %s (%s)\n",
142 prop_name, (ulong)fit, noffset, fit_get_name(fit, noffset, NULL),
147 * fit_get_subimage_count - get component (sub-image) count
148 * @fit: pointer to the FIT format image header
149 * @images_noffset: offset of images node
152 * number of image components
154 int fit_get_subimage_count(const void *fit, int images_noffset)
160 /* Process its subnodes, print out component images details */
161 for (ndepth = 0, count = 0,
162 noffset = fdt_next_node(fit, images_noffset, &ndepth);
163 (noffset >= 0) && (ndepth > 0);
164 noffset = fdt_next_node(fit, noffset, &ndepth)) {
174 * fit_image_print_data() - prints out the hash node details
175 * @fit: pointer to the FIT format image header
176 * @noffset: offset of the hash node
177 * @p: pointer to prefix string
178 * @type: Type of information to print ("hash" or "sign")
180 * fit_image_print_data() lists properties for the processed hash node
182 * This function avoid using puts() since it prints a newline on the host
183 * but does not in U-Boot.
186 * no returned results
188 static void fit_image_print_data(const void *fit, int noffset, const char *p,
199 debug("%s %s node: '%s'\n", p, type,
200 fit_get_name(fit, noffset, NULL));
201 printf("%s %s algo: ", p, type);
202 if (fit_image_hash_get_algo(fit, noffset, &algo)) {
203 printf("invalid/unsupported\n");
207 keyname = fdt_getprop(fit, noffset, FIT_KEY_HINT, NULL);
208 required = fdt_getprop(fit, noffset, FIT_KEY_REQUIRED, NULL) != NULL;
210 printf(":%s", keyname);
212 printf(" (required)");
215 padding = fdt_getprop(fit, noffset, "padding", NULL);
217 printf("%s %s padding: %s\n", p, type, padding);
219 ret = fit_image_hash_get_value(fit, noffset, &value,
221 printf("%s %s value: ", p, type);
223 printf("unavailable\n");
225 for (i = 0; i < value_len; i++)
226 printf("%02x", value[i]);
230 debug("%s %s len: %d\n", p, type, value_len);
232 /* Signatures have a time stamp */
233 if (IMAGE_ENABLE_TIMESTAMP && keyname) {
236 printf("%s Timestamp: ", p);
237 if (fit_get_timestamp(fit, noffset, ×tamp))
238 printf("unavailable\n");
240 genimg_print_time(timestamp);
245 * fit_image_print_verification_data() - prints out the hash/signature details
246 * @fit: pointer to the FIT format image header
247 * @noffset: offset of the hash or signature node
248 * @p: pointer to prefix string
250 * This lists properties for the processed hash node
253 * no returned results
255 static void fit_image_print_verification_data(const void *fit, int noffset,
261 * Check subnode name, must be equal to "hash" or "signature".
262 * Multiple hash/signature nodes require unique unit node
263 * names, e.g. hash-1, hash-2, signature-1, signature-2, etc.
265 name = fit_get_name(fit, noffset, NULL);
266 if (!strncmp(name, FIT_HASH_NODENAME, strlen(FIT_HASH_NODENAME))) {
267 fit_image_print_data(fit, noffset, p, "Hash");
268 } else if (!strncmp(name, FIT_SIG_NODENAME,
269 strlen(FIT_SIG_NODENAME))) {
270 fit_image_print_data(fit, noffset, p, "Sign");
275 * fit_conf_print - prints out the FIT configuration details
276 * @fit: pointer to the FIT format image header
277 * @noffset: offset of the configuration node
278 * @p: pointer to prefix string
280 * fit_conf_print() lists all mandatory properties for the processed
281 * configuration node.
284 * no returned results
286 static void fit_conf_print(const void *fit, int noffset, const char *p)
291 int fdt_index, loadables_index;
294 /* Mandatory properties */
295 ret = fit_get_desc(fit, noffset, &desc);
296 printf("%s Description: ", p);
298 printf("unavailable\n");
300 printf("%s\n", desc);
302 uname = fdt_getprop(fit, noffset, FIT_KERNEL_PROP, NULL);
303 printf("%s Kernel: ", p);
305 printf("unavailable\n");
307 printf("%s\n", uname);
309 /* Optional properties */
310 uname = fdt_getprop(fit, noffset, FIT_RAMDISK_PROP, NULL);
312 printf("%s Init Ramdisk: %s\n", p, uname);
314 uname = fdt_getprop(fit, noffset, FIT_FIRMWARE_PROP, NULL);
316 printf("%s Firmware: %s\n", p, uname);
319 uname = fdt_stringlist_get(fit, noffset, FIT_FDT_PROP,
320 fdt_index, NULL), uname;
323 printf("%s FDT: ", p);
326 printf("%s\n", uname);
329 uname = fdt_getprop(fit, noffset, FIT_FPGA_PROP, NULL);
331 printf("%s FPGA: %s\n", p, uname);
333 /* Print out all of the specified loadables */
334 for (loadables_index = 0;
335 uname = fdt_stringlist_get(fit, noffset, FIT_LOADABLE_PROP,
336 loadables_index, NULL), uname;
338 if (loadables_index == 0) {
339 printf("%s Loadables: ", p);
343 printf("%s\n", uname);
346 /* Process all hash subnodes of the component configuration node */
347 for (ndepth = 0, noffset = fdt_next_node(fit, noffset, &ndepth);
348 (noffset >= 0) && (ndepth > 0);
349 noffset = fdt_next_node(fit, noffset, &ndepth)) {
351 /* Direct child node of the component configuration node */
352 fit_image_print_verification_data(fit, noffset, p);
358 * fit_print_contents - prints out the contents of the FIT format image
359 * @fit: pointer to the FIT format image header
360 * @p: pointer to prefix string
362 * fit_print_contents() formats a multi line FIT image contents description.
363 * The routine prints out FIT image properties (root node level) followed by
364 * the details of each component image.
367 * no returned results
369 void fit_print_contents(const void *fit)
382 if (!CONFIG_IS_ENABLED(FIT_PRINT))
385 /* Indent string is defined in header image.h */
386 p = IMAGE_INDENT_STRING;
388 /* Root node properties */
389 ret = fit_get_desc(fit, 0, &desc);
390 printf("%sFIT description: ", p);
392 printf("unavailable\n");
394 printf("%s\n", desc);
396 if (IMAGE_ENABLE_TIMESTAMP) {
397 ret = fit_get_timestamp(fit, 0, ×tamp);
398 printf("%sCreated: ", p);
400 printf("unavailable\n");
402 genimg_print_time(timestamp);
405 /* Find images parent node offset */
406 images_noffset = fdt_path_offset(fit, FIT_IMAGES_PATH);
407 if (images_noffset < 0) {
408 printf("Can't find images parent node '%s' (%s)\n",
409 FIT_IMAGES_PATH, fdt_strerror(images_noffset));
413 /* Process its subnodes, print out component images details */
414 for (ndepth = 0, count = 0,
415 noffset = fdt_next_node(fit, images_noffset, &ndepth);
416 (noffset >= 0) && (ndepth > 0);
417 noffset = fdt_next_node(fit, noffset, &ndepth)) {
420 * Direct child node of the images parent node,
421 * i.e. component image node.
423 printf("%s Image %u (%s)\n", p, count++,
424 fit_get_name(fit, noffset, NULL));
426 fit_image_print(fit, noffset, p);
430 /* Find configurations parent node offset */
431 confs_noffset = fdt_path_offset(fit, FIT_CONFS_PATH);
432 if (confs_noffset < 0) {
433 debug("Can't get configurations parent node '%s' (%s)\n",
434 FIT_CONFS_PATH, fdt_strerror(confs_noffset));
438 /* get default configuration unit name from default property */
439 uname = (char *)fdt_getprop(fit, noffset, FIT_DEFAULT_PROP, NULL);
441 printf("%s Default Configuration: '%s'\n", p, uname);
443 /* Process its subnodes, print out configurations details */
444 for (ndepth = 0, count = 0,
445 noffset = fdt_next_node(fit, confs_noffset, &ndepth);
446 (noffset >= 0) && (ndepth > 0);
447 noffset = fdt_next_node(fit, noffset, &ndepth)) {
450 * Direct child node of the configurations parent node,
451 * i.e. configuration node.
453 printf("%s Configuration %u (%s)\n", p, count++,
454 fit_get_name(fit, noffset, NULL));
456 fit_conf_print(fit, noffset, p);
462 * fit_image_print - prints out the FIT component image details
463 * @fit: pointer to the FIT format image header
464 * @image_noffset: offset of the component image node
465 * @p: pointer to prefix string
467 * fit_image_print() lists all mandatory properties for the processed component
468 * image. If present, hash nodes are printed out as well. Load
469 * address for images of type firmware is also printed out. Since the load
470 * address is not mandatory for firmware images, it will be output as
471 * "unavailable" when not present.
474 * no returned results
476 void fit_image_print(const void *fit, int image_noffset, const char *p)
479 uint8_t type, arch, os, comp = IH_COMP_NONE;
487 if (!CONFIG_IS_ENABLED(FIT_PRINT))
490 /* Mandatory properties */
491 ret = fit_get_desc(fit, image_noffset, &desc);
492 printf("%s Description: ", p);
494 printf("unavailable\n");
496 printf("%s\n", desc);
498 if (IMAGE_ENABLE_TIMESTAMP) {
501 ret = fit_get_timestamp(fit, 0, ×tamp);
502 printf("%s Created: ", p);
504 printf("unavailable\n");
506 genimg_print_time(timestamp);
509 fit_image_get_type(fit, image_noffset, &type);
510 printf("%s Type: %s\n", p, genimg_get_type_name(type));
512 fit_image_get_comp(fit, image_noffset, &comp);
513 printf("%s Compression: %s\n", p, genimg_get_comp_name(comp));
515 ret = fit_image_get_data_and_size(fit, image_noffset, &data, &size);
517 if (!tools_build()) {
518 printf("%s Data Start: ", p);
520 printf("unavailable\n");
522 void *vdata = (void *)data;
524 printf("0x%08lx\n", (ulong)map_to_sysmem(vdata));
528 printf("%s Data Size: ", p);
530 printf("unavailable\n");
532 genimg_print_size(size);
534 /* Remaining, type dependent properties */
535 if ((type == IH_TYPE_KERNEL) || (type == IH_TYPE_STANDALONE) ||
536 (type == IH_TYPE_RAMDISK) || (type == IH_TYPE_FIRMWARE) ||
537 (type == IH_TYPE_FLATDT)) {
538 fit_image_get_arch(fit, image_noffset, &arch);
539 printf("%s Architecture: %s\n", p, genimg_get_arch_name(arch));
542 if ((type == IH_TYPE_KERNEL) || (type == IH_TYPE_RAMDISK) ||
543 (type == IH_TYPE_FIRMWARE)) {
544 fit_image_get_os(fit, image_noffset, &os);
545 printf("%s OS: %s\n", p, genimg_get_os_name(os));
548 if ((type == IH_TYPE_KERNEL) || (type == IH_TYPE_STANDALONE) ||
549 (type == IH_TYPE_FIRMWARE) || (type == IH_TYPE_RAMDISK) ||
550 (type == IH_TYPE_FPGA)) {
551 ret = fit_image_get_load(fit, image_noffset, &load);
552 printf("%s Load Address: ", p);
554 printf("unavailable\n");
556 printf("0x%08lx\n", load);
559 /* optional load address for FDT */
560 if (type == IH_TYPE_FLATDT && !fit_image_get_load(fit, image_noffset, &load))
561 printf("%s Load Address: 0x%08lx\n", p, load);
563 if ((type == IH_TYPE_KERNEL) || (type == IH_TYPE_STANDALONE) ||
564 (type == IH_TYPE_RAMDISK)) {
565 ret = fit_image_get_entry(fit, image_noffset, &entry);
566 printf("%s Entry Point: ", p);
568 printf("unavailable\n");
570 printf("0x%08lx\n", entry);
573 /* Process all hash subnodes of the component image node */
574 for (ndepth = 0, noffset = fdt_next_node(fit, image_noffset, &ndepth);
575 (noffset >= 0) && (ndepth > 0);
576 noffset = fdt_next_node(fit, noffset, &ndepth)) {
578 /* Direct child node of the component image node */
579 fit_image_print_verification_data(fit, noffset, p);
585 * fit_get_desc - get node description property
586 * @fit: pointer to the FIT format image header
587 * @noffset: node offset
588 * @desc: double pointer to the char, will hold pointer to the description
590 * fit_get_desc() reads description property from a given node, if
591 * description is found pointer to it is returned in third call argument.
597 int fit_get_desc(const void *fit, int noffset, char **desc)
601 *desc = (char *)fdt_getprop(fit, noffset, FIT_DESC_PROP, &len);
603 fit_get_debug(fit, noffset, FIT_DESC_PROP, len);
611 * fit_get_timestamp - get node timestamp property
612 * @fit: pointer to the FIT format image header
613 * @noffset: node offset
614 * @timestamp: pointer to the time_t, will hold read timestamp
616 * fit_get_timestamp() reads timestamp property from given node, if timestamp
617 * is found and has a correct size its value is returned in third call
622 * -1, on property read failure
623 * -2, on wrong timestamp size
625 int fit_get_timestamp(const void *fit, int noffset, time_t *timestamp)
630 data = fdt_getprop(fit, noffset, FIT_TIMESTAMP_PROP, &len);
632 fit_get_debug(fit, noffset, FIT_TIMESTAMP_PROP, len);
635 if (len != sizeof(uint32_t)) {
636 debug("FIT timestamp with incorrect size of (%u)\n", len);
640 *timestamp = uimage_to_cpu(*((uint32_t *)data));
645 * fit_image_get_node - get node offset for component image of a given unit name
646 * @fit: pointer to the FIT format image header
647 * @image_uname: component image node unit name
649 * fit_image_get_node() finds a component image (within the '/images'
650 * node) of a provided unit name. If image is found its node offset is
651 * returned to the caller.
654 * image node offset when found (>=0)
655 * negative number on failure (FDT_ERR_* code)
657 int fit_image_get_node(const void *fit, const char *image_uname)
659 int noffset, images_noffset;
661 images_noffset = fdt_path_offset(fit, FIT_IMAGES_PATH);
662 if (images_noffset < 0) {
663 debug("Can't find images parent node '%s' (%s)\n",
664 FIT_IMAGES_PATH, fdt_strerror(images_noffset));
665 return images_noffset;
668 noffset = fdt_subnode_offset(fit, images_noffset, image_uname);
670 debug("Can't get node offset for image unit name: '%s' (%s)\n",
671 image_uname, fdt_strerror(noffset));
678 * fit_image_get_os - get os id for a given component image node
679 * @fit: pointer to the FIT format image header
680 * @noffset: component image node offset
681 * @os: pointer to the uint8_t, will hold os numeric id
683 * fit_image_get_os() finds os property in a given component image node.
684 * If the property is found, its (string) value is translated to the numeric
685 * id which is returned to the caller.
691 int fit_image_get_os(const void *fit, int noffset, uint8_t *os)
696 /* Get OS name from property data */
697 data = fdt_getprop(fit, noffset, FIT_OS_PROP, &len);
699 fit_get_debug(fit, noffset, FIT_OS_PROP, len);
704 /* Translate OS name to id */
705 *os = genimg_get_os_id(data);
710 * fit_image_get_arch - get arch id for a given component image node
711 * @fit: pointer to the FIT format image header
712 * @noffset: component image node offset
713 * @arch: pointer to the uint8_t, will hold arch numeric id
715 * fit_image_get_arch() finds arch property in a given component image node.
716 * If the property is found, its (string) value is translated to the numeric
717 * id which is returned to the caller.
723 int fit_image_get_arch(const void *fit, int noffset, uint8_t *arch)
728 /* Get architecture name from property data */
729 data = fdt_getprop(fit, noffset, FIT_ARCH_PROP, &len);
731 fit_get_debug(fit, noffset, FIT_ARCH_PROP, len);
736 /* Translate architecture name to id */
737 *arch = genimg_get_arch_id(data);
742 * fit_image_get_type - get type id for a given component image node
743 * @fit: pointer to the FIT format image header
744 * @noffset: component image node offset
745 * @type: pointer to the uint8_t, will hold type numeric id
747 * fit_image_get_type() finds type property in a given component image node.
748 * If the property is found, its (string) value is translated to the numeric
749 * id which is returned to the caller.
755 int fit_image_get_type(const void *fit, int noffset, uint8_t *type)
760 /* Get image type name from property data */
761 data = fdt_getprop(fit, noffset, FIT_TYPE_PROP, &len);
763 fit_get_debug(fit, noffset, FIT_TYPE_PROP, len);
768 /* Translate image type name to id */
769 *type = genimg_get_type_id(data);
774 * fit_image_get_comp - get comp id for a given component image node
775 * @fit: pointer to the FIT format image header
776 * @noffset: component image node offset
777 * @comp: pointer to the uint8_t, will hold comp numeric id
779 * fit_image_get_comp() finds comp property in a given component image node.
780 * If the property is found, its (string) value is translated to the numeric
781 * id which is returned to the caller.
787 int fit_image_get_comp(const void *fit, int noffset, uint8_t *comp)
792 /* Get compression name from property data */
793 data = fdt_getprop(fit, noffset, FIT_COMP_PROP, &len);
795 fit_get_debug(fit, noffset, FIT_COMP_PROP, len);
799 /* Translate compression name to id */
800 *comp = genimg_get_comp_id(data);
805 * fit_image_get_phase() - get the phase for a configuration node
806 * @fit: pointer to the FIT format image header
807 * @offset: configuration-node offset
808 * @phasep: returns the phase
810 * Finds the phase property in a given configuration node. If the property is
811 * found, its (string) value is translated to the numeric id which is returned
814 * Returns: 0 on success, -ENOENT if missing, -EINVAL for invalid value
816 int fit_image_get_phase(const void *fit, int offset, enum image_phase_t *phasep)
821 /* Get phase name from property data */
822 data = fdt_getprop(fit, offset, FIT_PHASE_PROP, &len);
824 fit_get_debug(fit, offset, FIT_PHASE_PROP, len);
829 /* Translate phase name to id */
830 ret = genimg_get_phase_id(data);
838 static int fit_image_get_address(const void *fit, int noffset, char *name,
845 cell = fdt_getprop(fit, noffset, name, &len);
847 fit_get_debug(fit, noffset, name, len);
852 /* Use load64 to avoid compiling warning for 32-bit target */
854 load64 = (load64 << 32) | uimage_to_cpu(*cell);
858 if (len > sizeof(ulong) && (uint32_t)(load64 >> 32)) {
859 printf("Unsupported %s address size\n", name);
863 *load = (ulong)load64;
868 * fit_image_get_load() - get load addr property for given component image node
869 * @fit: pointer to the FIT format image header
870 * @noffset: component image node offset
871 * @load: pointer to the uint32_t, will hold load address
873 * fit_image_get_load() finds load address property in a given component
874 * image node. If the property is found, its value is returned to the caller.
880 int fit_image_get_load(const void *fit, int noffset, ulong *load)
882 return fit_image_get_address(fit, noffset, FIT_LOAD_PROP, load);
886 * fit_image_get_entry() - get entry point address property
887 * @fit: pointer to the FIT format image header
888 * @noffset: component image node offset
889 * @entry: pointer to the uint32_t, will hold entry point address
891 * This gets the entry point address property for a given component image
894 * fit_image_get_entry() finds entry point address property in a given
895 * component image node. If the property is found, its value is returned
902 int fit_image_get_entry(const void *fit, int noffset, ulong *entry)
904 return fit_image_get_address(fit, noffset, FIT_ENTRY_PROP, entry);
908 * fit_image_get_data - get data property and its size for a given component image node
909 * @fit: pointer to the FIT format image header
910 * @noffset: component image node offset
911 * @data: double pointer to void, will hold data property's data address
912 * @size: pointer to size_t, will hold data property's data size
914 * fit_image_get_data() finds data property in a given component image node.
915 * If the property is found its data start address and size are returned to
922 int fit_image_get_data(const void *fit, int noffset,
923 const void **data, size_t *size)
927 *data = fdt_getprop(fit, noffset, FIT_DATA_PROP, &len);
929 fit_get_debug(fit, noffset, FIT_DATA_PROP, len);
939 * Get 'data-offset' property from a given image node.
941 * @fit: pointer to the FIT image header
942 * @noffset: component image node offset
943 * @data_offset: holds the data-offset property
947 * -ENOENT if the property could not be found
949 int fit_image_get_data_offset(const void *fit, int noffset, int *data_offset)
953 val = fdt_getprop(fit, noffset, FIT_DATA_OFFSET_PROP, NULL);
957 *data_offset = fdt32_to_cpu(*val);
963 * Get 'data-position' property from a given image node.
965 * @fit: pointer to the FIT image header
966 * @noffset: component image node offset
967 * @data_position: holds the data-position property
971 * -ENOENT if the property could not be found
973 int fit_image_get_data_position(const void *fit, int noffset,
978 val = fdt_getprop(fit, noffset, FIT_DATA_POSITION_PROP, NULL);
982 *data_position = fdt32_to_cpu(*val);
988 * Get 'data-size' property from a given image node.
990 * @fit: pointer to the FIT image header
991 * @noffset: component image node offset
992 * @data_size: holds the data-size property
996 * -ENOENT if the property could not be found
998 int fit_image_get_data_size(const void *fit, int noffset, int *data_size)
1002 val = fdt_getprop(fit, noffset, FIT_DATA_SIZE_PROP, NULL);
1006 *data_size = fdt32_to_cpu(*val);
1012 * Get 'data-size-unciphered' property from a given image node.
1014 * @fit: pointer to the FIT image header
1015 * @noffset: component image node offset
1016 * @data_size: holds the data-size property
1020 * -ENOENT if the property could not be found
1022 int fit_image_get_data_size_unciphered(const void *fit, int noffset,
1027 val = fdt_getprop(fit, noffset, "data-size-unciphered", NULL);
1031 *data_size = (size_t)fdt32_to_cpu(*val);
1037 * fit_image_get_data_and_size - get data and its size including
1038 * both embedded and external data
1039 * @fit: pointer to the FIT format image header
1040 * @noffset: component image node offset
1041 * @data: double pointer to void, will hold data property's data address
1042 * @size: pointer to size_t, will hold data property's data size
1044 * fit_image_get_data_and_size() finds data and its size including
1045 * both embedded and external data. If the property is found
1046 * its data start address and size are returned to the caller.
1050 * otherwise, on failure
1052 int fit_image_get_data_and_size(const void *fit, int noffset,
1053 const void **data, size_t *size)
1055 bool external_data = false;
1060 if (!fit_image_get_data_position(fit, noffset, &offset)) {
1061 external_data = true;
1062 } else if (!fit_image_get_data_offset(fit, noffset, &offset)) {
1063 external_data = true;
1065 * For FIT with external data, figure out where
1066 * the external images start. This is the base
1067 * for the data-offset properties in each image.
1069 offset += ((fdt_totalsize(fit) + 3) & ~3);
1072 if (external_data) {
1073 debug("External Data\n");
1074 ret = fit_image_get_data_size(fit, noffset, &len);
1076 *data = fit + offset;
1080 ret = fit_image_get_data(fit, noffset, data, size);
1087 * fit_image_hash_get_algo - get hash algorithm name
1088 * @fit: pointer to the FIT format image header
1089 * @noffset: hash node offset
1090 * @algo: double pointer to char, will hold pointer to the algorithm name
1092 * fit_image_hash_get_algo() finds hash algorithm property in a given hash node.
1093 * If the property is found its data start address is returned to the caller.
1099 int fit_image_hash_get_algo(const void *fit, int noffset, const char **algo)
1103 *algo = (const char *)fdt_getprop(fit, noffset, FIT_ALGO_PROP, &len);
1104 if (*algo == NULL) {
1105 fit_get_debug(fit, noffset, FIT_ALGO_PROP, len);
1113 * fit_image_hash_get_value - get hash value and length
1114 * @fit: pointer to the FIT format image header
1115 * @noffset: hash node offset
1116 * @value: double pointer to uint8_t, will hold address of a hash value data
1117 * @value_len: pointer to an int, will hold hash data length
1119 * fit_image_hash_get_value() finds hash value property in a given hash node.
1120 * If the property is found its data start address and size are returned to
1127 int fit_image_hash_get_value(const void *fit, int noffset, uint8_t **value,
1132 *value = (uint8_t *)fdt_getprop(fit, noffset, FIT_VALUE_PROP, &len);
1133 if (*value == NULL) {
1134 fit_get_debug(fit, noffset, FIT_VALUE_PROP, len);
1144 * fit_image_hash_get_ignore - get hash ignore flag
1145 * @fit: pointer to the FIT format image header
1146 * @noffset: hash node offset
1147 * @ignore: pointer to an int, will hold hash ignore flag
1149 * fit_image_hash_get_ignore() finds hash ignore property in a given hash node.
1150 * If the property is found and non-zero, the hash algorithm is not verified by
1151 * u-boot automatically.
1154 * 0, on ignore not found
1155 * value, on ignore found
1157 static int fit_image_hash_get_ignore(const void *fit, int noffset, int *ignore)
1162 value = (int *)fdt_getprop(fit, noffset, FIT_IGNORE_PROP, &len);
1163 if (value == NULL || len != sizeof(int))
1172 * fit_image_cipher_get_algo - get cipher algorithm name
1173 * @fit: pointer to the FIT format image header
1174 * @noffset: cipher node offset
1175 * @algo: double pointer to char, will hold pointer to the algorithm name
1177 * fit_image_cipher_get_algo() finds cipher algorithm property in a given
1178 * cipher node. If the property is found its data start address is returned
1185 int fit_image_cipher_get_algo(const void *fit, int noffset, char **algo)
1189 *algo = (char *)fdt_getprop(fit, noffset, FIT_ALGO_PROP, &len);
1191 fit_get_debug(fit, noffset, FIT_ALGO_PROP, len);
1198 ulong fit_get_end(const void *fit)
1200 return map_to_sysmem((void *)(fit + fdt_totalsize(fit)));
1204 * fit_set_timestamp - set node timestamp property
1205 * @fit: pointer to the FIT format image header
1206 * @noffset: node offset
1207 * @timestamp: timestamp value to be set
1209 * fit_set_timestamp() attempts to set timestamp property in the requested
1210 * node and returns operation status to the caller.
1214 * -ENOSPC if no space in device tree, -1 for other error
1216 int fit_set_timestamp(void *fit, int noffset, time_t timestamp)
1221 t = cpu_to_uimage(timestamp);
1222 ret = fdt_setprop(fit, noffset, FIT_TIMESTAMP_PROP, &t,
1225 debug("Can't set '%s' property for '%s' node (%s)\n",
1226 FIT_TIMESTAMP_PROP, fit_get_name(fit, noffset, NULL),
1228 return ret == -FDT_ERR_NOSPACE ? -ENOSPC : -1;
1235 * calculate_hash - calculate and return hash for provided input data
1236 * @data: pointer to the input data
1237 * @data_len: data length
1238 * @name: requested hash algorithm name
1239 * @value: pointer to the char, will hold hash value data (caller must
1240 * allocate enough free space)
1241 * value_len: length of the calculated hash
1243 * calculate_hash() computes input data hash according to the requested
1245 * Resulting hash value is placed in caller provided 'value' buffer, length
1246 * of the calculated hash is returned via value_len pointer argument.
1250 * -1, when algo is unsupported
1252 int calculate_hash(const void *data, int data_len, const char *name,
1253 uint8_t *value, int *value_len)
1255 #if !defined(USE_HOSTCC) && defined(CONFIG_DM_HASH)
1257 enum HASH_ALGO hash_algo;
1258 struct udevice *dev;
1260 rc = uclass_get_device(UCLASS_HASH, 0, &dev);
1262 debug("failed to get hash device, rc=%d\n", rc);
1266 hash_algo = hash_algo_lookup_by_name(name);
1267 if (hash_algo == HASH_ALGO_INVALID) {
1268 debug("Unsupported hash algorithm\n");
1272 rc = hash_digest_wd(dev, hash_algo, data, data_len, value, CHUNKSZ);
1274 debug("failed to get hash value, rc=%d\n", rc);
1278 *value_len = hash_algo_digest_size(hash_algo);
1280 struct hash_algo *algo;
1283 ret = hash_lookup_algo(name, &algo);
1285 debug("Unsupported hash alogrithm\n");
1289 algo->hash_func_ws(data, data_len, value, algo->chunk_size);
1290 *value_len = algo->digest_size;
1296 static int fit_image_check_hash(const void *fit, int noffset, const void *data,
1297 size_t size, char **err_msgp)
1299 ALLOC_CACHE_ALIGN_BUFFER(uint8_t, value, FIT_MAX_HASH_LEN);
1308 if (fit_image_hash_get_algo(fit, noffset, &algo)) {
1309 *err_msgp = "Can't get hash algo property";
1314 if (!tools_build()) {
1315 fit_image_hash_get_ignore(fit, noffset, &ignore);
1317 printf("-skipped ");
1322 if (fit_image_hash_get_value(fit, noffset, &fit_value,
1324 *err_msgp = "Can't get hash value property";
1328 if (calculate_hash(data, size, algo, value, &value_len)) {
1329 *err_msgp = "Unsupported hash algorithm";
1333 if (value_len != fit_value_len) {
1334 *err_msgp = "Bad hash value len";
1336 } else if (memcmp(value, fit_value, value_len) != 0) {
1337 *err_msgp = "Bad hash value";
1344 int fit_image_verify_with_data(const void *fit, int image_noffset,
1345 const void *key_blob, const void *data,
1353 /* Verify all required signatures */
1354 if (FIT_IMAGE_ENABLE_VERIFY &&
1355 fit_image_verify_required_sigs(fit, image_noffset, data, size,
1356 key_blob, &verify_all)) {
1357 err_msg = "Unable to verify required signature";
1361 /* Process all hash subnodes of the component image node */
1362 fdt_for_each_subnode(noffset, fit, image_noffset) {
1363 const char *name = fit_get_name(fit, noffset, NULL);
1366 * Check subnode name, must be equal to "hash".
1367 * Multiple hash nodes require unique unit node
1368 * names, e.g. hash-1, hash-2, etc.
1370 if (!strncmp(name, FIT_HASH_NODENAME,
1371 strlen(FIT_HASH_NODENAME))) {
1372 if (fit_image_check_hash(fit, noffset, data, size,
1376 } else if (FIT_IMAGE_ENABLE_VERIFY && verify_all &&
1377 !strncmp(name, FIT_SIG_NODENAME,
1378 strlen(FIT_SIG_NODENAME))) {
1379 ret = fit_image_check_sig(fit, noffset, data, size,
1380 gd_fdt_blob(), -1, &err_msg);
1383 * Show an indication on failure, but do not return
1384 * an error. Only keys marked 'required' can cause
1385 * an image validation failure. See the call to
1386 * fit_image_verify_required_sigs() above.
1395 if (noffset == -FDT_ERR_TRUNCATED || noffset == -FDT_ERR_BADSTRUCTURE) {
1396 err_msg = "Corrupted or truncated tree";
1403 printf(" error!\n%s for '%s' hash node in '%s' image node\n",
1404 err_msg, fit_get_name(fit, noffset, NULL),
1405 fit_get_name(fit, image_noffset, NULL));
1410 * fit_image_verify - verify data integrity
1411 * @fit: pointer to the FIT format image header
1412 * @image_noffset: component image node offset
1414 * fit_image_verify() goes over component image hash nodes,
1415 * re-calculates each data hash and compares with the value stored in hash
1419 * 1, if all hashes are valid
1420 * 0, otherwise (or on error)
1422 int fit_image_verify(const void *fit, int image_noffset)
1424 const char *name = fit_get_name(fit, image_noffset, NULL);
1429 if (IS_ENABLED(CONFIG_FIT_SIGNATURE) && strchr(name, '@')) {
1431 * We don't support this since libfdt considers names with the
1432 * name root but different @ suffix to be equal
1434 err_msg = "Node name contains @";
1437 /* Get image data and data length */
1438 if (fit_image_get_data_and_size(fit, image_noffset, &data, &size)) {
1439 err_msg = "Can't get image data/size";
1443 return fit_image_verify_with_data(fit, image_noffset, gd_fdt_blob(),
1447 printf("error!\n%s in '%s' image node\n", err_msg,
1448 fit_get_name(fit, image_noffset, NULL));
1453 * fit_all_image_verify - verify data integrity for all images
1454 * @fit: pointer to the FIT format image header
1456 * fit_all_image_verify() goes over all images in the FIT and
1457 * for every images checks if all it's hashes are valid.
1460 * 1, if all hashes of all images are valid
1461 * 0, otherwise (or on error)
1463 int fit_all_image_verify(const void *fit)
1470 /* Find images parent node offset */
1471 images_noffset = fdt_path_offset(fit, FIT_IMAGES_PATH);
1472 if (images_noffset < 0) {
1473 printf("Can't find images parent node '%s' (%s)\n",
1474 FIT_IMAGES_PATH, fdt_strerror(images_noffset));
1478 /* Process all image subnodes, check hashes for each */
1479 printf("## Checking hash(es) for FIT Image at %08lx ...\n",
1481 for (ndepth = 0, count = 0,
1482 noffset = fdt_next_node(fit, images_noffset, &ndepth);
1483 (noffset >= 0) && (ndepth > 0);
1484 noffset = fdt_next_node(fit, noffset, &ndepth)) {
1487 * Direct child node of the images parent node,
1488 * i.e. component image node.
1490 printf(" Hash(es) for Image %u (%s): ", count,
1491 fit_get_name(fit, noffset, NULL));
1494 if (!fit_image_verify(fit, noffset))
1502 static int fit_image_uncipher(const void *fit, int image_noffset,
1503 void **data, size_t *size)
1505 int cipher_noffset, ret;
1509 cipher_noffset = fdt_subnode_offset(fit, image_noffset,
1510 FIT_CIPHER_NODENAME);
1511 if (cipher_noffset < 0)
1514 ret = fit_image_decrypt_data(fit, image_noffset, cipher_noffset,
1515 *data, *size, &dst, &size_dst);
1527 * fit_image_check_os - check whether image node is of a given os type
1528 * @fit: pointer to the FIT format image header
1529 * @noffset: component image node offset
1530 * @os: requested image os
1532 * fit_image_check_os() reads image os property and compares its numeric
1533 * id with the requested os. Comparison result is returned to the caller.
1536 * 1 if image is of given os type
1537 * 0 otherwise (or on error)
1539 int fit_image_check_os(const void *fit, int noffset, uint8_t os)
1543 if (fit_image_get_os(fit, noffset, &image_os))
1545 return (os == image_os);
1549 * fit_image_check_arch - check whether image node is of a given arch
1550 * @fit: pointer to the FIT format image header
1551 * @noffset: component image node offset
1552 * @arch: requested imagearch
1554 * fit_image_check_arch() reads image arch property and compares its numeric
1555 * id with the requested arch. Comparison result is returned to the caller.
1558 * 1 if image is of given arch
1559 * 0 otherwise (or on error)
1561 int fit_image_check_arch(const void *fit, int noffset, uint8_t arch)
1564 int aarch32_support = 0;
1566 /* Let's assume that sandbox can load any architecture */
1567 if (IS_ENABLED(CONFIG_SANDBOX))
1570 if (IS_ENABLED(CONFIG_ARM64_SUPPORT_AARCH32))
1571 aarch32_support = 1;
1573 if (fit_image_get_arch(fit, noffset, &image_arch))
1575 return (arch == image_arch) ||
1576 (arch == IH_ARCH_I386 && image_arch == IH_ARCH_X86_64) ||
1577 (arch == IH_ARCH_ARM64 && image_arch == IH_ARCH_ARM &&
1582 * fit_image_check_type - check whether image node is of a given type
1583 * @fit: pointer to the FIT format image header
1584 * @noffset: component image node offset
1585 * @type: requested image type
1587 * fit_image_check_type() reads image type property and compares its numeric
1588 * id with the requested type. Comparison result is returned to the caller.
1591 * 1 if image is of given type
1592 * 0 otherwise (or on error)
1594 int fit_image_check_type(const void *fit, int noffset, uint8_t type)
1598 if (fit_image_get_type(fit, noffset, &image_type))
1600 return (type == image_type);
1604 * fit_image_check_comp - check whether image node uses given compression
1605 * @fit: pointer to the FIT format image header
1606 * @noffset: component image node offset
1607 * @comp: requested image compression type
1609 * fit_image_check_comp() reads image compression property and compares its
1610 * numeric id with the requested compression type. Comparison result is
1611 * returned to the caller.
1614 * 1 if image uses requested compression
1615 * 0 otherwise (or on error)
1617 int fit_image_check_comp(const void *fit, int noffset, uint8_t comp)
1621 if (fit_image_get_comp(fit, noffset, &image_comp))
1623 return (comp == image_comp);
1627 * fdt_check_no_at() - Check for nodes whose names contain '@'
1629 * This checks the parent node and all subnodes recursively
1631 * @fit: FIT to check
1632 * @parent: Parent node to check
1633 * Return: 0 if OK, -EADDRNOTAVAIL is a node has a name containing '@'
1635 static int fdt_check_no_at(const void *fit, int parent)
1641 name = fdt_get_name(fit, parent, NULL);
1642 if (!name || strchr(name, '@'))
1643 return -EADDRNOTAVAIL;
1645 fdt_for_each_subnode(node, fit, parent) {
1646 ret = fdt_check_no_at(fit, node);
1654 int fit_check_format(const void *fit, ulong size)
1658 /* A FIT image must be a valid FDT */
1659 ret = fdt_check_header(fit);
1661 log_debug("Wrong FIT format: not a flattened device tree (err=%d)\n",
1666 if (CONFIG_IS_ENABLED(FIT_FULL_CHECK)) {
1668 * If we are not given the size, make do wtih calculating it.
1669 * This is not as secure, so we should consider a flag to
1672 if (size == IMAGE_SIZE_INVAL)
1673 size = fdt_totalsize(fit);
1674 ret = fdt_check_full(fit, size);
1679 * U-Boot stopped using unit addressed in 2017. Since libfdt
1680 * can match nodes ignoring any unit address, signature
1681 * verification can see the wrong node if one is inserted with
1682 * the same name as a valid node but with a unit address
1683 * attached. Protect against this by disallowing unit addresses.
1685 if (!ret && CONFIG_IS_ENABLED(FIT_SIGNATURE)) {
1686 ret = fdt_check_no_at(fit, 0);
1689 log_debug("FIT check error %d\n", ret);
1694 log_debug("FIT check error %d\n", ret);
1699 /* mandatory / node 'description' property */
1700 if (!fdt_getprop(fit, 0, FIT_DESC_PROP, NULL)) {
1701 log_debug("Wrong FIT format: no description\n");
1705 if (IMAGE_ENABLE_TIMESTAMP) {
1706 /* mandatory / node 'timestamp' property */
1707 if (!fdt_getprop(fit, 0, FIT_TIMESTAMP_PROP, NULL)) {
1708 log_debug("Wrong FIT format: no timestamp\n");
1713 /* mandatory subimages parent '/images' node */
1714 if (fdt_path_offset(fit, FIT_IMAGES_PATH) < 0) {
1715 log_debug("Wrong FIT format: no images parent node\n");
1722 int fit_conf_find_compat(const void *fit, const void *fdt)
1725 int noffset, confs_noffset, images_noffset;
1726 const void *fdt_compat;
1728 int best_match_offset = 0;
1729 int best_match_pos = 0;
1731 confs_noffset = fdt_path_offset(fit, FIT_CONFS_PATH);
1732 images_noffset = fdt_path_offset(fit, FIT_IMAGES_PATH);
1733 if (confs_noffset < 0 || images_noffset < 0) {
1734 debug("Can't find configurations or images nodes.\n");
1738 fdt_compat = fdt_getprop(fdt, 0, "compatible", &fdt_compat_len);
1740 debug("Fdt for comparison has no \"compatible\" property.\n");
1745 * Loop over the configurations in the FIT image.
1747 for (noffset = fdt_next_node(fit, confs_noffset, &ndepth);
1748 (noffset >= 0) && (ndepth > 0);
1749 noffset = fdt_next_node(fit, noffset, &ndepth)) {
1751 const char *kfdt_name;
1752 int kfdt_noffset, compat_noffset;
1753 const char *cur_fdt_compat;
1761 /* If there's a compat property in the config node, use that. */
1762 if (fdt_getprop(fit, noffset, "compatible", NULL)) {
1763 fdt = fit; /* search in FIT image */
1764 compat_noffset = noffset; /* search under config node */
1765 } else { /* Otherwise extract it from the kernel FDT. */
1766 kfdt_name = fdt_getprop(fit, noffset, "fdt", &len);
1768 debug("No fdt property found.\n");
1771 kfdt_noffset = fdt_subnode_offset(fit, images_noffset,
1773 if (kfdt_noffset < 0) {
1774 debug("No image node named \"%s\" found.\n",
1779 if (!fit_image_check_comp(fit, kfdt_noffset,
1781 debug("Can't extract compat from \"%s\" "
1782 "(compressed)\n", kfdt_name);
1786 /* search in this config's kernel FDT */
1787 if (fit_image_get_data_and_size(fit, kfdt_noffset,
1789 debug("Failed to get fdt \"%s\".\n", kfdt_name);
1793 compat_noffset = 0; /* search kFDT under root node */
1796 len = fdt_compat_len;
1797 cur_fdt_compat = fdt_compat;
1799 * Look for a match for each U-Boot compatibility string in
1800 * turn in the compat string property.
1802 for (i = 0; len > 0 &&
1803 (!best_match_offset || best_match_pos > i); i++) {
1804 int cur_len = strlen(cur_fdt_compat) + 1;
1806 if (!fdt_node_check_compatible(fdt, compat_noffset,
1808 best_match_offset = noffset;
1813 cur_fdt_compat += cur_len;
1816 if (!best_match_offset) {
1817 debug("No match found.\n");
1821 return best_match_offset;
1824 int fit_conf_get_node(const void *fit, const char *conf_uname)
1826 int noffset, confs_noffset;
1829 char *conf_uname_copy = NULL;
1831 confs_noffset = fdt_path_offset(fit, FIT_CONFS_PATH);
1832 if (confs_noffset < 0) {
1833 debug("Can't find configurations parent node '%s' (%s)\n",
1834 FIT_CONFS_PATH, fdt_strerror(confs_noffset));
1835 return confs_noffset;
1838 if (conf_uname == NULL) {
1839 /* get configuration unit name from the default property */
1840 debug("No configuration specified, trying default...\n");
1841 if (!tools_build() && IS_ENABLED(CONFIG_MULTI_DTB_FIT)) {
1842 noffset = fit_find_config_node(fit);
1845 conf_uname = fdt_get_name(fit, noffset, NULL);
1847 conf_uname = (char *)fdt_getprop(fit, confs_noffset,
1848 FIT_DEFAULT_PROP, &len);
1849 if (conf_uname == NULL) {
1850 fit_get_debug(fit, confs_noffset, FIT_DEFAULT_PROP,
1855 debug("Found default configuration: '%s'\n", conf_uname);
1858 s = strchr(conf_uname, '#');
1860 len = s - conf_uname;
1861 conf_uname_copy = malloc(len + 1);
1862 if (!conf_uname_copy) {
1863 debug("Can't allocate uname copy: '%s'\n",
1867 memcpy(conf_uname_copy, conf_uname, len);
1868 conf_uname_copy[len] = '\0';
1869 conf_uname = conf_uname_copy;
1872 noffset = fdt_subnode_offset(fit, confs_noffset, conf_uname);
1874 debug("Can't get node offset for configuration unit name: '%s' (%s)\n",
1875 conf_uname, fdt_strerror(noffset));
1878 free(conf_uname_copy);
1883 int fit_conf_get_prop_node_count(const void *fit, int noffset,
1884 const char *prop_name)
1886 return fdt_stringlist_count(fit, noffset, prop_name);
1889 int fit_conf_get_prop_node_index(const void *fit, int noffset,
1890 const char *prop_name, int index)
1895 /* get kernel image unit name from configuration kernel property */
1896 uname = fdt_stringlist_get(fit, noffset, prop_name, index, &len);
1900 return fit_image_get_node(fit, uname);
1903 int fit_conf_get_prop_node(const void *fit, int noffset, const char *prop_name,
1904 enum image_phase_t sel_phase)
1908 if (sel_phase == IH_PHASE_NONE)
1909 return fit_conf_get_prop_node_index(fit, noffset, prop_name, 0);
1911 count = fit_conf_get_prop_node_count(fit, noffset, prop_name);
1915 /* check each image in the list */
1916 for (i = 0; i < count; i++) {
1917 enum image_phase_t phase;
1920 node = fit_conf_get_prop_node_index(fit, noffset, prop_name, i);
1921 ret = fit_image_get_phase(fit, node, &phase);
1923 /* if the image is for any phase, let's use it */
1929 if (phase == sel_phase)
1936 static int fit_get_data_tail(const void *fit, int noffset,
1937 const void **data, size_t *size)
1944 if (!fit_image_verify(fit, noffset))
1947 if (fit_image_get_data_and_size(fit, noffset, data, size))
1950 if (!fit_get_desc(fit, noffset, &desc))
1951 printf("%s\n", desc);
1956 int fit_get_data_node(const void *fit, const char *image_uname,
1957 const void **data, size_t *size)
1959 int noffset = fit_image_get_node(fit, image_uname);
1961 return fit_get_data_tail(fit, noffset, data, size);
1964 int fit_get_data_conf_prop(const void *fit, const char *prop_name,
1965 const void **data, size_t *size)
1967 int noffset = fit_conf_get_node(fit, NULL);
1969 noffset = fit_conf_get_prop_node(fit, noffset, prop_name,
1971 return fit_get_data_tail(fit, noffset, data, size);
1974 static int fit_image_select(const void *fit, int rd_noffset, int verify)
1976 fit_image_print(fit, rd_noffset, " ");
1979 puts(" Verifying Hash Integrity ... ");
1980 if (!fit_image_verify(fit, rd_noffset)) {
1981 puts("Bad Data Hash\n");
1990 int fit_get_node_from_config(struct bootm_headers *images,
1991 const char *prop_name, ulong addr)
1997 debug("* %s: using config '%s' from image at 0x%08lx\n",
1998 prop_name, images->fit_uname_cfg, addr);
2000 /* Check whether configuration has this property defined */
2001 fit_hdr = map_sysmem(addr, 0);
2002 cfg_noffset = fit_conf_get_node(fit_hdr, images->fit_uname_cfg);
2003 if (cfg_noffset < 0) {
2004 debug("* %s: no such config\n", prop_name);
2008 noffset = fit_conf_get_prop_node(fit_hdr, cfg_noffset, prop_name,
2011 debug("* %s: no '%s' in config\n", prop_name, prop_name);
2019 * fit_get_image_type_property() - get property name for IH_TYPE_...
2021 * Return: the properly name where we expect to find the image in the
2024 static const char *fit_get_image_type_property(int type)
2027 * This is sort-of available in the uimage_type[] table in image.c
2028 * but we don't have access to the short name, and "fdt" is different
2029 * anyway. So let's just keep it here.
2032 case IH_TYPE_FLATDT:
2033 return FIT_FDT_PROP;
2034 case IH_TYPE_KERNEL:
2035 return FIT_KERNEL_PROP;
2036 case IH_TYPE_FIRMWARE:
2037 return FIT_FIRMWARE_PROP;
2038 case IH_TYPE_RAMDISK:
2039 return FIT_RAMDISK_PROP;
2040 case IH_TYPE_X86_SETUP:
2041 return FIT_SETUP_PROP;
2042 case IH_TYPE_LOADABLE:
2043 return FIT_LOADABLE_PROP;
2045 return FIT_FPGA_PROP;
2046 case IH_TYPE_STANDALONE:
2047 return FIT_STANDALONE_PROP;
2053 int fit_image_load(struct bootm_headers *images, ulong addr,
2054 const char **fit_unamep, const char **fit_uname_configp,
2055 int arch, int ph_type, int bootstage_id,
2056 enum fit_load_op load_op, ulong *datap, ulong *lenp)
2058 int image_type = image_ph_type(ph_type);
2059 int cfg_noffset, noffset;
2060 const char *fit_uname;
2061 const char *fit_uname_config;
2062 const char *fit_base_uname_config;
2068 ulong load, load_end, data, len;
2070 const char *prop_name;
2073 fit = map_sysmem(addr, 0);
2074 fit_uname = fit_unamep ? *fit_unamep : NULL;
2075 fit_uname_config = fit_uname_configp ? *fit_uname_configp : NULL;
2076 fit_base_uname_config = NULL;
2077 prop_name = fit_get_image_type_property(image_type);
2078 printf("## Loading %s from FIT Image at %08lx ...\n", prop_name, addr);
2080 bootstage_mark(bootstage_id + BOOTSTAGE_SUB_FORMAT);
2081 ret = fit_check_format(fit, IMAGE_SIZE_INVAL);
2083 printf("Bad FIT %s image format! (err=%d)\n", prop_name, ret);
2084 if (CONFIG_IS_ENABLED(FIT_SIGNATURE) && ret == -EADDRNOTAVAIL)
2085 printf("Signature checking prevents use of unit addresses (@) in nodes\n");
2086 bootstage_error(bootstage_id + BOOTSTAGE_SUB_FORMAT);
2089 bootstage_mark(bootstage_id + BOOTSTAGE_SUB_FORMAT_OK);
2091 /* get FIT component image node offset */
2092 bootstage_mark(bootstage_id + BOOTSTAGE_SUB_UNIT_NAME);
2093 noffset = fit_image_get_node(fit, fit_uname);
2096 * no image node unit name, try to get config
2097 * node first. If config unit node name is NULL
2098 * fit_conf_get_node() will try to find default config node
2100 bootstage_mark(bootstage_id + BOOTSTAGE_SUB_NO_UNIT_NAME);
2101 if (IS_ENABLED(CONFIG_FIT_BEST_MATCH) && !fit_uname_config) {
2102 cfg_noffset = fit_conf_find_compat(fit, gd_fdt_blob());
2104 cfg_noffset = fit_conf_get_node(fit, fit_uname_config);
2106 if (cfg_noffset < 0) {
2107 puts("Could not find configuration node\n");
2108 bootstage_error(bootstage_id +
2109 BOOTSTAGE_SUB_NO_UNIT_NAME);
2113 fit_base_uname_config = fdt_get_name(fit, cfg_noffset, NULL);
2114 printf(" Using '%s' configuration\n", fit_base_uname_config);
2115 /* Remember this config */
2116 if (image_type == IH_TYPE_KERNEL)
2117 images->fit_uname_cfg = fit_base_uname_config;
2119 if (FIT_IMAGE_ENABLE_VERIFY && images->verify) {
2120 puts(" Verifying Hash Integrity ... ");
2121 if (fit_config_verify(fit, cfg_noffset)) {
2122 puts("Bad Data Hash\n");
2123 bootstage_error(bootstage_id +
2124 BOOTSTAGE_SUB_HASH);
2130 bootstage_mark(BOOTSTAGE_ID_FIT_CONFIG);
2132 noffset = fit_conf_get_prop_node(fit, cfg_noffset, prop_name,
2133 image_ph_phase(ph_type));
2134 fit_uname = fit_get_name(fit, noffset, NULL);
2137 printf("Could not find subimage node type '%s'\n", prop_name);
2138 bootstage_error(bootstage_id + BOOTSTAGE_SUB_SUBNODE);
2142 printf(" Trying '%s' %s subimage\n", fit_uname, prop_name);
2144 ret = fit_image_select(fit, noffset, images->verify);
2146 bootstage_error(bootstage_id + BOOTSTAGE_SUB_HASH);
2150 bootstage_mark(bootstage_id + BOOTSTAGE_SUB_CHECK_ARCH);
2151 if (!tools_build() && IS_ENABLED(CONFIG_SANDBOX)) {
2152 if (!fit_image_check_target_arch(fit, noffset)) {
2153 puts("Unsupported Architecture\n");
2154 bootstage_error(bootstage_id + BOOTSTAGE_SUB_CHECK_ARCH);
2163 fit_image_get_arch(fit, noffset, &os_arch);
2164 images->os.arch = os_arch;
2168 bootstage_mark(bootstage_id + BOOTSTAGE_SUB_CHECK_ALL);
2169 type_ok = fit_image_check_type(fit, noffset, image_type) ||
2170 fit_image_check_type(fit, noffset, IH_TYPE_FIRMWARE) ||
2171 fit_image_check_type(fit, noffset, IH_TYPE_TEE) ||
2172 (image_type == IH_TYPE_KERNEL &&
2173 fit_image_check_type(fit, noffset, IH_TYPE_KERNEL_NOLOAD));
2175 os_ok = image_type == IH_TYPE_FLATDT ||
2176 image_type == IH_TYPE_FPGA ||
2177 fit_image_check_os(fit, noffset, IH_OS_LINUX) ||
2178 fit_image_check_os(fit, noffset, IH_OS_U_BOOT) ||
2179 fit_image_check_os(fit, noffset, IH_OS_TEE) ||
2180 fit_image_check_os(fit, noffset, IH_OS_OPENRTOS) ||
2181 fit_image_check_os(fit, noffset, IH_OS_EFI) ||
2182 fit_image_check_os(fit, noffset, IH_OS_VXWORKS);
2185 * If either of the checks fail, we should report an error, but
2186 * if the image type is coming from the "loadables" field, we
2187 * don't care what it is
2189 if ((!type_ok || !os_ok) && image_type != IH_TYPE_LOADABLE) {
2190 fit_image_get_os(fit, noffset, &os);
2191 printf("No %s %s %s Image\n",
2192 genimg_get_os_name(os),
2193 genimg_get_arch_name(arch),
2194 genimg_get_type_name(image_type));
2195 bootstage_error(bootstage_id + BOOTSTAGE_SUB_CHECK_ALL);
2199 bootstage_mark(bootstage_id + BOOTSTAGE_SUB_CHECK_ALL_OK);
2201 /* get image data address and length */
2202 if (fit_image_get_data_and_size(fit, noffset,
2203 (const void **)&buf, &size)) {
2204 printf("Could not find %s subimage data!\n", prop_name);
2205 bootstage_error(bootstage_id + BOOTSTAGE_SUB_GET_DATA);
2209 /* Decrypt data before uncompress/move */
2210 if (IS_ENABLED(CONFIG_FIT_CIPHER) && IMAGE_ENABLE_DECRYPT) {
2211 puts(" Decrypting Data ... ");
2212 if (fit_image_uncipher(fit, noffset, &buf, &size)) {
2219 /* perform any post-processing on the image data */
2220 if (!tools_build() && IS_ENABLED(CONFIG_FIT_IMAGE_POST_PROCESS))
2221 board_fit_image_post_process(fit, noffset, &buf, &size);
2225 bootstage_mark(bootstage_id + BOOTSTAGE_SUB_GET_DATA_OK);
2227 data = map_to_sysmem(buf);
2229 if (load_op == FIT_LOAD_IGNORED) {
2231 } else if (fit_image_get_load(fit, noffset, &load)) {
2232 if (load_op == FIT_LOAD_REQUIRED) {
2233 printf("Can't get %s subimage load address!\n",
2235 bootstage_error(bootstage_id + BOOTSTAGE_SUB_LOAD);
2238 } else if (load_op != FIT_LOAD_OPTIONAL_NON_ZERO || load) {
2239 ulong image_start, image_end;
2242 * move image data to the load address,
2243 * make sure we don't overwrite initial image
2246 image_end = addr + fit_get_size(fit);
2248 load_end = load + len;
2249 if (image_type != IH_TYPE_KERNEL &&
2250 load < image_end && load_end > image_start) {
2251 printf("Error: %s overwritten\n", prop_name);
2255 printf(" Loading %s from 0x%08lx to 0x%08lx\n",
2256 prop_name, data, load);
2258 load = data; /* No load address specified */
2261 comp = IH_COMP_NONE;
2263 /* Kernel images get decompressed later in bootm_load_os(). */
2264 if (!fit_image_get_comp(fit, noffset, &comp) &&
2265 comp != IH_COMP_NONE &&
2266 !(image_type == IH_TYPE_KERNEL ||
2267 image_type == IH_TYPE_KERNEL_NOLOAD ||
2268 image_type == IH_TYPE_RAMDISK)) {
2269 ulong max_decomp_len = len * 20;
2271 loadbuf = malloc(max_decomp_len);
2272 load = map_to_sysmem(loadbuf);
2274 loadbuf = map_sysmem(load, max_decomp_len);
2276 if (image_decomp(comp, load, data, image_type,
2277 loadbuf, buf, len, max_decomp_len, &load_end)) {
2278 printf("Error decompressing %s\n", prop_name);
2282 len = load_end - load;
2283 } else if (load != data) {
2284 loadbuf = map_sysmem(load, len);
2285 memcpy(loadbuf, buf, len);
2288 if (image_type == IH_TYPE_RAMDISK && comp != IH_COMP_NONE)
2289 puts("WARNING: 'compression' nodes for ramdisks are deprecated,"
2290 " please fix your .its file!\n");
2292 /* verify that image data is a proper FDT blob */
2293 if (image_type == IH_TYPE_FLATDT && fdt_check_header(loadbuf)) {
2294 puts("Subimage data is not a FDT");
2298 bootstage_mark(bootstage_id + BOOTSTAGE_SUB_LOAD);
2303 *fit_unamep = (char *)fit_uname;
2304 if (fit_uname_configp)
2305 *fit_uname_configp = (char *)(fit_uname_config ? :
2306 fit_base_uname_config);
2311 int boot_get_setup_fit(struct bootm_headers *images, uint8_t arch,
2312 ulong *setup_start, ulong *setup_len)
2319 addr = map_to_sysmem(images->fit_hdr_os);
2320 noffset = fit_get_node_from_config(images, FIT_SETUP_PROP, addr);
2324 ret = fit_image_load(images, addr, NULL, NULL, arch,
2325 IH_TYPE_X86_SETUP, BOOTSTAGE_ID_FIT_SETUP_START,
2326 FIT_LOAD_REQUIRED, setup_start, &len);
2332 int boot_get_fdt_fit(struct bootm_headers *images, ulong addr,
2333 const char **fit_unamep, const char **fit_uname_configp,
2334 int arch, ulong *datap, ulong *lenp)
2336 int fdt_noffset, cfg_noffset, count;
2338 const char *fit_uname = NULL;
2339 const char *fit_uname_config = NULL;
2340 char *fit_uname_config_copy = NULL;
2341 char *next_config = NULL;
2343 #ifdef CONFIG_OF_LIBFDT_OVERLAY
2344 ulong image_start, image_end;
2345 ulong ovload, ovlen, ovcopylen;
2346 const char *uconfig;
2348 void *base, *ov, *ovcopy = NULL;
2349 int i, err, noffset, ov_noffset;
2352 fit_uname = fit_unamep ? *fit_unamep : NULL;
2354 if (fit_uname_configp && *fit_uname_configp) {
2355 fit_uname_config_copy = strdup(*fit_uname_configp);
2356 if (!fit_uname_config_copy)
2359 next_config = strchr(fit_uname_config_copy, '#');
2361 *next_config++ = '\0';
2362 if (next_config - 1 > fit_uname_config_copy)
2363 fit_uname_config = fit_uname_config_copy;
2366 fdt_noffset = fit_image_load(images,
2367 addr, &fit_uname, &fit_uname_config,
2368 arch, IH_TYPE_FLATDT,
2369 BOOTSTAGE_ID_FIT_FDT_START,
2370 FIT_LOAD_OPTIONAL, &load, &len);
2372 if (fdt_noffset < 0)
2375 debug("fit_uname=%s, fit_uname_config=%s\n",
2376 fit_uname ? fit_uname : "<NULL>",
2377 fit_uname_config ? fit_uname_config : "<NULL>");
2379 fit = map_sysmem(addr, 0);
2381 cfg_noffset = fit_conf_get_node(fit, fit_uname_config);
2383 /* single blob, or error just return as well */
2384 count = fit_conf_get_prop_node_count(fit, cfg_noffset, FIT_FDT_PROP);
2385 if (count <= 1 && !next_config)
2388 /* we need to apply overlays */
2390 #ifdef CONFIG_OF_LIBFDT_OVERLAY
2392 image_end = addr + fit_get_size(fit);
2393 /* verify that relocation took place by load address not being in fit */
2394 if (load >= image_start && load < image_end) {
2395 /* check is simplified; fit load checks for overlaps */
2396 printf("Overlayed FDT requires relocation\n");
2397 fdt_noffset = -EBADF;
2401 base = map_sysmem(load, len);
2403 /* apply extra configs in FIT first, followed by args */
2404 for (i = 1; ; i++) {
2406 noffset = fit_conf_get_prop_node_index(fit, cfg_noffset,
2408 uname = fit_get_name(fit, noffset, NULL);
2413 uconfig = next_config;
2414 next_config = strchr(next_config, '#');
2416 *next_config++ = '\0';
2420 * fit_image_load() would load the first FDT from the
2421 * extra config only when uconfig is specified.
2422 * Check if the extra config contains multiple FDTs and
2425 cfg_noffset = fit_conf_get_node(fit, uconfig);
2428 count = fit_conf_get_prop_node_count(fit, cfg_noffset,
2432 debug("%d: using uname=%s uconfig=%s\n", i, uname, uconfig);
2434 ov_noffset = fit_image_load(images,
2435 addr, &uname, &uconfig,
2436 arch, IH_TYPE_FLATDT,
2437 BOOTSTAGE_ID_FIT_FDT_START,
2438 FIT_LOAD_IGNORED, &ovload, &ovlen);
2439 if (ov_noffset < 0) {
2440 printf("load of %s failed\n", uname);
2443 debug("%s loaded at 0x%08lx len=0x%08lx\n",
2444 uname, ovload, ovlen);
2445 ov = map_sysmem(ovload, ovlen);
2447 ovcopylen = ALIGN(fdt_totalsize(ov), SZ_4K);
2448 ovcopy = malloc(ovcopylen);
2450 printf("failed to duplicate DTO before application\n");
2451 fdt_noffset = -ENOMEM;
2455 err = fdt_open_into(ov, ovcopy, ovcopylen);
2457 printf("failed on fdt_open_into for DTO\n");
2462 base = map_sysmem(load, len + ovlen);
2463 err = fdt_open_into(base, base, len + ovlen);
2465 printf("failed on fdt_open_into\n");
2470 /* the verbose method prints out messages on error */
2471 err = fdt_overlay_apply_verbose(base, ovcopy);
2477 len = fdt_totalsize(base);
2480 printf("config with overlays but CONFIG_OF_LIBFDT_OVERLAY not set\n");
2481 fdt_noffset = -EBADF;
2490 *fit_unamep = fit_uname;
2491 if (fit_uname_configp)
2492 *fit_uname_configp = fit_uname_config;
2494 #ifdef CONFIG_OF_LIBFDT_OVERLAY
2497 free(fit_uname_config_copy);