freebsd-dev/sys/pccard/driver.h

/*-
 * pccard driver interface.
 * Bruce Evans, November 1995.
 * This file is in the public domain.
 */

#ifndef _PCCARD_DRIVER_H_
#define	_PCCARD_DRIVER_H_

struct lkm_table;
struct pccard_device;
extern struct linker_set pccarddrv_set;

void	pccard_add_driver __P((struct pccard_device *));
#ifdef _I386_ISA_ISA_DEVICE_H_ /* XXX actually if inthand2_t is declared */
int	pccard_alloc_intr __P((u_int imask, inthand2_t *hand, int unit,
			       u_int *maskp, u_int *pcic_imask));
#endif
void	pccard_configure __P((void));
void	pccard_remove_driver __P((struct pccard_device *));
int	pcic_probe __P((void));	/* XXX should be linker set */

enum beepstate { BEEP_ON, BEEP_OFF };

void	pccard_insert_beep __P((void));
void	pccard_remove_beep __P((void));
void	pccard_success_beep __P((void));
void	pccard_failure_beep __P((void));
void	pccard_beep_select __P((enum beepstate));

#endif /* !_PCCARD_DRIVER_H_ */
New file for pccard driver interface declarations. 1995-11-21 08:49:21 +00:00			`/*-`
			`* pccard driver interface.`
			`* Bruce Evans, November 1995.`
			`* This file is in the public domain.`
			`*/`

			`#ifndef _PCCARD_DRIVER_H_`
			`#define _PCCARD_DRIVER_H_`

			`struct lkm_table;`
- Do a bunch of gratuitous changes intended to make the code easier to follow. * Rename/reorder all of the pccard structures, change many of the member names to be descriptive, and follow more closely other 'bus' drivers naming schemes. * Rename a bunch of parameter and local variable names to be more consistant in the code. * Renamed the PCCARD 'crd' device to be the 'card' device * KNF and make the code consistant where it was obvious. * ifdef'd out some unused code 1997-10-26 04:36:24 +00:00			`struct pccard_device;`
- Instead of relying on a functional call to register PCARD-capable drivers, use a Linker Set. Note, if a driver is loaded as an LKM if will have to use the function call, but since none of the existing drivers are loadable, this made things cleaner and boot messages nicer. Obtained from: PAO-970616 1997-10-26 21:08:42 +00:00			`extern struct linker_set pccarddrv_set;`
New file for pccard driver interface declarations. 1995-11-21 08:49:21 +00:00
- Do a bunch of gratuitous changes intended to make the code easier to follow. * Rename/reorder all of the pccard structures, change many of the member names to be descriptive, and follow more closely other 'bus' drivers naming schemes. * Rename a bunch of parameter and local variable names to be more consistant in the code. * Renamed the PCCARD 'crd' device to be the 'card' device * KNF and make the code consistant where it was obvious. * ifdef'd out some unused code 1997-10-26 04:36:24 +00:00			`void pccard_add_driver __P((struct pccard_device *));`
New file for pccard driver interface declarations. 1995-11-21 08:49:21 +00:00			`#ifdef _I386_ISA_ISA_DEVICE_H_ /* XXX actually if inthand2_t is declared */`
Update the PCIC controller's imask with individual slot IRQ's. Assuming that the intr_mask[] was updated by changing the maskptrs (the existing update_intr_masks() function will not work) this code was written so the PCIC controller insertion/removal events will not interrupt the card IRQ handler events. Some possible scenarios: + Card is removed during IRQ handler: - PCIC card handler is allowed to interrupt - card removal event is called, removing the driver and data structures * card interrupt handler continues w/out driver, data structures, and hardware OR (the code just committed) * card IRQ handler has no hardware to read/write to, but has code and data to run on (XXX- Assume it completes and doesn't spin forever) - PCIC card handler unloads the card driver The current situation at least leaves the card interrupt handlers the drivers and data structures to work with although the hardware can't be guaranteed. Reviewed by: bde 1997-01-11 18:23:20 +00:00			`int pccard_alloc_intr __P((u_int imask, inthand2_t *hand, int unit,`
			`u_int maskp, u_int pcic_imask));`
New file for pccard driver interface declarations. 1995-11-21 08:49:21 +00:00			`#endif`
			`void pccard_configure __P((void));`
- Do a bunch of gratuitous changes intended to make the code easier to follow. * Rename/reorder all of the pccard structures, change many of the member names to be descriptive, and follow more closely other 'bus' drivers naming schemes. * Rename a bunch of parameter and local variable names to be more consistant in the code. * Renamed the PCCARD 'crd' device to be the 'card' device * KNF and make the code consistant where it was obvious. * ifdef'd out some unused code 1997-10-26 04:36:24 +00:00			`void pccard_remove_driver __P((struct pccard_device *));`
New file for pccard driver interface declarations. 1995-11-21 08:49:21 +00:00			`int pcic_probe __P((void)); /* XXX should be linker set */`

- 'Beep' support now happens in it's own separate file, so you can mess around with different noises for the different events and not have it affect other files. Inspired by: PAO 1997-10-26 06:06:54 +00:00			`enum beepstate { BEEP_ON, BEEP_OFF };`

			`void pccard_insert_beep __P((void));`
			`void pccard_remove_beep __P((void));`
			`void pccard_success_beep __P((void));`
			`void pccard_failure_beep __P((void));`
			`void pccard_beep_select __P((enum beepstate));`

New file for pccard driver interface declarations. 1995-11-21 08:49:21 +00:00			`#endif /* !_PCCARD_DRIVER_H_ */`