[source]

Class uvm_pkg::uvm_tlm_if_base

uvm_pkg::uvm_tlm_if_base <T1, T2> + can_get(): bit + can_peek(): bit + can_put(): bit + get() + nb_transport(): bit + peek() + put() + transport() + try_get(): bit + try_peek(): bit + try_put(): bit + write(): void

Inheritance Diagram of uvm_tlm_if_base

CLASS

uvm_tlm_if_base #(T1,T2)

This class declares all of the methods of the TLM API.

Various subsets of these methods are combined to form primitive TLM interfaces, which are then paired in various ways to form more abstract "combination" TLM interfaces. Components that require a particular interface use ports to convey that requirement. Components that provide a particular interface use exports to convey its availability.

Communication between components is established by connecting ports to compatible exports, much like connecting module signal-level output ports to compatible input ports. The difference is that UVM ports and exports bind interfaces (groups of methods), not signals and wires. The methods of the interfaces so bound pass data as whole transactions (e.g. objects). The set of primitive and combination TLM interfaces afford many choices for designing components that communicate at the transaction level.

Parameters

Name

Default value

Description

T1

int

T2

int

Functions

try_put(int t)

Function

try_put

Sends a transaction of type T, if possible.

If the component is ready to accept the transaction argument, then it does so and returns 1, otherwise it returns 0.

Parameters:

t (int)

can_put()

Function

can_put

Returns 1 if the component is ready to accept the transaction; 0 otherwise.

try_get(int t)

Function

try_get

Provides a new transaction of type T.

If a transaction is immediately available, then it is written to the output argument and 1 is returned. Otherwise, the output argument is not modified and 0 is returned.

Parameters:

t (int)

can_get()

Function

can_get

Returns 1 if a new transaction can be provided immediately upon request, 0 otherwise.

try_peek(int t)

Function

try_peek

Provides a new transaction without consuming it.

If available, a transaction is written to the output argument and 1 is returned. A subsequent peek or get will return the same transaction. If a transaction is not available, then the argument is unmodified and 0 is returned.

Parameters:

t (int)

can_peek()

Function

can_peek

Returns 1 if a new transaction is available; 0 otherwise.

nb_transport(int req, int rsp)

Task

nb_transport

Executes the given request and returns the response in the given output argument. Completion of this operation must occur without blocking.

If for any reason the operation could not be executed immediately, then a 0 must be returned; otherwise 1.

Parameters:
  • req (int)

  • rsp (int)

write(int t)

Function

write

Broadcasts a user-defined transaction of type T to any number of listeners. The operation must complete without blocking.

Parameters:

t (int)

Tasks

put(int t)

Task

put

Sends a user-defined transaction of type T.

Components implementing the put method will block the calling thread if it cannot immediately accept delivery of the transaction.

Parameters:

t (int)

get(int t)

Task

get

Provides a new transaction of type T.

The calling thread is blocked if the requested transaction cannot be provided immediately. The new transaction is returned in the provided output argument.

The implementation of get must regard the transaction as consumed. Subsequent calls to get must return a different transaction instance.

Parameters:

t (int)

peek(int t)

Task

peek

Obtain a new transaction without consuming it.

If a transaction is available, then it is written to the provided output argument. If a transaction is not available, then the calling thread is blocked until one is available.

The returned transaction is not consumed. A subsequent peek or get will return the same transaction.

Parameters:

t (int)

transport(int req, int rsp)

Task

transport

Executes the given request and returns the response in the given output argument. The calling thread may block until the operation is complete.

Parameters:
  • req (int)

  • rsp (int)