Search
lxdream.org :: lxdream/src/dream.h
lxdream 0.9.1
released Jun 29
Download Now
filename src/dream.h
changeset 35:21a4be098304
prev31:495e480360d7
next119:cef4d880123c
author nkeynes
date Sun Feb 05 04:04:25 2006 +0000 (14 years ago)
permissions -rw-r--r--
last change Install the bios hooks if we're loading a demo
view annotate diff log raw
     1 /**
     2  * $Id: dream.h,v 1.7 2005-12-26 03:54:52 nkeynes Exp $
     3  *
     4  * Miscellaneous application-wide declarations (mainly logging atm)
     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 #ifndef dream_H
    20 #define dream_H 1
    22 #include <stdio.h>
    23 #include <stdlib.h>
    24 #include <stdint.h>
    25 #include <string.h>
    26 #include <glib/gtypes.h>
    28 #ifdef __cplusplus
    29 extern "C" {
    30 #endif
    32 /************************ Modules ********************************/
    33 /**
    34  * Basic module structure defining the common operations across all
    35  * modules, ie start, stop, reset, etc. 
    36  */
    37 typedef struct dreamcast_module {
    38     char *name;
    39     /**
    40      * Perform all initial module setup (ie register / allocate any
    41      * memory required, etc). Only called once during DreamOn startup
    42      */
    43     void (*init)();
    44     /**
    45      * Reset the module into it's initial system boot state. Will be called
    46      * once after init(), as well as whenever the user requests a reset.
    47      */
    48     void (*reset)();
    49     /**
    50      * Set the module into a running state (may be NULL)
    51      */
    52     void (*start)();
    53     /**
    54      * Execute one time-slice worth of operations, for the given number of
    55      * nanoseconds.
    56      * @return Number of nanoseconds actually executed
    57      */
    58     uint32_t (*run_time_slice)( uint32_t nanosecs );
    59     /**
    60      * Set the module into a stopped state (may be NULL)
    61      */
    62     void (*stop)();
    63     /**
    64      * Save the module state to the FILE stream. May be NULL, in which case
    65      * the module is considered to have no state.
    66      */
    67     void (*save)(FILE *);
    68     /**
    69      * Load the saved module state from the FILE stream. May be NULL, in which
    70      * case reset() will be called instead.
    71      * @return 0 on success, nonzero on failure.
    72      */
    73     int (*load)(FILE *);
    74 } *dreamcast_module_t;
    76 void dreamcast_register_module( dreamcast_module_t );
    78 extern struct dreamcast_module mem_module;
    79 extern struct dreamcast_module sh4_module;
    80 extern struct dreamcast_module asic_module;
    81 extern struct dreamcast_module pvr2_module;
    82 extern struct dreamcast_module aica_module;
    83 extern struct dreamcast_module ide_module;
    84 extern struct dreamcast_module maple_module;
    85 extern struct dreamcast_module pvr2_module;
    86 extern struct dreamcast_module gui_module;
    87 extern struct dreamcast_module unknown_module;
    89 /*************************** Logging **************************/
    91 #define EMIT_FATAL 0
    92 #define EMIT_ERR 1
    93 #define EMIT_WARN 2
    94 #define EMIT_INFO 3
    95 #define EMIT_DEBUG 4
    96 #define EMIT_TRACE 5
    98 #ifndef MODULE
    99 #define MODULE unknown_module
   100 #endif
   102 void emit( void *, int level, const char *source, const char *msg, ... );
   104 #define FATAL( ... ) emit( NULL, EMIT_FATAL, MODULE.name, __VA_ARGS__ )
   105 #define ERROR( ... ) emit( NULL, EMIT_ERR, MODULE.name, __VA_ARGS__ )
   106 #define WARN( ... ) emit( NULL, EMIT_WARN, MODULE.name, __VA_ARGS__ )
   107 #define INFO( ... ) emit( NULL, EMIT_INFO, MODULE.name, __VA_ARGS__ )
   108 #define DEBUG( ... ) emit( NULL, EMIT_DEBUG, MODULE.name, __VA_ARGS__ )
   109 #define TRACE( ... ) emit( NULL, EMIT_TRACE, MODULE.name, __VA_ARGS__ )
   111 #define BIOS_PATH "../bios"
   113 void fwrite_string( char *s, FILE *f );
   114 int fread_string( char *s, int maxlen, FILE *f );
   116 #ifdef __cplusplus
   117 }
   118 #endif
   119 #endif
.