[ibis-macro] Re: BIRD 187.1 questions

  • From: Curtis Clark <curtis.clark@xxxxxxxxx>
  • To: "Mirmak, Michael" <michael.mirmak@xxxxxxxxx>
  • Date: Fri, 6 Jan 2017 13:20:53 -0500

Hi Michael,

FYI to everyone, at the Open Forum meeting we decided to talk about this
some more at the next ATM meeting.

Michael, your suggestions sound reasonable to me.

2) As you mentioned in the Open Forum, we can discuss in ATM whether to
move the sentence, remove it, etc.


As for 1), I noticed that the misuse of "Type" appears in at least one
other place in the spec already.  Here's a paragraph from the "Combination
and Corner Rules" section that is now included in the BIRD.

For AMI parameter Types “Range”, “Increment” and “Steps” <min value>, <max
value> does not imply slow and fast corners, and for Usage In and Usage
InOut the user may select any value provided by these parameters regardless
of what corner is used for the simulation.  If the user does not make a
selection for parameter types “Range”, “List”, “Increment” and “Steps”, the
EDA tool shall automatically use the value defined by Default, if it
exists, or the <typ value> otherwise (regardless of what corner is used for
the simulation).

The first use of "Types" is incorrect, as those are Formats not Types.  In
the second sentence lower case "types" is used instead.  These issues
pre-date this BIRD.  Just mentioning it in case we want to clean them up
too. Maybe we should just add a search and review of "types" and "Types" to
the known issues list?  There are many places where we say "type" when we
actually mean "Type" as well.

Thanks,
Curtis



On Thu, Jan 5, 2017 at 11:35 PM, Mirmak, Michael <michael.mirmak@xxxxxxxxx>
wrote:

Curtis,



Thanks for the review and comments!



1)      Yes, the word “Type” is probably an accidental leftover from an
earlier draft.  It can be removed.

2)      If we were to move the existing Format sentence you pointed out
to page 202, after the related sentence, would that resolve the issue?



-          MM



*From:* ibis-macro-bounce@xxxxxxxxxxxxx [mailto:ibis-macro-bounce@
freelists.org] *On Behalf Of *Curtis Clark
*Sent:* Thursday, January 05, 2017 12:53 PM
*To:* IBIS-ATM <ibis-macro@xxxxxxxxxxxxx>
*Subject:* [ibis-macro] BIRD 187.1 questions



Hi Everyone,

At the last ATM meeting of 2016 we were all asked to review BIRD 187.1.

I have two questions about its language.

Thanks,

Curtis


1.  Page 4 of the BIRD. "Format" section:

Unless otherwise noted, Usage Out arguments or data of Type Value or
Default provided as Format are effectively ignored by EDA tools.

I think this sentence is a bit confusing.  In particular, "Type" should
not be capitalized, right?  I think we want to be careful to avoid
confusion with the AMI reserved word "Type" (Float, String, Integer, etc.),
which we don't mean here, right?  We simply want to say that Value or
Default are generally ignored for an Output parameter.



2.  Last sentence of that same paragraph of the "Format" section:
Data of Usage Dep, Usage Info or Usage Out shall not be passed to the
executable model file by the EDA tool, unlike data of Usage In or InOut,
which shall always be passed to the executable model file by the EDA tool.

I know that this sentence was added as a clarification statement, but it
is essentially a restatement of something that's already in the spec on
page 202 (see below).  I think restating something two different places in
the spec can cause maintenance issues later, and it may lead to confusion
if the reader wonders whether we are trying to draw a distinction between
the two different statements.  In addition, the sentence itself is entirely
about Usage rules, so it seems out of place in the Format section anyway.

(page 202 of the spec):  "The EDA tool shall pass a string to the
executable model through the AMI_parameters_in argument. This string
shall contain all of the leaf-formatted Usage In and Usage InOut AMI
parameters if there are any defined in the .ami file. No other information
may be included in this string. The string shall always include the root
name of the parameter tree, even if there are no parameters to pass to the
algorithmic model. The executable model shall return a string to the EDA
tool through the AMI_parameters_out argument. This string shall contain all
of the leaf formatted Usage InOut and Usage Out AMI parameters if there are
any defined in the AMI parameter definition file. No other information may
be included in this string."

Other related posts: