The Programmer's Guide to SCSI (with CD-ROM)

PREFACE: \ 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.\ Intended Audience\ 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 fascinatingtechnology.\ 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.\ How This Book Is Organized\ 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.\ What You Will Need\ 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.\ Acknowledgments\ 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.\ \

PrefaceAbout the AuthorsIntroductionCh. 1An Overview of SCSI Technology1Ch. 2SCSI Fundamentals15Ch. 3SCSI Phases17Ch. 4SCSI Messages23Ch. 5SCSI Commands31Ch. 6Status, Sense, and Errors47Ch. 7ASPI: The Advanced SCSI Programming Interface55Ch. 8Low-Level SCSI Programming with SCRIPTS103Ch. 9SCSI Target-Mode Programming127Ch. 10SCSI Support under Windows161Ch. 11Unix SCSI Implementations175Ch. 12Troubleshooting and Common Mistakes231Ch. 13Sample Application: SCSI Snooper237App. A: Glossary of Acronyms263App. BSCSI Resources267App. CInstalling the Windows NT ASPI32 Service273App. D: Companion CD-ROM Contents275Index279

\ BooknewsA tutorial and reference to Small Computer Systems Interface (SCSI), the standard interface for high-performance computer peripherals, for programmers who are writing drivers or creating applications that support SCSI devices. Presents SCSI hardware and software information within the context of software development and provides advice, tips, and techniques for more effective SCSI programming, covering both high- and low-level programming. The CD-ROM contains code, the SCSI FAQ, specifications, SCRIPTS support, and Linux SCSI documentation. Annotation c. by Book News, Inc., Portland, Or.\ \