patch-2.1.15 linux/include/linux/mca.h

• Lines: 92
• Date: Thu Dec 12 16:54:20 1996
• Orig file: v2.1.14/linux/include/linux/mca.h
• Orig date: Thu Jan 1 02:00:00 1970

diff -u --recursive --new-file v2.1.14/linux/include/linux/mca.h linux/include/linux/mca.h
@@ -0,0 +1,91 @@
+/*
+ * 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 );
+
+/* adapter state info - returns 0 if no */
+extern int mca_isadapter( int slot );
+extern int mca_isenabled( 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 );
+
+#endif /* _LINUX_MCA_H */