android_image.h 2.0 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869
  1. /*
  2. * This is from the Android Project,
  3. * Repository: https://android.googlesource.com/platform/bootable/bootloader/legacy
  4. * File: include/boot/bootimg.h
  5. * Commit: 4205b865141ff2e255fe1d3bd16de18e217ef06a
  6. *
  7. * Copyright (C) 2008 The Android Open Source Project
  8. *
  9. * SPDX-License-Identifier: BSD-2-Clause
  10. */
  11. #ifndef _ANDROID_IMAGE_H_
  12. #define _ANDROID_IMAGE_H_
  13. #define ANDR_BOOT_MAGIC "ANDROID!"
  14. #define ANDR_BOOT_MAGIC_SIZE 8
  15. #define ANDR_BOOT_NAME_SIZE 16
  16. #define ANDR_BOOT_ARGS_SIZE 512
  17. struct andr_img_hdr {
  18. char magic[ANDR_BOOT_MAGIC_SIZE];
  19. u32 kernel_size; /* size in bytes */
  20. u32 kernel_addr; /* physical load addr */
  21. u32 ramdisk_size; /* size in bytes */
  22. u32 ramdisk_addr; /* physical load addr */
  23. u32 second_size; /* size in bytes */
  24. u32 second_addr; /* physical load addr */
  25. u32 tags_addr; /* physical addr for kernel tags */
  26. u32 page_size; /* flash page size we assume */
  27. u32 unused[2]; /* future expansion: should be 0 */
  28. char name[ANDR_BOOT_NAME_SIZE]; /* asciiz product name */
  29. char cmdline[ANDR_BOOT_ARGS_SIZE];
  30. u32 id[8]; /* timestamp / checksum / sha1 / etc */
  31. };
  32. /*
  33. * +-----------------+
  34. * | boot header | 1 page
  35. * +-----------------+
  36. * | kernel | n pages
  37. * +-----------------+
  38. * | ramdisk | m pages
  39. * +-----------------+
  40. * | second stage | o pages
  41. * +-----------------+
  42. *
  43. * n = (kernel_size + page_size - 1) / page_size
  44. * m = (ramdisk_size + page_size - 1) / page_size
  45. * o = (second_size + page_size - 1) / page_size
  46. *
  47. * 0. all entities are page_size aligned in flash
  48. * 1. kernel and ramdisk are required (size != 0)
  49. * 2. second is optional (second_size == 0 -> no second)
  50. * 3. load each element (kernel, ramdisk, second) at
  51. * the specified physical address (kernel_addr, etc)
  52. * 4. prepare tags at tag_addr. kernel_args[] is
  53. * appended to the kernel commandline in the tags.
  54. * 5. r0 = 0, r1 = MACHINE_TYPE, r2 = tags_addr
  55. * 6. if second_size != 0: jump to second_addr
  56. * else: jump to kernel_addr
  57. */
  58. #endif