blob: afc953d51e2d07cdbcde9459b7c2d275c3e60dee [file] [log] [blame]
Tom Rini83d290c2018-05-06 17:58:06 -04001/* SPDX-License-Identifier: GPL-2.0+ */
Patrick Delaunaydafa84d2018-03-09 18:28:12 +01002/*
3 * (C) Copyright 2000-2009
4 * Wolfgang Denk, DENX Software Engineering, wd@denx.de.
5 *
6 * Copy the startup prototype, previously defined in common.h
7 * Copyright (C) 2018, STMicroelectronics - All Rights Reserved
Patrick Delaunaydafa84d2018-03-09 18:28:12 +01008 */
9
10#ifndef __INIT_H_
11#define __INIT_H_ 1
12
13#ifndef __ASSEMBLY__ /* put C only stuff in this section */
14
15/*
16 * Function Prototypes
17 */
18
19/* common/board_f.c */
Patrick Delaunayd6f87712018-03-13 13:57:00 +010020void board_init_f(ulong dummy);
Patrick Delaunaydafa84d2018-03-09 18:28:12 +010021
22/**
23 * arch_cpu_init() - basic cpu-dependent setup for an architecture
24 *
25 * This is called after early malloc is available. It should handle any
26 * CPU- or SoC- specific init needed to continue the init sequence. See
27 * board_f.c for where it is called. If this is not provided, a default
28 * version (which does nothing) will be used.
29 *
Mario Sixdc145a72018-08-06 10:23:40 +020030 * Return: 0 on success, otherwise error
Patrick Delaunaydafa84d2018-03-09 18:28:12 +010031 */
32int arch_cpu_init(void);
33
34/**
Patrick Delaunayd6f87712018-03-13 13:57:00 +010035 * arch_cpu_init_dm() - init CPU after driver model is available
36 *
37 * This is called immediately after driver model is available before
38 * relocation. This is similar to arch_cpu_init() but is able to reference
39 * devices
40 *
Mario Sixdc145a72018-08-06 10:23:40 +020041 * Return: 0 if OK, -ve on error
Patrick Delaunayd6f87712018-03-13 13:57:00 +010042 */
43int arch_cpu_init_dm(void);
44
45/**
Patrick Delaunaydafa84d2018-03-09 18:28:12 +010046 * mach_cpu_init() - SoC/machine dependent CPU setup
47 *
48 * This is called after arch_cpu_init(). It should handle any
49 * SoC or machine specific init needed to continue the init sequence. See
50 * board_f.c for where it is called. If this is not provided, a default
51 * version (which does nothing) will be used.
52 *
Mario Sixdc145a72018-08-06 10:23:40 +020053 * Return: 0 on success, otherwise error
Patrick Delaunaydafa84d2018-03-09 18:28:12 +010054 */
55int mach_cpu_init(void);
56
Patrick Delaunayd6f87712018-03-13 13:57:00 +010057/**
58 * arch_fsp_init() - perform firmware support package init
59 *
60 * Where U-Boot relies on binary blobs to handle part of the system init, this
61 * function can be used to set up the blobs. This is used on some Intel
62 * platforms.
Mario Sixdc145a72018-08-06 10:23:40 +020063 *
64 * Return: 0
Patrick Delaunayd6f87712018-03-13 13:57:00 +010065 */
66int arch_fsp_init(void);
67
68int dram_init(void);
69
70/**
71 * dram_init_banksize() - Set up DRAM bank sizes
72 *
73 * This can be implemented by boards to set up the DRAM bank information in
74 * gd->bd->bi_dram(). It is called just before relocation, after dram_init()
75 * is called.
76 *
77 * If this is not provided, a default implementation will try to set up a
78 * single bank. It will do this if CONFIG_NR_DRAM_BANKS and
79 * CONFIG_SYS_SDRAM_BASE are set. The bank will have a start address of
80 * CONFIG_SYS_SDRAM_BASE and the size will be determined by a call to
81 * get_effective_memsize().
82 *
Mario Sixdc145a72018-08-06 10:23:40 +020083 * Return: 0 if OK, -ve on error
Patrick Delaunayd6f87712018-03-13 13:57:00 +010084 */
85int dram_init_banksize(void);
86
87/**
Mario Sixdc145a72018-08-06 10:23:40 +020088 * arch_reserve_stacks() - Reserve all necessary stacks
Patrick Delaunayd6f87712018-03-13 13:57:00 +010089 *
90 * This is used in generic board init sequence in common/board_f.c. Each
91 * architecture could provide this function to tailor the required stacks.
92 *
93 * On entry gd->start_addr_sp is pointing to the suggested top of the stack.
94 * The callee ensures gd->start_add_sp is 16-byte aligned, so architectures
95 * require only this can leave it untouched.
96 *
97 * On exit gd->start_addr_sp and gd->irq_sp should be set to the respective
98 * positions of the stack. The stack pointer(s) will be set to this later.
99 * gd->irq_sp is only required, if the architecture needs it.
100 *
Mario Sixdc145a72018-08-06 10:23:40 +0200101 * Return: 0 if no error
Patrick Delaunayd6f87712018-03-13 13:57:00 +0100102 */
103int arch_reserve_stacks(void);
104
Patrick Delaunayb8aa55c2018-03-13 13:57:04 +0100105/**
106 * init_cache_f_r() - Turn on the cache in preparation for relocation
107 *
Mario Sixdc145a72018-08-06 10:23:40 +0200108 * Return: 0 if OK, -ve on error
Patrick Delaunayb8aa55c2018-03-13 13:57:04 +0100109 */
110int init_cache_f_r(void);
111
Mario Six5d6c61a2018-08-06 10:23:41 +0200112#if !CONFIG_IS_ENABLED(CPU)
113/**
114 * print_cpuinfo() - Display information about the CPU
115 *
116 * Return: 0 if OK, -ve on error
117 */
Patrick Delaunayd6f87712018-03-13 13:57:00 +0100118int print_cpuinfo(void);
Mario Six5d6c61a2018-08-06 10:23:41 +0200119#endif
Patrick Delaunayd6f87712018-03-13 13:57:00 +0100120int timer_init(void);
121int reserve_mmu(void);
122int misc_init_f(void);
Mario Sixdc145a72018-08-06 10:23:40 +0200123
Patrick Delaunayd6f87712018-03-13 13:57:00 +0100124#if defined(CONFIG_DTB_RESELECT)
125int embedded_dtb_select(void);
126#endif
127
Patrick Delaunay11f86cb2018-03-13 13:57:01 +0100128/* common/init/board_init.c */
129extern ulong monitor_flash_len;
130
131/**
132 * ulong board_init_f_alloc_reserve - allocate reserved area
Mario Sixdc145a72018-08-06 10:23:40 +0200133 * @top: top of the reserve area, growing down.
Patrick Delaunay11f86cb2018-03-13 13:57:01 +0100134 *
135 * This function is called by each architecture very early in the start-up
136 * code to allow the C runtime to reserve space on the stack for writable
137 * 'globals' such as GD and the malloc arena.
138 *
Mario Sixdc145a72018-08-06 10:23:40 +0200139 * Return: bottom of reserved area
Patrick Delaunay11f86cb2018-03-13 13:57:01 +0100140 */
141ulong board_init_f_alloc_reserve(ulong top);
142
143/**
144 * board_init_f_init_reserve - initialize the reserved area(s)
Mario Sixdc145a72018-08-06 10:23:40 +0200145 * @base: top from which reservation was done
Patrick Delaunay11f86cb2018-03-13 13:57:01 +0100146 *
147 * This function is called once the C runtime has allocated the reserved
148 * area on the stack. It must initialize the GD at the base of that area.
Patrick Delaunay11f86cb2018-03-13 13:57:01 +0100149 */
150void board_init_f_init_reserve(ulong base);
151
152/**
153 * arch_setup_gd() - Set up the global_data pointer
Mario Sixdc145a72018-08-06 10:23:40 +0200154 * @gd_ptr: Pointer to global data
Patrick Delaunay11f86cb2018-03-13 13:57:01 +0100155 *
156 * This pointer is special in some architectures and cannot easily be assigned
157 * to. For example on x86 it is implemented by adding a specific record to its
158 * Global Descriptor Table! So we we provide a function to carry out this task.
159 * For most architectures this can simply be:
160 *
161 * gd = gd_ptr;
Patrick Delaunay11f86cb2018-03-13 13:57:01 +0100162 */
163void arch_setup_gd(gd_t *gd_ptr);
164
Patrick Delaunaydafa84d2018-03-09 18:28:12 +0100165/* common/board_r.c */
Patrick Delaunaye2c219c2018-03-13 13:57:02 +0100166void board_init_r(gd_t *id, ulong dest_addr) __attribute__ ((noreturn));
167
168int cpu_init_r(void);
169int last_stage_init(void);
170int mac_read_from_eeprom(void);
171int set_cpu_clk_info(void);
172int update_flash_size(int flash_size);
173int arch_early_init_r(void);
174void pci_init(void);
175int misc_init_r(void);
176#if defined(CONFIG_VID)
177int init_func_vid(void);
178#endif
179
Patrick Delaunayfc22ee22018-03-13 13:57:03 +0100180/* common/board_info.c */
181int checkboard(void);
182int show_board_info(void);
Patrick Delaunaydafa84d2018-03-09 18:28:12 +0100183
184#endif /* __ASSEMBLY__ */
185/* Put only stuff here that the assembler can digest */
186
187#endif /* __INIT_H_ */