Releases: Unipisa/Simu5G
Release list
Simu5G 1.5.0
This release continues the architectural overhaul of Simu5G. Major themes include consolidating Control Plane functions under the RRC module, adding QoS support via DRBs and the SDAP protocol, restructuring Ip2Nic and other modules for cleaner architecture, and improving type safety throughout the codebase.
Tested with INET-4.5.4 and OMNeT++ 6.3, compatible with INET-4.6.0 and OMNeT++ 6.1 through 6.4.
More explicit Control Plane modeling
Continuing the direction set in v1.4.3, code fragments that implement pieces of
the 3GPP Control Plane have been identified throughout the codebase and collected
under the Rrc module. Rrc is now a compound module with the following
submodules:
-
BearerManagement: The former simple
Rrcmodule, renamed and extended.
It now owns the lifecycle (creation, deletion, lookup) of all PDCP and RLC
entities. Previously, entity management was scattered across the monolithic
PDCP module and theLteRlcUm/LteRlcAmmodules. -
Registration: Node registration and deregistration logic, previously
embedded inIp2Nic, was moved here. -
HandoverController: Handover decision and execution logic was extracted
fromLtePhyUeinto this new module. This is architecturally more correct,
as handover is an RRC function, not PHY. The internal "handover packet"
misnomer was corrected to "beacon" (HANDOVERPKT->BEACONPKT,
broadcastMessageInterval->beaconInterval). Several parameters were
exposed as NED parameters (hysteresisFactor,handoverDetachmentTime,
isNr). -
D2DModeController: D2D mode selection was moved here from the former
stack/d2dModeSelection/directory, and D2D peer tracking from
LteRlcUmD2D.
QoS support: SDAP, DRBs and per-bearer PDCP/RLC entities
QoS (Quality of Service) support was added through Data Radio Bearers (DRBs)
and the SDAP (Service Data Adaptation Protocol) layer, which is part of the 5G
NR protocol stack. The code is based on a contribution by Mohamed Seliem
(University College Cork); see releases v1.4.1-sdap and v1.4.1-sdap-2 for
details. In this release, the code was substantially reworked and integrated
into the main codebase.
In accordance with the 3GPP architecture, the PDCP and RLC layers were
transformed so that they purely consist of per-DRB entities, created and
configured by BearerManagement (RRC). Each DRB has dedicated PDCP TX/RX and
RLC TX/RX entity modules, wired directly to each other via per-bearer gate
connections.
Details:
-
SDAP protocol layer: An SDAP implementation was added, providing
QFI-to-DRB routing with a JSON-configuredDrbTable. The SDAP layer is
optional in NR NICs (enabled viahasSdap=true). -
QFI propagation via GTP-U: QFI is set by the application via DSCP,
picked up byTrafficFlowFilter/UPF, carried in the GTP-U protocol header
(mirroring the 3GPP PDU Session Container extension header), and extracted
by the gNB for SDAP routing. -
QoS-aware proportional fairness scheduler: A
QoSAwareSchedulerwas
added to MAC, supporting QFI-based scheduling with configurable weight
constants. Enable withLteMacEnb.schedulingDisciplineDl/Ul = "QOS_PF". -
DRB configuration in JSON: DRB configuration is split between SDAP
(sdap.drbConfigfor QFI-to-DRB routing) and MAC (mac.drbQosConfigfor
QoS scheduler parameters), both in JSON format. -
Non-IP PDU session support: SDAP was generalized for non-IP PDU session
types, withPduSessionTypeenum andupperProtocolin DRB configuration. -
PDCP refactored into per-bearer entities: The former monolithic PDCP
module (which had six subclass variants for LTE/NR × UE/eNB/D2D) was
replaced with per-bearerPdcpTxEntityandPdcpRxEntitymodules, plus
PdcpMuxfor upper-layer routing andDcMuxfor Dual Connectivity X2
forwarding. Bypass entities handle the DC secondary leg. Entities communicate
via OMNeT++ gates, not C++ method calls. -
RLC refactored into per-bearer entities: The former
LteRlccompound
module (containingLteRlcUm/LteRlcUmD2D,LteRlcAm,LteRlcTm) was
replaced with per-bearer TX/RX entity modules for all three RLC modes (UM,
AM, TM), plusRlcMuxfor MAC↔entity routing. -
PDCP↔RLC directly wired: PDCP and RLC entities are connected directly
via per-bearer gates. All submodules now reside directly at NIC level -- the
formerPdcpLayerandLteRlccompound modules no longer exist. -
Example simulations:
simulations/nr/standalone_drb/with
multi-UE, multi-QFI configurations.
Ip2Nic decomposed, further module architecture improvements
The Ip2Nic module, which had accumulated various unrelated responsibilities
over time, was decomposed. Several code fragments were factored out into
separate modules:
-
analyzePacket()moved to Ip2Nic from PDCP: Packet classification
(fillingFlowControlInfotags) was moved to where it logically belongs --
at the IP-to-NIC boundary. TheIpFlowIndtag was eliminated. RLC type NED
parameters (conversationalRlc, etc.) also moved from PDCP toIp2Nic. -
HandoverPacketHolderUe/Enb: Handover packet buffering was factored out
ofIp2Nicinto separate modules. X2 tunneled packets are now received via
gates instead of C++ method calls. -
TechnologyDecision: Dual Connectivity technology selection logic was
extracted into a separate, configurable module that uses NED expressions.
Further module architecture improvements:
-
MAC turned into compound module: MAC is now a compound module with
AMC
and DL/ULScheduleras propercSimpleModulesubmodules (previously
created vianewin C++). They perform their own staged initialization. -
UPF and PgwStandard now derive from INET's
ApplicationLayerNodeBase. -
PacketFlowObserver refactored to use OMNeT++ signals: Direct C++ calls
from PDCP, RLC, and MAC intoPacketFlowObserverwere replaced with
OMNeT++ signals, fully decoupling the observer from protocol modules. -
Replaced method-call-based packet passing with gate connections in several
places:LteHandoverManager,DualConnectivityManager,Ip2Nic(X2 path).
Type safety improvements
-
Strong typedefs:
SIMU5G_STRONG_TYPEDEFmacro applied toMacNodeId,
DrbId,LogicalCid, andQfi, preventing accidental mixing of ID types. -
Direction enum:
LteControlInfo.directionchanged fromunsigned short
to a properDirectionenum. -
C++ types extracted: Types previously defined in
LteCommon.msgwere
moved into a dedicatedLteTypes.hheader. -
ROHC header: PDCP header compression now uses a proper ROHC header
representation instead of simply truncating the IP header. -
FlowControlInfo:lcidfield renamed todrbId.
Naming and layout cleanup
-
Gate renames throughout the NIC for clarity and consistency:
MAC_to_RLC/RLC_to_MAC->upperLayerIn/upperLayerOutand
macIn/macOut;MAC_to_PHY/PHY_to_MAC->phyOut/phyIn;
filterGate->dnPppg. Severalinoutgates split into separateinput
andoutputgates. -
Submodule renames:
pdcpUpperMux->pdcpMux,rlcLowerMux->rlcMux,
pppIf->dpPpp(in UPF/PGW). -
Module renames:
DualConnectivityManager->DcX2Forwarder,
LteHandoverManager->HandoverX2Forwarder. -
Improved NED layout of NIC internals for better visualization in Qtenv:
data-path modules arranged vertically, control-plane modules on the left
edge, dynamically created PDCP/RLC entities positioned between muxes.
Bug fixes
LteSchedulerEnb: Fixed multi-UE starvation in multi-DRB scheduling.
Other
-
Added
tilxfingerprints (resistant to module renames) to the fingerprint
test suite. Fingerprint test coverage for MEC simulations improved. -
SplitBearersTableturned intostd::ordered_map.
Simu5G 1.4.5
This release is a collection of bug fixes to the physical-layer error model
(CQI and BLER computation), the MAC layer, and the uplink scheduler. Several of
these fixes change simulation results for the affected configurations.
Tested with INET-4.5.4 and OMNeT++ 6.3, compatible with INET-4.6.0 and OMNeT++
6.1 through 6.4.
PHY error model fixes
-
BLER table indexing:
GetBLER_TU()/GetBLER_AWGN()indexed the CQI/BLER
tables one row too low, making throughput results slightly optimistic. -
CQI boundary condition: An SNR exactly at the minimum (
minSnr, -14 dB)
wrongly yielded the maximum CQI 15 instead of CQI 0, scheduling a noise-floor
UE at the highest MCS. -
CQI 0 handling:
LteRealisticChannelModel::error()no longer treats CQI 0
(a valid "channel unusable" value, e.g. just after handover) as a fatal error;
the packet is simply dropped.
MAC and scheduler fixes
-
HARQ process count: The
harqProcessesNED parameter (whose NR default is
5) was ignored by the C++ code, which used a hardcoded value of 8. The code now
honors the parameter, so NR uses 5 HARQ processes as v1.4.4 already intended.
Contributed by Esteban Egea Lopez (Universidad Politécnica de Cartagena). -
RAC grant sizing: A UE completing RACH on a poor uplink channel could get a
grant too small to even carry a Buffer Status Report, leaving it unable to
report its buffer and re-RACHing forever. Grants are now sized to at least 56 B.
Other fixes
-
PacketFlowObserverEnb: An unknown grant ID on an uplink MAC PDU (normal
during handover) now logs a warning instead of throwing a fatal error. -
PacketFlowObserver: BSR-only MAC PDUs (no RLC SDUs) are now tolerated
instead of triggering a fatal error. -
AmcPilotAuto: Using it with a D2D direction now fails with a clear error
message; scenarios with D2D should setamcMode="D2D".
Simu5G 1.4.4 RLC-AM
This release incorporates the changes in v1.3.1-rlcam, rebased onto v1.4.4.
Simu5G 1.4.4
This release contains bug fixes and improvements, including more realistic MAC layer modeling and several MEC fixes.
Tested with INET-4.5.4 and OMNeT++ 6.3, compatible with INET-4.6.0 and OMNeT++ 6.1 through 6.4.
MAC improvements
-
RACH preamble collision modeling: UEs now pick a random preamble index
when sending Random Access Channel (RAC) requests. The eNB detects collisions
when multiple UEs choose the same preamble in a TTI, causing all colliding
requests to fail. Failed UEs exercise the existing backoff/retry path. A new
NED parameternumPreambles(default 64) controls the preamble pool size.
While this is an abstraction of the real multi-step RACH procedure, it
faithfully captures preamble contention (the primary source of access
failures) with minimal additional model complexity. -
NR MAC timer defaults adjusted:
raResponseWindowchanged from 3 to 20,
retxBsrTimerfrom 40 to 320. The original values were the LTE defaults, too
aggressive for NR's finer timing granularity. Also adjustedmaxRacAttempts
(10) andracBackoffMax(20) for both LTE and NR. -
Default HARQ processes for NR changed to 5 (from 8), reflecting the
asynchronous nature of NR HARQ. -
RAC/BSR timer parameters are now configurable from NED (previously
hardcoded).
Bug fixes
-
Ip2Nic: Fixed issue #302 -- packets arriving at the old gNB just after a
handover are now forwarded to the new gNB over X2, instead of causing an error. -
Ip2Nic: Fixed fallback to NR node ID when a UE has no LTE ID, which is
necessary for handling NR-only UEs. -
MAC: Fixed ASSERT failure on D2D mode switching (
SinglePair-modeSwitching
scenario). When switching from DM to IM mode, the MAC connection structure is
now preserved with empty buffers instead of being destroyed, so that switching
back to DM mode works correctly. -
GtpUserX2: Fixed
GtpUserMsgchunk length to 8B, consistent withGtpUser. -
MecOrchestrator: Fixed
contextIdCounternever being incremented, causing
every MEC app to overwrite the previous map entry at key 0. -
MecOrchestrator: Fixed missing return after a failure path that caused an
end-iterator dereference. -
MecAppBase: Fixed undisposed
HttpMessageStatusobjects on destruction. -
MecResponseApp, MecRTVideoStreamingReceiver: Fixed missing
localUePort
parameter that was inadvertently removed during earlier refactoring. -
RniService: Fixed incomplete CamelCase renaming that caused the service to
not be found in the registry. -
MEC: Fixed uninitialized variables that caused non-deterministic fingerprint
failures in debug builds.
Other changes
-
Binder:
getNextHop()renamed togetServingNodeOrSelf()for clarity. -
UDP error handling: Refactored several application modules (including
UeWarningAlertApp, UeRnisTestApp, UeRequestApp, and others) to use
UdpSocket::ICallback, fixing errors when receiving ICMP "destination
unreachable" indications. MEC apps now also properly close their UDP sockets. -
Copyright headers adjusted: Replaced generic "Authors" lines with precise
copyright lines and added SimuLTE copyright attribution to files derived from
SimuLTE. -
INET 4.6 compatibility: Added
checksumModeparameter to emulation
examples alongside the existingcrcModefor backward compatibility. -
TrafficLightController: Made backward compatible with OMNeT++ 6.1.
Simu5G 1.4.0 RLC-AM
This release incorporates the changes in v1.3.1-rlcam, rebased onto v1.4.0.
Simu5G 1.3.1 RLC-AM
This is a specialized topic release on top of v1.3.1, integrating contributions by Esteban Egea Lopez (Universidad Politécnica de Cartagena). The main highlights are the addition of NR RLC-AM (Acknowledged Mode) and the refactoring of NR RLC-UM (Unacknowledged Mode) to be closer to the 3GPP specifications. Integration work (splitting up, organizing, and fingerprint testing the original patches) was done by Andras Varga (OMNeT++ Core Team).
NR RLC Acknowledged Mode (RLC-AM):
- Added NR RLC-AM implementation: NrRlcAm module with NrAmTxQueue and NrAmRxQueue entities, sliding window TX/RX buffers, retransmission buffer, and AM data/status PDUs. Implements the core ARQ procedures of 3GPP TS 38.322.
- RLC-AM infrastructure: made LteRlcAm methods virtual, added ILteRlcAm interface NED type, made AM/UM submodules pluggable via NED typename, added NackInfo/StatusPduData structs, fixed AM header size.
NR RLC Unacknowledged Mode (RLC-UM) refactoring:
- Extracted buffer management from NrUmTxEntity/NrUmRxEntity into dedicated RlcUmTransmitterBuffer and RlcUmReceptionBuffer classes, implementing proper 3GPP TS 38.322 Section 5.2.2 procedures for UM transmission and reception.
- RlcUmReceptionBuffer: fixed reassembly window check, split timer management into separate start/stop methods, added proper memory management for buffered packets, return SDU completion status from handleSegment().
- RlcUmTransmitterBuffer: SDU segmentation based on MAC grants with byte-level interval tracking, SN assignment on last-byte transmission, BSR reporting support.
- Changed NR RLC-UM default t_Reassembly from 80ms to 50ms.
Radio Link Failure (RLF):
- Added Radio Link Failure detection and handling: RadioLinkFailure tag, MAC/PDCP/HARQ RLF queue cleanup deleteQueuesRadioLinkFailure in MAC, handleRadioLinkFailure in PDCP).
MAC improvements:
- Made HARQ process count configurable via NED parameter (replaced hardcoded ENB_TX/RX_HARQ_PROCESSES, UE_TX/RX_HARQ_PROCESSES constants), changed NR default to 5.
- Made RAC/BSR timer configuration into NED parameters in LteMacUe, set sensible defaults (maxRacAttempts=10, racBackoffMax=20), adjusted defaults for NR.
Other changes:
- Added new statistics signals across channel model, MAC, and RLC layers (RSRP, interference, fading, throughput samples, grantedBlocks, bsrSize).
- Added X2HandoverDataMsgSerializer for proper X2 handover data serialization.
- PHY: added RLC-AM module reference for handover buffer cleanup.
- Added example simulation configs for NR RLC-AM testing (VoIP-DL-AM, VoIP-DL-AM-Lossy, VoIP-UL-AM).
- Misc small fixes: BackgroundScheduler init order, LtePhyBase channelModel_ type, Binder.h include guard, LtePhyEnb debug flag
Simu5G 1.4.1-SDAP-2
This release improves on the 1.4.1-sdap release that added SDAP (Service Data Adaptation Protocol) layer support to Simu5G.
The most important changes:
-
New simulations that exercise the code more: Multi-UE, multi-app, multi-QFI
configurations were added intoomnetpp_drb.iniundernr/standalone. Based
on the Simu5G#294 bug report by Jonathan "Toaaster" Ebert. -
Fixed QFI propagation: QFI was originally added to packets by the application
(VoipSender) as a packet tag (QfiTag). However, this tag did not make it to
UPF, because it was already stripped by the local PPP interface on
transmission. This mechanism was replaced by the VoipSender app setting DSCP
on the packet, which UPF now interprets as QFI (simplified PDR matching). From
then on, QFI is now carried through the GTP-U tunnel in the GTP header
(mirroring the real 5G PDU Session Container extension header), instead of
relying on QoS tags that were being stripped by PPP. The gNB extracts QFI from
the GTP-U header to restore QoS tags for SDAP routing. -
DRB configuration changes: The DRB configuration is now split between SDAP and
MAC layers, each only knowing as much as they need for their operation.
QFI-to-DRB routing configuration went intosdap.drbConfig, while QoS
parameters for the scheduler (GBR, delay budget, PER, priority) went into
mac.drbQosConfig. Moreover, DRB configuration is now specified in JSON,
replacing the previous text file-based configuration. -
Fixed multi-UE DL starvation (fixes Simu5G#294):
MacDrbMultiplexer
incorrectly used LCID as thenrRlc[]array index, assuming LCID equals the
DRB index. When multiple UEs shared the same DRB, only the first UE received
data. Fixed by learning the LCID-to-gate mapping from RLC-to-MAC traffic. -
MEC fixes: There were several bug fixes in the MEC code, such as
MecOrchestrator(contextId counter was never incremented),MecOrchestrator
(missing return after failure path causing end-iterator dereference),
MecAppBase(eliminate undisposed objects), fix uninitialized variables in
various modules (fixing long-standing fingerprint failures of certain MEC
simulations in debug mode).
Simu5G 1.4.3
This release represents a major milestone in the complete overhaul of the Simu5G codebase to make it architecturally more compliant with the 3GPP specifications, modernize the code, and adopt the best practices of the INET Framework on which it is based. The goal is to pave the way for a clean implementation of new protocol features such as TSN support.
Tested with INET-4.5.4 and OMNeT++ 6.3, updated for INET-4.6.0 compatibility.
Key achievements in this release:
-
More explicit Control Plane modeling: Simu5G is advertised as a User Plane
simulator, but since it was also used to model dynamic scenarios such as
handovers, it always contained elements of the Control Plane distributed across
various modules. The new direction is to make these elements more explicit and
centralized, such as creating dedicated RRC (Radio Resource Control) and
Session Management Function (SMF) implementations. It is an explicit non-goal
to simulate Control Plane messaging -- its functionality will be implemented
with C++ method calls across modules. Thus, Simu5G remains a User Plane
simulator, but with the possibility to more faithfully model dynamic
scenarios with heavy Control Plane involvement. While this goal is not fully
realized in this release, many changes point into that direction. -
Control info refactoring: Cleaned up
UserControlInfoand
FlowControlInfoby removing 5+ unused fields and splitting out smaller,
focused tags. For example, IPv4 addresses, only used betweenIp2Nicand PDCP,
have been factored out into anIpFlowIndtag. This improves modularity,
reduces coupling between protocol layers, and makes the code easier to
maintain and extend. -
Added vital missing fields to PDCP and MAC headers: Protocol layers now
use proper header fields instead of "tunnelling" information via
UserControlInfoandFlowControlInfopacket tags that would not exist in a
real implementation. For example, PDCP sequence numbers are now carried in
PDCP headers, and LCIDs are stored in MAC PDU subheaders. This makes the
simulation more realistic and packet contents more inspectable in Qtenv. -
Explicit setup of logical connections instead of on-the-fly discovery:
This is a key architectural change, which also largely motivated the
previous items. In previous iterations of Simu5G, data structures associated
with logical connections / bearers were created in each protocol layer as they
encountered packets that belonged to new connections. Moreover, part of the
connection state was carried along by the packets inFlowControlInfotags
instead of stored inside the protocol. While this modeling approach still
allowed for faithful simulation of the traffic while keeping the
implementation simple, it has become a roadblock for implementing complex
dynamic scenarios where connections come and go. In this iteration,
centralized session and bearer management (SMF-like functionality) was added
to theBindermodule, and RRC modules were added to NICs to carry out local
configuration. This brings the architecture closer to the 3GPP control/user
plane separation, making it easier to implement features like handovers
correctly. This is work in progress: SMF is still part ofBinderand not a
separate module, and connection setup is still triggered by the first packet
of the connection hitting PDCP on the way out. However, moving the SMF code
into its own module will be trivial, and the singleBindermethod call in
PDCP can now be easily replaced with static configuration or with calls from a
more detailed Control Plane implementation. -
Removed incomplete MIMO support: Removed MIMO-related code and parameters.
The existing MIMO code was incomplete (e.g., PMI values were computed but
never used). Removing it simplifies the codebase and model parameterization,
and avoids confusion about capabilities. MIMO support will be added in a future
release, with a different approach. -
Initialization cleanup: Reorganized module initialization into well-defined,
Simu5G-specific init stages. This eliminates hidden cross-module dependencies,
makes the initialization order explicit and verifiable, and prevents subtle bugs
caused by modules accessing uninitialized data in other modules.
Further notable changes:
-
In UE models,
masterIdandnrMasterIdwere renamed toservingNodeIdand
nrServingNodeId. The old names were confusing because "Master" has a
specific meaning in Dual Connectivity (Master eNB vs Secondary gNB), unrelated
to the UE's serving node. -
In UE models, the
macCellId,nrMacCellIdparameters were removed. In
practice, the code already used the serving node ID as cell ID. -
macNodeIdassignment was moved to NED, and now it is based on the new
simu5g_seq()NED function that generates an integer sequence. This replaces
the earlier approach where node IDs were assigned byIp2Nicduring
initialization, and stored back into the module parameters for other modules to
use. -
LteRlcPduNewDataandLteRlcSdupacket chunks were converted to packet
tags, as they represent internal metadata rather than actual protocol data. -
In the C++ code, merged the
ENODEBandGNODEBnode type enum values into a
singleNODEBvalue, with a separateisNrflag where needed. This change
simplified a large number of "if" conditions throughout the codebase.
To port your existing Simu5G simulations to this version, apply the following
changes to the ini files:
-
Change
masterIdtoservingNodeId(andnrMasterIdtonrServingNodeId),
unless it refers to the Master/Secondary distinction in a Dual Connectivity
setup. -
Remove
macCellIdandnrMacCellIdparameter assignments for UE modules. -
Delete ini entries that set the following removed MIMO-related parameters:
numRus,ruRange,ruStartingAngle,ruTxPower,antennaCws,
muMimo,pmiWeight,lambdaMinTh,lambdaMaxTh,lambdaRatioTh,
feedbackGeneratorType. -
For
initialTxMode, the following values are no longer valid:
SINGLE_ANTENNA_PORT5,OL_SPATIAL_MULTIPLEXING,CL_SPATIAL_MULTIPLEXING,
MULTI_USER. Remove the parameter assigment to use the default.
There are many more changes that potentially affect existing simulations, and
projects extending, or built on top of, Simu5G. They cannot all be covered here
in detail - see the git history for details.
Simu5G 1.4.2
This is primarily a bugfix release.
-
Pdcp: Fixed Dual Connectivity bug where separate PDCP entities were
incorrectly created for LTE and NR legs of a Split Bearer instead of using a
single shared entity. This fix breaks RLC-UM packet loss statistics which
(incorrectly) inferred packet loss from PDCP sequence numbers. -
RlcUm: Removed packet loss statistics that incorrectly relied on PDCP sequence
numbers (PDCP sequences are not contiguous in Dual Connectivity setups) -
PacketFlowManager: Renamed to PacketFlowObserver, updated NED documentation.
-
Statistics collection refined, e.g. remove recording "sum" and/or "mean" where
it does not make sense; use new "rateavg" filter for computing average
throughput. -
Binder: New utility functions: isGNodeB(), getUeNodeId().
-
Apps: Added sequence numbers to VoIP and VoD packet names, to facilitate
tracing with Qtenv. -
NED documentation: Added content to simu5g-index.ned including version number
and WHATSNEW.
Simu5G 1.4.1-SDAP
This specialized branch release introduces SDAP protocol support, multiple DRBs and advanced QoS capabilities to Simu5G for enhanced 5G network simulations. Please note that future main releases may not include these features or may incorporate them in a different form, as the primary development focus remains on architectural refactoring and foundational improvements. The changes were contributed by Mohamed Seliem (University College Cork), with improvements by Andras Varga (OMNeT++ Core Team).
Compatible with OMNeT++ 6.2.0 and INET 4.5.4.
Reference paper: "QoS-Aware Proportional Fairness Scheduling for Multi-Flow 5G
UEs: A Smart Factory Perspective". Mohamed Seliem, Utz Roedig, Cormac Sreenan,
Dirk Pesch. IEEE MSWiM, 2025.
New Features:
-
Added an SDAP protocol implementation with reflexive QoS capabilities (NrSdap
and ReflectiveQosTable modules). Available using the NRUeSdap (UE) and
gNodeBSdap (gNodeB) node types that contain the NRNicUeSdap and NRNicEnbSdap
NIC types, respectively. -
DRB (Data Radio Bearer) support with multi-QFI/QoS handling for realistic 5G
bearer management simulations. This feature is available using NRUeDrb (UE)
and gNodeBDrb (gNodeB) node types that contain the NRNicUeDrb and NRNicEnbDrb
NIC types, respectively. It can be configured using the numDrbs parameter.
QFI-to-DRB mappings can be defined in a context file (see SDAP's
qfiContextFile parameter) with 5QI parameters and QoS requirements. -
QoSAwareScheduler with QFI-based Proportional Fair scheduling using QfiContextManager.
Enable QoS scheduling with LteMacEnb.schedulingDisciplineDl/Ul="QOS_PF". -
Better representation of compressed headers in PDCP. (Note that header compression is
disabled by default; enable using PDCP's headerCompressedSize parameter.) -
New example simulations: simulations/nr/standalone/omnetpp_sdap.ini and omnetpp_drb.ini,
each with Standalone, VoIP-DL, and VoIP-UL configurations demonstrating SDAP functionality
and multi-DRB support with QoS-aware scheduling.