The Programmer's Guide to SCSI offers a concise tutorial and reference to the Small Computer Systems Interface (SCSI), the standard interface for high-performance computer peripherals. Geared specifically for programmers who are writing drivers or creating applications that support SCSI devices, this book presents comprehensive SCSI hardware and software information within the context of software development. It will help you find your way through this complex topic and ease your learning curve by providing expert advice, tips, and techniques for more effective SCSI programming.
The Programmer's Guide to SCSI covers both high- and low-level programming topics. Specifically, you will find coverage of:
In addition, this book develops an ASPI class library and uses it to create a SCSI snooper application under Windows. The library can also be extended for use in your own projects.
This book's clear presentation of SCSI eliminates wading through densely packed hardware documentation and lets you approach the topic with better direction to gain a fuller understanding.
How This Book is Organized.
What You Will Need.
About the Authors.
An Overview of SCSI Technology.
The SCSI Solution.
Synchronous Data Transfer.
Multiple Device Types on a Single Interface.
The Birth of SCSI-2.
New Features in SCSI-2.
Fast Wide SCSI.
Queued I/O Processes.
New Command Sets.
Improved SCSI-1 Features.
Data Parity Required.
Message Support Required.
Terminator Power Provided by Initiator.
SCSI-3 on the Horizon.
Fast-20 and Fast-40 SCSI.
Serial SCSI Standards.
Serial Standard Architecture.
Plug and Play SCSI.
SCSI Transactions — An Overview.
Data In and Data Out.
The Identify Message.
Synchronous Data Transfer Request.
Wide Data Transfer Request.
Other Common Messages.
Bus Device Reset.
Ignore Wide Residue.
Queue Tag Messages.
Simple Queue Tag.
Head of Queue Tag.
Ordered Queue Tag.
Example - Iomega Zip Drive.
Mode Sense Data Format.
Example - Iomega Zip Drive.
Building the SCSI Request Block.
Sending an SRB to the ASPI Manager.
Waiting for an SRB to Complete.
Processing Returned Status Information.
Table Indirect Addressing.
Polling for Completion.
Hardware Interrupt on Completion.
SCSI-3 Command Sets.
SCSI Software Interfaces.
Appendix B — SCSI Resources.
Magazines and Journals.
Bulletin Board Systems.
In the years since the Small Computer Systems Interface (SCSI) first appeared, it has gained wide acceptance as the interface standard for high-performance computer peripherals. Once confined to mainframes and high-end workstations, SCSI devices are now supported by most desktop operating systems running on personal computers.
There is a reason for this near universal support. The SCSI standard was designed as a high-performance interface to a wide range of devices types. Disk drives, optical and tape drives, scanners, and printers all come equipped with SCSI interfaces. As faster machines become more common, the demand for faster peripherals follows. SCSI technology offers a way to meet this demand.
Though manufacturers and end users have embraced the Small Computer Systems Interface, information about programming SCSI devices is still scarce. This book attempts to fill that gap by describing SCSI from a programmer's point of view.
This book is intended as a tutorial and a reference for programmers writing software to support SCSI peripherals. Whether you are writing low-level code for a SCSI device driver or high-level code for an application, you will find information you can use.
Maybe you have waded through the details of the ANSI specification documents. Maybe you have tried to decipher another programmer's source code. There is no doubt that learning the fundamentals of SCSI programming through trial and error can be a source of endless frustration. Our goal is to plant a few guideposts to steer you in the right direction, so as to flatten the learning curve for this complex but fascinating technology.
The presentation is slanted toward software development. Information about signal characteristics, timing protocols, and hardware details only appear when they directly relate to a programming task. We assume that if you are reading this book, you're more comfortable with a keyboard than a soldering iron. We also assume some experience with C, C++, and assembly language.
This book begins with an overview of SCSI. We describe the design philosophy behind the standard, and how it has evolved to incorporate new features and capabilities. We also describe variations of the SCSI standard that offer faster transfers, wider data paths, or other features.
Anyone working with SCSI must understand some fundamental concepts. How do SCSI devices communicate? How are commands executed and data transferred? What roles do the initiator and the target play? We address these questions by describing the SCSI transaction model. This provides a foundation for a more detailed discussion of the elements of a SCSI transaction.
Next we present a layered approach to SCSI programming, starting with high-level programming interfaces. We explore the Advanced SCSI Programming Interface (ASPI) under DOS and Windows, and ASPI32 extensions under Windows 95 and NT.
Windows NT offers its own built-in SCSI support. We explore how it works by examining the Windows NT device model and how the ASPI layer uses it.
Then we tackle more advanced material as we look at low-level programming using common SCSI I/O processors and scripting languages such as Symbios Logic's SCRIPTS. We demonstrate both initiator and target operations.
SCSI enjoys wide support on UNIX systems. Unfortunately, the specifics of SCSI support differ greatly between UNIX implementations. The UNIX chapter highlights SCSI support under different systems, then focuses on SCSI under Linux. This platform is widely available, and open enough to encourage experimentation.
Last of all, we develop a SCSI class library and use it to develop a sample application under Windows. This should encourage you to use and extend the library for your own projects.
The final chapter offers advice in troubleshooting and debugging. Appendix B lists SCSI resources in print and electronic form.
The sample code in this book was designed for portability. We developed most of the code using Microsoft Visual C++. The SCRIPTS sample code uses Borland's C++ compiler and Turbo Assembler. Either should port with little effort. The sample application uses Microsoft's Foundation Classes library, also available with other compilers. The Linux code uses the compiler that comes with the operating system.
We recommend using an Iomega Zip drive as a test device for the sample code. Some of the samples demonstrate disk drive operations. When testing these, it's nice to have something besides your system disk to work with.
Zip drives come in SCSI or parallel port versions. The parallel port device uses an ASPI compatible driver.
The low-level code uses the Symbios Logic SCRIPTS compiler and host adapters equipped with 53C8XX family processors. The compiler is available from the Symbios Logic FTP site. The code should be compatible with other adapters in the same family. If your host adapter uses a chip from another manufacturer, you will not be able to use this code. If you wish to contact Symbios Logic, refer to the manufacturer listing in Appendix B.
The ASPI code will work with almost any host adapter that comes with an ASPI compatible driver. For more advanced work, you may wish to purchase the ASPI Developer's Kit from Adaptec. To contact Adaptec, refer to the manufacturer listing in Appendix B.
For any serious work with SCSI, you will need a copy of the ANSI SCSI-2 specification document. Though we cover SCSI fundamentals in this book, and probe the depths of some programming issues, we can't duplicate all the details that the specification covers. Consider this book a supplement to the ANSI document, which is available from Global Engineering Documents. You'll find them listed in Appendix B.
This book would not have been possible without contributions from many people. Kathleen Tibbetts, formerly an editor at Addison-Wesley, had faith in the project from the beginning.
Pamela Thompson at Earle Associates and Lauren Uddenberg at Symbios Logic went above and beyond the call of duty to provide support and information about Symbios products.
Thanks go to Mike Berhan and Dan Polfer of Adaptec for reviewing the ASPI-related material. Thanks also to John Lohmeyer, chairman of the T10 Technical Committee, for his comments and critiques of the material covering the SCSI specifications.
Special thanks go to contributing authors Larry Martin and Gary Field. Larry shares his invaluable programming experience in the chapters on ASPI, Windows device support, and SCSI target mode. Gary, who maintains the SCSI FAQ for the comp.periphs.scsi newsgroup, shares his considerable knowledge of UNIX support for SCSI in a chapter devoted to the subject.
Most important, I wish to acknowledge the inspiration and encouragement that my wife, Mary, provided throughout this project.