Developer Note Macintosh PowerBook Duo 2300c Computer Developer Press Apple Computer, Inc. 1995 Thi d t t d ith F M k 4 0 4 Apple Computer, Inc. Adobe Illustrator, Adobe Photoshop, LIMITED WARRANTY ON MEDIA AND 1995, Apple Computer, Inc. and PostScript are trademarks of Adobe REPLACEMENT All rights reserved. Systems Incorporated, which may be If you discover physical defects in the registered in certain jurisdictions. No part of this publication may be manual or in the media on which a software reproduced, stored in a retrieval America Online is a service mark of product is distributed, APDA will replace system, or transmitted, in any form or Quantum Computer Services, Inc. the media or manual at no charge to you by any means, mechanical, electronic, CompuServe is a registered service provided you return the item to be replaced photocopying, recording, or otherwise, mark of CompuServe, Inc. with proof of purchase to APDA. without prior written permission of DECnet is a trademark of Digital ALL IMPLIED WARRANTIES ON THIS Apple Computer, Inc. Printed in the Equipment Corporation. MANUAL, INCLUDING IMPLIED United States of America. FrameMaker is a registered trademark WARRANTIES OF MERCHANTABILITY The Apple logo is a registered of Frame Technology Corporation. AND FITNESS FOR A PARTICULAR trademark of Apple Computer, Inc. Helvetica and Palatino are registered PURPOSE, ARE LIMITED IN DURATION Use of the “keyboard” Apple logo trademarks of Linotype Company. TO NINETY (90) DAYS FROM THE DATE (Option-Shift-K) for commercial OF THE ORIGINAL RETAIL PURCHASE IBM is a registered trademark of purposes without the prior written OF THIS PRODUCT. consent of Apple may constitute International Business Machines trademark infringement and unfair Corporation. Even though Apple has reviewed this competition in violation of federal and ITC Zapf Dingbats is a registered manual, APPLE MAKES NO WARRANTY state laws. trademark of International Typeface OR REPRESENTATION, EITHER EXPRESS Corporation. OR IMPLIED, WITH RESPECT TO THIS No licenses, express or implied, are MANUAL, ITS QUALITY, ACCURACY, Motorola is a registered trademark of granted with respect to any of the MERCHANTABILITY, OR FITNESS FOR A Motorola Corporation. technology described in this book. PARTICULAR PURPOSE. AS A RESULT, Apple retains all intellectual property NuBus is a trademark of Texas THIS MANUAL IS SOLD “AS IS,” AND rights associated with the technology Instruments. YOU, THE PURCHASER, ARE ASSUMING described in this book. This book is PowerPC is a trademark of THE ENTIRE RISK AS TO ITS QUALITY intended to assist application International Business Machines AND ACCURACY. developers to develop applications only Corporation, used under license for Apple Macintosh computers. IN NO EVENT WILL APPLE BE LIABLE therefrom. FOR DIRECT, INDIRECT, SPECIAL, Apple Computer, Inc. Windows is a trademark of Microsoft INCIDENTAL, OR CONSEQUENTIAL 20525 Mariani Avenue Corporation. DAMAGES RESULTING FROM ANY Cupertino, CA 95014 Simultaneously published in the United DEFECT OR INACCURACY IN THIS 408-996-1010 States and Canada. MANUAL, even if advised of the possibility Apple, the Apple logo, APDA, of such damages. AppleLink, AppleTalk, GeoPort, THE WARRANTY AND REMEDIES SET LaserWriter, LocalTalk, Macintosh, FORTH ABOVE ARE EXCLUSIVE AND IN Macintosh Quadra, MacTCP, LIEU OF ALL OTHERS, ORAL OR PowerBook, and Power Macintosh are WRITTEN, EXPRESS OR IMPLIED. No trademarks of Apple Computer, Inc., Apple dealer, agent, or employee is registered in the United States and authorized to make any modification, other countries. extension, or addition to this warranty. AOCE, Apple Desktop Bus, AppleScript, Finder, Mac, Macintosh Some states do not allow the exclusion or PC Exchange, PowerBook Duo, Power limitation of implied warranties or liability Macintosh, and QuickDraw are for incidental or consequential damages, so trademarks of Apple Computer, Inc. the above limitation or exclusion may not apply to you. This warranty gives you specific legal rights, and you may also have other rights which vary from state to state. Thi d t t d ith F M k 4 0 4 Contents Figures and Tables vii Preface About This Note ix Contents of This Note ix Supplementary Documents x Conventions and Abbreviations xi Typographical Conventions xi Abbreviations xii Chapter 1 Introduction 1 Features 2 Configurations 3 Appearance 3 Accessory Devices 4 Compatibility Issues 4 Size of Case 5 Microprocessor Differences 5 Completion Serialized Instructions 5 Split Cache 5 Data Alignment 5 POWER-Clean Code 6 Power Manager Interface 6 Chapter 2 Architecture 7 Processor And Memory Subsystem 9 Main Processor 9 RAM 9 ROM 10 PBX Memory Controller IC 10 Memory Control 10 Bus Bridge 10 I/O Subsystem 10 Whitney Peripheral Support IC 11 Combo IC 11 Singer IC 12 Power Manager IC 12 Display Controller IC 12 Baboon Disk Drive IC 12 iii Thi d t t d ith F M k 4 0 4 Chapter 3 Input and Output Features 13 Displays 14 Internal IDE Hard Disk Drive 15 Hard Disk Specifications 15 Hard Disk Connector 16 Pin Assignments 17 IDE Signal Descriptions 19 Terminator 19 Power Requirements 20 Chapter 4 Software Features 21 ROM Software 22 PowerPC 603 Microprocessor 22 Machine Identification 22 Memory Controller Software 23 Power Manager Software 23 Display Controller Software 23 Sound Features 23 IDE Disk Mode 24 Ethernet Driver 24 Trackpad Software 24 System Software 25 Control Strip 26 Support for IDE Disk Drives 26 Large Partition Support 26 64-bit Volume Addresses 26 System-Level Software 26 Application-Level Software 27 Limitations 27 Drive Setup 27 Improved File Sharing 28 Dynamic Recompilation Emulator 28 Resource Manager in Native Code 28 Math Library 28 New BlockMove Extensions 29 POWER-Clean Native Code 30 POWER Emulation 31 POWER-Clean Code 31 Emulation and Exception Handling 31 Code Fragments and Cache Coherency 32 Limitations of PowerPC 601 Compatibility 32 QuickDraw Acceleration API 33 Display Manager 33 iv Chapter 5 Power Manager Interface 35 About the Power Manager Interface 36 Things That May Change 36 Checking for Routines 37 Power Manager Interface Functions 37 Header File for Power Manager Dispatch 57 Chapter 6 Large Volume Support 65 Overview of the Large Volume File System 66 API Changes 66 Allocation Block Size 66 File Size Limits 67 Compatibility Requirements 67 The API Modifications 67 Data Structures 67 Extended Volume Parameter Block 67 Extended I/O Parameter Block 69 New Extended Function 71 Chapter 7 Software for the ATA Hard Disk 75 Introduction to the ATA Software 76 ATA Disk Driver 77 ATA Manager 77 ATA Disk Driver Reference 78 Standard Device Routines 78 The Control Routine 78 The Status Routine 79 Control Functions 80 Status Functions 88 ATA Manager Reference 93 The ATA Parameter Block 93 Functions 98 Using the ATA Manager With Drivers 126 Notification of Device Events 127 Device Driver Loading 128 New API Entry Point for Device Drivers 128 Loading a Driver From the Media 130 Notify-All Driver Notification 130 ROM Driver Notification 131 Device Driver Purging 131 Setting the I/O Speed 133 Error Code Summary 134 v Appendix Color Lookup Table 137 Glossary 147 Index 149 vi Figures and Tables Chapter 1 Introduction 1 Figure 1-1 Front view of the computer 3 Figure 1-2 Back view of the computer 4 Table 1-1 Configurations 3 Chapter 2 Architecture 7 Figure 2-1 Block diagram 8 Chapter 3 Input and Output Features 13 Figure 3-1 Maximum dimensions of the internal IDE hard disk 16 Figure 3-2 Location of the connector on the hard disk 17 Figure 3-3 Connector pin arrangement 17 Table 3-1 Pin assignments on the IDE hard disk connector 17 Table 3-2 Signals on the IDE hard disk connector 19 Table 3-3 Hard disk power requirements 20 Chapter 4 Software Features 21 Table 4-1 Summary of BlockMove routines 29 Chapter 5 Power Manager Interface 35 Table 5-1 Interface functions and their selector values 38 Chapter 7 Software for the ATA Hard Disk 75 Figure 7-1 ATA software model 76 Table 7-1 Control functions 79 Table 7-2 Status functions 80 Table 7-3 Control bits in the ataFlags field 96 Table 7-4 ATA Manager functions 99 Table 7-5 Event masks 104 Table 7-6 Bits in pcValid field 114 Table 7-7 ATA register selectors 122 Table 7-8 Register mask bits 122 Table 7-9 Event codes send by the ATA Manager 127 vii Thi d t t d ith F M k 4 0 4 Table 7-10 Input parameter bits for the old API 129 Table 7-11 Input parameter bits for the new API 129 Table 7-12 Purge permissions and responses 132 Table 7-13 ATA driver error codes 134 Appendix Color Lookup Table 137 Table A-1 Color lookup table 137 viii PREFACE About This Note This developer note describes the Macintosh PowerBook Duo 2300c computer, emphasizing the features that are new or different from those of earlier PowerBook Duo computers. This developer note is a supplement to the Macintosh PowerBook Duo Developer Note, described in the section “Supplementary Documents,” later in this preface. This developer note is intended to help hardware and software developers design products that are compatible with the Macintosh products described in the note. If you are not already familiar with Macintosh computers or if you would simply like more technical information, you may wish to read the supplementary reference documents described in this preface. Contents of This Note 0 This developer note is arranged in seven chapters and an appendix: ■ Chapter 1, “Introduction,” describes the Macintosh PowerBook Duo 2300c computer and compares it with other PowerBook Duo models. ■ Chapter 2, “Architecture,” describes the architecture of the computer, with emphasis on the PowerPC 603 microprocessor and the custom ICs. ■ Chapter 3, “Input and Output Features,” describes the input and output features and the internal hard disk drive.