lorawan

Modul Lorawan NS-3

Ini adalah modul NS-3 yang dapat digunakan untuk melakukan simulasi jaringan Lorawan.

Tautan cepat:

• Tinjauan Model Simulasi

• Dokumentasi API

Memulai

Prasyarat

Untuk menjalankan simulasi menggunakan modul ini, pertama-tama Anda harus menginstal NS-3. Jika Anda berada di Ubuntu/Debian/Mint, Anda dapat menginstal paket minimal yang diperlukan sebagai berikut:

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

Kalau tidak, silakan merujuk langsung ke bagian Prasyarat dari halaman instalasi NS-3.

Catatan: Meskipun paket ccache tidak sepenuhnya diperlukan, sangat disarankan. Ini dapat secara signifikan meningkatkan waktu kompilasi di masa depan dengan menghemat puluhan menit, meskipun dengan biaya ruang disk yang lebih tinggi sekitar 5GB. Penggunaan ruang disk ini pada akhirnya dapat dikurangi melalui pengaturan.

Kemudian, Anda perlu:

1. Kloning basis kode NS-3 utama,
2. Klon repositori ini di dalam direktori src di dalamnya, dan
3. Lihat versi NS-3 saat ini yang didukung oleh modul ini.

Untuk menginstal modul ini pada komit terbaru, Anda dapat menggunakan perintah all-in-one berikut:

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

Catatan : Saat beralih ke komitmen sebelumnya, termasuk rilis terbaru , selalu pastikan untuk juga memeriksa NS-3 ke versi yang benar (file NS3-VERSION di root repositori ini) yang didukung pada saat itu.

Kompilasi

NS-3 mengadopsi filosofi yang berorientasi pada pembangunan. Sebelum Anda dapat menjalankan apa pun, Anda harus mengkompilasi kode NS-3. Anda memiliki dua opsi:

1. Kompilasi NS-3 secara keseluruhan: Siapkan semua modul simulasi dengan mengonfigurasi dan membangun sebagai berikut (pastikan Anda berada di folder ns-3-dev !):

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

2. Fokus secara eksklusif pada modul Lorawan: untuk mempercepat proses kompilasi, karena dapat memakan waktu lebih dari 30/40 menit pada perangkat keras yang lambat, ubah konfigurasi sebagai berikut:

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

   Baris pertama memastikan Anda mulai dari status pembangunan yang bersih.

Akhirnya, pastikan tes berjalan dengan lancar dengan:

./test.py

Jika skrip melaporkan bahwa semua tes lulus, Anda baik untuk pergi.

Jika beberapa tes gagal atau macet, pertimbangkan untuk mengajukan masalah.

Contoh penggunaan

Modul ini mencakup contoh -contoh berikut:

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

Contoh dapat dijalankan melalui ./ns3 run example-name ./ns3 run --help

Dokumentasi

• Tinjauan Model Simulasi: Deskripsi model dasar modul ini (file sumber yang terletak di doc/lorawan.rst ).
• Dokumentasi API: Dokumentasi semua kelas, fungsi anggota dan variabel yang dihasilkan dari komentar doxygen dalam kode sumber.

Sumber Dokumentasi Berguna Lainnya:

• Tutorial NS-3: Mulailah di sini jika Anda baru mengenal NS-3!
• Manual NS-3: Tinjauan Umum Alat dan Abstraksi Fundamental di NS-3.
• Spesifikasi Lorawan dapat diunduh di situs web Lora Alliance.

Mendapatkan bantuan

Untuk membahas dan mendapatkan bantuan tentang cara menggunakan modul ini, Anda dapat membuka masalah di sini.

Berkontribusi

Lihat Pedoman Kontribusi untuk informasi tentang cara berkontribusi pada modul ini.

Penulis

• Davide Magrin
• Martina Capuzzo
• Stefano Romagnolo
• Michele Luvisotto

Lisensi

Perangkat lunak ini dilisensikan berdasarkan ketentuan GNU GPLV2 (lisensi yang sama yang digunakan oleh NS-3). Lihat file lisensi.md untuk lebih jelasnya.

Ucapan Terima Kasih dan Publikasi yang Relevan

Versi awal kode ini dikembangkan sebagai bagian dari tesis master di University of Padova, di bawah pengawasan Prof. Lorenzo Vangelista, Prof. Michele Zorzi dan dengan bantuan Marco Centenaro.

Publikasi:

• D. Magrin, M. Capuzzo dan A. Zanella, "Studi menyeluruh tentang kinerja Lorawan di bawah pengaturan parameter yang berbeda," di IEEE Internet of Things Journal. 2019. Tautan.
• M. Capuzzo, D. Magrin dan A. Zanella, "lalu lintas yang dikonfirmasi di Lorawan: Jebakan dan Penanggulangan," 2018 Workshop Jaringan Ad Hoc Mediterania Tahunan 2018 (Med-Hoc-Net), Capri, 2018. Link.
• D. Magrin, M. Centenaro dan L. Vangelista, "Evaluasi Kinerja Jaringan Lora dalam skenario kota pintar," Konferensi Internasional IEEE 2017 tentang Komunikasi (ICC), Paris, 2017. Tautan.
• Kinerja tingkat jaringan sistem LORA (tesis master). Link.