937a7a3ed9
This is a completely rewritten scsipi_xfer execution engine, and the associated changes to HBA drivers. Overview of changes & features: - All xfers are queued in the mid-layer, rather than doing so in an ad-hoc fashion in individual adapter drivers. - Adapter/channel resource management in the mid-layer, avoids even trying to start running an xfer if the adapter/channel doesn't have the resources. - Better communication between the mid-layer and the adapters. - Asynchronous event notification mechanism from adapter to mid-layer and peripherals. - Better peripheral queue management: freeze/thaw, sorted requeueing during recovery, etc. - Clean separation of peripherals, adapters, and adapter channels (no more scsipi_link). - Kernel thread for each scsipi_channel makes error recovery much easier (no more dealing with interrupt context when recovering from an error). - Mid-layer support for tagged queueing: commands can have the tag type set explicitly, tag IDs are allocated in the mid-layer (thus eliminating the need to use buggy tag ID allocation schemes in many adapter drivers). - support for QUEUE FULL and CHECK CONDITION status in mid-layer; the command will be requeued, or a REQUEST SENSE will be sent as appropriate. Just before the merge syssrc has been tagged with thorpej_scsipi_beforemerge
85 lines
3.6 KiB
C
85 lines
3.6 KiB
C
/* $NetBSD: ssvar.h,v 1.8 2001/04/25 17:53:41 bouyer Exp $ */
|
|
|
|
/*
|
|
* Copyright (c) 1995 Kenneth Stailey. All rights reserved.
|
|
* modified for configurable scanner support by Joachim Koenig
|
|
*
|
|
* 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. All advertising materials mentioning features or use of this software
|
|
* must display the following acknowledgement:
|
|
* This product includes software developed by Kenneth Stailey.
|
|
* 4. 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.
|
|
*/
|
|
|
|
/*
|
|
* SCSI scanner interface description
|
|
*/
|
|
|
|
/*
|
|
* Special handlers for impractically different scanner types.
|
|
* Register NULL for a function if you want to try the real SCSI code
|
|
* (with quirks table)
|
|
*/
|
|
struct ss_softc;
|
|
struct scan_io;
|
|
|
|
struct ss_special {
|
|
int (*set_params) __P((struct ss_softc *, struct scan_io *));
|
|
int (*trigger_scanner) __P((struct ss_softc *));
|
|
int (*get_params) __P((struct ss_softc *));
|
|
/* some scanners only send line-multiples */
|
|
void (*minphys) __P((struct ss_softc *, struct buf *));
|
|
int (*read) __P((struct ss_softc *, struct buf *));
|
|
int (*rewind_scanner) __P((struct ss_softc *));
|
|
int (*load_adf) __P((struct ss_softc *));
|
|
int (*unload_adf) __P((struct ss_softc *));
|
|
};
|
|
|
|
/*
|
|
* ss_softc has to be declared here, because the device dependant
|
|
* modules include it
|
|
*/
|
|
struct ss_softc {
|
|
struct device sc_dev;
|
|
|
|
int flags;
|
|
#define SSF_TRIGGERED 0x01 /* read operation has been primed */
|
|
#define SSF_LOADED 0x02 /* parameters loaded */
|
|
#define SSF_AUTOCONF 0x04 /* set during auto-configuration */
|
|
struct scsipi_periph *sc_periph; /* contains our targ, lun, etc. */
|
|
struct scan_io sio;
|
|
struct buf_queue buf_queue; /* the queue of pending IO operations */
|
|
u_int quirks; /* scanner is only mildly twisted */
|
|
#define SS_Q_GET_BUFFER_SIZE 0x0001 /* poll for available data in ssread() */
|
|
/* truncate to byte boundry is assumed by default unless one of these is set */
|
|
#define SS_Q_PAD_TO_BYTE 0x0002 /* pad monochrome data to byte boundary */
|
|
#define SS_Q_PAD_TO_WORD 0x0004 /* pad monochrome data to word boundary */
|
|
#define SS_Q_THRESHOLD_FOLLOWS_BRIGHTNESS 0x0008
|
|
struct ss_special *special; /* special handlers for spec. devices */
|
|
};
|
|
|
|
/*
|
|
* define the special attach routines if configured
|
|
*/
|
|
void mustek_attach __P((struct ss_softc *, struct scsipibus_attach_args *));
|
|
void scanjet_attach __P((struct ss_softc *, struct scsipibus_attach_args *));
|