[ibis-macro] IBIS AMI Reserved Parameter BIRD draft 01
- From: "Bob Ross" <bob@xxxxxxxxxxxxx>
- To: "'IBIS-ATM'" <ibis-macro@xxxxxxxxxxxxx>
- Date: Wed, 15 Jun 2011 11:51:04 -0700
All:
Attached is a new BIRD draft to constrain Reserved_Parameters
to be the first branch so that the AMI_Version number can be detected
before further parsing.
Bob
--
Bob Ross
Teraspeed Consulting Group, LCC
http://www.teraspeed.com
bob@xxxxxxxxxxxxxx
Direct : 503-246-8048
Teraspeed Labs: 503-430-1065
Headquarters: 401-284-1827
Teraspeed is a registered service mark of Teraspeed Consulting Group LLC
******************************************************************************
******************************************************************************
BIRD ID#: <TBD>
ISSUE TITLE: Reserved_Parameters Order
REQUESTER: Bob Ross, Teraspeed Consulting Group
DATE SUBMITTED: June 15, 2011
DATE REVISED:
DATE ACCEPTED BY IBIS OPEN FORUM:
******************************************************************************
******************************************************************************
STATEMENT OF THE ISSUE:
In general there are no order dependency rules in the .ami file. The
(requried) Reserved_Parameters section is not required to appear before the
Model_Specific section. However, with approved BIRD126 (adding AMI_Version)
the Reserve_Parameters branch needs to appear first for IBIS Version 5.1
and above so that new features can be immediately identified and processed
according to the correct Specification version.
******************************************************************************
STATEMENT OF THE RESOLVED SPECIFICATIONS:
On Page 143, change the paragraph
| The ?Reserved_Parameter? section is required while the
| ?Model_Specific? section is optional. The sub-trees can be
| in any order in the parameter file. The ?|? character is the
| comment character. Any text after the ?|? character will be
| ignored by the parser.
|
to
| The ?Reserved_Parameter? section is required while the
|* ?Model_Specific? section is optional. For AMI_Version 5.1
|* and above, the Reserved_Parameter sub-tree shall appear
|* before the Model_Specific sub-tree. The ?|? character is the
| comment character. Any text after the ?|? character will be
| ignored by the parser.
|
******************************************************************************
ANALYSIS PATH/DATA THAT LED TO SPECIFICATION
In all IBIS formats (.ibs, .pkg, .ebd, .icm) and Touchstone 2.0, the Version
information is required as the first keyword so that the remaining content
can be immediately parsed at the specified Version. This is now very
desirable for .ami files with the approval of BIRD126 which already mandates
that IBIS_Version appear first under the Reserved_Parameters sub-tree.
The diagram organization on page 144 shows Reserved_Parameters first, and
this organzation appears already to be common practice.
With the new requirement that Reserved_Parameters be positioned first,
the AMI_Version can be determined, and .ami file legal set of parameters and
structures can be parsed during the first pass. Otherwise a separate pass
might be needed.
*****************************************************************************
ANY OTHER BACKGROUND INFORMATION:
The word "sub-tree" is not modified in this BIRD. However the word
"branch" appears in BIRD126. The final terminology might be decided later
for overall IBIS-AMI terminology consistency.
******************************************************************************
Other related posts:
- » [ibis-macro] IBIS AMI Reserved Parameter BIRD draft 01 - Bob Ross
