Skip to content
Snippets Groups Projects
android_image.h 1.97 KiB
Newer Older
  • Learn to ignore specific revisions
  • /*
     * This is from the Android Project,
     * Repository: https://android.googlesource.com/platform/bootable/bootloader/legacy
     * File: include/boot/bootimg.h
     * Commit: 4205b865141ff2e255fe1d3bd16de18e217ef06a
     *
     * Copyright (C) 2008 The Android Open Source Project
     *
     * SPDX-License-Identifier: BSD-2-Clause
     */
    
    #ifndef _ANDROID_IMAGE_H_
    #define _ANDROID_IMAGE_H_
    
    #define ANDR_BOOT_MAGIC "ANDROID!"
    #define ANDR_BOOT_MAGIC_SIZE 8
    #define ANDR_BOOT_NAME_SIZE 16
    #define ANDR_BOOT_ARGS_SIZE 512
    
    struct andr_img_hdr {
    	char magic[ANDR_BOOT_MAGIC_SIZE];
    
    	u32 kernel_size;	/* size in bytes */
    	u32 kernel_addr;	/* physical load addr */
    
    	u32 ramdisk_size;	/* size in bytes */
    	u32 ramdisk_addr;	/* physical load addr */
    
    	u32 second_size;	/* size in bytes */
    	u32 second_addr;	/* physical load addr */
    
    	u32 tags_addr;		/* physical addr for kernel tags */
    	u32 page_size;		/* flash page size we assume */
    	u32 unused[2];		/* future expansion: should be 0 */
    
    	char name[ANDR_BOOT_NAME_SIZE]; /* asciiz product name */
    
    	char cmdline[ANDR_BOOT_ARGS_SIZE];
    
    	u32 id[8]; /* timestamp / checksum / sha1 / etc */
    };
    
    /*
     * +-----------------+
     * | boot header     | 1 page
     * +-----------------+
     * | kernel          | n pages
     * +-----------------+
     * | ramdisk         | m pages
     * +-----------------+
     * | second stage    | o pages
     * +-----------------+
     *
     * n = (kernel_size + page_size - 1) / page_size
     * m = (ramdisk_size + page_size - 1) / page_size
     * o = (second_size + page_size - 1) / page_size
     *
     * 0. all entities are page_size aligned in flash
     * 1. kernel and ramdisk are required (size != 0)
     * 2. second is optional (second_size == 0 -> no second)
     * 3. load each element (kernel, ramdisk, second) at
     *    the specified physical address (kernel_addr, etc)
     * 4. prepare tags at tag_addr.  kernel_args[] is
     *    appended to the kernel commandline in the tags.
     * 5. r0 = 0, r1 = MACHINE_TYPE, r2 = tags_addr
     * 6. if second_size != 0: jump to second_addr
     *    else: jump to kernel_addr
     */
    #endif