Package Overview

The Td (Transmission Data) package is a collection of Kernel Procedures used to operate upon the values of Transceiver Pipeline Data Attributes (TDAs) of a packet. TDAs provide a mechanism to communicate information between the Simulation Kernel and the externally defined procedures that implement a communication link’s model. These procedures are known as pipeline stages. See Chapter 9 “Communication Mechanisms” on page 337 for more information about the operation of the Transceiver Pipeline.

Each packet transferred over a link traverses a series of pipeline stages (the number of stages depends upon the type of link) as it passes from its transmitter to a receiver in a remote node. The calculations and decisions performed in each stage for a given packet can rely upon information provided by the Simulation Kernel as well as data inserted into the packet by earlier pipeline stages. Conversely, each stage places the results of its computations into the packet for the benefit of later stages and possibly also for interpretation by the Simulation Kernel. All such information is carried within the TDAs of the packet.

To assign values to TDAs, pipeline stages can use the KPs op_td_set_int(), op_td_set_int64(), op_td_set_dbl(), and op_td_set_ptr(). These are applicable to fields of type integer (32- and 64-bit), double, and pointer, respectively. When extracting values from TDAs, pipeline stages and process models can use the parallel set of KPs op_td_get_int(), op_td_get_int64(), op_td_get_dbl(), and op_td_get_ptr(). These KPs are used to obtain integer (32- and 64-bit), double, and pointer values, respectively. To change a TDA value quickly, use op_td_increment_int(), op_td_increment_int64(), and op_td_increment_dbl(). Finally, the KP op_td_is_set() determines whether a TDA currently has an assignment.