Initial support for USB, UHCI, and USB Keyboards.
[seabios.git] / src / util.h
1 // Basic x86 asm functions and function defs.
2 //
3 // Copyright (C) 2008,2009  Kevin O'Connor <kevin@koconnor.net>
4 //
5 // This file may be distributed under the terms of the GNU LGPLv3 license.
6 #ifndef __UTIL_H
7 #define __UTIL_H
8
9 #include "types.h" // u32
10
11 static inline void irq_disable(void)
12 {
13     asm volatile("cli": : :"memory");
14 }
15
16 static inline void irq_enable(void)
17 {
18     asm volatile("sti": : :"memory");
19 }
20
21 static inline unsigned long irq_save(void)
22 {
23     unsigned long flags;
24     asm volatile("pushfl ; popl %0" : "=g" (flags));
25     irq_disable();
26     return flags;
27 }
28
29 static inline void irq_restore(unsigned long flags)
30 {
31     asm volatile("pushl %0 ; popfl" : : "g" (flags) : "memory", "cc");
32 }
33
34 static inline void cpu_relax(void)
35 {
36     asm volatile("rep ; nop": : :"memory");
37 }
38
39 // Atomically enable irqs and sleep until an irq; then re-disable irqs.
40 static inline void wait_irq(void)
41 {
42     asm volatile("sti ; hlt ; cli ; cld": : :"memory");
43 }
44
45 static inline void nop(void)
46 {
47     asm volatile("nop");
48 }
49
50 static inline void hlt(void)
51 {
52     asm volatile("hlt");
53 }
54
55 static inline void wbinvd(void)
56 {
57     asm volatile("wbinvd");
58 }
59
60 #define CPUID_MSR (1 << 5)
61 #define CPUID_APIC (1 << 9)
62 #define CPUID_MTRR (1 << 12)
63 static inline void cpuid(u32 index, u32 *eax, u32 *ebx, u32 *ecx, u32 *edx)
64 {
65     asm("cpuid"
66         : "=a" (*eax), "=b" (*ebx), "=c" (*ecx), "=d" (*edx)
67         : "0" (index));
68 }
69
70 static inline u64 rdmsr(u32 index)
71 {
72     u64 ret;
73     asm ("rdmsr" : "=A"(ret) : "c"(index));
74     return ret;
75 }
76
77 static inline void wrmsr(u32 index, u64 val)
78 {
79     asm volatile ("wrmsr" : : "c"(index), "A"(val));
80 }
81
82 static inline u64 rdtscll(void)
83 {
84     u64 val;
85     asm volatile("rdtsc" : "=A" (val));
86     return val;
87 }
88
89 static inline u32 __ffs(u32 word)
90 {
91     asm("bsf %1,%0"
92         : "=r" (word)
93         : "rm" (word));
94     return word;
95 }
96
97 // GDT bit manipulation
98 #define GDT_BASE(v)  ((((u64)(v) & 0xff000000) << 32)           \
99                       | (((u64)(v) & 0x00ffffff) << 16))
100 #define GDT_LIMIT(v) ((((u64)(v) & 0x000f0000) << 32)   \
101                       | (((u64)(v) & 0x0000ffff) << 0))
102 #define GDT_CODE     (0x9bULL << 40) // Code segment - P,R,A bits also set
103 #define GDT_DATA     (0x93ULL << 40) // Data segment - W,A bits also set
104 #define GDT_B        (0x1ULL << 54)  // Big flag
105 #define GDT_G        (0x1ULL << 55)  // Granularity flag
106
107 #define call16_simpint(nr, peax, pflags) do {                           \
108         ASSERT16();                                                     \
109         asm volatile(                                                   \
110             "stc\n"                                                     \
111             "int %2\n"                                                  \
112             "pushfl\n"                                                  \
113             "popl %1\n"                                                 \
114             "cli\n"                                                     \
115             "cld"                                                       \
116             : "+a"(*peax), "=r"(*pflags)                                \
117             : "i"(nr)                                                   \
118             : "cc", "memory");                                          \
119     } while (0)
120
121 // util.c
122 inline u32 stack_hop(u32 eax, u32 edx, u32 ecx, void *func);
123 u8 checksum_far(u16 buf_seg, void *buf_far, u32 len);
124 u8 checksum(void *buf, u32 len);
125 int memcmp(const void *s1, const void *s2, size_t n);
126 size_t strlen(const char *s);
127 int strcmp(const char *s1, const char *s2);
128 inline void memset_far(u16 d_seg, void *d_far, u8 c, size_t len);
129 inline void memset16_far(u16 d_seg, void *d_far, u16 c, size_t len);
130 void *memset(void *s, int c, size_t n);
131 void *memcpy(void *d1, const void *s1, size_t len);
132 #if MODE16 == 0
133 #define memcpy __builtin_memcpy
134 #endif
135 inline void memcpy_far(u16 d_seg, void *d_far
136                        , u16 s_seg, const void *s_far, size_t len);
137 void *memmove(void *d, const void *s, size_t len);
138 char *strtcpy(char *dest, const char *src, size_t len);
139 struct bregs;
140 inline void call16(struct bregs *callregs);
141 inline void call16big(struct bregs *callregs);
142 inline void __call16_int(struct bregs *callregs, u16 offset);
143 #define call16_int(nr, callregs) do {                           \
144         extern void irq_trampoline_ ##nr ();                    \
145         __call16_int((callregs), (u32)&irq_trampoline_ ##nr );  \
146     } while (0)
147 void usleep(u32 usec);
148 int get_keystroke(int msec);
149
150 // output.c
151 void debug_serial_setup();
152 void panic(const char *fmt, ...)
153     __attribute__ ((format (printf, 1, 2)))
154     __attribute__ ((noreturn));
155 void printf(const char *fmt, ...)
156     __attribute__ ((format (printf, 1, 2)));
157 void __dprintf(const char *fmt, ...)
158     __attribute__ ((format (printf, 1, 2)));
159 #define dprintf(lvl, fmt, args...) do {                         \
160         if (CONFIG_DEBUG_LEVEL && (lvl) <= CONFIG_DEBUG_LEVEL)  \
161             __dprintf((fmt) , ##args );                         \
162     } while (0)
163 void __debug_enter(struct bregs *regs, const char *fname);
164 void __debug_stub(struct bregs *regs, int lineno, const char *fname);
165 void __debug_isr(const char *fname);
166 #define debug_enter(regs, lvl) do {                     \
167         if ((lvl) && (lvl) <= CONFIG_DEBUG_LEVEL)       \
168             __debug_enter((regs), __func__);            \
169     } while (0)
170 #define debug_isr(lvl) do {                             \
171         if ((lvl) && (lvl) <= CONFIG_DEBUG_LEVEL)       \
172             __debug_isr(__func__);                      \
173     } while (0)
174 #define debug_stub(regs)                        \
175     __debug_stub((regs), __LINE__, __func__)
176 void hexdump(const void *d, int len);
177
178 // kbd.c
179 void kbd_setup();
180 void handle_15c2(struct bregs *regs);
181 void process_key(u8 key);
182
183 // mouse.c
184 void mouse_setup();
185
186 // system.c
187 extern u32 RamSize;
188 extern u64 RamSizeOver4G;
189 void mathcp_setup();
190
191 // serial.c
192 void serial_setup();
193 void lpt_setup();
194
195 // clock.c
196 void timer_setup();
197 void ndelay(u32 count);
198 void udelay(u32 count);
199 void mdelay(u32 count);
200 u64 calc_future_tsc(u32 msecs);
201 void handle_1583(struct bregs *regs);
202 void handle_1586(struct bregs *regs);
203
204 // apm.c
205 void VISIBLE16 handle_1553(struct bregs *regs);
206
207 // pcibios.c
208 void handle_1ab1(struct bregs *regs);
209
210 // shadow.c
211 void make_bios_writable();
212 void make_bios_readonly();
213
214 // pciinit.c
215 void pci_setup(void);
216
217 // smm.c
218 void smm_init();
219
220 // smp.c
221 extern u32 CountCPUs;
222 void wrmsr_smp(u32 index, u64 val);
223 void smp_probe(void);
224 void smp_probe_setup(void);
225
226 // smbios.c
227 void smbios_init(void);
228
229 // coreboot.c
230 struct cbfs_file;
231 struct cbfs_file *cbfs_findprefix(const char *prefix, struct cbfs_file *last);
232 u32 cbfs_datasize(struct cbfs_file *file);
233 const char *cbfs_filename(struct cbfs_file *file);
234 int cbfs_copyfile(struct cbfs_file *file, void *dst, u32 maxlen);
235 int cbfs_copy_optionrom(void *dst, u32 maxlen, u32 vendev);
236 void cbfs_run_payload(struct cbfs_file *file);
237
238 void coreboot_copy_biostable();
239 void coreboot_setup();
240
241 // vgahooks.c
242 extern int VGAbdf;
243 void handle_155f();
244 void vgahook_setup(const char *vendor, const char *part);
245
246 // optionroms.c
247 void call_bcv(u16 seg, u16 ip);
248 void optionrom_setup();
249 void vga_setup();
250 void s3_resume_vga_init();
251 extern u32 RomEnd;
252
253 // resume.c
254 void init_dma();
255
256 // pnpbios.c
257 #define PNP_SIGNATURE 0x506e5024 // $PnP
258 u16 get_pnp_offset();
259 void pnp_setup();
260
261 // pmm.c
262 extern struct zone_s ZoneLow, ZoneHigh, ZoneFSeg, ZoneTmpLow, ZoneTmpHigh;
263 void *zone_malloc(struct zone_s *zone, u32 size, u32 align);
264 void *zone_malloc_low(u32 size, u32 align);
265 void malloc_setup();
266 void malloc_finalize();
267 void pmm_setup();
268 void pmm_finalize();
269 // Minimum alignment of malloc'd memory
270 #define MALLOC_MIN_ALIGN 16
271 // Helper functions for memory allocation.
272 static inline void *malloc_low(u32 size) {
273     return zone_malloc_low(size, MALLOC_MIN_ALIGN);
274 }
275 static inline void *malloc_high(u32 size) {
276     return zone_malloc(&ZoneHigh, size, MALLOC_MIN_ALIGN);
277 }
278 static inline void *malloc_fseg(u32 size) {
279     return zone_malloc(&ZoneFSeg, size, MALLOC_MIN_ALIGN);
280 }
281 static inline void *malloc_tmphigh(u32 size) {
282     return zone_malloc(&ZoneTmpHigh, size, MALLOC_MIN_ALIGN);
283 }
284 static inline void *memalign_tmphigh(u32 align, u32 size) {
285     return zone_malloc(&ZoneTmpHigh, size, align);
286 }
287 static inline void *memalign_high(u32 align, u32 size) {
288     return zone_malloc(&ZoneHigh, size, align);
289 }
290
291 // mtrr.c
292 void mtrr_setup(void);
293
294 // romlayout.S
295 void reset_vector() __attribute__ ((noreturn));
296
297 // misc.c
298 extern u8 BiosChecksum;
299
300 // mptable.c
301 extern int irq0override;
302
303 // version (auto generated file out/version.c)
304 extern const char VERSION[];
305
306 #endif // util.h