op_radio_txch_rxgroup_compute()
注意: 需要 Wireless 功能
摘要
通过对可能的接收信道集合进行过滤,计算发射机信道的接收机组。
语法
op_radio_txch_rxgroup_compute (txch_objid, rxgroup_proc)
| 参数 | 类型 | 说明 |
|---|---|---|
txch_objid |
Objid |
正在计算(或重新计算)接收机组的发射机信道的对象 ID。如果该对象 ID 为 OPC_OBJID_UNIVERSAL,则仿真中所有发射机信道的接收机组都会被重新计算。 |
rxgroup_proc |
Txch_Rxgroup_Proc |
针对发射机/接收信道对象 ID 对调用的函数,用于决定接收机是否应属于该发射机信道的接收机组。如果该函数为 OPC_TXCH_RXGROUP_PS,则使用该发射机的接收机组流水线阶段。 |
返回类型
Compcode
完成代码,指示重新计算接收机组是否成功。若接收机组被成功重新计算,该过程返回 OPC_COMPCODE_SUCCESS;否则返回 OPC_COMPCODE_FAILURE。
示例
static int
check_rxch (Objid txch, Objid rxch)
{
/* Okay if not part of the same node */
return (op_topo_parent (op_topo_parent (txch))!=
op_topo_parent (op_topo_parent (rxch)))
}
static void
reset_txch_rxgroup (Objid txch)
{
op_radio_txch_rxgroup_compute (txch, check_rxch);
}
详情
如果不是设置为 OPC_TXCH_RXGROUP_PS,rxgroup_proc 应当是一个接受两个参数的函数(第一个和第二个参数分别为发射机信道和接收信道的对象 ID),并返回 OPC_TRUE 或 OPC_FALSE。
为计算发射机的接收机组,该内核过程会遍历仿真中的全部接收信道。对每个接收信道,应用程序都会以发射机和接收机的对象 ID 调用滤波器过程(如果 rxgroup_proc 为 OPC_TXCH_RXGROUP_PS,则调用该发射机的 rxgroup 流水线阶段)。如果滤波器返回 OPC_TRUE,则该接收机将被包含在接收机组中。
如果发射机信道 ID 为 OPC_OBJID_UNIVERSAL,则仿真中所有发射机信道的接收机组都将使用指定的过程或各发射机对应的 rxgroup 流水线阶段重新计算。
rxgroup 流水线阶段可以通过调用 op_sim_time() 来判断它是由该内核过程调用的(而不是在仿真开始时调用的)。内核过程 op_sim_time() 在 rxgroup 流水线阶段首次调用期间返回 -1,该首次调用发生在 begin sim 中断之前。由 op_radio_txch_rxgroup_compute() 后续调用 rxgroup 流水线阶段时,仿真时间将大于或等于 0。
用途
提供一种使用滤波器过程测试所有可能的接收机来计算发射机接收机组的机制。
错误
- 可恢复错误:对象 ID (
<objid>) 不是发射机信道。 - 可恢复错误:发射机对象 ID (
<objid>) 指向受限对象。 - 可恢复错误:内部内存分配错误,接收机组未改变。
- 程序中止:段违例。(由于无效的函数指针)
参考
- 使用内核过程 op_radio_txch_rxgroup_get() 可获取当前的接收机组
- 使用内核过程 op_radio_txch_rxgroup_set() 可将接收机组设置为给定的对象 ID 数组
- 使用内核过程 op_radio_txch_rxch_add() 可向发射机信道的组添加一个接收信道
- 使用内核过程 op_radio_txch_rxch_remove() 可从发射机信道的组中移除一个接收信道