LDI/DDI Specifications and Developer's Guide
Total Page:16
File Type:pdf, Size:1020Kb
LDI/DDI Specifications and Developer’s Guide Version 3.0 September 30, 1997 This page intentionally left blank Disclaimer Novell , Inc. makes no representations or warranties with respect to the contents or use of this manual, and specifically disclaims any express or implied warranties of merchantability or fitness for any particular purpose. Further, Novell, Inc. reserves the right to revise this publication and to make changes to its content, at any time, without obligation to notify any person or entity of such revisions or changes. Copyright 1995 through 1996 by Novell, Inc. All rights reserved. This work is subject to U.S. and international copyright laws and treaties. No part of this work may be used, practiced, performed, copied, distributed, revised, modified, translated, abridged, condensed, expanded, collected, or adapted without the prior written consent of Novell, Inc. Any use or exploitation of this work without authorization could subject the perpetrator to criminal and civil liability. Trademarks Novell, Inc. has made every effort to supply trademark information about company names, products, and services mentioned in this book. Trademarks indicated below were derived from various sources. Novell Trademarks NetWare, Novell and UnixWare are registered trademarks of Novell, Inc. Internetwork Packet Exchange (IPX), ODI, Open Data-Link Interface, LSL, Link Support Layer, MLID, Multiple Link-Interface Driver, MLI, Multiple Link Interface, MPI, Multiple Protocol Interface, MSM, Media Support Module, TSM, Topology Support Module, HSM, Hardware Support Module, RX-Net, NE1000, NE2000, NE/2, NE2-32, and NTR2000 are trademarks of Novell, Inc. Other Trademarks ARCnet is a registered trademark of Datapoint Corporation. Apple, AppleTalk and LocalTalk are registered trademarks of Apple Computer, Inc. COMPAQ is a registered trademark of Compaq Computer Corporation. DEC and LAT are trademarks of Digital Equipment Corporation. Gateway and G/Net are registered trademarks of Gateway Communications, Inc. IBM, OS/2, and PS/2 are registered trademarks of International Business Machines Corporation. Intel is a registered trademark of Intel Corporation. MS-DOS, MS-Windows, and MS-Windows NT are registered trademarks of Microsoft Corporation. Proteon and ProNET are registered trademarks of Proteon, Inc. Xerox and XNS are registered trademarks of Xerox Corporation. Version 3.0 Contents 1 LDI/DDI Specification What is the Installation Information File? . 7 Cards and Buses Supported . 7 Information File Format and Syntax. 8 Reserved Keywords . 8 General Format of the Installation File . 10 VeRsIoN (comment) . 11 CoPyRiGhT . 11 Version. 12 SyntaxVersion . 12 Driver Section . 12 Language Section . 12 General Information File Syntax. 12 Language Translation . 14 Language ID . 15 Example with Spanish Language Block . 16 2 Driver Section—General Syntax Overview . 18 Driver Description Name . 19 Dependency Expression . 19 Dependency Expression Syntax. 20 General Dependency Expression Syntax Rules. 21 Evaluation of Dependency Expressions with UNDEFINED Parameters 22 Handling Multiple Buses in One Machine . 23 Description . 24 Help . 24 Guidelines for Writing Useful Help. 25 ParameterInformation . 27 Non-HIN-Aware Example . 28 HIN-Aware Example . 29 Non-HIN Aware, LOMHI Example . 30 HIN Aware, LOMHI Example . 30 Contents iii LDI/DDI Specification and Developer’s Guide Documentation Part Number September 29, 1997 Version 3.0 ProductID. 31 Syntax . 31 Handling Special Characters in a PROD String . 33 Conditional SCSI and IDE Device Driver Module Support . 34 Path . 38 File . 38 OFiles (Other Associated Files) . 38 CProg (Configuration Program) . 39 Timeout. 39 3 Driver Section—Parameters Parameter Types. 40 General Parameter Definitions . 40 The PROMPT Parameter . 42 Syntax . 42 Dependency Expression . 43 Description . 43 Help . 43 Type . 43 Example 1 . 44 Example 2 . 44 Values . 44 Default . 44 ReservedLength . 45 OutputFormat. 45 Example . 45 Resulting Screens . 46 The LIST Parameter . 46 Syntax . 46 Dependency Expression.. 47 Description.. 47 Help . 47 Choice and CDescription . 47 Default . 48 OutputFormat. 48 Example . 48 The FRAME Parameter . 49 Syntax . 49 Dependency Expression . 49 Description . 50 Help . 50 Choice and CDescription . 50 Default . 51 iv LDI/DDI Specification and Developer’s Guide LDI/DDI Specification and Developer’s Guide Documentation Part Number September 29, 1997 Version 3.0 OutputFormat . 51 OctetBitOrder . 51 Example (for Assembly Language MLIDs) . 51 4 Predefined Parameters Global Predefined Parameters . 53 The BUS Parameter . 53 The GT_16 Parameter . 53 Local Predefined Parameters . 54 Predefined PROMPT Parameter . 54 The INT Predefined Parameter . 57 The PORTx and MEMx Predefined Parameters. 58 Example MLID . 59 5 Driver Installation Information Template 6 Sample DDI/LDI files for Family Drivers with ISA Support First Example . 66 Second Example . 67 A 16-Bit DOS Client Installation Information (INS) File General Rules . 69 File Syntax . 70 Signature Lines . 70 Driver Name . 70 Version . 71 Associated File List . 71 Board Description . 71 Help Text . 72 Parameter Definitions . 73 Parameter Syntax . 73 Parameter Code . 73 First character . 73 Second character . 74 Last Six Characters . 74 Parameter Keyword . ..