これは、ロラワンネットワークのシミュレーションを実行するために使用できるNS-3モジュールです。
クイックリンク:
シミュレーションモデルの概要
APIドキュメント
このモジュールを使用してシミュレーションを実行するには、最初にNS-3をインストールする必要があります。 ubuntu/debian/mintを使用している場合は、次のように最小限の必要なパッケージをインストールできます。
sudo apt install g++ python3 cmake ninja-build git ccacheそれ以外の場合は、NS-3インストールページの前提条件セクションを直接参照してください。
注:
ccacheパッケージは厳密には必要ありませんが、強くお勧めします。約5GBのディスクスペースコストが高いにもかかわらず、数分節約することにより、将来のコンピレーション時間を大幅に強化できます。このディスクスペースの使用は、最終的に設定を通じて削減できます。
次に、次のことが必要です。
srcディレクトリ内のこのリポジトリをクローンしますこのモジュールを最新のコミットでインストールするには、次のオールインワンコマンドを使用できます。
git clone https://gitlab.com/nsnam/ns-3-dev.git && cd ns-3-dev &&
git clone https://github.com/signetlabdei/lorawan src/lorawan &&
tag= $( < src/lorawan/NS3-VERSION ) && tag= ${tag # release } && git checkout $tag -b $tag注:最新リリースを含む以前のコミットに切り替えるときは、その時点でサポートされている正しいバージョン(このリポジトリのルートにあるNS3-VERSIONファイル)に常にNS-3をチェックアウトするようにしてください。
NS-3は、開発指向の哲学を採用しています。何でも実行する前に、NS-3コードをコンパイルする必要があります。 2つのオプションがあります。
全体としてNS-3をコンパイルします。次のように構成および構築して、すべてのシミュレーションモジュールを使用可能にします( ns-3-devフォルダーにいることを確認してください!):
./ns3 configure --enable-tests --enable-examples &&
./ns3 buildLorawanモジュールのみに焦点を当てる:スローハードウェアで30/40分以上かかる可能性があるため、コンピレーションプロセスを促進するには、次のように構成を変更します。
./ns3 clean &&
./ns3 configure --enable-tests --enable-examples --enable-modules lorawan &&
./ns3 build最初の行は、きれいなビルド状態から始めることを保証します。
最後に、テストがスムーズに実行されることを確認してください。
./test.pyスクリプトがすべてのテストが合格したと報告した場合、あなたは行くのが良いです。
一部のテストが失敗またはクラッシュした場合は、問題を提出することを検討してください。
モジュールには次の例が含まれています。
simple-network-examplecomplete-network-examplenetwork-server-exampleadr-examplealoha-throughputframe-counter-updatelora-energy-model-exampleparallel-reception-example例は./ns3 run example-nameコマンドを介して実行できます(その他のオプションについては./ns3 run --helpを参照してください)。
doc/lorawan.rstにあるソースファイル)。その他の便利なドキュメントソース:
このモジュールの使用方法について議論してヘルプを取得するには、ここで問題を開くことができます。
このモジュールに貢献する方法については、貢献ガイドラインを参照してください。
このソフトウェアは、GNU GPLV2(NS-3が使用するのと同じライセンス)の条件の下でライセンスされています。詳細については、license.mdファイルを参照してください。
このコードの初期バージョンは、パドバ大学の修士論文の一部として、ロレンツォヴァンゲリスタ教授のミケーレゾルジ教授の監督とマルコセンテナロの助けを借りて開発されました。
出版物: