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 Codebase หลัก
2. โคลนที่เก็บนี้ภายในไดเรกทอรี src ในนั้นและ
3. ชำระเงินรุ่น NS-3 ปัจจุบันที่รองรับโดยโมดูลนี้

ในการติดตั้งโมดูลนี้ในการประชุมล่าสุดคุณสามารถใช้คำสั่ง all-in-one ต่อไปนี้:

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

หมายเหตุ : เมื่อเปลี่ยนไปใช้คอมมิชชันก่อนหน้านี้ รวมถึงรีลีสล่าสุด ให้แน่ใจว่าได้ชำระเงิน NS-3 ไปยังเวอร์ชันที่ถูกต้อง (ไฟล์ NS3-VERSION ที่รูทของที่เก็บนี้) รองรับ ณ เวลานั้น

การรวบรวม

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: ภาพรวมของเครื่องมือพื้นฐานและ abstractions ใน NS-3
• ข้อมูลจำเพาะของ Lorawan สามารถดาวน์โหลดได้ที่เว็บไซต์ Lora Alliance

ขอความช่วยเหลือ

ในการพูดคุยและรับความช่วยเหลือเกี่ยวกับวิธีการใช้โมดูลนี้คุณสามารถเปิดปัญหาได้ที่นี่

การบริจาค

อ้างถึงแนวทางการบริจาคสำหรับข้อมูลเกี่ยวกับวิธีการมีส่วนร่วมในโมดูลนี้

ผู้เขียน

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

ใบอนุญาต

ซอฟต์แวร์นี้ได้รับอนุญาตภายใต้ข้อกำหนดของ GNU GPLV2 (ใบอนุญาตเดียวกันกับที่ใช้โดย NS-3) ดูไฟล์ License.md สำหรับรายละเอียดเพิ่มเติม

กิตติกรรมประกาศและสิ่งพิมพ์ที่เกี่ยวข้อง

เวอร์ชันเริ่มต้นของรหัสนี้ได้รับการพัฒนาเป็นส่วนหนึ่งของวิทยานิพนธ์ปริญญาโทที่ University of Padova ภายใต้การดูแลของศาสตราจารย์ Lorenzo Vangelista, Prof. Michele Zorzi และด้วยความช่วยเหลือของ Marco Centenaro

สิ่งพิมพ์:

• D. Magrin, M. Capuzzo และ A. Zanella, "การศึกษาอย่างละเอียดเกี่ยวกับประสิทธิภาพของ Lorawan ภายใต้การตั้งค่าพารามิเตอร์ที่แตกต่างกัน" ใน IEEE Internet of Things Journal 2019. ลิงค์
• M. Capuzzo, D. Magrin และ A. Zanella, "การจราจรที่ยืนยันใน Lorawan: ข้อผิดพลาดและการตอบโต้," 2018 ครั้งที่ 17 การประชุมเชิงปฏิบัติการเครือข่ายเฉพาะกิจเฉพาะกิจ (Med-Hoc-Net), Capri, 2018. ลิงก์
• D. Magrin, M. Centenaro และ L. Vangelista, "การประเมินผลการปฏิบัติงานของ Lora Networks ในสถานการณ์ที่ชาญฉลาด" 2017 การประชุมนานาชาติ IEEE เกี่ยวกับการสื่อสาร (ICC), ปารีส, 2017. ลิงค์
• การแสดงระดับเครือข่ายของระบบ LORA (วิทยานิพนธ์หลัก) ลิงค์.