1 /* SPDX-License-Identifier: GPL-2.0+ */
2 /*
3 * (C) Copyright 2002
4 * Daniel Engström, Omicron Ceti AB, daniel@omicron.se.
5 */
6
7 #ifndef _U_BOOT_I386_H_
8 #define _U_BOOT_I386_H_ 1
9
10 struct global_data;
11
12 extern char gdt_rom[];
13
14 /* cpu/.../cpu.c */
15 int arch_cpu_init(void);
16
17 /**
18 * x86_cpu_init_f() - Set up basic features of the x86 CPU
19 *
20 * 0 on success, -ve on error
21 */
22 int x86_cpu_init_f(void);
23
24 /**
25 * x86_cpu_reinit_f() - Set up the CPU a second time
26 *
27 * Once cpu_init_f() has been called (e.g. in SPL) we should not call it
28 * again (e.g. in U-Boot proper) since it sets up the state from scratch.
29 * Call this function in later phases of U-Boot instead. It reads the CPU
30 * identify so that CPU functions can be used correctly, but does not change
31 * anything.
32 *
33 * Return: 0 (indicating success, to mimic cpu_init_f())
34 */
35 int x86_cpu_reinit_f(void);
36
37 /**
38 * x86_cpu_init_tpl() - Do the minimum possible CPU init
39 *
40 * This just sets up the CPU features and figured out the identity
41 *
42 * Return: 0 (indicating success, to mimic cpu_init_f())
43 */
44 int x86_cpu_init_tpl(void);
45
46 /**
47 * x86_get_identity_for_timer() - Set up CPU identity for use by the early timer
48 *
49 * The timer can be needed early in board_f if bootstage is enabled. This
50 * function can be called from the TSC timer to make sure that the CPU-identity
51 * info has been set up
52 */
53 void x86_get_identity_for_timer(void);
54
55 /**
56 * cpu_reinit_fpu() - Reinit the FPU if something is wrong with it
57 *
58 * The FSP-M code can leave registers in use in the FPU. This functions reinits
59 * it so that the FPU can be used safely
60 */
61 void cpu_reinit_fpu(void);
62
63 /**
64 * x86_cpu_vendor_info() - Get the CPU-vendor name and device number
65 *
66 * @name: 13-byte area to hold the returned string
67 * Return: CPU device number read from cpuid
68 */
69 int x86_cpu_vendor_info(char *name);
70
71 int cpu_init_f(void);
72 void setup_gdt(struct global_data *id, u64 *gdt_addr);
73 /*
74 * Setup FSP execution environment GDT to use the one we used in
75 * arch/x86/cpu/start16.S and reload the segment registers.
76 */
77 void setup_fsp_gdt(void);
78 int init_cache(void);
79 int cleanup_before_linux(void);
80
81 /* cpu/.../timer.c */
82 void timer_isr(void *);
83 typedef void (timer_fnc_t) (void);
84 int register_timer_isr (timer_fnc_t *isr_func);
85 unsigned long get_tbclk_mhz(void);
86 void timer_set_base(uint64_t base);
87 int i8254_init(void);
88
89 /* cpu/.../interrupts.c */
90 int cpu_init_interrupts(void);
91
92 int cleanup_before_linux(void);
93 int x86_cleanup_before_linux(void);
94 void x86_enable_caches(void);
95 void x86_disable_caches(void);
96 int x86_init_cache(void);
97 phys_addr_t board_get_usable_ram_top(phys_size_t total_size);
98
99 /* Set up a UART which can be used with printch(), printhex8(), etc. */
100 int setup_internal_uart(int enable);
101
102 void isa_unmap_rom(u32 addr);
103 u32 isa_map_rom(u32 bus_addr, int size);
104
105 /* arch/x86/lib/... */
106 int video_bios_init(void);
107
108 /* arch/x86/lib/fsp1,2/... */
109
110 /**
111 * fsp_save_s3_stack() - save stack address to CMOS for next S3 boot
112 *
113 * At the end of pre-relocation phase, save the new stack address
114 * to CMOS and use it as the stack on next S3 boot for fsp_init()
115 * continuation function.
116 *
117 * @return: 0 if OK, -ve on error
118 */
119 int fsp_save_s3_stack(void);
120
121 /**
122 * board_init_f_r_trampoline() - jump to relocated address with new stack
123 *
124 * @sp: New stack pointer to use
125 */
126 void __noreturn board_init_f_r_trampoline(ulong sp);
127
128 /**
129 * board_init_f_r() - jump to relocated U-Boot
130 *
131 * This is used to jump from pre-relocation to post-relocation U-Boot. It
132 * enables the cache and jump to the new location.
133 */
134 void __noreturn board_init_f_r(void);
135
136 /*
137 * board_init_f_r_trampoline64() - jump to relocated address with new stack
138 *
139 * This is the 64-bit version
140 *
141 * @new_gd: New global_data pointer to use
142 * @sp: New stack pointer to pass on to board_init_r()
143 */
144 void __noreturn board_init_f_r_trampoline64(struct global_data *new_gd,
145 ulong sp);
146
147 int arch_misc_init(void);
148
149 /* Read the time stamp counter */
rdtsc(void)150 static inline notrace uint64_t rdtsc(void)
151 {
152 uint32_t high, low;
153 __asm__ __volatile__("rdtsc" : "=a" (low), "=d" (high));
154 return (((uint64_t)high) << 32) | low;
155 }
156
157 /* board/... */
158 void timer_set_tsc_base(uint64_t new_base);
159 uint64_t timer_get_tsc(void);
160
161 void quick_ram_check(void);
162
163 #define PCI_VGA_RAM_IMAGE_START 0xc0000
164
165 #endif /* _U_BOOT_I386_H_ */
166