GSOC2025Ntn

Main Page - Roadmap - Summer Projects - Project Ideas - Developer FAQ - Tools - Related Projects

HOWTOs - Installation - Troubleshooting - User FAQ - Samples - Models - Education - Contributed Code - Papers

Back to GSoC 2025 projects

Project Overview

• Project Name: NTN Helper and a LEO example for 5G NR
• Student: Thiago Miyazaki
• Mentors: Gabriel Ferreira, Biljana Bojovic, Amir Ashtari Gargari and Katerina Koutlia
• Google page: https://summerofcode.withgoogle.com/myprojects/details/Z1PZUHaC
• Project Goals: Create a simplified means for users to instantiate and set up GEO and LEO satellites through Helper models, providing a high-level interface for users interested in simulations using LEO and GEO satellites. Write a LEO example using implementations from the 5G NR Module for ground nodes and channel models.
• Repository: https://gitlab.com/thiagomiyazaki/nr-ntn-dev
• About Me: I am a Computer Science graduate student at UNESP/IGCE (Universidade Estadual Paulista - Instituto de Geociências e Ciências Exatas) and since September/2024 I have been part of a research group on Networks and Distributed Systems at IC/UNICAMP, where we have been working on a LEO simulator integrating OpenRAN on ns-3.

Design Document

You can find the Design Document for this project at this link: https://docs.google.com/document/d/1LpZ83rH4adx3xcJoWsKJ30zSKwbJ2m6n-mE855yXeCQ/edit?usp=sharing

Milestones (not final)

• Orbital mobility model: week 9
  • Models simple circular orbits, could be later extended to model elliptical orbits. This implies constant escape/orbital velocity. Model should support both fake velocity (with no position changes) and real velocity (with position changes, for when handover is fully supported).

• Orbital mobility helper: week 13
  • Helper should set up the orbital planes with a given inclination and altitude (radius), for a given number of equally spaced satellites. Orbits in same orbital plane should be equally separated. Orbital plane assignment should start at ascending node (where orbital plane simultaneously intersects the equator plane and the prime meridian plane, e.g. greenwich)

• Example with orbital mobility and 3GPP NTN settings: week 16
  • Example should reproduce deployments of LEO constellations such as Starlink and OneWeb.

Weekly Reports

Community Bonding

Week 1 (May 4-10)

• Review on topics about 4G & 5G:
  • 4G Architecture, components and Protocol Stack.
  • 5G modes (NSA & SA), functions and Protocol Stack.

Week 2 (May 11-17)

• Requirement gathering with mentors and project discussion

Week 3 (May 18-24)

• Studied cttc-nr-demo example
• Studied NR Module documentation:
  • Getting Started
  • Manual: Introduction, Architecture, PHY Layer & Beamforming

Week 4 (May 25-31)

• Requirement gathering with mentors and project discussion

GSoC officially starts

Week 5 (June 1-7)

• Study of important concepts for LEO Satellites, such as orbital planes and coordinate systems.
• Study case of existing LEO module: ns-3-leo
  • Brief presentation on how the module sets up the initial position for satellite nodes.

Week 6 (June 8-14)

• Initial draft and commit for a LEO Position Allocator and Mobility Model
  • Sets up resolution and define a discrete position for satellites within an orbit, setting their initial positions as evenly as possible, given a certain resolution.

Week 7 (June 15-21)

• Finished porting Mobility from ns-3-leo, including a trace example and utility to plot data for validation.
• The porting also included a new feature to precompute each node position.

Week 8 (June 22-28)

• Rebased fork to nr-4.0
• Created initial design document for the project.
• Precomputation feature: replace position queue with a deque to save computational resources.
• WIP: Envision how to share a single orbit deque with positions to multiple satellites in the orbit.

Week 9 (June 29-July 5)

• Expected: commit for the Mobility Model & Position Allocator

Week 10 (July 6-12)

• Expected: tests and validation for the Mobility Model & Position Allocator

Week 11 (July 13-19)

• Expected: commit for the NTN Helper

Week 12 (July 20-26)

• Expected: tests and validation for the NTN Helper

Week 13 (July 27-August 2)

• Expected: code commit for the NTN example

Week 14 (August 3-9)

• Expected: tests and validation for the NTN example

Week 15 (August 10-16)

• Project Delivery and Final Results discussion