Patrick Delaunay | c6bfcd5 | 2018-03-09 18:28:12 +0100 | [diff] [blame] | 1 | /* |
| 2 | * (C) Copyright 2000-2009 |
| 3 | * Wolfgang Denk, DENX Software Engineering, wd@denx.de. |
| 4 | * |
| 5 | * Copy the startup prototype, previously defined in common.h |
| 6 | * Copyright (C) 2018, STMicroelectronics - All Rights Reserved |
| 7 | * |
| 8 | * SPDX-License-Identifier: GPL-2.0+ |
| 9 | */ |
| 10 | |
| 11 | #ifndef __INIT_H_ |
| 12 | #define __INIT_H_ 1 |
| 13 | |
| 14 | #ifndef __ASSEMBLY__ /* put C only stuff in this section */ |
| 15 | |
| 16 | /* |
| 17 | * Function Prototypes |
| 18 | */ |
| 19 | |
| 20 | /* common/board_f.c */ |
Patrick Delaunay | a0a2b21 | 2018-03-13 13:57:00 +0100 | [diff] [blame] | 21 | void board_init_f(ulong dummy); |
Patrick Delaunay | c6bfcd5 | 2018-03-09 18:28:12 +0100 | [diff] [blame] | 22 | |
| 23 | /** |
| 24 | * arch_cpu_init() - basic cpu-dependent setup for an architecture |
| 25 | * |
| 26 | * This is called after early malloc is available. It should handle any |
| 27 | * CPU- or SoC- specific init needed to continue the init sequence. See |
| 28 | * board_f.c for where it is called. If this is not provided, a default |
| 29 | * version (which does nothing) will be used. |
| 30 | * |
| 31 | * @return: 0 on success, otherwise error |
| 32 | */ |
| 33 | int arch_cpu_init(void); |
| 34 | |
| 35 | /** |
Patrick Delaunay | a0a2b21 | 2018-03-13 13:57:00 +0100 | [diff] [blame] | 36 | * arch_cpu_init_dm() - init CPU after driver model is available |
| 37 | * |
| 38 | * This is called immediately after driver model is available before |
| 39 | * relocation. This is similar to arch_cpu_init() but is able to reference |
| 40 | * devices |
| 41 | * |
| 42 | * @return 0 if OK, -ve on error |
| 43 | */ |
| 44 | int arch_cpu_init_dm(void); |
| 45 | |
| 46 | /** |
Patrick Delaunay | c6bfcd5 | 2018-03-09 18:28:12 +0100 | [diff] [blame] | 47 | * mach_cpu_init() - SoC/machine dependent CPU setup |
| 48 | * |
| 49 | * This is called after arch_cpu_init(). It should handle any |
| 50 | * SoC or machine specific init needed to continue the init sequence. See |
| 51 | * board_f.c for where it is called. If this is not provided, a default |
| 52 | * version (which does nothing) will be used. |
| 53 | * |
| 54 | * @return: 0 on success, otherwise error |
| 55 | */ |
| 56 | int mach_cpu_init(void); |
| 57 | |
Patrick Delaunay | a0a2b21 | 2018-03-13 13:57:00 +0100 | [diff] [blame] | 58 | /** |
| 59 | * arch_fsp_init() - perform firmware support package init |
| 60 | * |
| 61 | * Where U-Boot relies on binary blobs to handle part of the system init, this |
| 62 | * function can be used to set up the blobs. This is used on some Intel |
| 63 | * platforms. |
| 64 | */ |
| 65 | int arch_fsp_init(void); |
| 66 | |
| 67 | int dram_init(void); |
| 68 | |
| 69 | /** |
| 70 | * dram_init_banksize() - Set up DRAM bank sizes |
| 71 | * |
| 72 | * This can be implemented by boards to set up the DRAM bank information in |
| 73 | * gd->bd->bi_dram(). It is called just before relocation, after dram_init() |
| 74 | * is called. |
| 75 | * |
| 76 | * If this is not provided, a default implementation will try to set up a |
| 77 | * single bank. It will do this if CONFIG_NR_DRAM_BANKS and |
| 78 | * CONFIG_SYS_SDRAM_BASE are set. The bank will have a start address of |
| 79 | * CONFIG_SYS_SDRAM_BASE and the size will be determined by a call to |
| 80 | * get_effective_memsize(). |
| 81 | * |
| 82 | * @return 0 if OK, -ve on error |
| 83 | */ |
| 84 | int dram_init_banksize(void); |
| 85 | |
| 86 | /** |
| 87 | * Reserve all necessary stacks |
| 88 | * |
| 89 | * This is used in generic board init sequence in common/board_f.c. Each |
| 90 | * architecture could provide this function to tailor the required stacks. |
| 91 | * |
| 92 | * On entry gd->start_addr_sp is pointing to the suggested top of the stack. |
| 93 | * The callee ensures gd->start_add_sp is 16-byte aligned, so architectures |
| 94 | * require only this can leave it untouched. |
| 95 | * |
| 96 | * On exit gd->start_addr_sp and gd->irq_sp should be set to the respective |
| 97 | * positions of the stack. The stack pointer(s) will be set to this later. |
| 98 | * gd->irq_sp is only required, if the architecture needs it. |
| 99 | * |
| 100 | * @return 0 if no error |
| 101 | */ |
| 102 | int arch_reserve_stacks(void); |
| 103 | |
| 104 | int print_cpuinfo(void); |
| 105 | int timer_init(void); |
| 106 | int reserve_mmu(void); |
| 107 | int misc_init_f(void); |
| 108 | #if defined(CONFIG_DTB_RESELECT) |
| 109 | int embedded_dtb_select(void); |
| 110 | #endif |
| 111 | |
Patrick Delaunay | 98c8bbc | 2018-03-13 13:57:01 +0100 | [diff] [blame^] | 112 | /* common/init/board_init.c */ |
| 113 | extern ulong monitor_flash_len; |
| 114 | |
| 115 | /** |
| 116 | * ulong board_init_f_alloc_reserve - allocate reserved area |
| 117 | * |
| 118 | * This function is called by each architecture very early in the start-up |
| 119 | * code to allow the C runtime to reserve space on the stack for writable |
| 120 | * 'globals' such as GD and the malloc arena. |
| 121 | * |
| 122 | * @top: top of the reserve area, growing down. |
| 123 | * @return: bottom of reserved area |
| 124 | */ |
| 125 | ulong board_init_f_alloc_reserve(ulong top); |
| 126 | |
| 127 | /** |
| 128 | * board_init_f_init_reserve - initialize the reserved area(s) |
| 129 | * |
| 130 | * This function is called once the C runtime has allocated the reserved |
| 131 | * area on the stack. It must initialize the GD at the base of that area. |
| 132 | * |
| 133 | * @base: top from which reservation was done |
| 134 | */ |
| 135 | void board_init_f_init_reserve(ulong base); |
| 136 | |
| 137 | /** |
| 138 | * arch_setup_gd() - Set up the global_data pointer |
| 139 | * |
| 140 | * This pointer is special in some architectures and cannot easily be assigned |
| 141 | * to. For example on x86 it is implemented by adding a specific record to its |
| 142 | * Global Descriptor Table! So we we provide a function to carry out this task. |
| 143 | * For most architectures this can simply be: |
| 144 | * |
| 145 | * gd = gd_ptr; |
| 146 | * |
| 147 | * @gd_ptr: Pointer to global data |
| 148 | */ |
| 149 | void arch_setup_gd(gd_t *gd_ptr); |
| 150 | |
Patrick Delaunay | c6bfcd5 | 2018-03-09 18:28:12 +0100 | [diff] [blame] | 151 | /* common/board_r.c */ |
| 152 | |
| 153 | #endif /* __ASSEMBLY__ */ |
| 154 | /* Put only stuff here that the assembler can digest */ |
| 155 | |
| 156 | #endif /* __INIT_H_ */ |