aboutsummaryrefslogtreecommitdiff
path: root/sim/common/hw-ports.h
diff options
context:
space:
mode:
Diffstat (limited to 'sim/common/hw-ports.h')
-rw-r--r--sim/common/hw-ports.h129
1 files changed, 129 insertions, 0 deletions
diff --git a/sim/common/hw-ports.h b/sim/common/hw-ports.h
new file mode 100644
index 0000000..566895a
--- /dev/null
+++ b/sim/common/hw-ports.h
@@ -0,0 +1,129 @@
+/* Hardware ports.
+ Copyright (C) 1998 Free Software Foundation, Inc.
+ Contributed by Andrew Cagney and Cygnus Solutions.
+
+This file is part of GDB, the GNU debugger.
+
+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, 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 HW_PORTS_H
+#define HW_PORTS_H
+
+/* Initialize a port */
+
+struct hw_port_descriptor {
+ const char *name;
+ int number;
+ int nr_ports;
+ port_direction direction;
+};
+
+void set_hw_ports (struct hw *hw, const struct hw_port_descriptor ports[]);
+
+typedef void (hw_port_event_method)
+ (struct hw *me,
+ int my_port,
+ struct hw *source,
+ int source_port,
+ int level);
+
+void set_hw_port_event (struct hw *hw, hw_port_event_method *to_port_event);
+
+
+/* Port source
+
+ A device drives its output ports using the call
+
+ */
+
+void hw_port_event
+(struct hw *me,
+ int my_port,
+ int value);
+
+/* This port event will then be propogated to any attached
+ destination ports.
+
+ Any interpretation of PORT and VALUE is model dependant. As a
+ guideline the following are recommended: PCI interrupts A-D should
+ correspond to ports 0-3; level sensative interrupts be requested
+ with a value of one and withdrawn with a value of 0; edge sensative
+ interrupts always have a value of 1, the event its self is treated
+ as the interrupt.
+
+
+ Port destinations
+
+ Attached to each port of a device can be zero or more
+ desitinations. These destinations consist of a device/port pair.
+ A destination is attached/detached to a device line using the
+ attach and detach calls. */
+
+void hw_port_attach
+(struct hw *me,
+ int my_port,
+ struct hw *dest,
+ int dest_port,
+ object_disposition disposition);
+
+void hw_port_detach
+(struct hw *me,
+ int my_port,
+ struct hw *dest,
+ int dest_port);
+
+
+/* Iterate over the list of ports attached to a device */
+
+typedef void (hw_port_traverse_function)
+ (struct hw *me,
+ int my_port,
+ struct hw *dest,
+ int dest_port,
+ void *data);
+
+void hw_port_traverse
+(struct hw *me,
+ hw_port_traverse_function *handler,
+ void *data);
+
+
+/* DESTINATION is attached (detached) to LINE of the device ME
+
+
+ Port conversion
+
+ Users refer to port numbers symbolically. For instance a device
+ may refer to its `INT' signal which is internally represented by
+ port 3.
+
+ To convert to/from the symbolic and internal representation of a
+ port name/number. The following functions are available. */
+
+int hw_port_decode
+(struct hw *me,
+ const char *symbolic_name,
+ port_direction direction);
+
+int hw_port_encode
+(struct hw *me,
+ int port_number,
+ char *buf,
+ int sizeof_buf,
+ port_direction direction);
+
+
+#endif