****************************************************************************
****************************************************************************
BIRD ID#: 128
ISSUE TITLE: Allow AMI_parameters_out to pass AMI_parameters_in data on
             calls to AMI_GetWave 
REQUESTOR: Walter Katz, SiSoft
DATE SUBMITTED: March 11, 2011
DATE REVISED:
DATE ACCEPTED BY IBIS OPEN FORUM:

****************************************************************************
****************************************************************************
STATEMENT OF THE ISSUE:
In order to implment communications from the Rx model to the Tx AMI_GetWave
call this BIRD modifies the use of the argument AMI_parameters_out to point
to AMI_parameters_in data when calling the AMI_GetWave function.

****************************************************************************
STATEMENT OF THE RESOLVED SPECIFICATIONS:

Replace the following text in Section 3.2.2.4:

| 3.2.2.4 AMI_parameters_out (optional)
| =====================================
|
| A handle to a ‘tree string’ as described in 1.3.1.2.6.  This is used by the
| algorithmic model to return dynamic information and parameters.  The memory
| for this string is to be allocated and deleted by the algorithmic model.

With the following text:

| 3.2.2.4 AMI_parameters_out (optional)
| =====================================
|
|* A handle to a ‘tree string’ as described in 1.3.1.2.6.  On the call to the
|* AMI_GetWave function, AMI_parameters_out shall either contain a NULL
|* pointer, or shall point to a ‘tree string’. The memory for this string
|* shall be allocated and deleted by the simulator. This is also used by the
|* algorithmic model to return dynamic information and parameters.  The memory
|* for this string is to be allocated and deleted by the algorithmic model.
|* If the algorithmic model does not return a ‘tree string’, the value of this
|* handle shall be the NULL pointer.

****************************************************************************
ANALYSIS PATH/DATA THAT LED TO SPECIFICATION:
Implementing backchannel co-optimization in the time domain will require
that instructions and data be passed from the Rx AMI_Init and
Rx AMI_GetWave functions to the Tx AMI_GetWave function. This BIRD utilizes
the AMI_GetWave argument "AMI_parameters_out" to accomplish this.

****************************************************************************
ANY OTHER BACKGROUND INFORMATION:
Background information is provided through numerous e-mails on the IBIS 
Backchannel Reflector (see freelists.org).  Also see presentations given by 
Walter Katz and Kumar Keshavan at the 2011 DesignCon IBIS Summit.

****************************************************************************