通过外部库定义天线方向图
你可以指定一个外部库,它会为给定的一对极角、方位角返回增益值。天线方向图编辑器会用这个库来填充增益表:对表中每个单元格调用一次该库的 _gain 函数。离散事件仿真会在需要某个特定方向上的天线增益时使用该库,以获得精确取值。
要指定外部库:
过程 32:指定外部库
-
必要时,在天线方向图编辑器中打开该天线方向图。
-
如果你尚未创建要使用的外部库,现在创建它(如构建天线方向图库所述)。
-
从下拉菜单中选择你的外部库。

-
如果该库使用初始化值,请在 “External library initialization value” 字段中输入它。
-
选中 “Obtained from an external library” 复选框。
由所命名库生成的天线方向图会取代当前方向图。增益表和所有视图都会更新。
天线方向图外部库定义
用于定义天线方向图的外部代码库由单个 C 或 C++ 文件构成,其中包含三个函数定义:
<lib_name>_open<lib_name>_gain<lib_name>_close
该库的源文件必须命名为 <lib_name>.ex.c(如果用 C++ 编写则为 .cpp),并保存在 mod_dirs 偏好设置所列的某个目录中。使用该源文件构建天线方向图模型中所指定的外部库(如构建天线方向图库所述)。
<lib_name>_open()
调用该函数的时机包括
- DES 在仿真开始时(首次计算接收机组之前)调用,以及在天线模块的 “pattern” 属性被修改时调用。
- GUI 在库与天线方向图编辑器中的某个天线方向图建立关联时调用。
_open 函数应当设置一个指向状态信息的指针,以便传递给库中的其他函数,同时还要设置方向图的视准轴与旋转手柄矢量。这些信息包含在 AntnT_Init_Info 结构中,该结构定义于 <install_dir>/sys/include/op_antn_gain.h。
图 73:<lib_name>_open 原型
VosT_Fun_Status
<lib_name>_open (AntnT_Init_Info * info_ptr);
<lib_name>_gain()
当需要增益值时,DES 或 GUI 会调用该函数。如果无法计算增益,该函数应返回 0.0。
图 74:<lib_name>_gain 原型
double
<lib_name>_gain (void * state_ptr,
double polar /* 0 … 180 */,
double azimuth /* 0 … 360 */,
void * extra_data_ptr /* arbitrary structure passed to call when using */
/* op_tbl_pat_gain_ext; VOSC_NIL otherwise */);
<lib_name>_close()
调用该函数的时机如下:
- DES 在仿真结束时调用,以及在与天线模块关联的方向图被另一个方向图替换时调用
- GUI 在库不再与天线方向图编辑器中的某个天线方向图关联时调用
图 75:<lib_name>_close 原型
VosT_Fun_Status
<lib_name>_close (void * state_ptr);
天线方向图外部库示例
#include "op_antn_gain.h"
static int global_var = 1234;
DLLEXPORT VosT_Fun_Status
my_test_gain_open (AntnT_Init_Info * info_ptr)
{
FIN (test_gain_open);
printf ("test_gain_open:\n");
printf ("called for pattern \"%s\"\n", info_ptr->antenna_pattern);
printf ("init string: \"%s\"\n", info_ptr->init_str);
#if defined (OPD_DES)
printf ("called for module %d\n", info_ptr->antenna_module);
#endif
info_ptr->boresight_azimuth = 0.0;
info_ptr->boresight_polar = 90.0;
info_ptr->use_rotation_handle = OPC_TRUE;
info_ptr->rotation_azimuth = 0.0;
info_ptr->rotation_polar = 0.0;
printf ("state pointer set to %p\n", &global_var);
info_ptr->returned_state_ptr = &global_var;
FRET (VOSC_SUCCESS);
}
DLLEXPORT double
my_test_gain_gain (void * state_ptr, double polar, double azimuth, void * extra_data_ptr)
{
double gain;
FIN (test_gain_gain);
/* way to look at things in GUI */
/* polar: 0 - 180, azimuth: 0 - 360 */
gain = (int)(polar) + ((int) azimuth / 1000.0);
FRET (gain);
}
DLLEXPORT VosT_Fun_Status
my_test_gain_close (void * state_ptr)
{
FIN (test_gain_close);
printf ("close proc\n");
FRET (VOSC_SUCCESS);
}
构建天线方向图库
使用本过程来构建可在天线方向图编辑器中用于指定天线方向图增益的共享对象库。需要两个库——一个供 GUI 使用(供增益表使用),另一个供离散事件仿真使用。
过程 33:构建天线方向图库
-
使用天线方向图外部库定义中给出的原型创建源文件。
-
打开 Riverbed 控制台,并进入包含该源文件的目录。
-
使用 op_mko 生成仿真和 GUI 目标文件。(关于该过程的详情,参见“op_mko”第 179 页。)例如,在 32 位 Windows 上可以使用以下命令:
op_mko -type ex -m <lib_name> -kernel_type development -m32 op_mko -type ex -m <lib_name> -gui -m32其中
<lib_name>是源文件名(不含扩展名)。会生成两个目标文件。本例将生成以下文件
<lib_name>.dev32.i0.ex.obj <lib_name>.gui32.i0.ex.obj -
使用 op_mkso 生成共享对象库。(关于该过程的详情,参见“op_mkso”第 185 页。)例如,在 32 位 Windows 上可以使用以下命令:
op_mkso -type antn -f <object_file> -m <lib_name> -m32 op_mkso -type antn -f <object_file> -m <lib_name> -gui -m32其中
<object_file>是第 3 步生成的目标文件的全名,<lib_name>是源文件名(不含扩展名)。会生成两个共享对象库。本例将生成以下文件
<lib_name>.dev32.i0.antn.dll <lib_name>.gui32.i0.antn.dll在天线方向图编辑器中,
<lib_name>会出现在可用外部库列表中。