Search
lxdream.org :: lxdream/src/sh4/sh4.h
lxdream 0.9.1
released Jun 29
Download Now
filename src/sh4/sh4.h
changeset 564:dc7b5ffb0535
next566:59be465e5f01
author nkeynes
date Tue Jan 01 08:37:26 2008 +0000 (13 years ago)
branchlxdream-mmu
permissions -rw-r--r--
last change Refactor sh4core.h to extract the "public" material into a new sh4.h
file annotate diff log raw
nkeynes@564
     1
/**
nkeynes@564
     2
 * $Id: sh4.h 577 2008-01-01 05:08:38Z nkeynes $
nkeynes@564
     3
 * 
nkeynes@564
     4
 * This file defines the public functions and definitions exported by the SH4
nkeynes@564
     5
 * modules.
nkeynes@564
     6
 *
nkeynes@564
     7
 * Copyright (c) 2005 Nathan Keynes.
nkeynes@564
     8
 *
nkeynes@564
     9
 * This program is free software; you can redistribute it and/or modify
nkeynes@564
    10
 * it under the terms of the GNU General Public License as published by
nkeynes@564
    11
 * the Free Software Foundation; either version 2 of the License, or
nkeynes@564
    12
 * (at your option) any later version.
nkeynes@564
    13
 *
nkeynes@564
    14
 * This program is distributed in the hope that it will be useful,
nkeynes@564
    15
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
nkeynes@564
    16
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
nkeynes@564
    17
 * GNU General Public License for more details.
nkeynes@564
    18
 */
nkeynes@564
    19
nkeynes@564
    20
#ifndef lxdream_sh4_H
nkeynes@564
    21
#define lxdream_sh4_H 1
nkeynes@564
    22
nkeynes@564
    23
#include "lxdream.h"
nkeynes@564
    24
nkeynes@564
    25
#ifdef __cplusplus
nkeynes@564
    26
extern "C" {
nkeynes@564
    27
#endif
nkeynes@564
    28
nkeynes@564
    29
nkeynes@564
    30
/**
nkeynes@564
    31
 * SH4 is running normally 
nkeynes@564
    32
 */
nkeynes@564
    33
#define SH4_STATE_RUNNING 1
nkeynes@564
    34
/**
nkeynes@564
    35
 * SH4 is not executing instructions but all peripheral modules are still
nkeynes@564
    36
 * running
nkeynes@564
    37
 */
nkeynes@564
    38
#define SH4_STATE_SLEEP 2
nkeynes@564
    39
/**
nkeynes@564
    40
 * SH4 is not executing instructions, DMAC is halted, but all other peripheral
nkeynes@564
    41
 * modules are still running
nkeynes@564
    42
 */
nkeynes@564
    43
#define SH4_STATE_DEEP_SLEEP 3
nkeynes@564
    44
/**
nkeynes@564
    45
 * SH4 is not executing instructions and all peripheral modules are also
nkeynes@564
    46
 * stopped. As close as you can get to powered-off without actually being
nkeynes@564
    47
 * off.
nkeynes@564
    48
 */
nkeynes@564
    49
#define SH4_STATE_STANDBY 4
nkeynes@564
    50
nkeynes@564
    51
/**
nkeynes@564
    52
 * sh4r.event_types flag indicating a pending IRQ
nkeynes@564
    53
 */
nkeynes@564
    54
#define PENDING_IRQ 1
nkeynes@564
    55
nkeynes@564
    56
/**
nkeynes@564
    57
 * sh4r.event_types flag indicating a pending event (from the event queue)
nkeynes@564
    58
 */
nkeynes@564
    59
#define PENDING_EVENT 2
nkeynes@564
    60
nkeynes@564
    61
/**
nkeynes@564
    62
 * SH4 register structure
nkeynes@564
    63
 */
nkeynes@564
    64
struct sh4_registers {
nkeynes@564
    65
    uint32_t r[16];
nkeynes@564
    66
    uint32_t sr, pr, pc, fpscr;
nkeynes@564
    67
    uint32_t t, m, q, s; /* really boolean - 0 or 1 */
nkeynes@564
    68
    int32_t fpul;
nkeynes@564
    69
    float *fr_bank;
nkeynes@564
    70
    float fr[2][16];
nkeynes@564
    71
    uint64_t mac;
nkeynes@564
    72
    uint32_t gbr, ssr, spc, sgr, dbr, vbr;
nkeynes@564
    73
nkeynes@564
    74
    uint32_t r_bank[8]; /* hidden banked registers */
nkeynes@564
    75
    int32_t store_queue[16]; /* technically 2 banks of 32 bytes */
nkeynes@564
    76
    
nkeynes@564
    77
    uint32_t new_pc; /* Not a real register, but used to handle delay slots */
nkeynes@564
    78
    uint32_t event_pending; /* slice cycle time of the next pending event, or FFFFFFFF
nkeynes@564
    79
                             when no events are pending */
nkeynes@564
    80
    uint32_t event_types; /* bit 0 = IRQ pending, bit 1 = general event pending */
nkeynes@564
    81
    int in_delay_slot; /* flag to indicate the current instruction is in
nkeynes@564
    82
                             * a delay slot (certain rules apply) */
nkeynes@564
    83
    uint32_t slice_cycle; /* Current nanosecond within the timeslice */
nkeynes@564
    84
    int sh4_state; /* Current power-on state (one of the SH4_STATE_* values ) */
nkeynes@564
    85
};
nkeynes@564
    86
nkeynes@564
    87
extern struct sh4_registers sh4r;
nkeynes@564
    88
nkeynes@564
    89
/**
nkeynes@564
    90
 * Switch between translation and emulation execution modes. Note that this
nkeynes@564
    91
 * should only be used while the system is stopped. If the system was built
nkeynes@564
    92
 * without translation support, this method has no effect.
nkeynes@564
    93
 *
nkeynes@564
    94
 * @param use TRUE for translation mode, FALSE for emulation mode.
nkeynes@564
    95
 */
nkeynes@564
    96
void sh4_set_use_xlat( gboolean use );
nkeynes@564
    97
nkeynes@564
    98
/**
nkeynes@564
    99
 * Explicitly set the SH4 PC to the supplied value - this will be the next
nkeynes@564
   100
 * instruction executed. This should only be called while the system is stopped.
nkeynes@564
   101
 */
nkeynes@564
   102
void sh4_set_pc( int pc );
nkeynes@564
   103
nkeynes@564
   104
/**
nkeynes@564
   105
 * Execute (using the emulator) a single instruction (in other words, perform a
nkeynes@564
   106
 * single-step operation). 
nkeynes@564
   107
 */
nkeynes@564
   108
gboolean sh4_execute_instruction( void );
nkeynes@564
   109
nkeynes@564
   110
/* SH4 breakpoints */
nkeynes@564
   111
nkeynes@564
   112
#define BREAK_ONESHOT 1
nkeynes@564
   113
#define BREAK_PERM 2
nkeynes@564
   114
nkeynes@564
   115
void sh4_set_breakpoint( uint32_t pc, int type );
nkeynes@564
   116
gboolean sh4_clear_breakpoint( uint32_t pc, int type );
nkeynes@564
   117
int sh4_get_breakpoint( uint32_t pc );
nkeynes@564
   118
nkeynes@564
   119
nkeynes@564
   120
nkeynes@564
   121
nkeynes@564
   122
#ifdef __cplusplus
nkeynes@564
   123
}
nkeynes@564
   124
#endif
nkeynes@564
   125
#endif /* !lxdream_sh4_H */
.