动画管道
基础设施
Riverbed 分析软件通过提供一个独立的框架,将数据包传输管道的建模部分与动画部分解耦,该框架基于 TDA 值将动画回调与基于无线通信的各个阶段相关联。这确保同一动画可以用于各种管道阶段模型。
通信动画通过进程模型代码指定的一组回调来定义。一个仿真中可以有多个这样的动画。
数据结构
仿真内核维护一组与无线模块以及与被探测节点关联的通信的数据结构。这些结构是不透明的,但它们包含一个模型特定的状态组件,由适当的回调来定义和分配。关于用于访问这些对象的过程的信息,参见通信子包。
表 7:无线对象的数据结构
| 数据结构 | 说明 |
|---|---|
OvisT_Transmitter |
与映射站点的发射机信道关联。单个信道可以有多个关联的 OvisT_Transmitter 对象,对应不同的动画。 |
OvisT_Receiver |
如果映射站点的某个接收机信道是映射发射机接收机组的一部分(或通过有线链路连接到映射发射机),则与该接收机信道关联。 |
OvisT_Transmission |
表示发射机与一组接收机之间的数据包传输。内核在每个 Ovis 发射机开始传输时创建该对象,并在所有接收完成后销毁。 |
OvisT_Reception |
表示潜在的数据包接收。内核为每个 Ovis 传输对象和接收节点上的每个 Ovis 接收机对象创建该对象,并在接收结束后由内核销毁。 **注:**对于点对点通信, OvisT_Reception 的数量与传输数量相同。 |
回调
在下文中,X_ 表示 3 种通信介质对应的 radio_、bus_ 或 link_。这意味着可以定义三个不同的入口点。
状态管理
各种 _destroy 回调将在仿真结束时被调用,以便清理动画空间。
发射机
OvisT_Transmitter 数据结构由 API Ovis_Wireless_Transmitter_Animation_Enable()、Ovis_Bus_Transmitter_Animation_Enable() 或 Ovis_Ptpt_Link_Transmitter_Animation_Enable() 动态创建并与发射机信道关联。使用哪个 API 取决于发射机信道类型。作为此类调用的结果,具有指定的一组传输事件处理回调的 OvisT_Transmitter 数据结构只会为属于映射到 Ovis 实体的节点的信道创建。注意,每个发射机信道对象可能关联多个具有不同回调集的 OvisT_Transmitter 结构。
表 8:发射机回调
| 回调 | 参考 |
|---|---|
X_transmitter_init |
OvisT_Anim_Transmitter_Init_Proc |
X_transmitter_destroy |
OvisT_Anim_Transmitter_Destroy_Proc |
接收机
仿真内核自动创建 OvisT_Receiver 数据结构。内核将接收机信道对象添加到具有以下条件之一的收发信机接收组(或通过有线链路连接到发射机的接收机):
- 收发信机具有关联的
OvisT_Transmitter数据条目。 - 具有一个与接收机信道关联的
OvisT_Receiver的条目。该特定的接收机信道为与发射机信道关联的每个OvisT_Transmitter创建。
对于给定的传输回调集,只创建一个 OvisT_Receiver 实例;如果接收机信道属于多个发射机的接收组,则共享同一个 OvisT_Receiver 结构。
表 9:接收机回调
| 回调 | 参考 |
|---|---|
X_receiver_init |
OvisT_Anim_Receiver_Init_Proc |
X_receiver_destroy |
OvisT_Anim_Receiver_Destroy_Proc |
传输
当映射对象中的发射机发起传输时,内核创建 OvisT_Transmission 数据结构。
该结构在所有关联的接收被销毁之后销毁。
表 10:传输回调
| 回调 | 参考 |
|---|---|
X_transmission_init(在任何传输开始事件的 PS 调用之前被调用) |
OvisT_Anim_Transmission_Init_Proc |
X_transmission_destroy(在所有关联接收被接收之后被调用) |
OvisT_Anim_Transmission_Destroy_Proc |
接收
OvisT_Reception 数据结构由内核在发射机/接收机对的链路闭合管道阶段之前创建。一旦接收完成(无论成功与否),该结构即被销毁。这种创建/销毁回调的组合允许对失败的传输进行动画,对于这些传输,传输开始和结束可能永远不会被调用。
表 11:接收回调
| 回调 | 参考 |
|---|---|
X_reception_init(在开始传输的任何接收机相关 PS 调用之前被调用) |
OvisT_Anim_Reception_Init_Proc |
X_reception_destroy(在接收完成之后被调用) |
OvisT_Anim_Reception_Destroy_Proc |
通信步骤
接收机组
接收机组在无线发射机的 post-init 阶段创建。之后它可以被各种 KP 修改。
表 12:接收机组回调
| 回调 | 参考 |
|---|---|
wireless_rxgroup_preset |
在使用 op_radio_txch_rxgroup_set() 或 op_radio_txch_rxgroup_compute() 将接收机组设置为一个集合之前被调用 参见 OvisT_Anim_Wireless_Rxgroup_Pre_Set_Proc |
wireless_rxgroup_postset |
在 postinit 期间或使用 op_radio_txch_rxgroup_set() 或 op_radio_txch_rxgroup_compute() 将接收机组设置为新集合之后被调用 参见 OvisT_Anim_Wireless_Rxgroup_Post_Set_Proc |
wireless_rxgroup_increase |
在 op_radio_txch_rxch_add() 之后被调用 参见 OvisT_Anim_Wireless_Rxgroup_Increase_Proc |
wireless_rxgroup_decrease |
在 op_radio_txch_rxch_remove() 之后被调用 参见 OvisT_Anim_Wireless_Rxgroup_Decrease_Proc |
开始传输
这对应于开始传输事件的各种阶段。
表 13:开始传输回调
| 回调 | 参考 |
|---|---|
X_transmission_start |
在 txdel 管道阶段之后被调用 参见 OvisT_Anim_Transmission_Start_Proc |
radio_broadcast, bus_broadcast |
在所有接收机相关的管道阶段调用之后被调用 参见 OvisT_Anim_Bus_Broadcast_Proc 和 OvisT_Anim_Wireless_Broadcast_Proc |
结束传输
这在执行结束传输事件时被调用(开始传输后 txdel 秒)。
表 14:结束传输回调
| 回调 | 参考 |
|---|---|
X_transmission_end |
OvisT_Anim_Transmission_End_Proc |
开始接收
这对应于开始接收事件的各种阶段。
表 15:开始接收回调
| 回调 | 参考 |
|---|---|
X_reception_start |
在开始接收事件中的所有 PS 调用之后被调用 参见 OvisT_Anim_Reception_Start_Proc |
结束接收
这与特定的接收相关。一些干扰回调也参与其中(ber、snr、error)。
表 16:结束接收回调
| 回调 | 参考 |
|---|---|
X_reception_end |
在结束接收事件中的所有 PS 调用之后被调用 参见 OvisT_Anim_Reception_End_Proc |
执行序列
点对点链路
开始传输事件:
link_transmission_init()- Txdel 管道阶段
link_transmission_start()link_reception_init()- Propdel 管道阶段
结束传输事件:
link_transmission_end()
**注:**传输对象在接收结束之前不会被销毁。
开始接收事件:
link_reception_start()
结束接收事件:
- Error Ecc 管道阶段
link_reception_end()link_reception_destroy (<End_Success> 或 <End_Failure>)link_transmission_destroy()
无线
开始传输事件:
wireless_transmission_init()- Txdel 管道阶段
wireless_transmission_start()- 对于接收机组中的所有接收机:
- 复制源数据包
wireless_reception_init()- Closure 管道阶段
- 如果失败,
wireless_reception_destroy(Closure) - 否则
- Chanmatch 管道状态
- 如果失败,
wireless_reception_destroy(Chanmatch) - 否则
- Txgain、Propdel 管道阶段
wireless_broadcast()
结束传输事件:wireless_transmission_end
**注:**传输对象在所有接收结束之前不会被销毁。
开始接收事件:
- Rxdel、Power 管道阶段
- 如果数据包在 power 阶段被拒绝:
wireless_reception_destroy(Power)
- 否则
- Inoise、Bgnoise、SNR 管道阶段
wireless_reception_start()
- 如果数据包在 power 阶段被拒绝:
结束接收事件:
- BER、Error、Ecc 管道阶段
wireless_reception_end()wireless_reception_destroy(End_Success 或 End_Failure)
所有接收结束后:wireless_transmission_destroy()
总线
开始传输事件:
bus_transmission_init()- Txdel 管道阶段
bus_transmission_start()- 对于附着在总线上的所有接收机:
- 复制源数据包
bus_reception_init()- Closure 管道阶段
- 如果接收机拒绝
bus_reception_destroy(Closure)
- 否则
- Propdel 管道阶段
- 如果接收机拒绝
bus_broadcast()
结束传输事件:bus_transmission_end()
**注:**传输对象在所有接收结束之前不会被销毁。
开始接收事件:
- collision 管道状态
bus_reception_start()
结束接收事件:
- Error 和 Ecc 管道阶段
bus_reception_end()bus_reception_destroy(End_Success 或 End_Failure)
所有接收结束后:
bus_transmission_destroy()
图 8:无线传输期间的回调调用:示例
