Default Link Closure Model (dbu_closure)
This section describes the functionality and implementation of the default model occupying stage one of the Bus Link Transceiver Pipeline. This model is named dbu_closure. Source code is provided in the file dbu_closure.ps.c, which resides in the <reldir>/models/std/links directory.
Invocation Context
Whenever a bus transmitter initiates a transmission, closure is computed independently for each bus receiver which is attached to the bus. The Closure Model is invoked by the Simulation Kernel to compute this upon completion of the Transmission Delay Model of the pipeline. The simulation time at invocation is the starting time of the packet transmission. Closure represents the ability of the bus transmitter of interest to reach a specific bus receiver. Therefore, if the closure stage fails—that is, indicates that there is no closure—the remaining pipeline stages are not invoked for the transmitter-receiver pair.
The result of the Closure Model invocation for each packet is one integer value that is interpreted as a Boolean representing the closure between the transmitter and receiver. A value of OPC_TRUE indicates that the transmitter is able to reach the receiver, while a value of OPC_FALSE indicates to the Simulation Kernel that no communication is possible. The Simulation Kernel expects this result to be placed in the packet's OPC_TDA_BU_CLOSURE transmission data attribute.
Closure Assumption
For most situations, bus links provide full connectivity to all transceivers attached to them. Therefore, the closure stage is most often designed to not impose restrictions on the transmitter-receiver pairs that can communicate. This is the functionality provided by the default model, dbu_closure, which in all cases returns a value of OPC_TRUE for closure. The source code for dbu_closure is shown in the following figure.
Figure 4: Source Code for Pipeline Procedure dbu_closure
/* dbu_closure.ps.c */
/* Default link closure model for bus link Transceiver Pipeline */
/**********************************/
/* Copyright (c) 2013 */
/* Riverbed Technology, Inc. */
/* All Rights Reserved. */
/**********************************/
#include "opnet.h"
#if defined (__cplusplus)
extern "C"
#endif
void
dbu_closure (Packet * pkptr)
{
/** For bus links the default closure model assumes **/
/** all stations on the bus can reach all others. **/
FIN (dbu_closure (pkptr));
/* Place closure status in packet transmission data block. */
op_td_set_int (pkptr, OPC_TDA_BU_CLOSURE, OPC_TRUE);
FOUT
}