1 /* -*- mode: c; c-basic-offset: 8 -*- */ 2 3 /* This is the function prototypes for the old legacy MCA interface 4 * 5 * Please move your driver to the new sysfs based one instead */ 6 7 #ifndef _LINUX_MCA_LEGACY_H 8 #define _LINUX_MCA_LEGACY_H 9 10 #include <linux/mca.h> 11 12 #warning "MCA legacy - please move your driver to the new sysfs api" 13 14 /* MCA_NOTFOUND is an error condition. The other two indicate 15 * motherboard POS registers contain the adapter. They might be 16 * returned by the mca_find_adapter() function, and can be used as 17 * arguments to mca_read_stored_pos(). I'm not going to allow direct 18 * access to the motherboard registers until we run across an adapter 19 * that requires it. We don't know enough about them to know if it's 20 * safe. 21 * 22 * See Documentation/mca.txt or one of the existing drivers for 23 * more information. 24 */ 25 #define MCA_NOTFOUND (-1) 26 27 28 29 /* Returns the slot of the first enabled adapter matching id. User can 30 * specify a starting slot beyond zero, to deal with detecting multiple 31 * devices. Returns MCA_NOTFOUND if id not found. Also checks the 32 * integrated adapters. 33 */ 34 extern int mca_find_adapter(int id, int start); 35 extern int mca_find_unused_adapter(int id, int start); 36 37 extern int mca_mark_as_used(int slot); 38 extern void mca_mark_as_unused(int slot); 39 40 /* gets a byte out of POS register (stored in memory) */ 41 extern unsigned char mca_read_stored_pos(int slot, int reg); 42 43 /* This can be expanded later. Right now, it gives us a way of 44 * getting meaningful information into the MCA_info structure, 45 * so we can have a more interesting /proc/mca. 46 */ 47 extern void mca_set_adapter_name(int slot, char* name); 48 49 /* These routines actually mess with the hardware POS registers. They 50 * temporarily disable the device (and interrupts), so make sure you know 51 * what you're doing if you use them. Furthermore, writing to a POS may 52 * result in two devices trying to share a resource, which in turn can 53 * result in multiple devices sharing memory spaces, IRQs, or even trashing 54 * hardware. YOU HAVE BEEN WARNED. 55 * 56 * You can only access slots with this. Motherboard registers are off 57 * limits. 58 */ 59 60 /* read a byte from the specified POS register. */ 61 extern unsigned char mca_read_pos(int slot, int reg); 62 63 /* write a byte to the specified POS register. */ 64 extern void mca_write_pos(int slot, int reg, unsigned char byte); 65 66 #endif 67