ISSUE 518

Number 518
Notify-List
Category errata
Synopsis 26.6.40 no discussion of how vpi_get_time() and vpiTimeQueue works
State lrmdraft
Class errata-ptf
Arrival-DateDec 15 2003
Originator Debi Dalio
Release
Environment
Description
Entered by Charles Dawson on behalf of Debi Dalio. Her
original email:

Is there any equivalent VPI function that gives me the time
of the next scheduled event like the PLI TF-function
tf_getnextlongtime?

I think that the diagram in section 26.6.40 implies that
you get a handle to a vpiTimeQueue object and then call
vpi_get_time() on it, but it doesn't actually describe this
functionality anywhere that I can see. In fact, the
description of vpi_get_time() talks only about getting the
current simulation time using the time scale of the object.

Am I correctly interpreting the time queue diagram? If so,
I think there should be a description somewhere of what
vpi_get_time() is supposed to do with this type of object.
Fix
I propose the following change to the description of 27.12 vpi_get_time()

FROM:

The VPI routine vpi_get_time() shall retrieve the current
simulation time, using the time scale of the object. If obj
is NULL, the simulation time is retrieved using the simulation
time unit. The time_p->type ...

TO:

The VPI routine vpi_get_time() shall retrieve the current
simulation time, using the time scale of the object. If obj
is NULL, the current simulation time is retrieved using the
simulation time unit. If obj is a time queue object, the
scheduled time of the future event is retrieved using the
simulation time unit. The time_p->type ...
Audit-Trail
From: "Garnett, Jim" <jimg@model.com>
To: ptf-bugs@boyd.com
Cc:
Subject: errata/518: PROPOSAL - Modifying vpi_get_time description
Date: Tue, 04 May 2004 09:48:18 -0700

There was a question as to whether vpi_get_time would return the
time of a scheduled event if provided with an object of type
vpiTimeQueue. The answer is yes, and the LRM currently describes
this in section 26.4 Table 210 where it describes vpi_get_time as
follows:

Find the current simulation time or the scheduled time
of future events

The vpi_get_time description does not include any reference to what
is returned when the 'obj' is a time queue object. Thus, I propose the
following change in the description.

FROM:

The VPI routine vpi_get_time() shall retrieve the current simulation
time,
using the time scale of the object. If obj is NULL, the simulation
time is
retrieved using the simulation time unit. The time_p->type ...

TO:

The VPI routine vpi_get_time() shall retrieve the current simulation
time,
using the time scale of the object. If obj is NULL, the current
simulation
time is retrieved using the simulation time unit. If obj is a time queue
object, the scheduled time of the future event is retrieved using the
simulation time unit. The time_p->type ...

Regards,

Jim Garnett


Fix replaced by jimg@model.com on Mon Jun 14 10:21:10 2004
I propose the following change to the description of 27.12 vpi_get_time()

FROM:

The VPI routine vpi_get_time() shall retrieve the current
simulation time, using the time scale of the object. If obj
is NULL, the simulation time is retrieved using the simulation
time unit. The time_p->type ...

TO:

The VPI routine vpi_get_time() shall retrieve the current
simulation time, using the time scale of the object. If obj
is NULL, the current simulation time is retrieved using the
simulation time unit. If obj is a time queue object, the
scheduled time of the future event is retrieved using the
simulation time unit. The time_p->type ...


Unformatted


Hosted by Boyd Technology