image.h 37.2 KB
Newer Older
wdenk's avatar
wdenk committed
1
/*
2 3
 * (C) Copyright 2008 Semihalf
 *
4
 * (C) Copyright 2000-2005
wdenk's avatar
wdenk committed
5 6
 * Wolfgang Denk, DENX Software Engineering, wd@denx.de.
 *
7
 * SPDX-License-Identifier:	GPL-2.0+
8 9 10 11 12 13
 ********************************************************************
 * NOTE: This header file defines an interface to U-Boot. Including
 * this (unmodified) header file in another file is considered normal
 * use of U-Boot, and does *not* fall under the heading of "derived
 * work".
 ********************************************************************
wdenk's avatar
wdenk committed
14 15 16 17 18
 */

#ifndef __IMAGE_H__
#define __IMAGE_H__

19
#include "compiler.h"
20
#include <asm/byteorder.h>
21

22 23 24
/* Define this to avoid #ifdefs later on */
struct lmb;

25
#ifdef USE_HOSTCC
Jörg Krause's avatar
Jörg Krause committed
26
#include <sys/types.h>
27 28

/* new uImage format support enabled on host */
29 30
#define IMAGE_ENABLE_FIT	1
#define IMAGE_ENABLE_OF_LIBFDT	1
31
#define CONFIG_FIT_VERBOSE	1 /* enable fit_format_{error,warning}() */
32

33
#define IMAGE_ENABLE_IGNORE	0
34
#define IMAGE_INDENT_STRING	""
35

36 37 38 39
#else

#include <lmb.h>
#include <asm/u-boot.h>
40
#include <command.h>
41

42 43
/* Take notice of the 'ignore' property for hashes */
#define IMAGE_ENABLE_IGNORE	1
44
#define IMAGE_INDENT_STRING	"   "
45

46 47
#define IMAGE_ENABLE_FIT	CONFIG_IS_ENABLED(FIT)
#define IMAGE_ENABLE_OF_LIBFDT	CONFIG_IS_ENABLED(OF_LIBFDT)
48

49
#endif /* USE_HOSTCC */
50

51
#if IMAGE_ENABLE_FIT
52
#include <hash.h>
53 54
#include <libfdt.h>
#include <fdt_support.h>
55 56 57 58 59 60 61 62 63 64
# ifdef CONFIG_SPL_BUILD
#  ifdef CONFIG_SPL_CRC32_SUPPORT
#   define IMAGE_ENABLE_CRC32	1
#  endif
#  ifdef CONFIG_SPL_MD5_SUPPORT
#   define IMAGE_ENABLE_MD5	1
#  endif
#  ifdef CONFIG_SPL_SHA1_SUPPORT
#   define IMAGE_ENABLE_SHA1	1
#  endif
Heiko Schocher's avatar
Heiko Schocher committed
65 66 67
#  ifdef CONFIG_SPL_SHA256_SUPPORT
#   define IMAGE_ENABLE_SHA256	1
#  endif
68 69 70 71
# else
#  define CONFIG_CRC32		/* FIT images need CRC32 support */
#  define CONFIG_MD5		/* and MD5 */
#  define CONFIG_SHA1		/* and SHA1 */
Heiko Schocher's avatar
Heiko Schocher committed
72
#  define CONFIG_SHA256		/* and SHA256 */
73 74 75
#  define IMAGE_ENABLE_CRC32	1
#  define IMAGE_ENABLE_MD5	1
#  define IMAGE_ENABLE_SHA1	1
Heiko Schocher's avatar
Heiko Schocher committed
76
#  define IMAGE_ENABLE_SHA256	1
77 78
# endif

79 80 81 82 83
#ifdef CONFIG_FIT_DISABLE_SHA256
#undef CONFIG_SHA256
#undef IMAGE_ENABLE_SHA256
#endif

84 85 86 87 88 89 90 91 92 93 94 95
#ifndef IMAGE_ENABLE_CRC32
#define IMAGE_ENABLE_CRC32	0
#endif

#ifndef IMAGE_ENABLE_MD5
#define IMAGE_ENABLE_MD5	0
#endif

#ifndef IMAGE_ENABLE_SHA1
#define IMAGE_ENABLE_SHA1	0
#endif

Heiko Schocher's avatar
Heiko Schocher committed
96 97 98 99
#ifndef IMAGE_ENABLE_SHA256
#define IMAGE_ENABLE_SHA256	0
#endif

100
#endif /* IMAGE_ENABLE_FIT */
101 102 103 104 105 106 107 108 109 110 111 112 113 114

#ifdef CONFIG_SYS_BOOT_RAMDISK_HIGH
# define IMAGE_ENABLE_RAMDISK_HIGH	1
#else
# define IMAGE_ENABLE_RAMDISK_HIGH	0
#endif

#ifdef CONFIG_SYS_BOOT_GET_CMDLINE
# define IMAGE_BOOT_GET_CMDLINE		1
#else
# define IMAGE_BOOT_GET_CMDLINE		0
#endif

#ifdef CONFIG_OF_BOARD_SETUP
115
# define IMAGE_OF_BOARD_SETUP		1
116
#else
117
# define IMAGE_OF_BOARD_SETUP		0
118
#endif
119

120 121 122 123 124 125
#ifdef CONFIG_OF_SYSTEM_SETUP
# define IMAGE_OF_SYSTEM_SETUP	1
#else
# define IMAGE_OF_SYSTEM_SETUP	0
#endif

wdenk's avatar
wdenk committed
126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146
/*
 * Operating System Codes
 */
#define IH_OS_INVALID		0	/* Invalid OS	*/
#define IH_OS_OPENBSD		1	/* OpenBSD	*/
#define IH_OS_NETBSD		2	/* NetBSD	*/
#define IH_OS_FREEBSD		3	/* FreeBSD	*/
#define IH_OS_4_4BSD		4	/* 4.4BSD	*/
#define IH_OS_LINUX		5	/* Linux	*/
#define IH_OS_SVR4		6	/* SVR4		*/
#define IH_OS_ESIX		7	/* Esix		*/
#define IH_OS_SOLARIS		8	/* Solaris	*/
#define IH_OS_IRIX		9	/* Irix		*/
#define IH_OS_SCO		10	/* SCO		*/
#define IH_OS_DELL		11	/* Dell		*/
#define IH_OS_NCR		12	/* NCR		*/
#define IH_OS_LYNXOS		13	/* LynxOS	*/
#define IH_OS_VXWORKS		14	/* VxWorks	*/
#define IH_OS_PSOS		15	/* pSOS		*/
#define IH_OS_QNX		16	/* QNX		*/
#define IH_OS_U_BOOT		17	/* Firmware	*/
147
#define IH_OS_RTEMS		18	/* RTEMS	*/
148
#define IH_OS_ARTOS		19	/* ARTOS	*/
149
#define IH_OS_UNITY		20	/* Unity OS	*/
150
#define IH_OS_INTEGRITY		21	/* INTEGRITY	*/
151
#define IH_OS_OSE		22	/* OSE		*/
152
#define IH_OS_PLAN9		23	/* Plan 9	*/
153
#define IH_OS_OPENRTOS		24	/* OpenRTOS	*/
wdenk's avatar
wdenk committed
154 155 156 157

/*
 * CPU Architecture Codes (supported by Linux)
 */
158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175
#define IH_ARCH_INVALID		0	/* Invalid CPU	*/
#define IH_ARCH_ALPHA		1	/* Alpha	*/
#define IH_ARCH_ARM		2	/* ARM		*/
#define IH_ARCH_I386		3	/* Intel x86	*/
#define IH_ARCH_IA64		4	/* IA64		*/
#define IH_ARCH_MIPS		5	/* MIPS		*/
#define IH_ARCH_MIPS64		6	/* MIPS	 64 Bit */
#define IH_ARCH_PPC		7	/* PowerPC	*/
#define IH_ARCH_S390		8	/* IBM S390	*/
#define IH_ARCH_SH		9	/* SuperH	*/
#define IH_ARCH_SPARC		10	/* Sparc	*/
#define IH_ARCH_SPARC64		11	/* Sparc 64 Bit */
#define IH_ARCH_M68K		12	/* M68K		*/
#define IH_ARCH_MICROBLAZE	14	/* MicroBlaze   */
#define IH_ARCH_NIOS2		15	/* Nios-II	*/
#define IH_ARCH_BLACKFIN	16	/* Blackfin	*/
#define IH_ARCH_AVR32		17	/* AVR32	*/
#define IH_ARCH_ST200	        18	/* STMicroelectronics ST200  */
176
#define IH_ARCH_SANDBOX		19	/* Sandbox architecture (test only) */
177
#define IH_ARCH_NDS32	        20	/* ANDES Technology - NDS32  */
178
#define IH_ARCH_OPENRISC        21	/* OpenRISC 1000  */
David Feng's avatar
David Feng committed
179
#define IH_ARCH_ARM64		22	/* ARM64	*/
180
#define IH_ARCH_ARC		23	/* Synopsys DesignWare ARC */
181
#define IH_ARCH_X86_64		24	/* AMD x86_64, Intel and Via */
wdenk's avatar
wdenk committed
182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209

/*
 * Image Types
 *
 * "Standalone Programs" are directly runnable in the environment
 *	provided by U-Boot; it is expected that (if they behave
 *	well) you can continue to work in U-Boot after return from
 *	the Standalone Program.
 * "OS Kernel Images" are usually images of some Embedded OS which
 *	will take over control completely. Usually these programs
 *	will install their own set of exception handlers, device
 *	drivers, set up the MMU, etc. - this means, that you cannot
 *	expect to re-enter U-Boot except by resetting the CPU.
 * "RAMDisk Images" are more or less just data blocks, and their
 *	parameters (address, size) are passed to an OS kernel that is
 *	being started.
 * "Multi-File Images" contain several images, typically an OS
 *	(Linux) kernel image and one or more data images like
 *	RAMDisks. This construct is useful for instance when you want
 *	to boot over the network using BOOTP etc., where the boot
 *	server provides just a single image file, but you want to get
 *	for instance an OS kernel and a RAMDisk image.
 *
 *	"Multi-File Images" start with a list of image sizes, each
 *	image size (in bytes) specified by an "uint32_t" in network
 *	byte order. This list is terminated by an "(uint32_t)0".
 *	Immediately after the terminating 0 follow the images, one by
 *	one, all aligned on "uint32_t" boundaries (size rounded up to
210
 *	a multiple of 4 bytes - except for the last file).
wdenk's avatar
wdenk committed
211 212 213 214 215 216 217 218
 *
 * "Firmware Images" are binary images containing firmware (like
 *	U-Boot or FPGA images) which usually will be programmed to
 *	flash memory.
 *
 * "Script files" are command sequences that will be executed by
 *	U-Boot's command interpreter; this feature is especially
 *	useful when you configure U-Boot to use a real shell (hush)
219
 *	as command interpreter (=> Shell Scripts).
wdenk's avatar
wdenk committed
220 221 222 223 224 225 226 227 228
 */

#define IH_TYPE_INVALID		0	/* Invalid Image		*/
#define IH_TYPE_STANDALONE	1	/* Standalone Program		*/
#define IH_TYPE_KERNEL		2	/* OS Kernel Image		*/
#define IH_TYPE_RAMDISK		3	/* RAMDisk Image		*/
#define IH_TYPE_MULTI		4	/* Multi-File Image		*/
#define IH_TYPE_FIRMWARE	5	/* Firmware Image		*/
#define IH_TYPE_SCRIPT		6	/* Script file			*/
wdenk's avatar
wdenk committed
229
#define IH_TYPE_FILESYSTEM	7	/* Filesystem Image (any type)	*/
230
#define IH_TYPE_FLATDT		8	/* Binary Flat Device Tree Blob	*/
231
#define IH_TYPE_KWBIMAGE	9	/* Kirkwood Boot Image		*/
232
#define IH_TYPE_IMXIMAGE	10	/* Freescale IMXBoot Image	*/
233
#define IH_TYPE_UBLIMAGE	11	/* Davinci UBL Image		*/
234
#define IH_TYPE_OMAPIMAGE	12	/* TI OMAP Config Header Image	*/
235
#define IH_TYPE_AISIMAGE	13	/* TI Davinci AIS Image		*/
236
#define IH_TYPE_KERNEL_NOLOAD	14	/* OS Kernel Image, can run from any load address */
237
#define IH_TYPE_PBLIMAGE	15	/* Freescale PBL Boot Image	*/
238
#define IH_TYPE_MXSIMAGE	16	/* Freescale MXSBoot Image	*/
239
#define IH_TYPE_GPIMAGE		17	/* TI Keystone GPHeader Image	*/
240
#define IH_TYPE_ATMELIMAGE	18	/* ATMEL ROM bootable Image	*/
241
#define IH_TYPE_SOCFPGAIMAGE	19	/* Altera SOCFPGA Preloader	*/
242
#define IH_TYPE_X86_SETUP	20	/* x86 setup.bin Image		*/
243
#define IH_TYPE_LPC32XXIMAGE	21	/* x86 setup.bin Image		*/
244
#define IH_TYPE_LOADABLE	22	/* A list of typeless images	*/
245
#define IH_TYPE_RKIMAGE		23	/* Rockchip Boot Image		*/
246
#define IH_TYPE_RKSD		24	/* Rockchip SD card		*/
247
#define IH_TYPE_RKSPI		25	/* Rockchip SPI image		*/
248
#define IH_TYPE_ZYNQIMAGE	26	/* Xilinx Zynq Boot Image */
wdenk's avatar
wdenk committed
249

250
#define IH_TYPE_COUNT		27	/* Number of image types */
251

wdenk's avatar
wdenk committed
252 253 254 255 256 257
/*
 * Compression Types
 */
#define IH_COMP_NONE		0	/*  No	 Compression Used	*/
#define IH_COMP_GZIP		1	/* gzip	 Compression Used	*/
#define IH_COMP_BZIP2		2	/* bzip2 Compression Used	*/
258
#define IH_COMP_LZMA		3	/* lzma  Compression Used	*/
259
#define IH_COMP_LZO		4	/* lzo   Compression Used	*/
260
#define IH_COMP_LZ4		5	/* lz4   Compression Used	*/
wdenk's avatar
wdenk committed
261 262 263 264

#define IH_MAGIC	0x27051956	/* Image Magic Number		*/
#define IH_NMLEN		32	/* Image Name Length		*/

265 266 267
/* Reused from common.h */
#define ROUND(a, b)		(((a) + (b) - 1) & ~((b) - 1))

wdenk's avatar
wdenk committed
268
/*
269 270
 * Legacy format image header,
 * all data in network byte order (aka natural aka bigendian).
wdenk's avatar
wdenk committed
271 272
 */
typedef struct image_header {
273 274 275 276 277 278 279
	__be32		ih_magic;	/* Image Header Magic Number	*/
	__be32		ih_hcrc;	/* Image Header CRC Checksum	*/
	__be32		ih_time;	/* Image Creation Timestamp	*/
	__be32		ih_size;	/* Image Data Size		*/
	__be32		ih_load;	/* Data	 Load  Address		*/
	__be32		ih_ep;		/* Entry Point Address		*/
	__be32		ih_dcrc;	/* Image Data CRC Checksum	*/
wdenk's avatar
wdenk committed
280 281 282 283 284 285 286
	uint8_t		ih_os;		/* Operating System		*/
	uint8_t		ih_arch;	/* CPU architecture		*/
	uint8_t		ih_type;	/* Image Type			*/
	uint8_t		ih_comp;	/* Compression Type		*/
	uint8_t		ih_name[IH_NMLEN];	/* Image Name		*/
} image_header_t;

287 288 289 290 291
typedef struct image_info {
	ulong		start, end;		/* start/end of blob */
	ulong		image_start, image_len; /* start of image within blob, len of image */
	ulong		load;			/* load addr for the image */
	uint8_t		comp, type, os;		/* compression, type of image, os type */
292
	uint8_t		arch;			/* CPU architecture */
293 294
} image_info_t;

295 296 297 298 299 300 301
/*
 * Legacy and FIT format headers used by do_bootm() and do_bootm_<os>()
 * routines.
 */
typedef struct bootm_headers {
	/*
	 * Legacy os image header, if it is a multi component image
302
	 * then boot_get_ramdisk() and get_fdt() will attempt to get
303 304
	 * data from second and third component accordingly.
	 */
305 306
	image_header_t	*legacy_hdr_os;		/* image header pointer */
	image_header_t	legacy_hdr_os_copy;	/* header copy */
307 308
	ulong		legacy_hdr_valid;

309
#if IMAGE_ENABLE_FIT
310 311
	const char	*fit_uname_cfg;	/* configuration node unit name */

312
	void		*fit_hdr_os;	/* os FIT image header */
313
	const char	*fit_uname_os;	/* os subimage node unit name */
314
	int		fit_noffset_os;	/* os subimage node offset */
315 316

	void		*fit_hdr_rd;	/* init ramdisk FIT image header */
317 318
	const char	*fit_uname_rd;	/* init ramdisk subimage node unit name */
	int		fit_noffset_rd;	/* init ramdisk subimage node offset */
319 320

	void		*fit_hdr_fdt;	/* FDT blob FIT image header */
321 322
	const char	*fit_uname_fdt;	/* FDT blob subimage node unit name */
	int		fit_noffset_fdt;/* FDT blob subimage node offset */
323 324 325 326

	void		*fit_hdr_setup;	/* x86 setup FIT image header */
	const char	*fit_uname_setup; /* x86 setup subimage node name */
	int		fit_noffset_setup;/* x86 setup subimage node offset */
327
#endif
328

Kumar Gala's avatar
Kumar Gala committed
329
#ifndef USE_HOSTCC
330
	image_info_t	os;		/* os image info */
331 332
	ulong		ep;		/* entry point of OS */

333 334
	ulong		rd_start, rd_end;/* ramdisk start/end */

335 336 337
	char		*ft_addr;	/* flat dev tree address */
	ulong		ft_len;		/* length of flat device tree */

Kumar Gala's avatar
Kumar Gala committed
338 339 340 341 342 343 344
	ulong		initrd_start;
	ulong		initrd_end;
	ulong		cmdline_start;
	ulong		cmdline_end;
	bd_t		*kbd;
#endif

345
	int		verify;		/* getenv("verify")[0] != 'n' */
Kumar Gala's avatar
Kumar Gala committed
346 347

#define	BOOTM_STATE_START	(0x00000001)
348 349 350 351 352 353 354 355
#define	BOOTM_STATE_FINDOS	(0x00000002)
#define	BOOTM_STATE_FINDOTHER	(0x00000004)
#define	BOOTM_STATE_LOADOS	(0x00000008)
#define	BOOTM_STATE_RAMDISK	(0x00000010)
#define	BOOTM_STATE_FDT		(0x00000020)
#define	BOOTM_STATE_OS_CMDLINE	(0x00000040)
#define	BOOTM_STATE_OS_BD_T	(0x00000080)
#define	BOOTM_STATE_OS_PREP	(0x00000100)
356 357
#define	BOOTM_STATE_OS_FAKE_GO	(0x00000200)	/* 'Almost' run the OS */
#define	BOOTM_STATE_OS_GO	(0x00000400)
Kumar Gala's avatar
Kumar Gala committed
358 359
	int		state;

360
#ifdef CONFIG_LMB
361 362
	struct lmb	lmb;		/* for memory mgmt */
#endif
363 364
} bootm_headers_t;

Simon Schwarz's avatar
Simon Schwarz committed
365 366
extern bootm_headers_t images;

367 368 369
/*
 * Some systems (for example LWMON) have very short watchdog periods;
 * we must make sure to split long operations like memmove() or
370
 * checksum calculations into reasonable chunks.
371
 */
372
#ifndef CHUNKSZ
373
#define CHUNKSZ (64 * 1024)
374 375 376 377 378 379 380 381 382 383 384 385 386
#endif

#ifndef CHUNKSZ_CRC32
#define CHUNKSZ_CRC32 (64 * 1024)
#endif

#ifndef CHUNKSZ_MD5
#define CHUNKSZ_MD5 (64 * 1024)
#endif

#ifndef CHUNKSZ_SHA1
#define CHUNKSZ_SHA1 (64 * 1024)
#endif
387

388 389
#define uimage_to_cpu(x)		be32_to_cpu(x)
#define cpu_to_uimage(x)		cpu_to_be32(x)
390

391 392 393 394 395 396 397 398 399 400 401 402 403 404 405
/*
 * Translation table for entries of a specific type; used by
 * get_table_entry_id() and get_table_entry_name().
 */
typedef struct table_entry {
	int	id;
	char	*sname;		/* short (input) name to find table entry */
	char	*lname;		/* long (output) name to print for messages */
} table_entry_t;

/*
 * get_table_entry_id() scans the translation table trying to find an
 * entry that matches the given short name. If a matching entry is
 * found, it's id is returned to the caller.
 */
406
int get_table_entry_id(const table_entry_t *table,
407 408 409 410 411 412
		const char *table_name, const char *name);
/*
 * get_table_entry_name() scans the translation table trying to find
 * an entry that matches the given id. If a matching entry is found,
 * its long name is returned to the caller.
 */
413
char *get_table_entry_name(const table_entry_t *table, char *msg, int id);
414

415
const char *genimg_get_os_name(uint8_t os);
416 417 418 419 420 421 422 423 424

/**
 * genimg_get_os_short_name() - get the short name for an OS
 *
 * @param os	OS (IH_OS_...)
 * @return OS short name, or "unknown" if unknown
 */
const char *genimg_get_os_short_name(uint8_t comp);

425
const char *genimg_get_arch_name(uint8_t arch);
426 427 428 429 430 431 432 433 434

/**
 * genimg_get_arch_short_name() - get the short name for an architecture
 *
 * @param arch	Architecture type (IH_ARCH_...)
 * @return architecture short name, or "unknown" if unknown
 */
const char *genimg_get_arch_short_name(uint8_t arch);

435
const char *genimg_get_type_name(uint8_t type);
436 437 438 439 440 441 442 443 444

/**
 * genimg_get_type_short_name() - get the short name for an image type
 *
 * @param type	Image type (IH_TYPE_...)
 * @return image short name, or "unknown" if unknown
 */
const char *genimg_get_type_short_name(uint8_t type);

445
const char *genimg_get_comp_name(uint8_t comp);
446 447 448 449 450 451 452 453 454

/**
 * genimg_get_comp_short_name() - get the short name for a compression method
 *
 * @param comp	compression method (IH_COMP_...)
 * @return compression method short name, or "unknown" if unknown
 */
const char *genimg_get_comp_short_name(uint8_t comp);

455 456 457 458 459
int genimg_get_os_id(const char *name);
int genimg_get_arch_id(const char *name);
int genimg_get_type_id(const char *name);
int genimg_get_comp_id(const char *name);
void genimg_print_size(uint32_t size);
460

461 462 463 464 465 466 467 468
#if defined(CONFIG_TIMESTAMP) || defined(CONFIG_CMD_DATE) || \
	defined(USE_HOSTCC)
#define IMAGE_ENABLE_TIMESTAMP 1
#else
#define IMAGE_ENABLE_TIMESTAMP 0
#endif
void genimg_print_time(time_t timestamp);

469 470 471 472
/* What to do with a image load address ('load = <> 'in the FIT) */
enum fit_load_op {
	FIT_LOAD_IGNORED,	/* Ignore load address */
	FIT_LOAD_OPTIONAL,	/* Can be provided, but optional */
473
	FIT_LOAD_OPTIONAL_NON_ZERO,	/* Optional, a value of 0 is ignored */
474 475 476
	FIT_LOAD_REQUIRED,	/* Must be provided */
};

477 478 479
int boot_get_setup(bootm_headers_t *images, uint8_t arch, ulong *setup_start,
		   ulong *setup_len);

480 481 482
#ifndef USE_HOSTCC
/* Image format types, returned by _get_format() routine */
#define IMAGE_FORMAT_INVALID	0x00
483
#if defined(CONFIG_IMAGE_FORMAT_LEGACY)
484
#define IMAGE_FORMAT_LEGACY	0x01	/* legacy image_header based format */
485
#endif
486
#define IMAGE_FORMAT_FIT	0x02	/* new, libfdt based format */
487
#define IMAGE_FORMAT_ANDROID	0x03	/* Android boot image */
488

489 490 491
ulong genimg_get_kernel_addr_fit(char * const img_addr,
			         const char **fit_uname_config,
			         const char **fit_uname_kernel);
492
ulong genimg_get_kernel_addr(char * const img_addr);
493
int genimg_get_format(const void *img_addr);
494 495
int genimg_has_config(bootm_headers_t *images);
ulong genimg_get_image(ulong img_addr);
496

497
int boot_get_ramdisk(int argc, char * const argv[], bootm_headers_t *images,
498
		uint8_t arch, ulong *rd_start, ulong *rd_end);
499 500 501 502 503 504 505 506 507 508 509 510 511 512 513 514 515 516 517 518 519 520 521 522 523

/**
 * boot_get_loadable - routine to load a list of binaries to memory
 * @argc: Ignored Argument
 * @argv: Ignored Argument
 * @images: pointer to the bootm images structure
 * @arch: expected architecture for the image
 * @ld_start: Ignored Argument
 * @ld_len: Ignored Argument
 *
 * boot_get_loadable() will take the given FIT configuration, and look
 * for a field named "loadables".  Loadables, is a list of elements in
 * the FIT given as strings.  exe:
 *   loadables = "linux_kernel@1", "fdt@2";
 * this function will attempt to parse each string, and load the
 * corresponding element from the FIT into memory.  Once placed,
 * no aditional actions are taken.
 *
 * @return:
 *     0, if only valid images or no images are found
 *     error code, if an error occurs during fit_image_load
 */
int boot_get_loadable(int argc, char * const argv[], bootm_headers_t *images,
		uint8_t arch, const ulong *ld_start, ulong * const ld_len);
#endif /* !USE_HOSTCC */
524

525 526 527
int boot_get_setup_fit(bootm_headers_t *images, uint8_t arch,
		       ulong *setup_start, ulong *setup_len);

528 529 530 531 532 533 534 535
/**
 * fit_image_load() - load an image from a FIT
 *
 * This deals with all aspects of loading an image from a FIT, including
 * selecting the right image based on configuration, verifying it, printing
 * out progress messages, checking the type/arch/os and optionally copying it
 * to the right load address.
 *
536 537
 * The property to look up is defined by image_type.
 *
538 539 540 541 542
 * @param images	Boot images structure
 * @param addr		Address of FIT in memory
 * @param fit_unamep	On entry this is the requested image name
 *			(e.g. "kernel@1") or NULL to use the default. On exit
 *			points to the selected image name
543 544 545
 * @param fit_uname_configp	On entry this is the requested configuration
 *			name (e.g. "conf@1") or NULL to use the default. On
 *			exit points to the selected configuration name.
546 547 548 549 550 551 552 553 554 555
 * @param arch		Expected architecture (IH_ARCH_...)
 * @param image_type	Required image type (IH_TYPE_...). If this is
 *			IH_TYPE_KERNEL then we allow IH_TYPE_KERNEL_NOLOAD
 *			also.
 * @param bootstage_id	ID of starting bootstage to use for progress updates.
 *			This will be added to the BOOTSTAGE_SUB values when
 *			calling bootstage_mark()
 * @param load_op	Decribes what to do with the load address
 * @param datap		Returns address of loaded image
 * @param lenp		Returns length of loaded image
556
 * @return node offset of image, or -ve error code on error
557
 */
558
int fit_image_load(bootm_headers_t *images, ulong addr,
559
		   const char **fit_unamep, const char **fit_uname_configp,
560 561 562
		   int arch, int image_type, int bootstage_id,
		   enum fit_load_op load_op, ulong *datap, ulong *lenp);

563
#ifndef USE_HOSTCC
564 565 566 567 568 569 570 571 572 573 574 575 576 577 578 579 580 581 582 583 584 585 586 587 588 589 590 591 592 593
/**
 * fit_get_node_from_config() - Look up an image a FIT by type
 *
 * This looks in the selected conf@ node (images->fit_uname_cfg) for a
 * particular image type (e.g. "kernel") and then finds the image that is
 * referred to.
 *
 * For example, for something like:
 *
 * images {
 *	kernel@1 {
 *		...
 *	};
 * };
 * configurations {
 *	conf@1 {
 *		kernel = "kernel@1";
 *	};
 * };
 *
 * the function will return the node offset of the kernel@1 node, assuming
 * that conf@1 is the chosen configuration.
 *
 * @param images	Boot images structure
 * @param prop_name	Property name to look up (FIT_..._PROP)
 * @param addr		Address of FIT in memory
 */
int fit_get_node_from_config(bootm_headers_t *images, const char *prop_name,
			ulong addr);

594 595 596
int boot_get_fdt(int flag, int argc, char * const argv[], uint8_t arch,
		 bootm_headers_t *images,
		 char **of_flat_tree, ulong *of_size);
597
void boot_fdt_add_mem_rsv_regions(struct lmb *lmb, void *fdt_blob);
598
int boot_relocate_fdt(struct lmb *lmb, char **of_flat_tree, ulong *of_size);
599

600
int boot_ramdisk_high(struct lmb *lmb, ulong rd_data, ulong rd_len,
601
		  ulong *initrd_start, ulong *initrd_end);
602
int boot_get_cmdline(struct lmb *lmb, ulong *cmd_start, ulong *cmd_end);
603
#ifdef CONFIG_SYS_BOOT_GET_KBD
604
int boot_get_kbd(struct lmb *lmb, bd_t **kbd);
605
#endif /* CONFIG_SYS_BOOT_GET_KBD */
606
#endif /* !USE_HOSTCC */
607

608 609 610
/*******************************************************************/
/* Legacy format specific code (prefixed with image_) */
/*******************************************************************/
611
static inline uint32_t image_get_header_size(void)
612
{
613
	return (sizeof(image_header_t));
614 615 616
}

#define image_get_hdr_l(f) \
617
	static inline uint32_t image_get_##f(const image_header_t *hdr) \
618
	{ \
619
		return uimage_to_cpu(hdr->ih_##f); \
620
	}
621 622 623 624 625 626 627
image_get_hdr_l(magic)		/* image_get_magic */
image_get_hdr_l(hcrc)		/* image_get_hcrc */
image_get_hdr_l(time)		/* image_get_time */
image_get_hdr_l(size)		/* image_get_size */
image_get_hdr_l(load)		/* image_get_load */
image_get_hdr_l(ep)		/* image_get_ep */
image_get_hdr_l(dcrc)		/* image_get_dcrc */
628 629

#define image_get_hdr_b(f) \
630
	static inline uint8_t image_get_##f(const image_header_t *hdr) \
631 632 633
	{ \
		return hdr->ih_##f; \
	}
634 635 636 637
image_get_hdr_b(os)		/* image_get_os */
image_get_hdr_b(arch)		/* image_get_arch */
image_get_hdr_b(type)		/* image_get_type */
image_get_hdr_b(comp)		/* image_get_comp */
638

639
static inline char *image_get_name(const image_header_t *hdr)
640 641 642 643
{
	return (char *)hdr->ih_name;
}

644
static inline uint32_t image_get_data_size(const image_header_t *hdr)
645
{
646
	return image_get_size(hdr);
647
}
648 649 650 651 652 653 654 655 656 657 658 659

/**
 * image_get_data - get image payload start address
 * @hdr: image header
 *
 * image_get_data() returns address of the image payload. For single
 * component images it is image data start. For multi component
 * images it points to the null terminated table of sub-images sizes.
 *
 * returns:
 *     image payload data start address
 */
660
static inline ulong image_get_data(const image_header_t *hdr)
661
{
662
	return ((ulong)hdr + image_get_header_size());
663 664
}

665
static inline uint32_t image_get_image_size(const image_header_t *hdr)
666
{
667
	return (image_get_size(hdr) + image_get_header_size());
668
}
669
static inline ulong image_get_image_end(const image_header_t *hdr)
670
{
671
	return ((ulong)hdr + image_get_image_size(hdr));
672 673 674 675 676
}

#define image_set_hdr_l(f) \
	static inline void image_set_##f(image_header_t *hdr, uint32_t val) \
	{ \
677
		hdr->ih_##f = cpu_to_uimage(val); \
678
	}
679 680 681 682 683 684 685
image_set_hdr_l(magic)		/* image_set_magic */
image_set_hdr_l(hcrc)		/* image_set_hcrc */
image_set_hdr_l(time)		/* image_set_time */
image_set_hdr_l(size)		/* image_set_size */
image_set_hdr_l(load)		/* image_set_load */
image_set_hdr_l(ep)		/* image_set_ep */
image_set_hdr_l(dcrc)		/* image_set_dcrc */
686 687 688 689 690 691

#define image_set_hdr_b(f) \
	static inline void image_set_##f(image_header_t *hdr, uint8_t val) \
	{ \
		hdr->ih_##f = val; \
	}
692 693 694 695
image_set_hdr_b(os)		/* image_set_os */
image_set_hdr_b(arch)		/* image_set_arch */
image_set_hdr_b(type)		/* image_set_type */
image_set_hdr_b(comp)		/* image_set_comp */
696

697
static inline void image_set_name(image_header_t *hdr, const char *name)
698
{
699
	strncpy(image_get_name(hdr), name, IH_NMLEN);
700 701
}

702 703
int image_check_hcrc(const image_header_t *hdr);
int image_check_dcrc(const image_header_t *hdr);
704
#ifndef USE_HOSTCC
705
ulong getenv_bootm_low(void);
706
phys_size_t getenv_bootm_size(void);
707
phys_size_t getenv_bootm_mapsize(void);
708
#endif
709
void memmove_wd(void *to, void *from, size_t len, ulong chunksz);
710

711
static inline int image_check_magic(const image_header_t *hdr)
712
{
713
	return (image_get_magic(hdr) == IH_MAGIC);
714
}
715
static inline int image_check_type(const image_header_t *hdr, uint8_t type)
716
{
717
	return (image_get_type(hdr) == type);
718
}
719
static inline int image_check_arch(const image_header_t *hdr, uint8_t arch)
720
{
721
	return (image_get_arch(hdr) == arch);
722
}
723
static inline int image_check_os(const image_header_t *hdr, uint8_t os)
724
{
725
	return (image_get_os(hdr) == os);
726 727
}

728 729
ulong image_multi_count(const image_header_t *hdr);
void image_multi_getimg(const image_header_t *hdr, ulong idx,
730 731
			ulong *data, ulong *len);

732
void image_print_contents(const void *hdr);
733

734
#ifndef USE_HOSTCC
735
static inline int image_check_target_arch(const image_header_t *hdr)
736
{
737 738
#ifndef IH_ARCH_DEFAULT
# error "please define IH_ARCH_DEFAULT in your arch asm/u-boot.h"
739
#endif
740
	return image_check_arch(hdr, IH_ARCH_DEFAULT);
741
}
742
#endif /* USE_HOSTCC */
wdenk's avatar
wdenk committed
743

744 745 746 747 748 749 750 751 752 753 754 755 756 757 758 759 760 761 762 763 764 765 766 767 768
/**
 * Set up properties in the FDT
 *
 * This sets up properties in the FDT that is to be passed to linux.
 *
 * @images:	Images information
 * @blob:	FDT to update
 * @of_size:	Size of the FDT
 * @lmb:	Points to logical memory block structure
 * @return 0 if ok, <0 on failure
 */
int image_setup_libfdt(bootm_headers_t *images, void *blob,
		       int of_size, struct lmb *lmb);

/**
 * Set up the FDT to use for booting a kernel
 *
 * This performs ramdisk setup, sets up the FDT if required, and adds
 * paramters to the FDT if libfdt is available.
 *
 * @param images	Images information
 * @return 0 if ok, <0 on failure
 */
int image_setup_linux(bootm_headers_t *images);

769 770 771 772 773 774 775 776 777 778 779
/**
 * bootz_setup() - Extract stat and size of a Linux xImage
 *
 * @image: Address of image
 * @start: Returns start address of image
 * @end : Returns end address of image
 * @return 0 if OK, 1 if the image was not recognised
 */
int bootz_setup(ulong image, ulong *start, ulong *end);


780
/*******************************************************************/
781
/* New uImage format specific code (prefixed with fit_) */
782
/*******************************************************************/
783 784 785 786

#define FIT_IMAGES_PATH		"/images"
#define FIT_CONFS_PATH		"/configurations"

787
/* hash/signature node */
788 789 790
#define FIT_HASH_NODENAME	"hash"
#define FIT_ALGO_PROP		"algo"
#define FIT_VALUE_PROP		"value"
791
#define FIT_IGNORE_PROP		"uboot-ignore"
792
#define FIT_SIG_NODENAME	"signature"
793 794 795 796 797 798 799 800 801 802 803 804 805 806 807 808

/* image node */
#define FIT_DATA_PROP		"data"
#define FIT_TIMESTAMP_PROP	"timestamp"
#define FIT_DESC_PROP		"description"
#define FIT_ARCH_PROP		"arch"
#define FIT_TYPE_PROP		"type"
#define FIT_OS_PROP		"os"
#define FIT_COMP_PROP		"compression"
#define FIT_ENTRY_PROP		"entry"
#define FIT_LOAD_PROP		"load"

/* configuration node */
#define FIT_KERNEL_PROP		"kernel"
#define FIT_RAMDISK_PROP	"ramdisk"
#define FIT_FDT_PROP		"fdt"
809
#define FIT_LOADABLE_PROP	"loadables"
810
#define FIT_DEFAULT_PROP	"default"
811
#define FIT_SETUP_PROP		"setup"
812

813
#define FIT_MAX_HASH_LEN	HASH_MAX_DIGEST_SIZE
814

815
#if IMAGE_ENABLE_FIT
816
/* cmdline argument format parsing */
817
int fit_parse_conf(const char *spec, ulong addr_curr,
818
		ulong *addr, const char **conf_name);
819
int fit_parse_subimage(const char *spec, ulong addr_curr,
820
		ulong *addr, const char **image_name);
821

822
int fit_get_subimage_count(const void *fit, int images_noffset);
823 824
void fit_print_contents(const void *fit);
void fit_image_print(const void *fit, int noffset, const char *p);
825 826 827 828 829 830 831 832

/**
 * fit_get_end - get FIT image size
 * @fit: pointer to the FIT format image header
 *
 * returns:
 *     size of the FIT image (blob) in memory
 */
833
static inline ulong fit_get_size(const void *fit)
834
{
835
	return fdt_totalsize(fit);
836 837 838 839 840 841 842 843 844
}

/**
 * fit_get_end - get FIT image end
 * @fit: pointer to the FIT format image header
 *
 * returns:
 *     end address of the FIT image (blob) in memory
 */
845
ulong fit_get_end(const void *fit);
846 847 848 849 850 851 852 853 854

/**
 * fit_get_name - get FIT node name
 * @fit: pointer to the FIT format image header
 *
 * returns:
 *     NULL, on error
 *     pointer to node name, on success
 */
855
static inline const char *fit_get_name(const void *fit_hdr,
856 857
		int noffset, int *len)
{
858
	return fdt_get_name(fit_hdr, noffset, len);
859 860
}

861 862 863 864 865 866 867 868 869 870 871
int fit_get_desc(const void *fit, int noffset, char **desc);
int fit_get_timestamp(const void *fit, int noffset, time_t *timestamp);

int fit_image_get_node(const void *fit, const char *image_uname);
int fit_image_get_os(const void *fit, int noffset, uint8_t *os);
int fit_image_get_arch(const void *fit, int noffset, uint8_t *arch);
int fit_image_get_type(const void *fit, int noffset, uint8_t *type);
int fit_image_get_comp(const void *fit, int noffset, uint8_t *comp);
int fit_image_get_load(const void *fit, int noffset, ulong *load);
int fit_image_get_entry(const void *fit, int noffset, ulong *entry);
int fit_image_get_data(const void *fit, int noffset,
872 873
				const void **data, size_t *size);

874 875
int fit_image_hash_get_algo(const void *fit, int noffset, char **algo);
int fit_image_hash_get_value(const void *fit, int noffset, uint8_t **value,
876 877
				int *value_len);

878
int fit_set_timestamp(void *fit, int noffset, time_t timestamp);
879 880

/**
881
 * fit_add_verification_data() - add verification data to FIT image nodes
882
 *
883 884 885 886 887 888 889 890 891 892 893 894 895 896 897
 * @keydir:	Directory containing keys
 * @kwydest:	FDT blob to write public key information to
 * @fit:	Pointer to the FIT format image header
 * @comment:	Comment to add to signature nodes
 * @require_keys: Mark all keys as 'required'
 *
 * Adds hash values for all component images in the FIT blob.
 * Hashes are calculated for all component images which have hash subnodes
 * with algorithm property set to one of the supported hash algorithms.
 *
 * Also add signatures if signature nodes are present.
 *
 * returns
 *     0, on success
 *     libfdt error code, on failure
898
 */
899 900
int fit_add_verification_data(const char *keydir, void *keydest, void *fit,
			      const char *comment, int require_keys);
901

902
int fit_image_verify(const void *fit, int noffset);
903
int fit_config_verify(const void *fit, int conf_noffset);
904
int fit_all_image_verify(const void *fit);
905 906 907 908 909
int fit_image_check_os(const void *fit, int noffset, uint8_t os);
int fit_image_check_arch(const void *fit, int noffset, uint8_t arch);
int fit_image_check_type(const void *fit, int noffset, uint8_t type);
int fit_image_check_comp(const void *fit, int noffset, uint8_t comp);
int fit_check_format(const void *fit);
910

911
int fit_conf_find_compat(const void *fit, const void *fdt);
912
int fit_conf_get_node(const void *fit, const char *conf_uname);
913

914 915 916 917 918 919 920 921 922 923 924 925 926 927
/**
 * fit_conf_get_prop_node() - Get node refered to by a configuration
 * @fit:	FIT to check
 * @noffset:	Offset of conf@xxx node to check
 * @prop_name:	Property to read from the conf node
 *
 * The conf@ nodes contain references to other nodes, using properties
 * like 'kernel = "kernel@1"'. Given such a property name (e.g. "kernel"),
 * return the offset of the node referred to (e.g. offset of node
 * "/images/kernel@1".
 */
int fit_conf_get_prop_node(const void *fit, int noffset,
		const char *prop_name);

928
void fit_conf_print(const void *fit, int noffset, const char *p);
929

930 931 932
int fit_check_ramdisk(const void *fit, int os_noffset,
		uint8_t arch, int verify);

933 934 935
int calculate_hash(const void *data, int data_len, const char *algo,
			uint8_t *value, int *value_len);

936
/*
937 938
 * At present we only support signing on the host, and verification on the
 * device
939 940 941
 */
#if defined(CONFIG_FIT_SIGNATURE)
# ifdef USE_HOSTCC
942
#  define IMAGE_ENABLE_SIGN	1
943
#  define IMAGE_ENABLE_VERIFY	1
944
# include  <openssl/evp.h>
945
#else
946
#  define IMAGE_ENABLE_SIGN	0
947 948 949
#  define IMAGE_ENABLE_VERIFY	1
# endif
#else
950
# define IMAGE_ENABLE_SIGN	0
951 952 953 954
# define IMAGE_ENABLE_VERIFY	0
#endif

#ifdef USE_HOSTCC
955 956 957
void *image_get_host_blob(void);
void image_set_host_blob(void *host_blob);
# define gd_fdt_blob()		image_get_host_blob()
958 959 960 961 962 963 964 965 966 967
#else
# define gd_fdt_blob()		(gd->fdt_blob)
#endif

#ifdef CONFIG_FIT_BEST_MATCH
#define IMAGE_ENABLE_BEST_MATCH	1
#else
#define IMAGE_ENABLE_BEST_MATCH	0
#endif

968 969 970 971 972 973 974 975 976 977 978
/* Information passed to the signing routines */
struct image_sign_info {
	const char *keydir;		/* Directory conaining keys */
	const char *keyname;		/* Name of key to use */
	void *fit;			/* Pointer to FIT blob */
	int node_offset;		/* Offset of signature node */
	struct image_sig_algo *algo;	/* Algorithm information */
	const void *fdt_blob;		/* FDT containing public keys */
	int required_keynode;		/* Node offset of key to use: -1=any */
	const char *require_keys;	/* Value for 'required' property */
};
979
#endif /* Allow struct image_region to always be defined for rsa.h */
980 981 982 983 984 985 986

/* A part of an image, used for hashing */
struct image_region {
	const void *data;
	int size;
};

987 988
#if IMAGE_ENABLE_FIT

989
#if IMAGE_ENABLE_VERIFY
990
# include <u-boot/rsa-checksum.h>
991 992 993 994
#endif
struct checksum_algo {
	const char *name;
	const int checksum_len;
995
	const int pad_len;
996
#if IMAGE_ENABLE_SIGN
997 998
	const EVP_MD *(*calculate_sign)(void);
#endif
999 1000 1001
	int (*calculate)(const char *name,
			 const struct image_region region[],
			 int region_count, uint8_t *checksum);
1002 1003 1004
	const uint8_t *rsa_padding;
};

1005 1006 1007 1008 1009 1010 1011 1012 1013 1014 1015 1016 1017 1018 1019 1020 1021 1022 1023 1024 1025 1026 1027 1028 1029 1030 1031 1032 1033 1034 1035 1036 1037 1038 1039 1040 1041 1042 1043 1044 1045 1046 1047 1048 1049 1050 1051 1052 1053 1054
struct image_sig_algo {
	const char *name;		/* Name of algorithm */

	/**
	 * sign() - calculate and return signature for given input data
	 *
	 * @info:	Specifies key and FIT information
	 * @data:	Pointer to the input data
	 * @data_len:	Data length
	 * @sigp:	Set to an allocated buffer holding the signature
	 * @sig_len:	Set to length of the calculated hash
	 *
	 * This computes input data signature according to selected algorithm.
	 * Resulting signature value is placed in an allocated buffer, the
	 * pointer is returned as *sigp. The length of the calculated
	 * signature is returned via the sig_len pointer argument. The caller
	 * should free *sigp.
	 *
	 * @return: 0, on success, -ve on error
	 */
	int (*sign)(struct image_sign_info *info,
		    const struct image_region region[],
		    int region_count, uint8_t **sigp, uint *sig_len);

	/**
	 * add_verify_data() - Add verification information to FDT
	 *
	 * Add public key information to the FDT node, suitable for
	 * verification at run-time. The information added depends on the
	 * algorithm being used.
	 *
	 * @info:	Specifies key and FIT information
	 * @keydest:	Destination FDT blob for public key data
	 * @return: 0, on success, -ve on error
	 */
	int (*add_verify_data)(struct image_sign_info *info, void *keydest);

	/**
	 * verify() - Verify a signature against some data
	 *
	 * @info:	Specifies key and FIT information
	 * @data:	Pointer to the input data
	 * @data_len:	Data length
	 * @sig:	Signature
	 * @sig_len:	Number of bytes in signature
	 * @return 0 if verified, -ve on error
	 */
	int (*verify)(struct image_sign_info *info,
		      const struct image_region region[], int region_count,
		      uint8_t *sig, uint sig_len);
1055 1056 1057

	/* pointer to checksum algorithm */
	struct checksum_algo *checksum;
1058 1059 1060 1061 1062 1063 1064 1065 1066 1067
};

/**
 * image_get_sig_algo() - Look up a signature algortihm
 *
 * @param name		Name of algorithm
 * @return pointer to algorithm information, or NULL if not found
 */
struct image_sig_algo *image_get_sig_algo(const char *name);

1068 1069 1070 1071 1072 1073 1074 1075 1076 1077 1078 1079 1080 1081 1082 1083 1084 1085 1086 1087 1088 1089 1090 1091 1092 1093 1094 1095 1096 1097 1098 1099 1100 1101 1102 1103
/**
 * fit_image_verify_required_sigs() - Verify signatures marked as 'required'
 *
 * @fit:		FIT to check
 * @image_noffset:	Offset of image node to check
 * @data:		Image data to check
 * @size:		Size of image data
 * @sig_blob:		FDT containing public keys
 * @no_sigsp:		Returns 1 if no signatures were required, and
 *			therefore nothing was checked. The caller may wish
 *			to fall back to other mechanisms, or refuse to
 *			boot.
 * @return 0 if all verified ok, <0 on error
 */
int fit_image_verify_required_sigs(const void *fit, int image_noffset,
		const char *data, size_t size, const void *sig_blob,
		int *no_sigsp);

/**
 * fit_image_check_sig() - Check a single image signature node
 *
 * @fit:		FIT to check
 * @noffset:		Offset of signature node to check
 * @data:		Image data to check
 * @size:		Size of image data
 * @required_keynode:	Offset in the control FDT of the required key node,
 *			if any. If this is given, then the image wil not
 *			pass verification unless that key is used. If this is
 *			-1 then any signature will do.
 * @err_msgp:		In the event of an error, this will be pointed to a
 *			help error string to display to the user.
 * @return 0 if all verified ok, <0 on error
 */
int fit_image_check_sig(const void *fit, int noffset, const void *data,
		size_t size, int required_keynode, char **err_msgp);

1104 1105 1106 1107 1108 1109 1110 1111 1112 1113 1114 1115 1116 1117 1118 1119
/**
 * fit_region_make_list() - Make a list of regions to hash
 *
 * Given a list of FIT regions (offset, size) provided by libfdt, create
 * a list of regions (void *, size) for use by the signature creationg
 * and verification code.
 *
 * @fit:		FIT image to process
 * @fdt_regions:	Regions as returned by libfdt
 * @count:		Number of regions returned by libfdt
 * @region:		Place to put list of regions (NULL to allocate it)
 * @return pointer to list of regions, or NULL if out of memory
 */
struct image_region *fit_region_make_list(const void *fit,
		struct fdt_region *fdt_regions, int count,
		struct image_region *region);
1120

1121
static inline int fit_image_check_target_arch(const void *fdt, int node)
1122
{
1123
#ifndef USE_HOSTCC
1124
	return fit_image_check_arch(fdt, node, IH_ARCH_DEFAULT);
1125 1126 1127
#else
	return 0;
#endif
1128 1129
}

1130
#ifdef CONFIG_FIT_VERBOSE
1131
#define fit_unsupported(msg)	printf("! %s:%d " \
1132 1133 1134
				"FIT images not supported for '%s'\n", \
				__FILE__, __LINE__, (msg))

1135
#define fit_unsupported_reset(msg)	printf("! %s:%d " \
1136 1137 1138 1139 1140 1141 1142
				"FIT images not supported for '%s' " \
				"- must reset board to recover!\n", \
				__FILE__, __LINE__, (msg))
#else
#define fit_unsupported(msg)
#define fit_unsupported_reset(msg)
#endif /* CONFIG_FIT_VERBOSE */
1143
#endif /* CONFIG_FIT */
1144

1145 1146 1147 1148 1149 1150 1151 1152 1153 1154 1155 1156
#if defined(CONFIG_ANDROID_BOOT_IMAGE)
struct andr_img_hdr;
int android_image_check_header(const struct andr_img_hdr *hdr);
int android_image_get_kernel(const struct andr_img_hdr *hdr, int verify,
			     ulong *os_data, ulong *os_len);
int android_image_get_ramdisk(const struct andr_img_hdr *hdr,
			      ulong *rd_data, ulong *rd_len);
ulong android_image_get_end(const struct andr_img_hdr *hdr);
ulong android_image_get_kload(const struct andr_img_hdr *hdr);

#endif /* CONFIG_ANDROID_BOOT_IMAGE */

1157 1158 1159 1160 1161 1162 1163 1164 1165 1166 1167 1168 1169
/**
 * board_fit_config_name_match() - Check for a matching board name
 *
 * This is used when SPL loads a FIT containing multiple device tree files
 * and wants to work out which one to use. The description of each one is
 * passed to this function. The description comes from the 'description' field
 * in each (FDT) image node.
 *
 * @name: Device tree description
 * @return 0 if this device tree should be used, non-zero to try the next
 */
int board_fit_config_name_match(const char *name);

1170
#endif	/* __IMAGE_H__ */