nkeynes@30: /**
nkeynes@586:  * $Id$
nkeynes@30:  * 
nkeynes@30:  * Generic CPU definitions, primarily for providing information to the GUI.
nkeynes@30:  *
nkeynes@30:  * Copyright (c) 2005 Nathan Keynes.
nkeynes@30:  *
nkeynes@30:  * This program is free software; you can redistribute it and/or modify
nkeynes@30:  * it under the terms of the GNU General Public License as published by
nkeynes@30:  * the Free Software Foundation; either version 2 of the License, or
nkeynes@30:  * (at your option) any later version.
nkeynes@30:  *
nkeynes@30:  * This program is distributed in the hope that it will be useful,
nkeynes@30:  * but WITHOUT ANY WARRANTY; without even the implied warranty of
nkeynes@30:  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
nkeynes@30:  * GNU General Public License for more details.
nkeynes@30:  */
nkeynes@9: 
nkeynes@736: #ifndef lxdream_cpu_H
nkeynes@736: #define lxdream_cpu_H 1
nkeynes@9: 
nkeynes@586: #include "lxdream.h"
nkeynes@586: #include "mem.h"
nkeynes@9: 
nkeynes@9: #ifdef __cplusplus
nkeynes@9: extern "C" {
nkeynes@9: #endif
nkeynes@9: 
nkeynes@9: /**
nkeynes@9:  * Disassembly function pointer typedef.
nkeynes@9:  *
nkeynes@9:  * @param pc Address to disassemble
nkeynes@9:  * @param buffer String buffer to write disassembly into
nkeynes@9:  * @param buflen Maximum length of buffer
nkeynes@9:  * @return next address to disassemble
nkeynes@9:  */
nkeynes@11: typedef uint32_t (*disasm_func_t)(uint32_t pc, char *buffer, int buflen, char *opcode );
nkeynes@11: 
nkeynes@9: #define REG_INT 0
nkeynes@998: #define REG_FLOAT 1
nkeynes@998: #define REG_DOUBLE 2
nkeynes@998: #define REG_NONE 3 /* Used for empty/separator field */
nkeynes@9: 
nkeynes@9: /**
nkeynes@9:  * Structure that defines a single register in a CPU for display purposes.
nkeynes@9:  */
nkeynes@9: typedef struct reg_desc_struct {
nkeynes@9:     char *name;
nkeynes@9:     int type;
nkeynes@9:     void *value;
nkeynes@9: } reg_desc_t;
nkeynes@9: 
nkeynes@30: /**
nkeynes@998:  * CPU definition structure - basic information and support functions. Most
nkeynes@998:  * of this is for debugger use.
nkeynes@30:  */
nkeynes@9: typedef struct cpu_desc_struct {
nkeynes@43:     char *name; /* CPU Name */
nkeynes@998:     /**
nkeynes@998:      * Single instruction disassembly 
nkeynes@998:      **/
nkeynes@998:     disasm_func_t disasm_func;
nkeynes@998:     
nkeynes@998:     /**
nkeynes@998:      * Return a pointer to a register (indexed per the reg_desc table)
nkeynes@998:      */
nkeynes@998:     void * (*get_register)( int reg );
nkeynes@998:     gboolean (*is_valid_page_func)(uint32_t); /* Test for valid memory page */
nkeynes@998:     /* Access to memory addressed by the CPU - physical and virtual versions.
nkeynes@998:      * Virtual access should account for the current CPU mode, privilege level,
nkeynes@998:      * etc.
nkeynes@998:      * All functions return the number of bytes copied, which may be 0 if the
nkeynes@998:      * address is unmapped.
nkeynes@998:      */
nkeynes@998:     size_t (*read_mem_phys)(unsigned char *buf, uint32_t addr, size_t length);
nkeynes@998:     size_t (*write_mem_phys)(uint32_t addr, unsigned char *buf, size_t length);
nkeynes@998:     size_t (*read_mem_vma)(unsigned char *buf, uint32_t addr, size_t length);
nkeynes@998:     size_t (*write_mem_vma)(uint32_t addr, unsigned char *buf, size_t length);
nkeynes@43:     gboolean (*step_func)(); /* Single step function */
nkeynes@586:     void (*set_breakpoint)(uint32_t, breakpoint_type_t);
nkeynes@586:     gboolean (*clear_breakpoint)(uint32_t, breakpoint_type_t);
nkeynes@43:     int (*get_breakpoint)(uint32_t);
nkeynes@43:     size_t instr_size; /* Size of instruction */
nkeynes@43:     char *regs; /* Pointer to start of registers */
nkeynes@43:     size_t regs_size; /* Size of register structure in bytes */
nkeynes@43:     const struct reg_desc_struct *regs_info; /* Description of all registers */
nkeynes@998:     unsigned int num_gpr_regs; /* Number of general purpose registers */
nkeynes@998:     unsigned int num_gdb_regs; /* Total number of registers visible to gdb */
nkeynes@43:     uint32_t *pc; /* Pointer to PC register */
nkeynes@429: } const *cpu_desc_t;
nkeynes@9: 
nkeynes@9: #ifdef __cplusplus
nkeynes@9: }
nkeynes@9: #endif
nkeynes@9: 
nkeynes@998: gboolean gdb_init_server( const char *interface, int port, cpu_desc_t cpu, gboolean mmu );
nkeynes@998: 
nkeynes@736: #endif /* !lxdream_cpu_H */