3b1emu: src/state.h@320dc6206f52 (annotated)

src/state.h@320dc6206f52 (annotated)

Mon, 29 Nov 2010 00:20:40 +0000

split state handling into state.[ch]

 #ifndef _STATE_H
 #define _STATE_H
 #include <stddef.h>
 #include <stdint.h>
 #include <stdbool.h>
 // Maximum size of the Boot PROMs. Must be a binary power of two.
 #define ROM_SIZE 32768
 /**
  * @brief Emulator state storage
  *
  * This structure stores the internal state of the emulator.
  */
 typedef struct {
 	// Boot PROM can be up to 32Kbytes total size
 	uint8_t		rom[ROM_SIZE];		///< Boot PROM data buffer
 	// Main system RAM
 	uint8_t		*ram;				///< RAM data buffer
 	size_t		ram_size;			///< Size of RAM buffer in bytes
 	// GENERAL CONTROL REGISTER
 	/// GENCON.ROMLMAP -- false ORs the address with 0x800000, forcing the
 	/// 68010 to access ROM instead of RAM when booting. TRM page 2-36.
 	bool		romlmap;
 } S_state;
 // Global emulator state. Yes, I know global variables are evil, please don't
 // email me and lecture me about it.  -philpem
 #ifndef _STATE_C
 extern S_state state;
 #else
 S_state state;
 #endif
 /**
  * @brief	Initialise system state
  *
  * @param	ramsize		RAM size in bytes -- must be a multiple of 512KiB, min 512KiB, max 4MiB.
  *
  * Initialises the emulator's internal state.
  */
 int state_init(size_t ramsize);
 /**
  * @brief Deinitialise system state
  *
  * Deinitialises the saved state, and frees all memory. Call this function
  * before exiting your program to avoid memory leaks.
  */
 void state_done();
 #endif