sim/common/dv-core.c

   1 /* The common simulator framework for GDB, the GNU Debugger.
   2
   3    Copyright 2002-2023 Free Software Foundation, Inc.
   4
   5    Contributed by Andrew Cagney and Red Hat.
   6
   7    This file is part of GDB.
   8
   9    This program is free software; you can redistribute it and/or modify
  10    it under the terms of the GNU General Public License as published by
  11    the Free Software Foundation; either version 3 of the License, or
  12    (at your option) any later version.
  13
  14    This program is distributed in the hope that it will be useful,
  15    but WITHOUT ANY WARRANTY; without even the implied warranty of
  16    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  17    GNU General Public License for more details.
  18
  19    You should have received a copy of the GNU General Public License
  20    along with this program.  If not, see <http://www.gnu.org/licenses/>.  */
  21
  22 /* This must come before any other includes.  */
  23 #include "defs.h"
  24
  25 #include "sim-main.h"
  26 #include "hw-main.h"
  27
  28 /* DEVICE
  29
  30    core - root of the device tree
  31
  32    DESCRIPTION
  33
  34    The core device, positioned at the root of the device tree appears
  35    to its child devices as a normal device just like every other
  36    device in the tree.
  37
  38    Internally it is implemented using a core object.  Requests to
  39    attach (or detach) address spaces are passed to that core object.
  40    Requests to transfer (DMA) data are reflected back down the device
  41    tree using the core_map data transfer methods.
  42
  43    PROPERTIES
  44
  45    None.
  46
  47    */
  48
  49
  50 static void
  51 dv_core_attach_address_callback (struct hw *me,
  52                                  int level,
  53                                  int space,
  54                                  address_word addr,
  55                                  address_word nr_bytes,
  56                                  struct hw *client)
  57 {
  58   HW_TRACE ((me, "attach - level=%d, space=%d, addr=0x%lx, nr_bytes=%ld, client=%s",
  59              level, space, (unsigned long) addr, (unsigned long) nr_bytes, hw_path (client)));
  60   /* NOTE: At preset the space is assumed to be zero.  Perhaphs the
  61      space should be mapped onto something for instance: space0 -
  62      unified memory; space1 - IO memory; ... */
  63   sim_core_attach (hw_system (me),
  64                    NULL, /*cpu*/
  65                    level,
  66                    access_read_write_exec,
  67                    space, addr,
  68                    nr_bytes,
  69                    0, /* modulo */
  70                    client,
  71                    NULL);
  72 }
  73
  74
  75 static void
  76 dv_core_detach_address_callback (struct hw *me,
  77                                  int level,
  78                                  int space,
  79                                  address_word addr,
  80                                  address_word nr_bytes,
  81                                  struct hw *client)
  82 {
  83   HW_TRACE ((me, "detach - level=%d, space=%d, addr=0x%lx, nr_bytes=%ld, client=%s",
  84              level, space, (unsigned long) addr, (unsigned long) nr_bytes, hw_path (client)));
  85   /* NOTE: At preset the space is assumed to be zero.  Perhaphs the
  86      space should be mapped onto something for instance: space0 -
  87      unified memory; space1 - IO memory; ... */
  88   sim_core_detach (hw_system (me), NULL, /*cpu*/ level, space, addr);
  89 }
  90
  91
  92 static unsigned
  93 dv_core_dma_read_buffer_callback (struct hw *me,
  94                                   void *dest,
  95                                   int space,
  96                                   unsigned_word addr,
  97                                   unsigned nr_bytes)
  98 {
  99   return sim_core_read_buffer (hw_system (me),
 100                                NULL, /*CPU*/
 101                                space, /*???*/
 102                                dest,
 103                                addr,
 104                                nr_bytes);
 105 }
 106
 107
 108 static unsigned
 109 dv_core_dma_write_buffer_callback (struct hw *me,
 110                                    const void *source,
 111                                    int space,
 112                                    unsigned_word addr,
 113                                    unsigned nr_bytes,
 114                                    int violate_read_only_section)
 115 {
 116   return sim_core_write_buffer (hw_system (me),
 117                                 NULL, /*cpu*/
 118                                 space, /*???*/
 119                                 source,
 120                                 addr,
 121                                 nr_bytes);
 122 }
 123
 124
 125 static void
 126 dv_core_finish (struct hw *me)
 127 {
 128   set_hw_attach_address (me, dv_core_attach_address_callback);
 129   set_hw_detach_address (me, dv_core_detach_address_callback);
 130   set_hw_dma_write_buffer (me, dv_core_dma_write_buffer_callback);
 131   set_hw_dma_read_buffer (me, dv_core_dma_read_buffer_callback);
 132 }
 133
 134 const struct hw_descriptor dv_core_descriptor[] = {
 135   { "core", dv_core_finish, },
 136   { NULL, NULL },
 137 };