Subversion Repositories openrisc_2011-10-31

/* abstract.h -- Abstract entities header file

   Copyright (C) 1999 Damjan Lampret, lampret@opencores.org

   Copyright (C) 2008 Embecosm Limited

   Contributor Jeremy Bennett <jeremy.bennett@embecosm.com>

   This file is part of OpenRISC 1000 Architectural Simulator.

   This program is free software; you can redistribute it and/or modify it

   under the terms of the GNU General Public License as published by the Free

   Software Foundation; either version 3 of the License, or (at your option)

   any later version.

   This program is distributed in the hope that it will be useful, but WITHOUT

   ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or

   FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for

   more details.

   You should have received a copy of the GNU General Public License along

   with this program.  If not, see <http://www.gnu.org/licenses/>. */

/* This program is commented throughout in a fashion suitable for processing

   with Doxygen. */

#ifndef ABSTRACT__H

#define ABSTRACT__H

/* Autoconf and/or portability configuration */

#include "port.h"

/* System includes */

#include <stdio.h>

/* Package includes */

#include "arch.h"

#define DEFAULT_MEMORY_START         0

#define DEFAULT_MEMORY_LEN    0x800000

#define STACK_SIZE                  20

#define LABELNAME_LEN               50

#define INSNAME_LEN                 15

#define OPERANDNAME_LEN             50

#define MAX_OPERANDS                 5

#define OP_MEM_ACCESS       0x80000000

/* Cache tag types.  */

#define CT_NONE                      0

#define CT_VIRTUAL                   1

#define CT_PHYSICAL                  2

/* History of execution */

#define HISTEXEC_LEN               200

/* Added by MM */

#ifndef LONGEST

#define LONGEST long long

#endif /* LONGEST */

#ifndef ULONGEST

#define ULONGEST unsigned long long

#endif /* ULONGEST */

/* Endianness convenience macros */

#define LE16(x) bswap_16(x)

/*! Instruction queue */

struct iqueue_entry

{

  int       insn_index;

  uint32_t  insn;

  oraddr_t  insn_addr;

};

/*! All the memory operations possible */

struct mem_ops

{

  /* Read functions */

  uint32_t    (*readfunc32) (oraddr_t, void *);

  uint16_t    (*readfunc16) (oraddr_t, void *);

  uint8_t     (*readfunc8) (oraddr_t, void *);

  /* Read functions' data */

  void       *read_dat8;

  void       *read_dat16;

  void       *read_dat32;

  /* Write functions */

  void        (*writefunc32) (oraddr_t, uint32_t, void *);

  void        (*writefunc16) (oraddr_t, uint16_t, void *);

  void        (*writefunc8) (oraddr_t, uint8_t, void *);

  /* Write functions' data */

  void       *write_dat8;

  void       *write_dat16;

  void       *write_dat32;

  /* Program load function.  If you have unwritteable memory but you would like

   * it if a program would be loaded here, make sure to set this.  If this is

   * not set, then writefunc8 will be called to load the program */

  void        (*writeprog32) (oraddr_t, uint32_t, void *);

  void        (*writeprog8) (oraddr_t, uint8_t, void *);

  /* Program load functions' data */

  void       *writeprog32_dat;

  void       *writeprog8_dat;

  /* Read/Write delays */

  int         delayr;

  int         delayw;

  /* Name of log file */

  const char *log;

};

/*! Memory regions assigned to devices */

struct dev_memarea

{

  struct dev_memarea *next;

  oraddr_t            addr_mask;

  oraddr_t            addr_compare;

  uint32_t            size;

  oraddr_t            size_mask;        /* Addr mask, calculated out of size */

  int                 valid;            /* Mirrors memory controler valid bit */

  FILE               *log;              /* log file (NULL if no logging) */

  struct mem_ops      ops;

  struct mem_ops      direct_ops;

};

/* Externally visible data */

extern struct dev_memarea *cur_area;

extern int                 data_ci;

extern int                 insn_ci;

extern struct hist_exec   *hist_exec_tail;

/* Function prototypes for external use */

extern uint32_t            eval_mem32 (oraddr_t memaddr, int *);

extern uint16_t            eval_mem16 (oraddr_t memaddr, int *);

extern uint8_t             eval_mem8 (oraddr_t memaddr, int *);

extern void                set_mem32 (oraddr_t memaddr, uint32_t value, int *);

extern void                set_mem16 (oraddr_t memaddr, uint16_t value, int *);

extern void                set_mem8 (oraddr_t memaddr, uint8_t value, int *);

extern void                dump_memory (oraddr_t  from,

                                        oraddr_t  to);

extern void                disassemble_memory (oraddr_t  from,

                                               oraddr_t  to,

                                               int       nl);

extern uint32_t            evalsim_mem32 (oraddr_t, oraddr_t);

extern uint16_t            evalsim_mem16 (oraddr_t, oraddr_t);

extern uint8_t             evalsim_mem8 (oraddr_t, oraddr_t);

extern void                setsim_mem32 (oraddr_t, oraddr_t, uint32_t);

extern void                setsim_mem16 (oraddr_t, oraddr_t, uint16_t);

extern void                setsim_mem8 (oraddr_t, oraddr_t, uint8_t);

extern void                done_memory_table ();

extern void                memory_table_status (void);

extern struct dev_memarea *reg_mem_area (oraddr_t        addr,

                                         uint32_t        size,

                                         unsigned        mc_dev,

                                         struct mem_ops *ops);

extern void                adjust_rw_delay (struct dev_memarea *mem,

                                            int                 delayr,

                                            int                 delayw);

extern void                set_mem_valid (struct dev_memarea *mem,

                                          int                 valid);

extern struct dev_memarea *verify_memoryarea (oraddr_t addr);

extern char               *generate_time_pretty (char *dest,

                                                 long  time_ps);

extern uint32_t            eval_insn (oraddr_t, int *);

extern uint32_t            eval_direct32 (oraddr_t  addr,

                                          int       through_mmu,

                                          int       through_dc);

extern uint16_t            eval_direct16 (oraddr_t  memaddr,

                                          int       through_mmu,

                                          int       through_dc);

extern uint8_t             eval_direct8 (oraddr_t   memaddr,

                                         int        through_mmu,

                                         int        through_dc);

extern void                set_direct8 (oraddr_t, uint8_t, int, int);

extern void                set_direct16 (oraddr_t, uint16_t, int, int);

extern void                set_direct32 (oraddr_t, uint32_t, int, int);

extern void                set_program32 (oraddr_t  memaddr,

                                          uint32_t  value);

extern void                set_program8 (oraddr_t  memaddr,

                                         uint8_t   value);

#endif /*  ABSTRACT__H */