blob: 094d60afe8e65e436ef4333c0fe96fd0ca19cfa6 [file] [log] [blame]
Sebastian Siewior9ace3fc2014-05-05 15:08:09 -05001/*
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
12#ifndef _ANDROID_IMAGE_H_
13#define _ANDROID_IMAGE_H_
14
15#define ANDR_BOOT_MAGIC "ANDROID!"
16#define ANDR_BOOT_MAGIC_SIZE 8
17#define ANDR_BOOT_NAME_SIZE 16
18#define ANDR_BOOT_ARGS_SIZE 512
19
20struct andr_img_hdr {
21 char magic[ANDR_BOOT_MAGIC_SIZE];
22
23 u32 kernel_size; /* size in bytes */
24 u32 kernel_addr; /* physical load addr */
25
26 u32 ramdisk_size; /* size in bytes */
27 u32 ramdisk_addr; /* physical load addr */
28
29 u32 second_size; /* size in bytes */
30 u32 second_addr; /* physical load addr */
31
32 u32 tags_addr; /* physical addr for kernel tags */
33 u32 page_size; /* flash page size we assume */
34 u32 unused[2]; /* future expansion: should be 0 */
35
36 char name[ANDR_BOOT_NAME_SIZE]; /* asciiz product name */
37
38 char cmdline[ANDR_BOOT_ARGS_SIZE];
39
40 u32 id[8]; /* timestamp / checksum / sha1 / etc */
41};
42
43/*
44 * +-----------------+
45 * | boot header | 1 page
46 * +-----------------+
47 * | kernel | n pages
48 * +-----------------+
49 * | ramdisk | m pages
50 * +-----------------+
51 * | second stage | o pages
52 * +-----------------+
53 *
54 * n = (kernel_size + page_size - 1) / page_size
55 * m = (ramdisk_size + page_size - 1) / page_size
56 * o = (second_size + page_size - 1) / page_size
57 *
58 * 0. all entities are page_size aligned in flash
59 * 1. kernel and ramdisk are required (size != 0)
60 * 2. second is optional (second_size == 0 -> no second)
61 * 3. load each element (kernel, ramdisk, second) at
62 * the specified physical address (kernel_addr, etc)
63 * 4. prepare tags at tag_addr. kernel_args[] is
64 * appended to the kernel commandline in the tags.
65 * 5. r0 = 0, r1 = MACHINE_TYPE, r2 = tags_addr
66 * 6. if second_size != 0: jump to second_addr
67 * else: jump to kernel_addr
68 */
69#endif