BSP Developer's Guide

VxWorks 5.5
BSP Developer’s Guide
Example I-2
Template: Advanced Controller Driver
/* xxxLib.c - XXX SCSI I/O Processor (SIOP) library */
/* Copyright 1989-1996 Wind River Systems, Inc. */
#include "copyright_wrs.h"
/*
modification history
--------------------
01g,19aug96,dds written
*/
/*
DESCRIPTION
This is the I/O driver for the XXX SCSI I/O Processor (SIOP).
It is designed to work with scsiLib and scsi2Lib. This driver
runs in conjunction with a script program for the XXX controller.
These scripts use DMA transfers for all data, messages and status.
This driver supports cache functions through scsi2Lib.
USER-CALLABLE ROUTINES
Most of the routines in this driver are accessible only through the I/O
system. The following routines must be called directly: xxxCtrlCreate()
to create a controller structure, and xxxCtrlInit() to initialize it.
The XXX SCSI Controller's hardware registers need to be configured according
to the hardware implementation. If the default configuration is not proper,
the routine xxxSetHwRegister() should be used to properly configure
the registers.
INTERNAL
This driver supports multiple initiators, disconnect/reconnect, tagged
command queueing, synchronous data transfer and wide data transfer protocols.
In general, the SCSI system and this driver automatically choose the
best combination of these features to suit the target devices used.
However, the default choices may be over-ridden by using the function
"scsiTargetOptionsSet()" (see scsi2Lib).
There are debug variables to trace events in the driver.
scsiLib debug variable, trace event in scsiLib, xxxScsiPhase(),
and xxxTransact().
prints interrupt informations.
INCLUDE FILES
xxx.h, xxxScript.h and scsiLib.h
*/
#define INCLUDE_SCSI2
#include "vxWorks.h"
#include "memLib.h"
#include "ctype.h"
#include "stdlib.h"
#include "string.h"
#include "stdio.h"
#include "logLib.h"
338