blob: 9ce04342349703f316fa0e90f72184278f1dbb13 [file] [log] [blame]
Jorge Ramirez-Ortiza29d9a62017-06-28 10:11:31 +02001/*
2 * Copyright (c) 2017, ARM Limited and Contributors. All rights reserved.
3 *
4 * SPDX-License-Identifier: BSD-3-Clause
5 */
6
7#ifndef __POPLAR_LAYOUT_H
8#define __POPLAR_LAYOUT_H
9
10/*
11 * Boot memory layout definitions for the HiSilicon Poplar board
12 */
13
14/*
Victor Chong539408d2018-01-03 01:53:08 +090015 * When Poplar is powered on, boot ROM verifies the initial content of
16 * boot media, loads it into low memory, and begins executing it
Jorge Ramirez-Ortiza29d9a62017-06-28 10:11:31 +020017 * in 32-bit mode. The image loaded is "l-loader.bin", which contains
18 * a small amount code along with an embedded ARM Trusted Firmware
19 * BL1 image. The main purpose of "l-loader" is to prepare the
20 * processor to execute the BL1 image in 64-bit mode, and to trigger
21 * that execution.
22 *
23 * Also embedded in "l-loader.bin" is a FIP image that contains
24 * other ARM Trusted Firmware images: BL2; BL31; and for BL33,
25 * U-Boot. When BL1 executes, it unpacks the BL2 image from the FIP
26 * image into a region of memory set aside to hold it. Similarly,
27 * BL2 unpacks BL31 into memory reserved for it, and unpacks U-Boot
28 * into high memory.
29 *
30 * Because the BL1 code is embedded in "l-loader", its base address
31 * in memory is derived from the base address of the "l-loader"
32 * text section, together with an offset. Memory space for BL2 is
33 * reserved immediately following BL1, and memory space is reserved
34 * for BL31 after that. ARM Trusted Firmware requires each of these
35 * memory regions to be aligned on page boundaries, so the size of
36 * each region is a multiple of a page size (ending in 000). Note
37 * that ARM Trusted Firmware requires the read-only and read-write
38 * regions of memory used for BL1 to be defined separately.
39 *
40 * ---------------------
41 * | (unused memory) |
42 * +-------------------+ - - - - -
43 * | (l-loader text) | \
44 * +-------------------+ \
45 * | BL1 (read-only) | \ \
46 * |- - - - - - - - - -| | |
47 * | BL1 (read-write) | | |
48 * +-------------------+ > BL Memory |
49 * | Reserved for BL2 | | > "l-loader.bin" image
50 * +-------------------+ | |
51 * | Reserved for BL31 | / |
52 * +-------------------+ |
53 * . . . /
54 * +-------------------+ /
55 * | FIP | /
56 * +-------------------+ - - - - -
57 * . . .
58 * | (unused memory) |
59 * . . .
60 * +-------------------+
61 * |Reserved for U-Boot|
62 * +-------------------+
63 * . . .
64 * | (unused memory) |
65 * ---------------------
66 *
67 * The size of each of these regions is defined below. The base
68 * address of the "l-loader" TEXT section and the offset of the BL1
69 * image within that serve as anchors for defining the positions of
70 * all other regions. The FIP is placed in a section of its own.
71 *
72 * A "BASE" is the memory address of the start of a region; a "LIMIT"
73 * marks its end. A "SIZE" is the size of a region (in bytes). An
74 * "OFFSET" is an offset to the start of a region relative to the
75 * base of the "l-loader" TEXT section (also a multiple of page size).
76 */
Victor Chong662556a2017-10-28 01:59:41 +090077#define LLOADER_TEXT_BASE 0x02001000 /* page aligned */
Jorge Ramirez-Ortiza29d9a62017-06-28 10:11:31 +020078#define BL1_OFFSET 0x0000D000 /* page multiple */
Victor Chong662556a2017-10-28 01:59:41 +090079#define FIP_BASE 0x02040000
Jorge Ramirez-Ortiza29d9a62017-06-28 10:11:31 +020080
Victor Chong539408d2018-01-03 01:53:08 +090081/*
82 * FIP_BASE_EMMC = 0x40000 - 0x1000
83 * = fip.bin offset - l-loader text offset
84 * in l-loader.bin
85 */
86#define FIP_BASE_EMMC 0x0003f000
87
Jorge Ramirez-Ortiza29d9a62017-06-28 10:11:31 +020088#define BL1_RO_SIZE 0x00008000 /* page multiple */
89#define BL1_RW_SIZE 0x00008000 /* page multiple */
90#define BL1_SIZE (BL1_RO_SIZE + BL1_RW_SIZE)
91#define BL2_SIZE 0x0000c000 /* page multiple */
92#define BL31_SIZE 0x00014000
Victor Chongf0c7c612018-01-16 00:29:47 +090093#if !POPLAR_RECOVERY
Victor Chong539408d2018-01-03 01:53:08 +090094/*
95 * emmc partition1 4096KB
96 * - l-loader.bin 1984KB
97 * |- l-loader + bl1.bin 256KB
98 * |- fip.bin 1728KB (0x001b0000)
99 * - u-boot persistent data 64KB
100 * - uefi persistent data 2048KB
101 */
102#define FIP_SIZE 0x001b0000 /* absolute max */
Victor Chongf0c7c612018-01-16 00:29:47 +0900103#else
104/*
105 * same as above, but bootrom can only load an image (l-loader.bin) of
106 * 1024KB max, so after deducting the size of l-loader + bl1.bin (256KB),
107 * that leaves 768KB (0x000c0000) for fip.bin
108 */
109#define FIP_SIZE 0x000c0000 /* absolute max */
110#endif
Jorge Ramirez-Ortiza29d9a62017-06-28 10:11:31 +0200111
112 /* BL1_OFFSET */ /* (Defined above) */
113#define BL1_BASE (LLOADER_TEXT_BASE + BL1_OFFSET)
114#define BL1_LIMIT (BL1_BASE + BL1_SIZE)
115
116#define BL1_RO_OFFSET (BL1_OFFSET)
117#define BL1_RO_BASE (LLOADER_TEXT_BASE + BL1_RO_OFFSET)
118#define BL1_RO_LIMIT (BL1_RO_BASE + BL1_RO_SIZE)
119
120#define BL1_RW_OFFSET (BL1_RO_OFFSET + BL1_RO_SIZE)
121#define BL1_RW_BASE (LLOADER_TEXT_BASE + BL1_RW_OFFSET)
122#define BL1_RW_LIMIT (BL1_RW_BASE + BL1_RW_SIZE)
123
124#define BL2_OFFSET (BL1_OFFSET + BL1_SIZE)
125#define BL2_BASE (LLOADER_TEXT_BASE + BL2_OFFSET)
126#define BL2_LIMIT (BL2_BASE + BL2_SIZE)
127
128#define BL31_OFFSET (BL2_OFFSET + BL2_SIZE)
129#define BL31_BASE (LLOADER_TEXT_BASE + BL31_OFFSET)
130#define BL31_LIMIT (BL31_BASE + BL31_SIZE)
131
132#endif /* !__POPLAR_LAYOUT_H */