VirtualBox

source: vbox/trunk/src/VBox/Devices/PC/BIOS/biosint.h@ 93115

Last change on this file since 93115 was 93115, checked in by vboxsync, 2 years ago

scm --update-copyright-year
  • Property svn:eol-style set to native
  • Property svn:keywords set to Author Date Id Revision
File size: 9.2 KB
Line 
1/* $Id: biosint.h 93115 2022-01-01 11:31:46Z vboxsync $ */
2/** @file
3 * PC BIOS - BIOS internal definitions.
4 */
5
6/*
7 * Copyright (C) 2006-2022 Oracle Corporation
8 *
9 * This file is part of VirtualBox Open Source Edition (OSE), as
10 * available from http://www.virtualbox.org. This file is free software;
11 * you can redistribute it and/or modify it under the terms of the GNU
12 * General Public License (GPL) as published by the Free Software
13 * Foundation, in version 2 as it comes in the "COPYING" file of the
14 * VirtualBox OSE distribution. VirtualBox OSE is distributed in the
15 * hope that it will be useful, but WITHOUT ANY WARRANTY of any kind.
16 * --------------------------------------------------------------------
17 *
18 * This code is based on:
19 *
20 * ROM BIOS for use with Bochs/Plex86/QEMU emulation environment
21 *
22 * Copyright (C) 2002 MandrakeSoft S.A.
23 *
24 * MandrakeSoft S.A.
25 * 43, rue d'Aboukir
26 * 75002 Paris - France
27 * http://www.linux-mandrake.com/
28 * http://www.mandrakesoft.com/
29 *
30 * This library is free software; you can redistribute it and/or
31 * modify it under the terms of the GNU Lesser General Public
32 * License as published by the Free Software Foundation; either
33 * version 2 of the License, or (at your option) any later version.
34 *
35 * This library is distributed in the hope that it will be useful,
36 * but WITHOUT ANY WARRANTY; without even the implied warranty of
37 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
38 * Lesser General Public License for more details.
39 *
40 * You should have received a copy of the GNU Lesser General Public
41 * License along with this library; if not, write to the Free Software
42 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
43 *
44 */
45
46/*
47 * Oracle LGPL Disclaimer: For the avoidance of doubt, except that if any license choice
48 * other than GPL or LGPL is available it will apply instead, Oracle elects to use only
49 * the Lesser General Public License version 2.1 (LGPLv2) at this time for any software where
50 * a choice of LGPL license versions is made available with the language indicating
51 * that LGPLv2 or any later version may be used, or where a choice of which version
52 * of the LGPL is applied is otherwise unspecified.
53 */
54
55#ifndef VBOX_INCLUDED_SRC_PC_BIOS_biosint_h
56#define VBOX_INCLUDED_SRC_PC_BIOS_biosint_h
57#ifndef RT_WITHOUT_PRAGMA_ONCE
58# pragma once
59#endif
60
61/* Compile-time assertion macro. */
62#define ct_assert(a) extern int ct_ass_arr[!!(a) == 1];
63
64/* For functions called from assembly code. */
65#define BIOSCALL __cdecl
66
67#define BX_ELTORITO_BOOT 1
68#define BX_PCIBIOS 1
69#define BX_USE_PS2_MOUSE 1
70#define BX_APM 1
71
72#ifndef DEBUG_ATA
73# define DEBUG_ATA 0
74#endif
75#ifdef DEBUG_AHCI
76# define DEBUG_AHCI 0
77#endif
78#ifndef DEBUG_SCSI
79# define DEBUG_SCSI 0
80#endif
81#ifndef DEBUG_CD_BOOT
82# define DEBUG_CD_BOOT 0
83#endif
84#ifndef DEBUG_ELTORITO
85# define DEBUG_ELTORITO 0
86#endif
87#ifndef DEBUG_INT13_HD
88# define DEBUG_INT13_HD 0
89#endif
90#ifndef DEBUG_INT13_FL
91# define DEBUG_INT13_FL 0
92#endif
93#ifndef DEBUG_INT13_CD
94# define DEBUG_INT13_CD 0
95#endif
96#ifndef DEBUG_INT15
97# define DEBUG_INT15 0
98#endif
99#ifndef DEBUG_INT15_MS
100# define DEBUG_INT15_MS 0
101#endif
102#ifndef DEBUG_INT16
103# define DEBUG_INT16 0
104#endif
105#ifndef DEBUG_INT1A
106# define DEBUG_INT1A 0
107#endif
108#ifndef DEBUG_INT74
109# define DEBUG_INT74 0
110#endif
111#ifndef DEBUG_PCI
112# define DEBUG_PCI 0
113#endif
114#ifndef DEBUG_APM
115# define DEBUG_APM 0
116#endif
117#ifndef DEBUG_POST
118# define DEBUG_POST 0
119#endif
120
121#define FP_OFF(p) ((unsigned)(p))
122#define FP_SEG(p) ((unsigned)((unsigned long)(void __far*)(p) >> 16))
123#define MK_FP(s,o) (((unsigned short)(s)):>((void __near *)(o)))
124
125typedef struct {
126 union {
127 struct {
128 uint16_t di, si, bp, sp;
129 uint16_t bx, dx, cx, ax;
130 } r16;
131 struct {
132 uint16_t filler[4];
133 uint8_t bl, bh, dl, dh, cl, ch, al, ah;
134 } r8;
135 } u;
136} pusha_regs_t;
137
138typedef struct {
139 union {
140 struct {
141 uint32_t edi, esi, ebp, esp;
142 uint32_t ebx, edx, ecx, eax;
143 } r32;
144 struct {
145 uint16_t di, filler1, si, filler2, bp, filler3, sp, filler4;
146 uint16_t bx, filler5, dx, filler6, cx, filler7, ax, filler8;
147 } r16;
148 struct {
149 uint32_t filler[4];
150 uint8_t bl, bh;
151 uint16_t filler1;
152 uint8_t dl, dh;
153 uint16_t filler2;
154 uint8_t cl, ch;
155 uint16_t filler3;
156 uint8_t al, ah;
157 uint16_t filler4;
158 } r8;
159 } u;
160} pushad_regs_t;
161
162typedef struct {
163 union {
164 struct {
165 uint16_t flags;
166 } r16;
167 struct {
168 uint8_t flagsl;
169 uint8_t flagsh;
170 } r8;
171 } u;
172} flags_t;
173
174typedef struct {
175 uint16_t ip;
176 uint16_t cs;
177 flags_t flags;
178} iret_addr_t;
179
180typedef struct {
181 uint16_t ds;
182 uint16_t es;
183 pusha_regs_t gr;
184 iret_addr_t ra;
185} disk_regs_t;
186
187typedef struct {
188 pusha_regs_t gr;
189 uint16_t es;
190 uint16_t ds;
191 uint16_t ifl;
192 iret_addr_t ra;
193} kbd_regs_t;
194
195typedef struct {
196 pusha_regs_t gr;
197 uint16_t es;
198 uint16_t ds;
199 flags_t fl;
200} sys_regs_t;
201
202typedef struct {
203 pushad_regs_t gr;
204 uint16_t es;
205 uint16_t ds;
206 flags_t fl;
207} sys32_regs_t;
208
209typedef struct {
210 pusha_regs_t gr;
211 iret_addr_t ra;
212} i1apci_regs_t;
213
214
215#define SetCF(x) x.u.r8.flagsl |= 0x01
216#define SetZF(x) x.u.r8.flagsl |= 0x40
217#define ClearCF(x) x.u.r8.flagsl &= 0xfe
218#define ClearZF(x) x.u.r8.flagsl &= 0xbf
219#define GetCF(x) (x.u.r8.flagsl & 0x01)
220
221#define SET_AL(val8) AX = ((AX & 0xff00) | (val8))
222#define SET_BL(val8) BX = ((BX & 0xff00) | (val8))
223#define SET_CL(val8) CX = ((CX & 0xff00) | (val8))
224#define SET_DL(val8) DX = ((DX & 0xff00) | (val8))
225#define SET_AH(val8) AX = ((AX & 0x00ff) | ((val8) << 8))
226#define SET_BH(val8) BX = ((BX & 0x00ff) | ((val8) << 8))
227#define SET_CH(val8) CX = ((CX & 0x00ff) | ((val8) << 8))
228#define SET_DH(val8) DX = ((DX & 0x00ff) | ((val8) << 8))
229
230#define GET_AL() ( AX & 0x00ff )
231#define GET_BL() ( BX & 0x00ff )
232#define GET_CL() ( CX & 0x00ff )
233#define GET_DL() ( DX & 0x00ff )
234#define GET_AH() ( AX >> 8 )
235#define GET_BH() ( BX >> 8 )
236#define GET_CH() ( CX >> 8 )
237#define GET_DH() ( DX >> 8 )
238
239#define GET_ELDL() ( ELDX & 0x00ff )
240#define GET_ELDH() ( ELDX >> 8 )
241
242#define SET_CF() FLAGS |= 0x0001
243#define CLEAR_CF() FLAGS &= 0xfffe
244#define GET_CF() (FLAGS & 0x0001)
245
246#define SET_ZF() FLAGS |= 0x0040
247#define CLEAR_ZF() FLAGS &= 0xffbf
248#define GET_ZF() (FLAGS & 0x0040)
249
250#define SET_IF() FLAGS |= 0x0200
251
252typedef unsigned short bx_bool;
253
254#define BX_VIRTUAL_PORTS 1 /* normal output to Bochs ports */
255#define BX_DEBUG_SERIAL 0 /* output to COM1 */
256
257#define BIOS_PRINTF_HALT 1
258#define BIOS_PRINTF_SCREEN 2
259#define BIOS_PRINTF_INFO 4
260#define BIOS_PRINTF_DEBUG 8
261#define BIOS_PRINTF_ALL (BIOS_PRINTF_SCREEN | BIOS_PRINTF_INFO)
262#define BIOS_PRINTF_DEBHALT (BIOS_PRINTF_SCREEN | BIOS_PRINTF_INFO | BIOS_PRINTF_HALT)
263
264extern const char bios_prefix_string[];
265extern void bios_printf(uint16_t action, const char *s, ...);
266extern void put_str(uint16_t action, const char __far *s);
267extern void put_str_near(uint16_t action, const char __near *s);
268extern uint8_t inb_cmos(uint8_t cmos_reg);
269extern void outb_cmos(uint8_t cmos_reg, uint8_t val);
270extern uint16_t get_cmos_word(uint8_t idxFirst);
271extern uint16_t cdrom_boot(void);
272extern void show_logo(void);
273extern void delay_boot(uint16_t secs);
274extern bx_bool set_enable_a20(bx_bool val);
275
276#define printf(...) bios_printf(BIOS_PRINTF_SCREEN, __VA_ARGS__)
277
278// Defines the output macros.
279// BX_DEBUG goes to INFO port until we can easily choose debug info on a
280// per-device basis. Debug info are sent only in debug mode
281#define DEBUG_ROMBIOS 1
282#if DEBUG_ROMBIOS
283# define BX_DEBUG(...) bios_printf(BIOS_PRINTF_INFO, __VA_ARGS__)
284#else
285# define BX_DEBUG(...)
286#endif
287#ifdef VBOX
288#define BX_INFO(...) do { put_str(BIOS_PRINTF_INFO, bios_prefix_string); bios_printf(BIOS_PRINTF_INFO, __VA_ARGS__); } while (0)
289#define BX_INFO_CON(...)do { put_str(BIOS_PRINTF_INFO, bios_prefix_string); bios_printf(BIOS_PRINTF_ALL, __VA_ARGS__); } while (0)
290#else /* !VBOX */
291#define BX_INFO(...) bios_printf(BIOS_PRINTF_INFO, __VA_ARGS__)
292#endif /* !VBOX */
293#define BX_PANIC(...) bios_printf(BIOS_PRINTF_DEBHALT, __VA_ARGS__)
294
295uint16_t pci16_find_device(uint32_t search_item, uint16_t index, int search_class, int ignore_if);
296
297/* Because we don't tell the recompiler when guest physical memory
298 * is written, it can incorrectly cache guest code overwritten by
299 * DMA (bus master or not). We just re-write the memory block to flush
300 * any of its caches. This is not exactly efficient, but works!
301 */
302#define DMA_WORKAROUND 1
303
304/* Random hardware-related definitions. */
305
306#define PIC_MASTER 0x20
307#define PIC_MASTER_MASK 0x21
308#define PIC_SLAVE 0xA0
309#define PIC_SLAVE_MASK 0xA1
310#define PIC_CMD_EOI 0x20
311#define PIC_CMD_RD_ISR 0x0B
312#define PIC_CMD_INIT 0x11
313
314#endif /* !VBOX_INCLUDED_SRC_PC_BIOS_biosint_h */
315
Note: See TracBrowser for help on using the repository browser.

© 2023 Oracle
Contact – Privacy policy – Terms of Use