Date: Sat, 20 Apr 1996 00:27:36 -0700 From: dmk@uask4it-223 (David Kahn) Subject: Item #335: ISA/EISA/ISA-PnP Draft version 0.2 NOTE: Posted by dmk, on behalf of Bob Coffin. P1275 Openboot Working Group Proposal -- Proposal #:335 Ver 1 Title: ISA/EISA/ISA-PnP Binding Draft 0.2 Author: Bob Coffin Date: Apr 19, 1996 Ed/Tech: Both Technical and Editorial Synopsis: New draft of the ISA bus supplement. Doc & Version: ISA/EISA/ISA-PnP Bus Binding, Draft 0.2 Problem: Applied the changes shown below to the ISA bus supplement. The new 0.6 draft of the device supplement is now available at the Open Firmware Working Group Web Site at the following URL: http://playground.sun.com/1275/home.html#OFDbusISA or via ftp at: ftp://playground.sun.com/pub/1275/bindings/isa/isa0_2d.ps Proposal: Editor updates to ISA/EISA/ISA-PnP Document, Version Draft 0.2. Page 7, line 23: Added Reference 9, Recommended Practice - Generic Names, Version 1.1. Page 8, lines 13-14: Removed the word 'full' in the first line. Corrected spelling for 'sense' to 'since'. Page 8, lines 38-41: Inserted the word 'shall' in the first sentence. Changed 'For this purpose' to 'For the numerical address format' in the second sentence. Added a new fourth sentence ' The decode format of the physical address is as follows:'. Page 8, line 44: Changed 's' to 'i' in the phys.hi cell definition(i - I/O). Page 8, line 47: Added 'where for phys.hi'. Page 8, lines 52-53: Changed 's' to 'i' and corrected '2-bit' to '1-bit' for definition of 'i' bit. Page 9, line 4: Changed 's' to 'i'. Page 9, line 18: Edited note by changing 'and these are the IEEE 1275 defaults' to '(these are the IEEE 1275 defaults)'. Page 9, lines 25-28: Changed 'i[t,v]NNNN' to 'i[t]NNNN or i[v]NNNN' and added 'or' in front of 'NNNNNNNN'. Page 9, lines 35-38: Added '10-bit aliasing', '11-bit aliasing' and 'indicates I/O Address Space'. Page 9, lines 43-45: Changed 'within the "ranges" property' to 'within the ISA 64KB I/O address space'. Page 9, lines 48-54: Changed 's' to 'i' and 'within the "ranges" property' to 'within the ISA 64KB I/O address space'. Changes 's' to 'i' in two places. Page 10, lines 2- 4: Changed 's' to 'i'. Page 10, lines 7- 9: Changed 's' to 'i'."'pci'VVV,DDDD" to "pci'VVVV,DDDD'". Page 10, lines 16-53 & Page 11, lines 1-45: Added new section, 2.2.4. Unit Address Representation. Added a new format for a PnP Unit Address of the form pVVVPPPP SSSSSSSS where phys.hi msb=1. Page 11, lines 46-49: Changed 'single memory-like address space' to 'single adress space model'. Page 12, line 7-9: Added Reference ›1|, Appendix A to define 'type code field' N for eisa-probe-list'. Page 12, line 20: Corrected spelling of 'adaptor' to 'adapter'. Page 12, lines 38-39: Line format change. Page 13, lines 7- 8: Changed 'address spaces' to 'address space requirements'. Page 13, line 21: Line format change. Page 13, lines 25-27: Capitalized 'ID' and line format changes. Page 13, lines 35-36: Changed line from 'The child note(ISA/EISA bus) will respond to an access not claimed by the parent node(ISA/EISA Bridge Chip) within the definition of the "ranges" property' to 'The ISA/EISA Bridge will respond to an access not claimed by the parent of the ISA Node within the definition of the "ranges" property'. Page 14, lines 5- 6: Changed from 'Allocate a 24-bit address memory region for later use(for ISA and EISA implementations)' to 'Allocate memory suitable for DMA use, by ISA and EISA. Since many I/O devices are restricted to 24-bit addressing, the memory that is allocated must be in an area that can be reached by 24-bit addressing'. Page 14, line 38: Changed 'each have a child node' to 'each be a child node'. Page 14, line 41: Changed 'three' to 'four'. Page 14, lines 43-45: Changed line spacing. Page 14, lines 46-52: Changed line spacing and added Item Number 4. Page 15, line 4: Changed 'Core-specified Properties' to 'Open Firmware Properites'. Page 15, lines 10-21: Added verbiage about "name" property. Added Reference 9, Generic Names, reference to "Header" on page 20 and reference to "Logical Device ID Recode on page 23. Also added lines for the string definition of isa, 'vvv' and 'pppp'. Page 15, lines 29-39: Edited section to change/add material about the unit address when 'phys.hi msb=1' and/or 'phys.hi msb=0'. Page 15, line 44: Changed sentence from 'arbitrary array of integers with one of more pairs where' to 'list of an arbitrary number of integer pairs where'. Page 16, line 4: Deleted 'and is platform dependent' from the note. Page 16, line 6: Changed definition of the standard property name from "the presence of indicates the operational status of the device" to "indicates the operational status of the device". Page 16, lines 13-17: Changed the text from: The first entry is derived from the "logical Device ID Record", Section 6.3.4 on Page 21. Additional entries, if present, come from the "Compatible Device ID Record, Section 6.3.5 on Page 22. to: The first entry should be an explicit, unique name that identifies the device precisely enough to be able to infer a detailed programming model. The format of the name is 'manufacturer,model' as specified in Reference 1, page 162. Page 16, lines 22-24: Changed text for 'Standard prop-name' from 'the presence of which indicates that the function represented by this node is connected to an ISA/EISA bus DMA line.' to 'indicates that the function represented by this node is connected to an ISA/EISA bus DMA resource". Page 16, lines 26-30: Moved note, line 44, to line 29. Changed text from 'DMA Channel 4 is not available' to 'DMA Channel 4 is used for cascading of 8259's and is not available." Page 16, lines 44-48: Renamed property 'connectors' to 'slot-names'. Changed text for "prop-encoded-array" from 'A list of strings, each encoded as with encode-string' to 'An integer, encoded as with encode-int, followed by a list of strings, each encoded as with encode-string'. Page 16, lines 50-53: Added text, second paragraph, to define the "prop-encoded-array" data structure. Page 16: Deleted two properties, "interrupt-choices" and "dma-choices". Data structure in PnP Format with the 'dependent' resource was incorrect for the properties as they were defined. Page 17, lines 3- 7: Removed author's note and did a format change. Page 17, line 11: Format change. Page 17, lines 20-22: Changed text for "prop-encoded-array" from 'a list of concatenated strings, as encoded with ecode+, where an individual string in the list is encoded as with encode-string. Format of the data resource is tbd' to 'an array of bytes containing PnP Packages encoded as with byte. Format of the data resource structure is defined to be PnP Data Resource (Section 6. on page 18). The adapter data format would be defined in an adapter binding'. Page 17, line 29 & 31: Format changes. Page 17, line 40: Changed text from 'Firmware expansion ROM' to 'Firmware expansion ROM ISA and EISA Adapters'. Page 18, line 31: Format change. Page 18, lines 34-37: Format changes. Page 19, line 34: Format change. Page 20, line 19: Capitalized 'ID'. Page 20, line 47: Format change. Page 20, lines 50-53: Added text '(used as part of the first component of the "reg" property of PnP Adapters). Page 23, line 14: Format change. Page 23, lines 45-47: Format change and removed sentence 'The name field of the child node of the device node is derived for the device id, function number and serial number(See "Header" on page 18.) fields as "isaddd,fff,sss"'. Page 29, lines 14-16: Format change to line up byte 2 and bytes 0-ff. Page 29, line 43: Added sentence 'This record identifies the end of resource information for the adapter card'. [ P1275 Item #335 -- Received: Sat Apr 20 00:27:12 PDT 1996 ]