Subversion Repositories openrisc_2011-10-31

/*  This file is part of the program psim.
 
    Copyright (C) 1994-1996, Andrew Cagney <cagney@highland.com.au>
 
    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 2 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, write to the Free Software
    Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
 
    */
 
 
#ifndef _DEVICE_TABLE_H_
#define _DEVICE_TABLE_H_
 
#include "basics.h"
#include "device.h"
#include "tree.h"
 
#ifdef HAVE_STRING_H
#include <string.h>
#else
#ifdef HAVE_STRINGS_H
#include <strings.h>
#endif
#endif
 
 
typedef struct _device_callbacks device_callbacks;
 
 
/* The creator, returns a pointer to any data that should be allocated
   once during (multiple) simulation runs */
 
typedef void *(device_creator)
     (const char *name,
      const device_unit *unit_address,
      const char *args);
 
 
/* two stages of initialization */
 
typedef void (device_init_callback)
     (device *me);
 
typedef struct _device_init_callbacks {
  device_init_callback *address; /* NULL - ignore */
  device_init_callback *data; /* NULL - ignore */
} device_init_callbacks;
 
 
/* attaching/detaching a devices address space to its parent */
 
typedef void (device_address_callback)
     (device *me,
      attach_type attach,
      int space,
      unsigned_word addr,
      unsigned nr_bytes,
      access_type access,
      device *client); /*callback/default*/
 
typedef struct _device_address_callbacks {
  device_address_callback *attach;
  device_address_callback *detach;
} device_address_callbacks;
 
 
/* I/O operations - from parent */
 
typedef unsigned (device_io_read_buffer_callback)
     (device *me,
      void *dest,
      int space,
      unsigned_word addr,
      unsigned nr_bytes,
      cpu *processor,
      unsigned_word cia);
 
typedef unsigned (device_io_write_buffer_callback)
     (device *me,
      const void *source,
      int space,
      unsigned_word addr,
      unsigned nr_bytes,
      cpu *processor,
      unsigned_word cia);
 
typedef struct _device_io_callbacks { /* NULL - error */
  device_io_read_buffer_callback *read_buffer;
  device_io_write_buffer_callback *write_buffer;
} device_io_callbacks;
 
 
/* DMA transfers by a device via its parent */
 
typedef unsigned (device_dma_read_buffer_callback)
     (device *me,
      void *dest,
      int space,
      unsigned_word addr,
      unsigned nr_bytes);
 
typedef unsigned (device_dma_write_buffer_callback)
     (device *me,
      const void *source,
      int space,
      unsigned_word addr,
      unsigned nr_bytes,
      int violate_read_only_section);
 
typedef struct _device_dma_callbacks { /* NULL - error */
  device_dma_read_buffer_callback *read_buffer;
  device_dma_write_buffer_callback *write_buffer;
} device_dma_callbacks;
 
 
/* Interrupts */
 
typedef void (device_interrupt_event_callback)
     (device *me,
      int my_port,
      device *source,
      int source_port,
      int level,
      cpu *processor,
      unsigned_word cia);
 
typedef void (device_child_interrupt_event_callback)
     (device *me,
      device *parent,
      device *source,
      int source_port,
      int level,
      cpu *processor,
      unsigned_word cia);
 
typedef struct _device_interrupt_port_descriptor {
  const char *name;
  int number; 
  int nr_ports;
  port_direction direction;
} device_interrupt_port_descriptor;
 
typedef struct _device_interrupt_callbacks {
  device_interrupt_event_callback *event;
  device_child_interrupt_event_callback *child_event;
  const device_interrupt_port_descriptor *ports;
} device_interrupt_callbacks;
 
 
/* symbolic value decoding */
 
typedef int (device_unit_decode_callback)
     (device *bus,
      const char *unit,
      device_unit *address);
 
typedef int (device_unit_encode_callback)
     (device *bus,
      const device_unit *unit_address,
      char *buf,
      int sizeof_buf);
 
typedef int (device_address_to_attach_address_callback)
     (device *bus,
      const device_unit *address,
      int *attach_space,
      unsigned_word *attach_address,
      device *client);
 
typedef int (device_size_to_attach_size_callback)
     (device *bus,
      const device_unit *size,
      unsigned *nr_bytes,
      device *client);
 
typedef struct _device_convert_callbacks {
  device_unit_decode_callback *decode_unit;
  device_unit_encode_callback *encode_unit;
  device_address_to_attach_address_callback *address_to_attach_address;
  device_size_to_attach_size_callback *size_to_attach_size;
} device_convert_callbacks;
 
 
/* instances */
 
typedef void (device_instance_delete_callback)
     (device_instance *instance);
 
typedef int (device_instance_read_callback)
     (device_instance *instance,
      void *buf,
      unsigned_word len);
 
typedef int (device_instance_write_callback)
     (device_instance *instance,
      const void *buf,
      unsigned_word len);
 
typedef int (device_instance_seek_callback)
     (device_instance *instance,
      unsigned_word pos_hi,
      unsigned_word pos_lo);
 
typedef int (device_instance_method)
     (device_instance *instance,
      int n_stack_args,
      unsigned_cell stack_args[/*n_stack_args*/],
      int n_stack_returns,
      unsigned_cell stack_returns[/*n_stack_returns*/]);
 
typedef struct _device_instance_methods {
  const char *name;
  device_instance_method *method;
} device_instance_methods;
 
struct _device_instance_callbacks { /* NULL - error */
  device_instance_delete_callback *delete;
  device_instance_read_callback *read;
  device_instance_write_callback *write;
  device_instance_seek_callback *seek;
  const device_instance_methods *methods;
};
 
typedef device_instance *(device_create_instance_callback)
     (device *me,
      const char *full_path,
      const char *args);
 
typedef device_instance *(package_create_instance_callback)
     (device_instance *parent,
      const char *args);
 
 
/* all else fails */
 
typedef int (device_ioctl_callback)
     (device *me,
      cpu *processor,
      unsigned_word cia,
      device_ioctl_request request,
      va_list ap);
 
typedef void (device_usage_callback)
     (int verbose);
 
 
/* the callbacks */
 
struct _device_callbacks {
 
  /* initialization */
  device_init_callbacks init;
 
  /* address/data config - from child */
  device_address_callbacks address;
 
  /* address/data transfer - from parent */
  device_io_callbacks io;
 
  /* address/data transfer - from child */
  device_dma_callbacks dma;
 
  /* interrupt signalling */
  device_interrupt_callbacks interrupt;
 
  /* bus address decoding */
  device_convert_callbacks convert;
 
  /* instances */
  device_create_instance_callback *instance_create;
 
  /* back door to anything we've forgot */
  device_ioctl_callback *ioctl;
  device_usage_callback *usage;
};
 
 
/* Table of all the devices and a function to lookup/create a device
   from its name */
 
typedef struct _device_descriptor device_descriptor;
struct _device_descriptor {
  const char *name;
  device_creator *creator;
  const device_callbacks *callbacks;
};
 
extern const device_descriptor *const device_table[];
#include "hw.h"
 
 
/* Pass through, ignore and generic callback functions.  A call going
   towards the root device are passed on up, local calls are ignored
   and call downs abort */
 
extern device_address_callback passthrough_device_address_attach;
extern device_address_callback passthrough_device_address_detach;
extern device_dma_read_buffer_callback passthrough_device_dma_read_buffer;
extern device_dma_write_buffer_callback passthrough_device_dma_write_buffer;
 
extern device_unit_decode_callback ignore_device_unit_decode;
 
extern device_init_callback generic_device_init_address;
extern device_unit_decode_callback generic_device_unit_decode;
extern device_unit_encode_callback generic_device_unit_encode;
extern device_address_to_attach_address_callback generic_device_address_to_attach_address;
extern device_size_to_attach_size_callback generic_device_size_to_attach_size;
 
 
extern const device_callbacks passthrough_device_callbacks;
 
#endif /* _DEVICE_TABLE_H_ */