doc/uImage.FIT/howto.txt

1 How to use images in the new image format
23 an image source file, which describes the contents of the image and defines
24 its various properties used during booting. By convention, image source file
27 the uImage (kernel, ramdisk, etc.) is specified in the image source file in the
28 form of paths to appropriate data files. The outcome of the image creation
37 - image source file (*.its)
38 - image data file(s)
41 Here's a graphical overview of the image creation and booting process:
43 image source file     mkimage + dtc		  transfer to target
44 	+	     ---------------> image file --------------------> bootm
45 image data file(s)
50 The SPL can make use of the new image format as well, this traditionally
51 is used to ship multiple device tree files within one image. Code in the SPL
55 arbitrary image files as well. These binaries should be specified in their
60 If a platform specific image source file (.its) is shipped with the U-Boot
63 the image.
65 can point to a script which generates this image source file during
76 The uImage can be produced using the image source file
79 specified in the kernel.its file). Here's how to create the image and inspect
87 FIT description: Simple image with single Linux kernel
89  Image 0 (kernel@1)
91   Type:		Kernel Image
108 The resulting image file kernel.itb can be now transferred to the target,
111 specific to the new image format).
129 ## Checking Image at 00900000 ...
130    FIT image found
131    FIT description: Simple image with single Linux kernel
133     Image 0 (kernel@1)
135      Type:	   Kernel Image
153 ## Booting kernel from FIT Image at 00900000 ...
157      Type:	   Kernel Image
170    Uncompressing Kernel Image ... OK
187 be produced using image source file doc/uImage.FIT/kernel_fdt.its like this
189 the current working directory -- image source file kernel_fdt.its can be
197 FIT description: Simple image with single Linux kernel and FDT blob
199  Image 0 (kernel@1)
201   Type:		Kernel Image
212  Image 1 (fdt@1)
229 The resulting image file kernel_fdt.itb can be now transferred to the target,
244 ## Checking Image at 00900000 ...
245    FIT image found
246    FIT description: Simple image with single Linux kernel and FDT blob
248     Image 0 (kernel@1)
250      Type:	   Kernel Image
262     Image 1 (fdt@1)
279 ## Booting kernel from FIT Image at 00900000 ...
283      Type:	   Kernel Image
296    Uncompressing Kernel Image ... OK
297 ## Flattened Device Tree from FIT Image at 00900000
320 Refer to doc/uImage.FIT/multi.its for an image source file that allows more