filename | src/sh4/sh4trans.h |
changeset | 593:6c710c7c6835 |
prev | 591:7b9612fd2395 |
next | 604:1024c3a9cb88 |
author | nkeynes |
date | Tue Jan 22 10:11:45 2008 +0000 (16 years ago) |
permissions | -rw-r--r-- |
last change | Invoke emulator single-step for untranslatable delay slots (and fix a few related bugs) |
view | annotate | diff | log | raw |
1 /**
2 * $Id$
3 *
4 * SH4->x86 translation module
5 *
6 * Copyright (c) 2005 Nathan Keynes.
7 *
8 * This program is free software; you can redistribute it and/or modify
9 * it under the terms of the GNU General Public License as published by
10 * the Free Software Foundation; either version 2 of the License, or
11 * (at your option) any later version.
12 *
13 * This program is distributed in the hope that it will be useful,
14 * but WITHOUT ANY WARRANTY; without even the implied warranty of
15 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 * GNU General Public License for more details.
17 */
19 #include "sh4/xltcache.h"
20 #include "dream.h"
21 #include "mem.h"
23 /** Maximum size of a translated instruction, in bytes. This includes potentially
24 * writing the entire epilogue
25 */
26 #define MAX_INSTRUCTION_SIZE 256
27 /** Maximum size of the translation epilogue (current real size is 116 bytes, so
28 * allows a little room
29 */
30 #define EPILOGUE_SIZE 128
32 /** Maximum number of recovery records for a translated block (2048 based on
33 * 1 record per SH4 instruction in a 4K page).
34 */
35 #define MAX_RECOVERY_SIZE 2048
37 /**
38 * Translation flag - exit the current block but continue (eg exception handling)
39 */
40 #define XLAT_EXIT_CONTINUE 1
42 /**
43 * Translation flag - exit the current block and halt immediately (eg fatal error)
44 */
45 #define XLAT_EXIT_HALT 2
47 /**
48 * Translation flag - exit the current block and halt immediately for a system
49 * breakpoint.
50 */
51 #define XLAT_EXIT_BREAKPOINT 3
53 /**
54 * Translation flag - exit the current block and continue after performing a full
55 * system reset (dreamcast_reset())
56 */
57 #define XLAT_EXIT_SYSRESET 4
59 /**
60 */
61 uint32_t sh4_xlat_run_slice( uint32_t nanosecs );
63 /**
64 * Return true if translated code is currently running
65 */
66 gboolean sh4_xlat_is_running();
68 /**
69 * Translate the specified block of code starting from the specified start
70 * address until the first branch/jump instruction.
71 */
72 void *sh4_translate_basic_block( sh4addr_t start );
75 extern uint8_t *xlat_output;
76 extern struct xlat_recovery_record xlat_recovery[MAX_RECOVERY_SIZE];
77 extern uint32_t xlat_recovery_posn;
79 /******************************************************************************
80 * Code generation - these methods must be provided by the
81 * actual code gen (eg sh4x86.c)
82 ******************************************************************************/
84 #define TARGET_X86 1
85 #define TARGET_X86_64 2
87 void sh4_translate_begin_block( sh4addr_t pc );
88 uint32_t sh4_translate_instruction( sh4addr_t pc );
89 void sh4_translate_end_block( sh4addr_t pc );
90 uint32_t sh4_translate_end_block_size();
92 typedef void (*unwind_thunk_t)(void);
94 /**
95 * From within the translator, (typically called from MMU exception handling routines)
96 * immediately exit the current translation block (performing cleanup as necessary) and
97 * return to sh4_xlat_run_slice(). Effectively a fast longjmp w/ xlat recovery.
98 *
99 * Note: The correct working of this method depends on the translator anticipating the
100 * exception and generating the appropriate recovery block(s) - currently this means
101 * that it should ONLY be called from within the context of a memory read or write.
102 *
103 * @param is_completion If TRUE, exit after completing the current instruction (effectively),
104 * otherwise abort the current instruction with no effect.
105 * @param thunk A function to execute after perform xlat recovery, but before returning
106 * to run_slice. If NULL, control returns directly.
107 * @return This method never returns.
108 */
109 void sh4_translate_unwind_stack( gboolean is_completion, unwind_thunk_t thunk );
111 /**
112 * From within the translator, immediately exit the current translation block with
113 * the specified exit code (one of the XLAT_EXIT_* values).
114 */
115 void sh4_translate_exit( int exit_code );
117 /**
118 * Support function called from the translator when a breakpoint is hit.
119 * Either returns immediately (to skip the breakpoint), or aborts the current
120 * cycle and never returns.
121 */
122 void sh4_translate_breakpoint_hit( sh4vma_t pc );
.