OMnet++ 初学者教程 第一节 入门
第1部分-入门
1.1模型
首先，让我们从一个包含两个节点的“network”开始。节点将做一些简单的事情：一个是节点将创建一个数据包，而两个节点将继续来回传递相同的数据包。我们将节点称为tic和toc。稍后，我们将逐步改进此模型，并在每个步骤中引入OMNeT ++功能。
这是您从头开始实施首次仿真所采取的步骤。
1.2设置项目
通过输入omnetpp终端来启动OMNeT ++ IDE 。（我们假设您已经安装了有效的OMNeT ++。如果没有，请安装最新版本，并根据需要咨询_安装指南_。）进入IDE后，从菜单中选择“新建”->“ OMNeT ++项目”。
将出现一个向导对话框。输入tictoc作为项目名称，在询问有关_项目_的初始内容时选择“_Empty _Project”，然后单击“完成”。你将在_Project Explorer中_看到一个空项目。（注意：某些OMNeT ++版本会package.ned在项目中生成文件。我们现在不需要它：通过选择文件并单击Delete删除文件。）
该项目将保存属于我们模拟的所有文件。在我们的示例中，项目由一个目录组成。对于较大的模拟，通常将项目的内容分类到src/和simulations/文件夹中，并一般将其放在这两个子文件夹下。
Note 注意！
使用IDE完全是可选的。命令行也上可以使用OMNeT ++的几乎所有功能（某些图形密集型和交互式功能（如序列图浏览和结果绘图）除外）。可以使用任何文本编辑器来编辑模型源文件，并且OMNeT ++提供了用于特殊任务的命令行工具，例如生成文件，将消息文件转换为C ++，结果文件查询和数据导出等。要在没有IDE的情况下继续操作，只需创建一个目录，然后使用您喜欢的文本编辑器在其中创建以下NED，C ++和ini文件。
1.3添加NED文件¶
OMNeT ++使用NED文件来定义组件并将它们组装成更大的单元，例如网络。我们开始通过添加NED文件来实现我们的模型。要将文件添加到项目中，请在左侧的_项目资源管理器_面板中右键单击项目目录 ，然后 从菜单中选择_NEW->网络描述文件Network Description File（NED 网络描述文件）_。提示您输入文件名时输入tictoc1.ned。
创建文件后，可以在OMNeT ++ IDE的“_编辑器”区域_中编辑该文件。OMNeT ++ IDE的NED编辑器有两种模式：“_Design”_和“Source”。您可以使用编辑器底部的标签在它们之间切换。在Design 模式下，可以使用鼠标和右侧的调色板以图形方式编辑拓扑。在_Source模式(源代码模式)_下，可以直接编辑NED源代码文本。在其中一种模式下所做的更改将立即反映在另一种模式下，因此您可以在编辑期间自由地在两种模式之间切换，并选择在更方便的任何一种模式下进行更改。（NED文件是纯文本文件，因此您甚至可以使用外部文本编辑器来编辑它们，尽管您会错过语法高亮显示，内容辅助，交叉引用和其他IDE功能。（那就不用外部编辑器呗！））
切换到“_Source”_模式，然后输入以下内容
simple Txc1
{// 定义一个简单模块
gates:
input in;
output out;
}
//
// Txc1的两个实例（tic和toc）双向连接
// Tic 和 toc 会互相发送信息
//
network Tictoc1
{//定义一个网络模块
submodules:
//网络模块由两个子模块组成吗，子模块的两个组成部分tic，toc
tic: Txc1;
toc: Txc1;
connections:
// 子模块之间的连接，但相箭头表示单向链接，{}中间定义连接的传输延时是100ms
tic.out --> { delay = 100ms; } --> toc.in;
tic.in <-- { delay = 100ms; } <-- toc.out;
}
完成后，切换回_Design_模式。您应该会看到类似以下内容的内容：
文件中的第一个块声明Txc1为简单模块类型。简单模块在NED级别上是原子的(最小模块，不可被拆分了)。它们也是活动组件（意思是组成其他大模块的组件），其行为是用C++实现的。该声明还说 Txc1有一个名为输入的门in和一个名为的输出门out。
第二个块声明Tictoc1作为network(网络)。Tictoc1是由两个子模块组装而成的，并且这两个子模块tic,``toc都是Txc1的实例， tic的输出门(gate)连接到toc的输入门(gate)，反之亦然。两种方式都有100ms的传播延迟。
笔记
您可以在《OMNeT ++仿真手册》中找到有关NED语言的详细说明 。（也可以在doc OMNeT ++安装目录中找到该手册。）
1.4添加C ++文件
现在，我们需要在C ++中实现Txc1简单模块的功能。txc1.cc通过从项目的上下文菜单中选择“新建”->“源文件”（或从IDE主菜单中选择“_File”->“New”->“File ”）_来创建一个文件名（指定文件夹创建文件，注意填写后缀，不然默认创建.h文件），然后输入以下内容：
#include <string.h>
#include <omnetpp.h>
using namespace omnetpp;
/**
* 类Txc1继承cSimpleModule,在Tictoc1 网络结构中，tic和toc斗士Txc1类的实例，
* 他们在仿真程序开始运行的时候就会被创建
*/
class Txc1 : public cSimpleModule
{
protected:
// The following redefined virtual function holds the algorithm.
virtual void initialize() override;
virtual void handleMessage(cMessage *msg) override;
};
// The module class needs to be registered with OMNeT++
// 定义的类Txc1都需要在OMNET++注册后才可以被使用
Define_Module(Txc1);
void Txc1::initialize()
{
// 仿真开始最初运行的程序.
// 引导运行tic-toc-tic-toc进程,
// 其中一个模块需要发送第一条信息，我们让tic先发送。
// 首先判断是tic还是toc
if (strcmp("tic", getName()) == 0) {
// 在out门(gate) 发送第一条信息，我们在message对象中随意发了一个 "tictocMsg"
cMessage *msg = new cMessage("tictocMsg");
send(msg, "out");
}
}
void Txc1::handleMessage(cMessage *msg)
{
// handleMessage()函数：当信息传输到当前module时被唤醒
// 这这个module中的这个函数，我们仅仅从out gate 中发送msg。
// 因为tic和toc都做同样的事情，所以他们会来来回回的互发信息
send(msg, "out"); // 发送 message
}
的Txc简单module,由C ++类表示Txc1。的Txc1 类需要继承的OMNeT ++的cSimpleModule类，并需要在OMNeT ++注册Define_Module()宏。
笔记！
忘记Define_Module()定义宏一个常见的错误。如果缺少该内容，则会收到与以下内容类似的错误消息：。"Error: Class 'Txc1' not found -- perhapsits code was not linked in, or the class wasn't registered with Register_Class(), or inthe case of modules and channels, with Define_Module()/Define_Channel()"
我们从重新定义两种方法cSimpleModule：initialize()和handleMessage()。它们是从仿真内核调用的：initialize()仅调用一次，handleMessage()在消息到达模块时调用。
在其中，initialize()我们创建一个消息对象（cMessage），然后将其从outgate发送出去。由于此门连接到另一个模块的in门，因此在handleMessage()分配给NED文件中的链接的传播延迟为100ms之后，仿真内核将在以下参数中将此消息传递给另一个模块。另一个模块只是将其发送回去（另一个100毫秒的延迟），因此它将导致来来回回的互相发送一样的信息。
Messages（数据包，帧，作业等）和events（计时器，超时）均由OMNeT ++中的cMessage对象（或其子类）表示。在发送或安排它们之后，它们将由仿真内核保存在“预定事件”或“未来事件”列表中，直到时间到了，并通过handleMessage()传递给modules.
请注意，此模拟中没有内置停止条件：它将永远持续下去。你可以从从GUI手动停止它。（您也可以在配置文件中指定模拟时间限制或CPU时间限制，但在本教程中我们不这样做。）
1.5添加omnetpp.ini
为了能够运行仿真，我们需要创建一个omnetpp.ini文件。 omnetpp.ini告诉仿真程序您要仿真哪个网络（因为NED文件可能包含多个网络），您可以将参数传递给模型，为随机数生成器显式指定种子，等等。omnetpp.ini使用_File->New->Initialization file (INI)_ 菜单项创建文件。新文件将在_Inifile编辑器中_打开。作为NED编辑器，Inifile编辑器还具有两种模式，即_Form(表单模式)和_Source（代码模式），它们可以编辑相同的内容。前者更适合配置仿真内核，后者更适合输入模块参数。
现在，只需切换到“_Source”_模式并输入以下内容：
[General]
network = Tictoc1
您可以在“_Form”_模式下验证结果：
tictoc2所有后续步骤将共享一个通用的omnetpp.ini文件。
现在，我们已经完成了创建第一个模型的准备，并可以编译和运行它了。
