lorawan

Lorawan NS-3模塊

這是一個NS-3模塊，可用於執行Lorawan網絡的模擬。

快速鏈接：

• 仿真模型概述

• API文檔

入門

先決條件

要使用此模塊運行模擬，您首先需要安裝NS-3。如果您在Ubuntu/Debian/Mint上，則可以安裝最小所需的包裝，如下所示：

sudo apt install g++ python3 cmake ninja-build git ccache

否則，請直接參考NS-3安裝頁面的先決條件部分。

注意：雖然不需要嚴格要求ccache軟件包，但強烈建議使用。它可以通過節省數十分鐘來顯著提高未來的彙編時間，儘管磁盤空間成本較高，約為5GB。最終可以通過設置減少此磁盤空間的使用情況。

然後，您需要：

1. 克隆主NS-3代碼庫，
2. 克隆此存儲庫在其中的src目錄中，並且
3. 結帳該模塊支持的當前NS-3版本。

要在最新提交中安裝此模塊，您可以使用以下多合一命令：

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代碼。您有兩個選擇：

1. 整體編譯NS-3：通過以下配置和構建來使所有模擬模塊可用（確保您在ns-3-dev文件夾中！）：

   ./ns3 configure --enable-tests --enable-examples &&
   ./ns3 build

2. 專門關注Lorawan模塊：加快彙編過程，因為它可能需要超過30/40分鐘的慢速硬件，請更改配置如下：

   ./ns3 clean &&
   ./ns3 configure --enable-tests --enable-examples --enable-modules lorawan &&
   ./ns3 build

   第一行可確保您從乾淨的構建狀態開始。

最後，確保測試順利進行：

./test.py

如果腳本報告所有測試通過了，那麼您就可以了。

如果某些測試失敗或崩潰，請考慮提交問題。

用法示例

該模塊包括以下示例：

• simple-network-example
• complete-network-example
• network-server-example
• adr-example
• aloha-throughput
• frame-counter-update
• lora-energy-model-example
• parallel-reception-example

示例可以通過./ns3 run example-name命令運行（有關更多選項，請參閱./ns3 run --help ）。

文件

• 仿真模型概述：此模塊的基礎模型的描述（位於doc/lorawan.rst上的源文件）。
• API文檔：源代碼中Doxygen註釋產生的所有類，成員函數和變量的文檔。

其他有用的文檔來源：

• NS-3教程：如果您是NS-3的新手，則在此處開始！
• NS-3手冊：NS-3中基本工具和抽象的概述。
• Lorawan規範可以在Lora Alliance網站上下載。

得到幫助

要討論並獲得有關如何使用此模塊的幫助，您可以在此處打開問題。

貢獻

有關如何為該模塊貢獻的信息，請參閱貢獻指南。

作者

• 戴維德·馬格林（Davide Magrin）
• Martina Capuzzo
• Stefano Romagnolo
• Michele Luvisotto

執照

該軟件是根據GNU GPLV2（NS-3使用的相同許可）獲得許可的。有關更多詳細信息，請參見許可證文件。

致謝和相關出版物

在洛倫佐·範格利斯塔（Lorenzo Vangelista）教授，米歇爾·佐爾茲（Michele Zorzi）和Marco Centenaro的幫助下，在帕多瓦大學（Padova University of Padova）的碩士論文中開發了此代碼的初始版本。

出版品:

• D. Magrin，M。 Capuzzo和A. Zanella，“對不同參數設置下的Lorawan性能的詳盡研究”，《 IEEE Things of Internet Journal》。 2019。鏈接。
• M. Capuzzo，D。 Magrin和A. Zanella，“確認的洛萬（Lorawan）交通：陷阱和對策”，2018年第17屆年度地中海臨時網絡網絡研討會（Med-Hoc-net），Capri，2018年，鏈接。
• D. Magrin，M。 Centenaro和L. Vangelista，“在智能城市場景中對洛拉網絡的績效評估”，2017年IEEE國際通信會議（ICC），巴黎，2017年，2017年。鏈接。
• 洛拉系統的網絡級別（主論文）。關聯。