ISSUE 568

Number 568
Category pending
Synopsis errat/398: 2nd try for proposal of vpi_handle_multi_index
State closed
Class mistaken
Arrival-DateMar 23 2004
Originator Francoise Martinolle <fm@cadence.com>
Release
Description
--=====================_1964064==_.ALT
Content-Type: text/plain; charset="us-ascii"; format=flowed

Rather than adding a new property, Charles proposed to annotate the VPI
diagrams with the vpi_handle_by_index and vpi_handle_by_multi_index
functions in the following fashion:
In diagram 26.6.2, under the Instance array class add:
-> instance array element
vpi_handle_by_index
vpi_handle_by_multi_index
In diagram 26.6.5, under the Ports class add:
-> port bit
vpi_handle_by_index
vpi_handle_by_multi_index
In diagram 26.6.6, under the Nets class add:
-> net bit
vpi_handle_by_index
vpi_handle_by_multi_index
In diagram 26.6.6 under the Net array class, add:
-> net array element
vpi_handle_by_index
vpi_handle_by_multi_index
In diagram 26.6.7, under the Regs class add:
-> reg bit
vpi_handle_by_index
vpi_handle_by_multi_index
In diagram 26.6.7 under the Reg array class, add:
-> reg array element
vpi_handle_by_index
vpi_handle_by_multi_index
In diagram 26.6.8 under the Variables class, add:
-> var select
vpi_handle_by_index
vpi_handle_by_multi_index
In diagram 26.6.9 (Memory diagram) under the regarray diagram
add:
-> memory work
vpi_handle_by_index
vpi_handle_by_multi_index

In diagram 26.6.11 under the Named Event Array class, add:
-> named event array element
vpi_handle_by_index
vpi_handle_by_multi_index

2. modify the vpi_handle_by_multi_index description as:
CHANGE synopsis section:
Obtain a handle to a sub object using an array of indexes and a parent object.
TO:
Obtain a handle to a sub object using an array of indices and a reference
object.
in the description of the argument num_index:
CHANGE:
number of indexes in the index array
TO:
number of indices in the index array
In the description of argument index_array
CHANGE:
array of indexes.
TO:
array of indices
In the table description, CHANGE:
Handle to an object of type vpiRegBit, vpiNetBit, vpiRegWord, or vpiNetWord
TO:
Handle to an object
CHANGE description:
The VPI routine vpi_handle_by_multi_index() shall return a handle to an
object based on the list of
indexes and parent object passed in. The argument num_index will contain
the number of indexes in the provided
array index_array. The order of the indexes provided, shall be for the left
most select first, progressing
to the right most select last. This function can be used to access all
objects whose property vpiMultiArray is
TRUE. This routine shall only provide access to a bit or word of the parent
object.
TO:
The VPI routine vpi_handle_by_multi_index() routine shall provide access to
an index selected sub object of the reference handle. This routine shall
return a handle to a valid Verilog
object based on the list of
indices provided by the argument index_array, and reference handle denoted
by obj. The argument num_index shall contain the number of indices in the
provided array index_array. The order of the indices provided, shall first
follow the array dimension declaration from the left most range and
progressing to the right ranges of the reference handle; the array indices
may be optionally followed by a bit select index. If the indices provided
do not lead to the construction of a legal Verilog index select expression,
the routine shall return a null handle.
--=====================_688299==_.ALT
Content-Type: text/html; charset="us-ascii"
Rather than adding a new property, Charles proposed to annotate the VPI
diagrams with the vpi_handle_by_index and vpi_handle_by_multi_index
functions in the following fashion:
In diagram 26.6.2, under the Instance array class add:
-> instance array element
vpi_handle_by_index
vpi_handle_by_multi_index

In diagram 26.6.5, under the Ports class add:
-> port bit
vpi_handle_by_index
vpi_handle_by_multi_index

In diagram 26.6.6, under the Nets class add:
-> net bit
vpi_handle_by_index
vpi_handle_by_multi_index
In diagram 26.6.6 under the Net array class, add:
-> net array element
vpi_handle_by_index
vpi_handle_by_multi_index

In diagram 26.6.7, under the Regs class add:
-> reg bit
vpi_handle_by_index
vpi_handle_by_multi_index
In diagram 26.6.7 under the Reg array class, add:
-> reg array element
vpi_handle_by_index
vpi_handle_by_multi_index

In diagram 26.6.8 under the Variables class, add:
-> var select
vpi_handle_by_index
vpi_handle_by_multi_index

In diagram 26.6.9 (Memory diagram) under the regarray diagram
add:
-> memory work
vpi_handle_by_index
vpi_handle_by_multi_index


In diagram 26.6.11 under the Named Event Array class, add:
-> named event array element
vpi_handle_by_index
vpi_handle_by_multi_index


2. modify the vpi_handle_by_multi_index description as:

CHANGE synopsis section:
Obtain a handle to a sub object using an array of indexes and a parent object.

TO:
Obtain a handle to a sub object using an array of indices and a reference
object.

in the description of the argument num_index:
CHANGE:
number of indexes in the index array
TO:
number of indices in the index array

In the description of argument index_array
CHANGE:
array of indexes.
TO:
array of indices

In the table description, CHANGE:
Handle to an object of type vpiRegBit, vpiNetBit, vpiRegWord, or vpiNetWord
TO:
Handle to an object

CHANGE description:
The VPI routine vpi_handle_by_multi_index() shall return a handle to an
object based on the list of
indexes and parent object passed in. The argument num_index will contain
the number of indexes in the provided
array index_array. The order of the indexes provided, shall be for the left
most select first, progressing
to the right most select last. This function can be used to access all
objects whose property vpiMultiArray is
TRUE. This routine shall only provide access to a bit or word of the parent
object.

TO:
The VPI routine vpi_handle_by_multi_index() routine shall provide access to
an index selected sub object of the reference handle. This routine shall
return a handle to a valid Verilog
object based on the list of
indices provided by the argument index_array, and reference handle denoted
by obj. The argument num_index shall contain the number of indices in the
provided array index_array. The order of the indices provided, shall first
follow the array dimension declaration from the left most range and
progressing to the right ranges of the reference handle; the array indices
may be optionally followed by a bit select index. If the indices provided
do not lead to the construction of a legal Verilog index select expression,
the routine shall return a null handle.


--=====================_1964064==_.ALT
Content-Type: text/html; charset="us-ascii"


Rather than adding a new property, Charles proposed to annotate the VPI


diagrams with the vpi_handle_by_index and vpi_handle_by_multi_index


functions in the following fashion:

In diagram 26.6.2, under the Instance array class add:

-> instance array element

vpi_handle_by_index

vpi_handle_by_multi_index

In diagram 26.6.5, under the Ports class add:

-> port bit

vpi_handle_by_index

vpi_handle_by_multi_index

In diagram 26.6.6, under the Nets class add:

-> net bit

vpi_handle_by_index

vpi_handle_by_multi_index

In diagram 26.6.6 under the Net array class, add:

-> net array element

vpi_handle_by_index

vpi_handle_by_multi_index

In diagram 26.6.7, under the Regs class add:

-> reg bit

vpi_handle_by_index

vpi_handle_by_multi_index

In diagram 26.6.7 under the Reg array class, add:

-> reg array element

vpi_handle_by_index

vpi_handle_by_multi_index

In diagram 26.6.8 under the Variables class, add:

-> var select

vpi_handle_by_index

vpi_handle_by_multi_index

In diagram 26.6.9 (Memory diagram) under the regarray diagram

add:

-> memory work

vpi_handle_by_index

vpi_handle_by_multi_index



In diagram 26.6.11 under the Named Event Array class, add:

-> named event array element

vpi_handle_by_index

vpi_handle_by_multi_index



2. modify the vpi_handle_by_multi_index description as:

CHANGE synopsis section:

Obtain a handle to a sub object using an array of indexes and a parent
object.

TO:

Obtain a handle to a sub object using an array of indices and a reference


object.

in the description of the argument num_index:

CHANGE:

number of indexes in the index array

TO:

number of indices in the index array

In the description of argument index_array

CHANGE:

array of indexes.

TO:

array of indices

In the table description, CHANGE:

Handle to an object of type vpiRegBit, vpiNetBit, vpiRegWord, or
vpiNetWord

TO:

Handle to an object

CHANGE description:

The VPI routine vpi_handle_by_multi_index() shall return a handle to an


object based on the list of

indexes and parent object passed in. The argument num_index will contain


the number of indexes in the provided

array index_array. The order of the indexes provided, shall be for the
left

most select first, progressing

to the right most select last. This function can be used to access all


objects whose property vpiMultiArray is

TRUE. This routine shall only provide access to a bit or word of the
parent

object.

TO:

The VPI routine vpi_handle_by_multi_index() routine shall provide access
to

an index selected sub object of the reference handle. This routine shall


return a handle to a valid Verilog

object based on the list of

indices provided by the argument index_array, and reference handle
denoted

by obj. The argument num_index shall contain the number of indices in the


provided array index_array. The order of the indices provided, shall
first

follow the array dimension declaration from the left most range and


progressing to the right ranges of the reference handle; the array
indices

may be optionally followed by a bit select index. If the indices provided


do not lead to the construction of a legal Verilog index select
expression,

the routine shall return a null handle.

--=====================_688299==_.ALT

Content-Type: text/html; charset="us-ascii"

Rather than adding a new property, Charles proposed to annotate the VPI
diagrams with the vpi_handle_by_index and vpi_handle_by_multi_index
functions in the following fashion:

In diagram 26.6.2, under the Instance array class add:

-> instance array element

vpi_handle_by_index

vpi_handle_by_multi_index



In diagram 26.6.5, under the Ports class add:

-> port bit

vpi_handle_by_index

vpi_handle_by_multi_index



In diagram 26.6.6, under the Nets class add:

-> net bit

vpi_handle_by_index

vpi_handle_by_multi_index

In diagram 26.6.6 under the Net array class, add:

-> net array element

vpi_handle_by_index

vpi_handle_by_multi_index



In diagram 26.6.7, under the Regs class add:

-> reg bit

vpi_handle_by_index

vpi_handle_by_multi_index

In diagram 26.6.7 under the Reg array class, add:

-> reg array element

vpi_handle_by_index

vpi_handle_by_multi_index



In diagram 26.6.8 under the Variables class, add:

-> var select

vpi_handle_by_index

vpi_handle_by_multi_index



In diagram 26.6.9 (Memory diagram) under the regarray diagram

add:

-> memory work

vpi_handle_by_index

vpi_handle_by_multi_index





In diagram 26.6.11 under the Named Event Array class, add:

-> named event array element

vpi_handle_by_index

vpi_handle_by_multi_index





2. modify the vpi_handle_by_multi_index description as:



CHANGE synopsis section:

Obtain a handle to a sub object using an array of indexes and a parent
object.



TO:

Obtain a handle to a sub object using an array of indices and a reference


object.



in the description of the argument num_index:

CHANGE:

number of indexes in the index array

TO:

number of indices in the index array



In the description of argument index_array

CHANGE:

array of indexes.

TO:

array of indices



In the table description, CHANGE:

Handle to an object of type vpiRegBit, vpiNetBit, vpiRegWord, or
vpiNetWord

TO:

Handle to an object



CHANGE description:

The VPI routine vpi_handle_by_multi_index() shall return a handle to an


object based on the list of

indexes and parent object passed in. The argument num_index will contain


the number of indexes in the provided

array index_array. The order of the indexes provided, shall be for the
left

most select first, progressing

to the right most select last. This function can be used to access all


objects whose property vpiMultiArray is

TRUE. This routine shall only provide access to a bit or word of the
parent

object.



TO:

The VPI routine vpi_handle_by_multi_index() routine shall provide access
to an index selected sub object of the reference handle. This routine
shall return a handle to a valid Verilog

object based on the list of

indices provided by the argument index_array, and reference handle
denoted

by obj. The argument num_index shall contain the number of indices in the


provided array index_array. The order of the indices provided, shall
first follow the array dimension declaration from the left most range and
progressing to the right ranges of the reference handle; the array
indices may be optionally followed by a bit select index. If the indices
provided do not lead to the construction of a legal Verilog index select
expression, the routine shall return a null handle.





--=====================_1964064==_.ALT--

Fix
accidental submission


Hosted by Boyd Technology