summaryrefslogtreecommitdiff
path: root/pfinet/linux-src/include/linux/mca.h
diff options
context:
space:
mode:
Diffstat (limited to 'pfinet/linux-src/include/linux/mca.h')
-rw-r--r--pfinet/linux-src/include/linux/mca.h100
1 files changed, 100 insertions, 0 deletions
diff --git a/pfinet/linux-src/include/linux/mca.h b/pfinet/linux-src/include/linux/mca.h
new file mode 100644
index 00000000..5b6a6ebf
--- /dev/null
+++ b/pfinet/linux-src/include/linux/mca.h
@@ -0,0 +1,100 @@
+/*
+ * Header for Microchannel Architecture Bus
+ * Written by Martin Kolinek, February 1996
+*/
+
+#ifndef _LINUX_MCA_H
+#define _LINUX_MCA_H
+
+/* The detection of MCA bus is done in the real mode (using BIOS).
+ * The information is exported to the protected code, where this
+ * variable is set to one in case MCA bus was detected.
+*/
+extern int MCA_bus;
+
+/* maximal number of MCA slots - actually, some machines have less, but
+they all have sufficient number of POS registers to cover 8. */
+#define MCA_MAX_SLOT_NR 8
+
+/* MCA_NOTFOUND is an error condition. The other two indicate
+ motherboard POS registers contain the adapter. They might be
+ returned by the mca_find_adapter() function, and can be used as
+ arguments to mca_read_stored_pos(). I'm not going to allow direct
+ access to the motherboard registers until we run across an adapter
+ that requires it. We don't know enough about them to know if it's
+ safe.
+
+ See Documentation/mca.txt or one of the existing drivers for
+ more information.
+*/
+#define MCA_NOTFOUND (-1)
+#define MCA_INTEGSCSI (MCA_MAX_SLOT_NR)
+#define MCA_INTEGVIDEO (MCA_MAX_SLOT_NR+1)
+
+/* max number of adapters, including both slots and various integrated
+things. */
+#define MCA_NUMADAPTERS (MCA_MAX_SLOT_NR+2)
+
+/* returns the slot of the first enabled adapter matching id. User can
+specify a starting slot beyond zero, to deal with detecting multiple
+devices. Returns MCA_NOTFOUND if id not found. Also checks the
+integrated adapters. */
+extern int mca_find_adapter(int id, int start);
+extern int mca_find_unused_adapter(int id, int start);
+
+/* adapter state info - returns 0 if no */
+extern int mca_isadapter(int slot);
+extern int mca_isenabled(int slot);
+
+extern int mca_is_adapter_used(int slot);
+extern int mca_mark_as_used(int slot);
+extern void mca_mark_as_unused(int slot);
+
+/* gets a byte out of POS register (stored in memory) */
+extern unsigned char mca_read_stored_pos(int slot, int reg);
+
+/*
+ This can be expanded later. Right now, it gives us a way of
+ getting meaningful information into the MCA_info structure,
+ so we can have a more interesting /proc/mca.
+*/
+extern void mca_set_adapter_name(int slot, char* name);
+extern char* mca_get_adapter_name(int slot);
+
+/*
+ This sets up an information callback for /proc/mca/slot?. The
+ function is called with the buffer, slot, and device pointer (or
+ some equally informative context information, or nothing, if you
+ prefer), and is expected to put useful information into the
+ buffer. The adapter name, id, and POS registers get printed
+ before this is called though, so don't do it again.
+
+ This should be called with a NULL procfn when a module
+ unregisters, thus preventing kernel crashes and other such
+ nastiness.
+*/
+typedef int (*MCA_ProcFn)(char* buf, int slot, void* dev);
+extern void mca_set_adapter_procfn(int slot, MCA_ProcFn, void* dev);
+
+/* These routines actually mess with the hardware POS registers. They
+temporarily disable the device (and interrupts), so make sure you know
+what you're doing if you use them. Furthermore, writing to a POS may
+result in two devices trying to share a resource, which in turn can
+result in multiple devices sharing memory spaces, IRQs, or even trashing
+hardware. YOU HAVE BEEN WARNED.
+
+You can only access slots with this. Motherboard registers are off
+limits.
+*/
+
+/* read a byte from the specified POS register. */
+extern unsigned char mca_read_pos(int slot, int reg);
+
+/* write a byte to the specified POS register. */
+extern void mca_write_pos(int slot, int reg, unsigned char byte);
+
+/* Should only be called by the NMI interrupt handler, this will do some
+fancy stuff to figure out what might have generated a NMI. */
+extern void mca_handle_nmi(void);
+
+#endif /* _LINUX_MCA_H */