定义无线域模型
本节介绍用于定义构成无线域模型的各个代码块的操作。
注意: 这些操作都使用 editor_prog 首选项所指定的编辑器(内置编辑区是默认编辑器)。
要查看各个代码块和回调的示例,可以查看 Modeler 自带的某个无线域模型(选择 File > Open > Wireless Domain Model)。
Auxiliary 回调
Code Blocks > Auxiliary Callback 操作打开一个编辑区,你可以在其中定义无线域模型的 Auxiliary 回调代码。该回调可以通过内核过程 op_radio_wireless_domain_aux_proc_call() 调用,以从无线域的状态信息中访问指定数据。
该回调的原型见 <auxproc_callback>。
函数块
Code Blocks > Function block 操作打开一个编辑区,你可以在其中定义无线域模型的函数块代码。函数块包含各回调所使用的函数。这些函数专门针对无线域模型所使用的数据结构。
头块
Code Blocks > Header Block 操作打开一个编辑区,你可以在其中定义无线域模型的头块代码。头块包含模型的头部信息,例如类型定义、变量定义和函数原型。
Info Get 回调
Code Blocks > Auxiliary Callback 操作打开一个编辑区,你可以在其中定义无线域模型的 Info Get 回调代码。仿真内核使用 Info Get 回调,针对指定的一对簇从无线域缓存中获取信息。这些信息可以是缓存中通常保存的各个值(闭合、信道匹配、传播时延和路径损耗)中的任意项或全部。
该回调的原型见 <info_get_callback>。
Info Set 回调
Code Blocks > Info_Set 操作打开一个编辑区,你可以在其中定义无线域模型的 Info Set 回调代码。仿真内核使用 Info Set 回调,将针对指定一对簇的管道阶段计算结果放入无线域缓存。
该回调的原型见 <info_set_callback>。
Init 回调
Code Blocks > Init Callback 操作打开一个编辑区,你可以在其中定义无线域模型的 Init 回调代码。仿真内核使用 Init 回调来实例化一个无线域。通常,该回调完成以下事情:
- 为无线域缓存定义数据结构
- 将无线域区域内每个信道的无线域属性设置为该无线域的 ID
- 返回一个状态指针,用于存放关于该无线域的用户自定义信息
该回调的原型见 <init_callback>。
Member 回调
Code Blocks > Member Callback 操作打开一个编辑区,你可以在其中定义无线域模型的 Member 回调代码。仿真内核使用 Member 回调来确定某个信道是否属于某个特定的无线域。
该回调的原型见 <member_callback>。