freebsd-dev/sys/pccard/slot.h
Nate Williams cc6da87199 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

147 lines
5.2 KiB
C

/*
* Slot structures for PC-CARD interface.
* Each slot has a controller specific structure
* attached to it. A slot number allows
* mapping from the character device to the
* slot structure. This is separate to the
* controller slot number to allow multiple controllers
* to be accessed.
*-------------------------------------------------------------------------
*
* Copyright (c) 1995 Andrew McRae. All rights reserved.
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions
* are met:
* 1. Redistributions of source code must retain the above copyright
* notice, this list of conditions and the following disclaimer.
* 2. Redistributions in binary form must reproduce the above copyright
* notice, this list of conditions and the following disclaimer in the
* documentation and/or other materials provided with the distribution.
* 3. The name of the author may not be used to endorse or promote products
* derived from this software without specific prior written permission.
*
* THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
* IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
* OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
* IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
* INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
* NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
* DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
* THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
* (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
* THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
*/
/*
* Controller data - Specific to each slot controller.
*/
struct slot;
struct slot_ctrl {
int (*mapmem) __P((struct slot *, int));
/* Map memory */
int (*mapio) __P((struct slot *, int));
/* Map io */
void (*reset) __P((void *));
/* init */
void (*disable) __P((struct slot *));
/* Disable slot */
int (*power) __P((struct slot *));
/* Set power values */
int (*ioctl) __P((struct slot *, int, caddr_t));
/* ioctl to lower level */
void (*mapirq) __P((struct slot *, int));
/* Map interrupt number */
void (*resume) __P((struct slot *));
/* suspend/resume support */
int extra; /* Controller specific size */
int maxmem; /* Number of allowed memory windows */
int maxio; /* Number of allowed I/O windows */
int irqs; /* IRQ's that are allowed */
u_int *imask; /* IRQ mask for the PCIC controller */
char *name; /* controller name */
/*
* The rest is maintained by the mainline PC-CARD code.
*/
struct slot_ctrl *next; /* Allows linked list of controllers */
int slots; /* Slots available */
};
/*
* Driver structure - each driver registers itself
* with the mainline PC-CARD code. These drivers are
* then available for linking to the devices.
*/
struct pccard_dev;
struct pccard_drv {
char *name; /* Driver name */
int (*handler)(struct pccard_dev *); /* Interrupt handler */
void (*unload)(struct pccard_dev *); /* Disable driver */
void (*suspend)(struct pccard_dev *); /* Suspend driver */
int (*init)(struct pccard_dev *, int); /* init device */
int attr; /* driver attributes */
unsigned int *imask; /* Interrupt mask ptr */
struct pccard_drv *next;
};
/*
* Device structure for cards. Each card may have one
* or more drivers attached to it; each driver is assumed
* to require at most one interrupt handler, one I/O block
* and one memory block. This structure is used to link the different
* devices together.
*/
struct pccard_dev {
struct pccard_dev *next; /* List of drivers */
#ifdef PC98
struct pc98_device isahd; /* Device details */
#else
struct isa_device isahd; /* Device details */
#endif
struct pccard_drv *drv;
void *arg; /* Device argument */
struct slot *sp; /* Back pointer to slot */
int running; /* Current state of driver */
u_char misc[128]; /* For any random info */
};
/*
* Per-slot structure.
*/
struct slot {
struct slot *next; /* Master list */
int slot; /* Slot number */
int flags; /* Slot flags (see below) */
int rwmem; /* Read/write flags */
int ex_sel; /* PID for select */
int irq; /* IRQ allocated (0 = none) */
int irqref; /* Reference count of driver IRQs */
struct pccard_dev *devices; /* List of drivers attached */
/*
* flags.
*/
unsigned int insert_seq; /* Firing up under the card */
enum cardstate state, laststate; /* Current/last card states */
struct selinfo selp; /* Info for select */
struct mem_desc mem[NUM_MEM_WINDOWS]; /* Memory windows */
struct io_desc io[NUM_IO_WINDOWS]; /* I/O windows */
struct power pwr; /* Power values */
struct slot_ctrl *ctrl; /* Per-controller data */
void *cdata; /* Controller specific data */
int suspend_power; /* Leave powered on during suspend */
int pwr_off_pending;/* Power status of slot */
#ifdef DEVFS
void *devfs_token;
#endif /* DEVFS*/
};
enum card_event { card_removed, card_inserted };
struct slot *pccard_alloc_slot(struct slot_ctrl *);
void pccard_event(struct slot *, enum card_event);
void pccard_remove_controller(struct slot_ctrl *);