5G-LENA Features Summary
(Centre TecnolΓ²gic de Telecomunicacions de Catalunya β CTTC)
π Overview
This document summarizes the main features currently supported, partially supported, or planned in the 5G-LENA (ns-3 nr) simulator.
It is meant to be a compact, βat-a-glanceβ view, complementary to the detailed technical documentation:
Table of Contents
- Features per layer:
- PHY
- MAC
- RLC / PDCP / RRC / Core
- Application Layer - Traffic Models
- Calibration & Testing:
- Calibration & Deployment Models
- CI & Testing Framework
- 5G-LENA Extensions (Sidelink and V2X, O-RAN, NR-U):
- Sidelink and NR-V2X
- Fronthaul / O-RAN integration
- NR-U (Unlicensed NR)
- Planned Roadmap
Features per layer:
PHY
| Feature | Status | Notes |
|---|---|---|
| OFDMA (DL/UL) | β Supported | 3GPP-compliant slot/symbol allocation; variable TTI and single analog beam capability |
| TDMA (DL/UL) | β Supported | Configurable symbol granularity; variable TTI |
| Numerologies (ΞΌ = 0β4) | β Supported | Per-BWP numerology configuration (sub-carrier spacing and symbol duration) |
| TDD and FDD | β Supported | Per-cell configurable TDD pattern |
| Time-multiplex of shared/control | β Supported | PDCCH/PDSCH in same slot; PUCCH/PUSCH in same slot |
| LDPC coding | β Supported | 3GPP TS 38.212 base graphs 1 & 2 |
| Code block segmentation | β Supported | 3GPP TS 38.212 |
| MCS tables | β Supported | Per BWP; 3GPP TS 38.214 MCS Tables 1 & 2 (Up to 256-QAM) |
| Sounding Reference Signal | β Supported | UE-specific scheduled SRS (configurable offset and periodicity) |
| CSI-RS & CSI-IM | β Supported | channel estimation and interference measurement (NR-v4.0) |
| SU-MIMO | β Supported | 3GPP-compliant; Up to rank-4 and 32 antenna ports (NR-v3.0) |
| Sub-band CSI feedback | β Supported | Sub-band CQI and PMI (NR-v4.0) |
| Uplink power control | β Supported | 3GPP compliant; PUSCH/PUCCH/SRS |
| Attach to max-RSRP gNB | β Supported | UE attaches to gNB with highest RSRP (NR-v4.0) |
| π¦ Antenna models | ||
| Phased array models | β Supported | 3GPP UPAs; dual-pol; multi-port; multi-panel UE; spatial channel models |
| ns-3 legacy antenna models | β Supported | Isotropic/Cosine/Parabolic/3GPP; non-spatial channel models; (NR-v4.0) |
| π¨ Beamforming & Precoding | ||
| Analog ideal beamforming | β Supported | Kronecker, Direct path, Cell scan, etc. |
| Analog realistic beamforming | β Supported | Realistic BF (SRS-based, imperfect CSI) |
| Digital Precoding | β Supported | 3GPP Type-I; codebook/ideal; closed-loop; based on CSI feedback (PMI, RI, CQI) (NR-v3.0) |
| PMI/RI search method | β Supported | 3GPP Codebook, Ideal, Maleki, Sasaoka, Fast |
| Beam management (sweep/track) | βοΈ Partial | Simplified model; no SSB blocks |
| π© Supported channel models | ||
| 3GPP TR 38.901 | β Supported | UMi/UMa/RMa/InH/InF/V2V/NTN (NR-v2.1), O2I penetration loss; shadowing; fast fading |
| Spatial consistency | βοΈ Ongoing | 3GPP TR 38.901 Procedure A; temporal consistency |
| NYUSIM | β Supported | NYU mmWave/THz channel; based on real NYU measurements (NR-v4.0) |
| Fluctuating Two-Ray (FTR) | β Supported | FTR model built on top of 3GPP pathloss/channel for fast abstraction; (NR-v4.0) |
| Sionna Ray Tracing | βοΈ Ongoing | Sionna-based channel model for the precise simulation of radio wave propagation |
| Legacy ns-3 non-spatial/Friis channel | β Supported | ns-3 legacy non-spatial channel models; Ideal for large-scale simulations (NR-v4.0) |
MAC
| Feature | Status | Notes |
|---|---|---|
| π¦ SCHEDULERS | ||
| PF / RR / MR | β Supported | Temporal fairness |
| QoS-aware scheduler | β Supported | 5QI-aware; LC byte assignment (NR-v2.5) |
| Random TDMA / OFDMA schedulers | β Supported | Stress interference testing (NR-v4.1) |
| AI Reinforcement-Learning scheduler | β Supported | Via ns3-gym (NR-v4.0) |
| Sub-band CQI-aware scheduling | β Supported | Optional sub-band CQI aware scheduling(NR-v4.0) |
| π© CORE MAC FEATURES | ||
| HARQ | β Supported | IR and CC methods; configurable max number of ReTx |
| Multiple HARQ processes per UE | β Supported | Configurable; defaults to 16 |
| 3GPP-compliant processing times | β Supported | NR K0/K1/K2 and N0/N1/N2 processing times |
| Adaptive Modulation and Coding (AMC) | β Supported | Error-model based and Shannon-based AMC |
| UL grant-based access | β Supported | UL grant-based access scheme with scheduling request (SR) |
| UL BSR | β Supported | 3GPP-compliant UL buffer status reporting |
| BSR / SR / CQI / RI / PMI processing | β Supported | BSR multiplexed with PUSCH; SR/CQI/RI/PMI in PUCCH |
| π¨ ADVANCED FEATURES | ||
| Notching mask | β Supported | UFA masks per-BWP and per-cell; configurable notched RBGs |
| CC / BWP managers | β Supported | Multi-carrier; FDM of numerologies; CC/BWP routing |
| Carrier Aggregation (CA) | β Supported | Multiple CC/BWPs with flexible mapping |
| RACH | βοΈ Ongoing | Contention-based for initial access; RA preamble, RAR, MSG3 |
| Fronthaul Control | β Supported | 7.2x split; Limited-capacity FH link; Dropping, Postponing, Optimize MCS/RBs; (NR-v3.3) |
RLC / PDCP / RRC / Core
| Feature | Status | Notes |
|---|---|---|
| RLC AM / UM / TM | β Supported | LTE-based |
| PDCP | β Supported | Basic header compression |
| 5QI handling | β Supported | QoS per flow; PDCP discard timer; RLC reordering window timer |
| SDAP | βοΈ Ongoing | Maybe will be contributed soon |
| RRC | βοΈ Ongoing | Ideal RRC; Real RRC, RLF, Handover ongoing |
| Multi-flow per UE | β Supported | Independent bearers |
| EPC/5GC integration | βοΈ Partial | Via LTE-EPC model |
Application layer - Traffic Models
| Feature | Status | Notes |
|---|---|---|
| NGMN apps (FTP, video, gaming, VoIP) | β Supported | NGMN-based traffic generators; NGMN mixed traffic model (NR-v2.4) |
| 3GPP XR (VR/AR/CG) | β Supported | 3GPP TR 38.838 XR traffic profiles; multi-flow XR models |
| 3GPP FTP (Model 1) | β Supported | 3GPP FTP Model 1; TR 36.814 (NR-v1.2) |
| ns-3 3GPP HTTP | β Supported | ns-3 3GPP HTTP model |
Calibration & Testing
Calibration & Deployment Models
| Feature | Status | Notes |
|---|---|---|
| Calibration examples | β Supported | Indoor/Outdoor (R1-1709828/RP-180524) and R1-1707360 (3GPP SU-MIMO) (NR-v4.1) |
| Hexagonal wrap-around | β Supported | Wrap-around for up to 5 rings, 37-site/111-cell topology for RMa/UMa/UMi calibration |
| Wraparound model | β Supported | Simulates outer interference to the edge devices without having to simulate outer devices |
| FastFadingConstantPositionMobilityModel | β Supported | Calibration for static users with temporal fading |
| REM maps (DL/UL) | β Supported | DL/UL REM maps, SIR/SNR/SINR for topology inspection |
CI & Testing Framework
| Feature | Status | Notes | Version | Date |
|---|---|---|---|---|
| CI Check dead URLs | β Checked | Detects dead URLs in source and documentation | NR-v4.2 | Nov 28, 2025 |
| CI Calibration Regression testing | β Checked | Calibration regression testing with 3GPP calibration campaign | NR-v4.1 | Jul 7, 2025 |
| CI Mac OS | β Checked | Test NR on MAC OS | NR-v4.1 | Jul 7, 2025 |
| CI Deprecated emacs line | β Checked | Checks that the file does not contain deprecated emacs lines | NR-v3.2 | Sep 25, 2024 |
| CI Eigen | β Checked | Check whether the module works correctly without Eigen | NR-v3.2 | Sep 25, 2024 |
| CI LLVM's libc++ | β Checked | Detect issues caused by different C++ standard libraries | NR-v3.2 | Sep 25, 2024 |
| CI Memory issues | β Checked | Early detection of memory bugs; prevents crashing and bogus results | NR-v3.1 | Jul 19, 2024 |
| CI Commit message | β Checked | Check that the commit message follows 5G-LENA guidelines | NR-v3.1 | Jul 19, 2024 |
| CI CMake format | β Checked | Checks CMake format | NR-v3.0 | Feb 16, 2024 |
| CI Spell-check | β Checked | Detects spelling errors | NR-v3.0 | Feb 16, 2024 |
| CI Ubuntu rolling | β Checked | Early detection of issues with the libraries using Ubuntu rolling | NR-v3.0 | Feb 16, 2024 |
| CI python-format | β Checked | Check using black and isort formatter settings; python formatting | NR-v3.0 | Feb 16, 2024 |
| CI Clang-tidy | β Checked | Detects clang-tidy issues | NR-v3.0 | Feb 16, 2024 |
| CI Clang-format | β Checked | Detects clang-format issues | NR-v2.4 | Apr 5, 2023 |
| CI Reuse | β Checked | Checks open-source licensing using REUSE | NR-v2.4 | Apr 5, 2023 |
| CI Regression and reproducibility testing | β Checked | KPI regression and reproducibility testing | NR-v2.4 | Apr 5, 2023 |
| CI unit and system tests | β Checked | Tests using Clang/GCC in debug/optimized/release mode | NR-v0.2 | Feb 1, 2019 |
5G-LENA Extensions (Sidelink and V2X, O-RAN, NR-U)
The following features are NOT yet available in the nr master.
Sidelink and NR-V2X extension
The sidelink and NR-V2X are under active development and are available in a separate branch of 5G-LENA. The latest release of the sidelink and NR V2X extension is compatible with 5G-LENA Release v3.1 and ns-3 Release 42 (available since July 30, 2024). A new release will be available soon.
Sidelink and NR V2X extension documentation can be found here Section 2.16. For the installation follow the instructions.
| Feature | Status | Notes |
|---|---|---|
| Broadcast | β Supported | Mode 4-like broadcast |
| Out-of-coverage | β Supported | V2V communication, No gNB required |
| PSCCH/PSSCH | β Supported | Time multiplexing of PSCCH and PSSCH |
| Resource allocation | β Supported | Mode 2: UE-selected, sensing-based |
| Semi-persistent scheduling (SPS) | β Supported | Sensing-based and random SPS |
| Blind retransmissions | β Supported | No feedback |
| HARQ feedback | β Not supported | Ongoing |
| Sidelink control information | β Supported | SCI update |
| 3GPP TR 38.885 compliant | β Supported | TR 38.885 scenario and channel models |
Fronthaul / O-RAN integration
Ongoing and under active development. Not yet publicly available.
| Feature | Status | Notes |
|---|---|---|
| near-RT RIC | βοΈ Ongoing | Integration & Testing |
| xApps | βοΈ Ongoing | Integration & Testing |
| E2 | βοΈ Ongoing | Integration & Testing |
NR-U (Unlicensed NR)
NR-U implements NR operation in unlicensed spectrum, i.e., energy detection, multiple channel access managers, including duty-cycling as well as Listen-Before-Talk (LBT)-based procedures. Openly available as a separate module here. NR-U documentation can be found here and the installation instructions in NR-U README.md.
The current NR-U code is compatible with 5G-LENA v1.2 and ns-3.35 (since July 2021). Not under active development, but it may get updated. (If interested in contributing, contact us.)
| Feature | Status | Notes |
|---|---|---|
| LBT Cat 2/3/4 | β Supported | ETSI-compliant LBT; LBT after MAC; ED omnidirectional |
| Channel Access Managers | β Supported | Per-BWP and per-node channel access; Modes: AlwaysOn, OnOff duty cycle, LBT |
| Wi-Fi coexistence | βοΈ Experimental | Coexistence with ns-3 Wi-Fi |
| Directional LBT | βοΈ Experimental | LBT with directional beams; null-space projected LBT and precoding |
π§ Planned Roadmap (2025 β 2028)
| Area | Possible Enhancements |
|---|---|
| Channel | Sionna-Ray Tracing channel; hybrid spatially-consistent channels |
| Antenna | Improved polarization; near-field blocking models for handheld devices |
| PHY | Precoding Type-II and MU-MIMO; SSB blocks transmission and scheduling |
| PHY | NTN maturation; TN-NTN integration |
| MAC | SL HARQ; LTM; MU-MIMO schedulers; O-RAN xApp hooks; network slicing |
| RLC | RLC implementations for high-throughput and ultra-low latency |
| SDAP | Add 5G SDAP layer (ongoing) |
| RRC | Handover (ongoing); Dual Connectivity; advanced mobility procedures |
| O-RAN | O-RAN xApp hooks; network slicing (ongoing) |
| NR-U | Directional LBT |
| V2X | HARQ feedback; multicast/unicast |
| Framework | SDAP layer; 5GC; Network Digital Twin; O-RAN integration |
| 6G-LENA | NTN; ISAC; FFS; RIS; AI |
Legend
β = Supported βοΈ = Partial / Ongoing/ Experimental β = Not yet supported
Β© 2025 Centre TecnolΓ²gic de Telecomunicacions de Catalunya (CTTC) β OpenSim Research Unit