Gitiles
Code Review Sign In
review.shift-gmbh.com / SHIFTPHONES / mainline / linux / 754e0b0e35608ed5206d6a67a791563c631cec07 / . / Documentation / arm / samsung / bootloader-interface.rst
blob: a56f325dae780ba5e0ff954dc670ea202ab136a6 [file] [log] [blame]
Mauro Carvalho Chehabdc7a12b2019-04-14 15:51:10 -0300[diff] [blame]1==========================================================
2Interface between kernel and boot loaders on Exynos boards
3==========================================================
Krzysztof Kozlowskia28ab162015-06-06 19:05:51 +0900[diff] [blame]4
5Author: Krzysztof Kozlowski
Mauro Carvalho Chehabdc7a12b2019-04-14 15:51:10 -0300[diff] [blame]6
Krzysztof Kozlowskia28ab162015-06-06 19:05:51 +0900[diff] [blame]7Date : 6 June 2015
8
9The document tries to describe currently used interface between Linux kernel
10and boot loaders on Samsung Exynos based boards. This is not a definition
11of interface but rather a description of existing state, a reference
12for information purpose only.
13
14In the document "boot loader" means any of following: U-boot, proprietary
15SBOOT or any other firmware for ARMv7 and ARMv8 initializing the board before
16executing kernel.
17
18
191. Non-Secure mode
Krzysztof Kozlowski9ba6e982015-07-05 11:56:51 +0900[diff] [blame]20
Krzysztof Kozlowskia28ab162015-06-06 19:05:51 +0900[diff] [blame]21Address: sysram_ns_base_addr
Mauro Carvalho Chehabdc7a12b2019-04-14 15:51:10 -0300[diff] [blame]22
23============= ============================================ ==================
Krzysztof Kozlowskia28ab162015-06-06 19:05:51 +0900[diff] [blame]24Offset Value Purpose
Mauro Carvalho Chehabdc7a12b2019-04-14 15:51:10 -0300[diff] [blame]25============= ============================================ ==================
Krzysztof Kozlowski97d5c7a2015-10-24 04:43:31 +0900[diff] [blame]260x08 exynos_cpu_resume_ns, mcpm_entry_point System suspend
Krzysztof Kozlowskia28ab162015-06-06 19:05:51 +0900[diff] [blame]270x0c 0x00000bad (Magic cookie) System suspend
280x1c exynos4_secondary_startup Secondary CPU boot
290x1c + 4*cpu exynos4_secondary_startup (Exynos4412) Secondary CPU boot
300x20 0xfcba0d10 (Magic cookie) AFTR
310x24 exynos_cpu_resume_ns AFTR
320x28 + 4*cpu 0x8 (Magic cookie, Exynos3250) AFTR
Krzysztof Kozlowskie0b35c12018-07-24 18:49:46 +0200[diff] [blame]330x28 0x0 or last value during resume (Exynos542x) System suspend
Mauro Carvalho Chehabdc7a12b2019-04-14 15:51:10 -0300[diff] [blame]34============= ============================================ ==================
Krzysztof Kozlowskia28ab162015-06-06 19:05:51 +0900[diff] [blame]35
36
372. Secure mode
Krzysztof Kozlowski9ba6e982015-07-05 11:56:51 +0900[diff] [blame]38
Krzysztof Kozlowskia28ab162015-06-06 19:05:51 +0900[diff] [blame]39Address: sysram_base_addr
Mauro Carvalho Chehabdc7a12b2019-04-14 15:51:10 -0300[diff] [blame]40
41============= ============================================ ==================
Krzysztof Kozlowskia28ab162015-06-06 19:05:51 +0900[diff] [blame]42Offset Value Purpose
Mauro Carvalho Chehabdc7a12b2019-04-14 15:51:10 -0300[diff] [blame]43============= ============================================ ==================
Krzysztof Kozlowskia28ab162015-06-06 19:05:51 +0900[diff] [blame]440x00 exynos4_secondary_startup Secondary CPU boot
450x04 exynos4_secondary_startup (Exynos542x) Secondary CPU boot
464*cpu exynos4_secondary_startup (Exynos4412) Secondary CPU boot
470x20 exynos_cpu_resume (Exynos4210 r1.0) AFTR
480x24 0xfcba0d10 (Magic cookie, Exynos4210 r1.0) AFTR
Mauro Carvalho Chehabdc7a12b2019-04-14 15:51:10 -0300[diff] [blame]49============= ============================================ ==================
Krzysztof Kozlowskia28ab162015-06-06 19:05:51 +0900[diff] [blame]50
51Address: pmu_base_addr
Mauro Carvalho Chehabdc7a12b2019-04-14 15:51:10 -0300[diff] [blame]52
53============= ============================================ ==================
Krzysztof Kozlowskia28ab162015-06-06 19:05:51 +0900[diff] [blame]54Offset Value Purpose
Mauro Carvalho Chehabdc7a12b2019-04-14 15:51:10 -0300[diff] [blame]55============= ============================================ ==================
Krzysztof Kozlowski9ba6e982015-07-05 11:56:51 +0900[diff] [blame]560x0800 exynos_cpu_resume AFTR, suspend
570x0800 mcpm_entry_point (Exynos542x with MCPM) AFTR, suspend
580x0804 0xfcba0d10 (Magic cookie) AFTR
590x0804 0x00000bad (Magic cookie) System suspend
Krzysztof Kozlowskia28ab162015-06-06 19:05:51 +0900[diff] [blame]600x0814 exynos4_secondary_startup (Exynos4210 r1.1) Secondary CPU boot
610x0818 0xfcba0d10 (Magic cookie, Exynos4210 r1.1) AFTR
620x081C exynos_cpu_resume (Exynos4210 r1.1) AFTR
Mauro Carvalho Chehabdc7a12b2019-04-14 15:51:10 -0300[diff] [blame]63============= ============================================ ==================
Krzysztof Kozlowskia28ab162015-06-06 19:05:51 +0900[diff] [blame]64
653. Other (regardless of secure/non-secure mode)
Krzysztof Kozlowski9ba6e982015-07-05 11:56:51 +0900[diff] [blame]66
Krzysztof Kozlowskia28ab162015-06-06 19:05:51 +0900[diff] [blame]67Address: pmu_base_addr
Mauro Carvalho Chehabdc7a12b2019-04-14 15:51:10 -0300[diff] [blame]68
69============= =============================== ===============================
Krzysztof Kozlowskia28ab162015-06-06 19:05:51 +0900[diff] [blame]70Offset Value Purpose
Mauro Carvalho Chehabdc7a12b2019-04-14 15:51:10 -0300[diff] [blame]71============= =============================== ===============================
Krzysztof Kozlowski97d5c7a2015-10-24 04:43:31 +0900[diff] [blame]720x0908 Non-zero Secondary CPU boot up indicator
73 on Exynos3250 and Exynos542x
Mauro Carvalho Chehabdc7a12b2019-04-14 15:51:10 -0300[diff] [blame]74============= =============================== ===============================
Krzysztof Kozlowski9ba6e982015-07-05 11:56:51 +0900[diff] [blame]75
76
774. Glossary
78
79AFTR - ARM Off Top Running, a low power mode, Cortex cores and many other
80modules are power gated, except the TOP modules
81MCPM - Multi-Cluster Power Management