nkeynes@359 | 1 | /**
|
nkeynes@586 | 2 | * $Id$
|
nkeynes@359 | 3 | *
|
nkeynes@359 | 4 | * SH4->x86 translation module
|
nkeynes@359 | 5 | *
|
nkeynes@359 | 6 | * Copyright (c) 2005 Nathan Keynes.
|
nkeynes@359 | 7 | *
|
nkeynes@359 | 8 | * This program is free software; you can redistribute it and/or modify
|
nkeynes@359 | 9 | * it under the terms of the GNU General Public License as published by
|
nkeynes@359 | 10 | * the Free Software Foundation; either version 2 of the License, or
|
nkeynes@359 | 11 | * (at your option) any later version.
|
nkeynes@359 | 12 | *
|
nkeynes@359 | 13 | * This program is distributed in the hope that it will be useful,
|
nkeynes@359 | 14 | * but WITHOUT ANY WARRANTY; without even the implied warranty of
|
nkeynes@359 | 15 | * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
nkeynes@359 | 16 | * GNU General Public License for more details.
|
nkeynes@359 | 17 | */
|
nkeynes@359 | 18 |
|
nkeynes@586 | 19 | #include "sh4/xltcache.h"
|
nkeynes@359 | 20 | #include "dream.h"
|
nkeynes@359 | 21 | #include "mem.h"
|
nkeynes@359 | 22 |
|
nkeynes@359 | 23 | /** Maximum size of a translated instruction, in bytes. This includes potentially
|
nkeynes@359 | 24 | * writing the entire epilogue
|
nkeynes@359 | 25 | */
|
nkeynes@389 | 26 | #define MAX_INSTRUCTION_SIZE 256
|
nkeynes@410 | 27 | /** Maximum size of the translation epilogue (current real size is 116 bytes, so
|
nkeynes@410 | 28 | * allows a little room
|
nkeynes@410 | 29 | */
|
nkeynes@410 | 30 | #define EPILOGUE_SIZE 128
|
nkeynes@586 | 31 |
|
nkeynes@586 | 32 | /** Maximum number of recovery records for a translated block (2048 based on
|
nkeynes@586 | 33 | * 1 record per SH4 instruction in a 4K page).
|
nkeynes@586 | 34 | */
|
nkeynes@586 | 35 | #define MAX_RECOVERY_SIZE 2048
|
nkeynes@586 | 36 |
|
nkeynes@359 | 37 | /**
|
nkeynes@586 | 38 | * Translation flag - exit the current block but continue (eg exception handling)
|
nkeynes@586 | 39 | */
|
nkeynes@586 | 40 | #define XLAT_EXIT_CONTINUE 1
|
nkeynes@359 | 41 |
|
nkeynes@586 | 42 | /**
|
nkeynes@586 | 43 | * Translation flag - exit the current block and halt immediately (eg fatal error)
|
nkeynes@586 | 44 | */
|
nkeynes@586 | 45 | #define XLAT_EXIT_HALT 2
|
nkeynes@586 | 46 |
|
nkeynes@586 | 47 | /**
|
nkeynes@586 | 48 | * Translation flag - exit the current block and halt immediately for a system
|
nkeynes@586 | 49 | * breakpoint.
|
nkeynes@586 | 50 | */
|
nkeynes@586 | 51 | #define XLAT_EXIT_BREAKPOINT 3
|
nkeynes@586 | 52 |
|
nkeynes@586 | 53 | /**
|
nkeynes@586 | 54 | * Translation flag - exit the current block and continue after performing a full
|
nkeynes@586 | 55 | * system reset (dreamcast_reset())
|
nkeynes@586 | 56 | */
|
nkeynes@586 | 57 | #define XLAT_EXIT_SYSRESET 4
|
nkeynes@586 | 58 |
|
nkeynes@586 | 59 | /**
|
nkeynes@617 | 60 | * Translation flag - exit the current block and continue after the next IRQ.
|
nkeynes@617 | 61 | */
|
nkeynes@617 | 62 | #define XLAT_EXIT_SLEEP 5
|
nkeynes@617 | 63 |
|
nkeynes@617 | 64 | /**
|
nkeynes@359 | 65 | */
|
nkeynes@359 | 66 | uint32_t sh4_xlat_run_slice( uint32_t nanosecs );
|
nkeynes@359 | 67 |
|
nkeynes@359 | 68 | /**
|
nkeynes@586 | 69 | * Return true if translated code is currently running
|
nkeynes@586 | 70 | */
|
nkeynes@586 | 71 | gboolean sh4_xlat_is_running();
|
nkeynes@586 | 72 |
|
nkeynes@586 | 73 | /**
|
nkeynes@669 | 74 | * Initialize the translation engine (if required). Note xlat cache
|
nkeynes@669 | 75 | * must already be initialized.
|
nkeynes@669 | 76 | */
|
nkeynes@669 | 77 | void sh4_xlat_init();
|
nkeynes@669 | 78 |
|
nkeynes@669 | 79 | /**
|
nkeynes@359 | 80 | * Translate the specified block of code starting from the specified start
|
nkeynes@359 | 81 | * address until the first branch/jump instruction.
|
nkeynes@359 | 82 | */
|
nkeynes@359 | 83 | void *sh4_translate_basic_block( sh4addr_t start );
|
nkeynes@359 | 84 |
|
nkeynes@669 | 85 | /**
|
nkeynes@669 | 86 | * Add a recovery record for the current code generation position, with the
|
nkeynes@669 | 87 | * specified instruction count
|
nkeynes@669 | 88 | */
|
nkeynes@669 | 89 | void sh4_translate_add_recovery( uint32_t icount );
|
nkeynes@586 | 90 |
|
nkeynes@359 | 91 | extern uint8_t *xlat_output;
|
nkeynes@586 | 92 | extern struct xlat_recovery_record xlat_recovery[MAX_RECOVERY_SIZE];
|
nkeynes@604 | 93 | extern xlat_cache_block_t xlat_current_block;
|
nkeynes@586 | 94 | extern uint32_t xlat_recovery_posn;
|
nkeynes@359 | 95 |
|
nkeynes@526 | 96 | /******************************************************************************
|
nkeynes@526 | 97 | * Code generation - these methods must be provided by the
|
nkeynes@526 | 98 | * actual code gen (eg sh4x86.c)
|
nkeynes@526 | 99 | ******************************************************************************/
|
nkeynes@359 | 100 |
|
nkeynes@527 | 101 | #define TARGET_X86 1
|
nkeynes@527 | 102 |
|
nkeynes@669 | 103 | void sh4_translate_init( void );
|
nkeynes@408 | 104 | void sh4_translate_begin_block( sh4addr_t pc );
|
nkeynes@526 | 105 | uint32_t sh4_translate_instruction( sh4addr_t pc );
|
nkeynes@359 | 106 | void sh4_translate_end_block( sh4addr_t pc );
|
nkeynes@593 | 107 | uint32_t sh4_translate_end_block_size();
|
nkeynes@669 | 108 | void sh4_translate_emit_breakpoint( sh4vma_t pc );
|
nkeynes@586 | 109 |
|
nkeynes@586 | 110 | typedef void (*unwind_thunk_t)(void);
|
nkeynes@586 | 111 |
|
nkeynes@586 | 112 | /**
|
nkeynes@586 | 113 | * From within the translator, (typically called from MMU exception handling routines)
|
nkeynes@586 | 114 | * immediately exit the current translation block (performing cleanup as necessary) and
|
nkeynes@586 | 115 | * return to sh4_xlat_run_slice(). Effectively a fast longjmp w/ xlat recovery.
|
nkeynes@586 | 116 | *
|
nkeynes@586 | 117 | * Note: The correct working of this method depends on the translator anticipating the
|
nkeynes@586 | 118 | * exception and generating the appropriate recovery block(s) - currently this means
|
nkeynes@586 | 119 | * that it should ONLY be called from within the context of a memory read or write.
|
nkeynes@586 | 120 | *
|
nkeynes@586 | 121 | * @param is_completion If TRUE, exit after completing the current instruction (effectively),
|
nkeynes@586 | 122 | * otherwise abort the current instruction with no effect.
|
nkeynes@586 | 123 | * @param thunk A function to execute after perform xlat recovery, but before returning
|
nkeynes@586 | 124 | * to run_slice. If NULL, control returns directly.
|
nkeynes@586 | 125 | * @return This method never returns.
|
nkeynes@586 | 126 | */
|
nkeynes@586 | 127 | void sh4_translate_unwind_stack( gboolean is_completion, unwind_thunk_t thunk );
|
nkeynes@586 | 128 |
|
nkeynes@586 | 129 | /**
|
nkeynes@586 | 130 | * From within the translator, immediately exit the current translation block with
|
nkeynes@586 | 131 | * the specified exit code (one of the XLAT_EXIT_* values).
|
nkeynes@586 | 132 | */
|
nkeynes@586 | 133 | void sh4_translate_exit( int exit_code );
|
nkeynes@591 | 134 |
|
nkeynes@591 | 135 | /**
|
nkeynes@669 | 136 | * From within the translator, exit the current block at the end of the
|
nkeynes@669 | 137 | * current instruction, flush the translation cache (completely) and return
|
nkeynes@669 | 138 | * control to sh4_xlat_run_slice.
|
nkeynes@669 | 139 | */
|
nkeynes@669 | 140 | void sh4_translate_flush_cache( void );
|
nkeynes@669 | 141 |
|
nkeynes@669 | 142 | /**
|
nkeynes@591 | 143 | * Support function called from the translator when a breakpoint is hit.
|
nkeynes@591 | 144 | * Either returns immediately (to skip the breakpoint), or aborts the current
|
nkeynes@591 | 145 | * cycle and never returns.
|
nkeynes@591 | 146 | */
|
nkeynes@591 | 147 | void sh4_translate_breakpoint_hit( sh4vma_t pc );
|