1 /* Device definitions. 2 Copyright (C) 1998-2024 Free Software Foundation, Inc. 3 Contributed by Cygnus Support. 4 5 This file is part of GDB, the GNU debugger. 6 7 This program is free software; you can redistribute it and/or modify 8 it under the terms of the GNU General Public License as published by 9 the Free Software Foundation; either version 3 of the License, or 10 (at your option) any later version. 11 12 This program is distributed in the hope that it will be useful, 13 but WITHOUT ANY WARRANTY; without even the implied warranty of 14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 15 GNU General Public License for more details. 16 17 You should have received a copy of the GNU General Public License 18 along with this program. If not, see <http://www.gnu.org/licenses/>. */ 19 20 #ifndef SIM_HW_H 21 #define SIM_HW_H 22 23 #include <stdarg.h> 24 25 #include "ansidecl.h" 26 27 /* Parse a hardware definition */ 28 29 struct hw *sim_hw_parse 30 (struct sim_state *sd, 31 const char *fmt, 32 ...) ATTRIBUTE_PRINTF (2, 3); 33 34 35 /* Print the hardware tree */ 36 37 void sim_hw_print 38 (struct sim_state *sd, 39 void (*print) (struct sim_state *, const char *, va_list ap)); 40 41 42 /* Abort the simulation specifying HW as the reason */ 43 44 void sim_hw_abort 45 (SIM_DESC sd, 46 struct hw *hw, 47 const char *fmt, 48 ...) ATTRIBUTE_PRINTF (3, 4) ATTRIBUTE_NORETURN; 49 50 51 52 /* CPU: The simulation is running and the current CPU/CIA 53 initiates a data transfer. */ 54 55 void sim_cpu_hw_io_read_buffer 56 (sim_cpu *cpu, 57 sim_cia cia, 58 struct hw *hw, 59 void *dest, 60 int space, 61 unsigned_word addr, 62 unsigned nr_bytes); 63 64 void sim_cpu_hw_io_write_buffer 65 (sim_cpu *cpu, 66 sim_cia cia, 67 struct hw *hw, 68 const void *source, 69 int space, 70 unsigned_word addr, 71 unsigned nr_bytes); 72 73 74 75 /* SYSTEM: A data transfer is being initiated by the system. */ 76 77 unsigned sim_hw_io_read_buffer 78 (struct sim_state *sd, 79 struct hw *hw, 80 void *dest, 81 int space, 82 unsigned_word addr, 83 unsigned nr_bytes); 84 85 unsigned sim_hw_io_write_buffer 86 (struct sim_state *sd, 87 struct hw *hw, 88 const void *source, 89 int space, 90 unsigned_word addr, 91 unsigned nr_bytes); 92 93 94 #endif 95