61cb83a8ccd1dd7f671f31fa93c9d8b7be09b4ccvboxsync/****************************************************************************
61cb83a8ccd1dd7f671f31fa93c9d8b7be09b4ccvboxsync* Realmode X86 Emulator Library
61cb83a8ccd1dd7f671f31fa93c9d8b7be09b4ccvboxsync* Copyright (C) 1996-1999 SciTech Software, Inc.
61cb83a8ccd1dd7f671f31fa93c9d8b7be09b4ccvboxsync* Copyright (C) David Mosberger-Tang
61cb83a8ccd1dd7f671f31fa93c9d8b7be09b4ccvboxsync* Copyright (C) 1999 Egbert Eich
61cb83a8ccd1dd7f671f31fa93c9d8b7be09b4ccvboxsync* ========================================================================
61cb83a8ccd1dd7f671f31fa93c9d8b7be09b4ccvboxsync* Permission to use, copy, modify, distribute, and sell this software and
61cb83a8ccd1dd7f671f31fa93c9d8b7be09b4ccvboxsync* its documentation for any purpose is hereby granted without fee,
61cb83a8ccd1dd7f671f31fa93c9d8b7be09b4ccvboxsync* provided that the above copyright notice appear in all copies and that
61cb83a8ccd1dd7f671f31fa93c9d8b7be09b4ccvboxsync* both that copyright notice and this permission notice appear in
61cb83a8ccd1dd7f671f31fa93c9d8b7be09b4ccvboxsync* supporting documentation, and that the name of the authors not be used
61cb83a8ccd1dd7f671f31fa93c9d8b7be09b4ccvboxsync* in advertising or publicity pertaining to distribution of the software
61cb83a8ccd1dd7f671f31fa93c9d8b7be09b4ccvboxsync* without specific, written prior permission. The authors makes no
61cb83a8ccd1dd7f671f31fa93c9d8b7be09b4ccvboxsync* representations about the suitability of this software for any purpose.
61cb83a8ccd1dd7f671f31fa93c9d8b7be09b4ccvboxsync* It is provided "as is" without express or implied warranty.
61cb83a8ccd1dd7f671f31fa93c9d8b7be09b4ccvboxsync* THE AUTHORS DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
61cb83a8ccd1dd7f671f31fa93c9d8b7be09b4ccvboxsync* INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO
61cb83a8ccd1dd7f671f31fa93c9d8b7be09b4ccvboxsync* EVENT SHALL THE AUTHORS BE LIABLE FOR ANY SPECIAL, INDIRECT OR
61cb83a8ccd1dd7f671f31fa93c9d8b7be09b4ccvboxsync* CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF
61cb83a8ccd1dd7f671f31fa93c9d8b7be09b4ccvboxsync* USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
61cb83a8ccd1dd7f671f31fa93c9d8b7be09b4ccvboxsync* OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
61cb83a8ccd1dd7f671f31fa93c9d8b7be09b4ccvboxsync* PERFORMANCE OF THIS SOFTWARE.
61cb83a8ccd1dd7f671f31fa93c9d8b7be09b4ccvboxsync* ========================================================================
61cb83a8ccd1dd7f671f31fa93c9d8b7be09b4ccvboxsync* Language: ANSI C
61cb83a8ccd1dd7f671f31fa93c9d8b7be09b4ccvboxsync* Environment: Any
61cb83a8ccd1dd7f671f31fa93c9d8b7be09b4ccvboxsync* Developer: Kendall Bennett
61cb83a8ccd1dd7f671f31fa93c9d8b7be09b4ccvboxsync* Description: Header file for public specific functions.
61cb83a8ccd1dd7f671f31fa93c9d8b7be09b4ccvboxsync* Any application linking against us should only
61cb83a8ccd1dd7f671f31fa93c9d8b7be09b4ccvboxsync* include this header
61cb83a8ccd1dd7f671f31fa93c9d8b7be09b4ccvboxsync****************************************************************************/
61cb83a8ccd1dd7f671f31fa93c9d8b7be09b4ccvboxsync/*---------------------- Macros and type definitions ----------------------*/
61cb83a8ccd1dd7f671f31fa93c9d8b7be09b4ccvboxsync#pragma PACK /* Don't pack structs with function pointers! */
61cb83a8ccd1dd7f671f31fa93c9d8b7be09b4ccvboxsync/****************************************************************************
61cb83a8ccd1dd7f671f31fa93c9d8b7be09b4ccvboxsyncData structure containing ponters to programmed I/O functions used by the
61cb83a8ccd1dd7f671f31fa93c9d8b7be09b4ccvboxsyncemulator. This is used so that the user program can hook all programmed
61cb83a8ccd1dd7f671f31fa93c9d8b7be09b4ccvboxsyncI/O for the emulator to handled as necessary by the user program. By
61cb83a8ccd1dd7f671f31fa93c9d8b7be09b4ccvboxsyncdefault the emulator contains simple functions that do not do access the
61cb83a8ccd1dd7f671f31fa93c9d8b7be09b4ccvboxsynchardware in any way. To allow the emualtor access the hardware, you will
61cb83a8ccd1dd7f671f31fa93c9d8b7be09b4ccvboxsyncneed to override the programmed I/O functions using the X86EMU_setupPioFuncs
61cb83a8ccd1dd7f671f31fa93c9d8b7be09b4ccvboxsyncinb - Function to read a byte from an I/O port
61cb83a8ccd1dd7f671f31fa93c9d8b7be09b4ccvboxsyncinw - Function to read a word from an I/O port
61cb83a8ccd1dd7f671f31fa93c9d8b7be09b4ccvboxsyncinl - Function to read a dword from an I/O port
61cb83a8ccd1dd7f671f31fa93c9d8b7be09b4ccvboxsyncoutb - Function to write a byte to an I/O port
61cb83a8ccd1dd7f671f31fa93c9d8b7be09b4ccvboxsyncoutw - Function to write a word to an I/O port
61cb83a8ccd1dd7f671f31fa93c9d8b7be09b4ccvboxsyncoutl - Function to write a dword to an I/O port
61cb83a8ccd1dd7f671f31fa93c9d8b7be09b4ccvboxsync****************************************************************************/
61cb83a8ccd1dd7f671f31fa93c9d8b7be09b4ccvboxsynctypedef struct {
61cb83a8ccd1dd7f671f31fa93c9d8b7be09b4ccvboxsync void (X86APIP outw) (X86EMU_pioAddr addr, u16 val);
61cb83a8ccd1dd7f671f31fa93c9d8b7be09b4ccvboxsync void (X86APIP outl) (X86EMU_pioAddr addr, u32 val);
61cb83a8ccd1dd7f671f31fa93c9d8b7be09b4ccvboxsync/****************************************************************************
61cb83a8ccd1dd7f671f31fa93c9d8b7be09b4ccvboxsyncData structure containing ponters to memory access functions used by the
61cb83a8ccd1dd7f671f31fa93c9d8b7be09b4ccvboxsyncemulator. This is used so that the user program can hook all memory
61cb83a8ccd1dd7f671f31fa93c9d8b7be09b4ccvboxsyncaccess functions as necessary for the emulator. By default the emulator
61cb83a8ccd1dd7f671f31fa93c9d8b7be09b4ccvboxsynccontains simple functions that only access the internal memory of the
61cb83a8ccd1dd7f671f31fa93c9d8b7be09b4ccvboxsyncemulator. If you need specialised functions to handle access to different
61cb83a8ccd1dd7f671f31fa93c9d8b7be09b4ccvboxsynctypes of memory (ie: hardware framebuffer accesses and BIOS memory access
61cb83a8ccd1dd7f671f31fa93c9d8b7be09b4ccvboxsyncetc), you will need to override this using the X86EMU_setupMemFuncs
61cb83a8ccd1dd7f671f31fa93c9d8b7be09b4ccvboxsyncrdb - Function to read a byte from an address
61cb83a8ccd1dd7f671f31fa93c9d8b7be09b4ccvboxsyncrdw - Function to read a word from an address
61cb83a8ccd1dd7f671f31fa93c9d8b7be09b4ccvboxsyncrdl - Function to read a dword from an address
61cb83a8ccd1dd7f671f31fa93c9d8b7be09b4ccvboxsyncwrb - Function to write a byte to an address
61cb83a8ccd1dd7f671f31fa93c9d8b7be09b4ccvboxsyncwrw - Function to write a word to an address
61cb83a8ccd1dd7f671f31fa93c9d8b7be09b4ccvboxsyncwrl - Function to write a dword to an address
61cb83a8ccd1dd7f671f31fa93c9d8b7be09b4ccvboxsync****************************************************************************/
61cb83a8ccd1dd7f671f31fa93c9d8b7be09b4ccvboxsynctypedef struct {
61cb83a8ccd1dd7f671f31fa93c9d8b7be09b4ccvboxsync/****************************************************************************
61cb83a8ccd1dd7f671f31fa93c9d8b7be09b4ccvboxsync Here are the default memory read and write
61cb83a8ccd1dd7f671f31fa93c9d8b7be09b4ccvboxsync function in case they are needed as fallbacks.
61cb83a8ccd1dd7f671f31fa93c9d8b7be09b4ccvboxsync***************************************************************************/
61cb83a8ccd1dd7f671f31fa93c9d8b7be09b4ccvboxsync/*--------------------- type definitions -----------------------------------*/
61cb83a8ccd1dd7f671f31fa93c9d8b7be09b4ccvboxsync/*-------------------------- Function Prototypes --------------------------*/
61cb83a8ccd1dd7f671f31fa93c9d8b7be09b4ccvboxsync void X86EMU_setupMemFuncs(X86EMU_memFuncs * funcs);
61cb83a8ccd1dd7f671f31fa93c9d8b7be09b4ccvboxsync void X86EMU_setupPioFuncs(X86EMU_pioFuncs * funcs);
61cb83a8ccd1dd7f671f31fa93c9d8b7be09b4ccvboxsync void X86EMU_setupIntrFuncs(X86EMU_intrFuncs funcs[]);
61cb83a8ccd1dd7f671f31fa93c9d8b7be09b4ccvboxsync printk("halt_sys: file %s, line %d\n", __FILE__, __LINE__), \
61cb83a8ccd1dd7f671f31fa93c9d8b7be09b4ccvboxsync/* Debug options */
61cb83a8ccd1dd7f671f31fa93c9d8b7be09b4ccvboxsync#define DEBUG_DECODE_F 0x000001 /* print decoded instruction */
61cb83a8ccd1dd7f671f31fa93c9d8b7be09b4ccvboxsync#define DEBUG_TRACE_F 0x000002 /* dump regs before/after execution */
61cb83a8ccd1dd7f671f31fa93c9d8b7be09b4ccvboxsync#define DEBUG_SYSINT_F 0x000200 /* bios system interrupts. */
61cb83a8ccd1dd7f671f31fa93c9d8b7be09b4ccvboxsync#define DEBUG_SYS_F (DEBUG_SVC_F|DEBUG_FS_F|DEBUG_PROC_F)
61cb83a8ccd1dd7f671f31fa93c9d8b7be09b4ccvboxsync void X86EMU_dump_memory(u16 seg, u16 off, u32 amt);
61cb83a8ccd1dd7f671f31fa93c9d8b7be09b4ccvboxsync} /* End of "C" linkage for C++ */
61cb83a8ccd1dd7f671f31fa93c9d8b7be09b4ccvboxsync#endif /* __X86EMU_X86EMU_H */