sunxi_image.h 3.2 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182
  1. /* SPDX-License-Identifier: GPL-2.0+ */
  2. /*
  3. * (C) Copyright 2007-2011
  4. * Allwinner Technology Co., Ltd. <www.allwinnertech.com>
  5. * Tom Cubie <tangliang@allwinnertech.com>
  6. *
  7. * Constants and data structures used in Allwinner "eGON" images, as
  8. * parsed by the Boot-ROM.
  9. *
  10. * Shared between mkimage and the SPL.
  11. */
  12. #ifndef SUNXI_IMAGE_H
  13. #define SUNXI_IMAGE_H
  14. #define BOOT0_MAGIC "eGON.BT0"
  15. #define BROM_STAMP_VALUE 0x5f0a6c39
  16. #define SPL_SIGNATURE "SPL" /* marks "sunxi" SPL header */
  17. #define SPL_MAJOR_BITS 3
  18. #define SPL_MINOR_BITS 5
  19. #define SPL_VERSION(maj, min) \
  20. ((((maj) & ((1U << SPL_MAJOR_BITS) - 1)) << SPL_MINOR_BITS) | \
  21. ((min) & ((1U << SPL_MINOR_BITS) - 1)))
  22. #define SPL_HEADER_VERSION SPL_VERSION(0, 2)
  23. #define SPL_ENV_HEADER_VERSION SPL_VERSION(0, 1)
  24. #define SPL_DT_HEADER_VERSION SPL_VERSION(0, 2)
  25. #define SPL_DRAM_HEADER_VERSION SPL_VERSION(0, 3)
  26. /* boot head definition from sun4i boot code */
  27. struct boot_file_head {
  28. uint32_t b_instruction; /* one intruction jumping to real code */
  29. uint8_t magic[8]; /* ="eGON.BT0" or "eGON.BT1", not C-style str */
  30. uint32_t check_sum; /* generated by PC */
  31. uint32_t length; /* generated by PC */
  32. /*
  33. * We use a simplified header, only filling in what is needed
  34. * by the boot ROM. To be compatible with Allwinner tools we
  35. * would need to implement the proper fields here instead of
  36. * padding.
  37. *
  38. * Actually we want the ability to recognize our "sunxi" variant
  39. * of the SPL. To do so, let's place a special signature into the
  40. * "pub_head_size" field. We can reasonably expect Allwinner's
  41. * boot0 to always have the upper 16 bits of this set to 0 (after
  42. * all the value shouldn't be larger than the limit imposed by
  43. * SRAM size).
  44. * If the signature is present (at 0x14), then we know it's safe
  45. * to use the remaining 8 bytes (at 0x18) for our own purposes.
  46. * (E.g. sunxi-tools "fel" utility can pass information there.)
  47. */
  48. union {
  49. uint32_t pub_head_size;
  50. uint8_t spl_signature[4];
  51. };
  52. uint32_t fel_script_address; /* since v0.1, set by sunxi-fel */
  53. /*
  54. * If the fel_uEnv_length member below is set to a non-zero value,
  55. * it specifies the size (byte count) of data at fel_script_address.
  56. * At the same time this indicates that the data is in uEnv.txt
  57. * compatible format, ready to be imported via "env import -t".
  58. */
  59. uint32_t fel_uEnv_length; /* since v0.1, set by sunxi-fel */
  60. /*
  61. * Offset of an ASCIIZ string (relative to the SPL header), which
  62. * contains the default device tree name (CONFIG_DEFAULT_DEVICE_TREE).
  63. * This is optional and may be set to NULL. Is intended to be used
  64. * by flash programming tools for providing nice informative messages
  65. * to the users.
  66. */
  67. uint32_t dt_name_offset; /* since v0.2, set by mksunxiboot */
  68. uint32_t dram_size; /* in MiB, since v0.3, set by SPL */
  69. uint32_t boot_media; /* written here by the boot ROM */
  70. /* A padding area (may be used for storing text strings) */
  71. uint32_t string_pool[13]; /* since v0.2, filled by mksunxiboot */
  72. /* The header must be a multiple of 32 bytes (for VBAR alignment) */
  73. };
  74. /* Compile time check to assure proper alignment of structure */
  75. typedef char boot_file_head_not_multiple_of_32[1 - 2*(sizeof(struct boot_file_head) % 32)];
  76. #endif