NrNicUe¶

compound module NrNicUe

Defines a User Equipment (UE) network interface card that supports both LTE and NR (New Radio) technologies. It extends the LteNicUe module by adding additional submodules and parameters to support NR-specific functionalities. D2D support is added by the NrNicUeD2D subtype.

The PDCP and RLC entities are missing from the submodules on purpose: the RRC layer’s BearerManagement creates them per bearer at run time.

Usage diagram¶

Inheritance diagram¶

Known subclasses¶

Name	Type	Description
NrNicUeD2D	compound module	Device-to-Device (D2D) capable NR User Equipment network interface. It extends NrNicUe by swapping in the D2D-capable NR MAC/PHY leaves and enabling the D2D mode controller, allowing direct UE-to-UE communication without routing traffic through the gNodeB. It is the NR counterpart of LteNicUeD2D.

Extends¶

Name	Type	Description
LteNicUe	compound module	The LteNicUe module is a network interface that provides LTE connectivity within a UE (User Equipment). It implements the data and signaling planes of the LTE stack, which includes PDCP, RLC, MAC, and PHY layers. The parameters and submodules allow customization of the UE’s behavior.

Parameters¶

Name	Type	Default value	Description
displayStringTextFormat	string	“%a (%i)\n%m”	Determines the text that is written on top of the submodule, supports displaying pars, watches, and module-specific information
recordPcap	bool	false
numPcapRecorders	int	recordPcap ? 1 : 0
isWireless	bool	true
interfaceTableModule	string
routingTableModule	string
hasRniSupport	bool	false
nodeType	string
processingDelayIn	double	0s	Additional processing delay for incoming ip packets
processingDelayOut	double	0s	Additional processing delay for outgoing ip packets
channelModelType	string	“StochasticChannelModel”
dualConnectivityEnabled	bool	false
numCarriers	int	1
address	string	“auto”
sessionType	string		The type of the UE’s session (see LteUe), set by the node
hasSdap	bool	false	Whether the stack has an SDAP layer: true on 5GC (Upf) networks, false on EPC/EN-DC ones; the network sets it per its core
useReflectiveQos	bool	false
nrChannelModelType	string	“Tr38901ChannelModel”
numNrCarriers	int	1

Properties¶

Name	Value	Description
class	NonlayoutingNetworkInterface
display	i=block/ifcard;bgb=800,810;bgl=3
lifecycleSupport
networkInterface

Gates¶

Name	Direction	Description
upperLayerIn	input
upperLayerOut	output
radioIn	input	To receive messages sent using sendDirect()
nrRadioIn	input	For NR support
x2 [ ]	inout	Optional X2 manager

Signals¶

Name	Type	Unit	Description
packetDropped	inet::Packet ↗

Statistics¶

Name	Title	Source	Record	Unit	Interpolation Mode	Description
packetDropInterfaceDown	packet drops: interface down	packetDropReasonIsInterfaceDown(packetDropped)	count,sum(packetBytes),vector(packetBytes)		none
packetDropNoCarrier	packet drops: no carrier	packetDropReasonIsNoCarrier(packetDropped)	count,sum(packetBytes),vector(packetBytes)		none

Unassigned submodule parameters¶

Name	Type	Default value	Description
pcapRecorder ↗.displayStringTextFormat	string	“rec: %n pks”	Determines the text that is written on top of the submodule, supports displaying pars, watches, and module-specific information
pcapRecorder ↗.verbose	bool	true	Whether to log packets on the module output
pcapRecorder ↗.recordEmptyPackets	bool	true	Specifies if zero length packets are recorded or not
pcapRecorder ↗.enableConvertingPackets	bool	true	Specifies if converting packets to link type is allowed or not
pcapRecorder ↗.pcapFile	string	“”	The PCAP file to be written, suggested value: pcapFile = “${resultdir}/${configname}-#${runnumber}” + fullpath() + “.pcap”
pcapRecorder ↗.fileFormat	string	“pcapng”
pcapRecorder ↗.snaplen	int	65535	Maximum number of bytes to record per packet
pcapRecorder ↗.timePrecision	int	6	Time precision in recorded file. pcap supports only 6 (usec) or 9 (nanosec), pcapng supports more values (see ‘if_tsresol’ option in pcapng file format).
pcapRecorder ↗.dumpBadFrames	bool	true	Enable dump of frames with hasBitError
pcapRecorder ↗.sendingSignalNames	string	“transmissionEnded”	Space-separated list of outbound packet signals to subscribe to
pcapRecorder ↗.receivingSignalNames	string	“receptionEnded”	Space-separated list of inbound packet signals to subscribe to
pcapRecorder ↗.dumpProtocols	string	“ethernetmac ppp ieee80211mac”	Space-separated list of protocol names as defined in the Protocol class
pcapRecorder ↗.packetFilter	object	“*”	Which packets are considered, matches all packets by default
pcapRecorder ↗.helpers	string	“”	Usable PcapRecorder::IHelper helpers for accept packettype and store/convert packet as specified linktype
pcapRecorder ↗.alwaysFlush	bool	false	Flush the pcapFile after each write to ensure that all packets are captured in case of a crash
handoverPacketHolder.sessionType	string		The type of the UE’s session (see LteUe): the IP types parse the uplink datagram’s header for the modules after this one, the others carry the payload as is
ip2nic.binderModule	string	“binder”
ip2nic.connectionControlModule	string	“^.rrc.connectionControl”	The node’s control-plane entry point, asked for a bearer on a lookup miss
ip2nic.isNr	bool	false	True for the NR leg (set by NrNicUe/NrNicEnb, or in the ini for a DC master eNB)
ip2nic.hasSdap	bool	false	When true, SDAP handles DRB/RLC assignment; Ip2Nic skips traffic classification
ip2nic.sessionType	string	“”	UE only: the type of the UE’s session (see LteUe), which the payload the NIC delivers up is of; set by the NIC
ip2nic.establishBearersOnDemand	bool	true	When false, a packet that finds no established bearer raises an error instead of establishing one (static bearers are established up front; see the staticDrbs parameter of BearerConfigurator)
rrc.registration.interfaceTableModule	string
rrc.registration.interfaceName	string	“cellular”
rrc.registration.routingTableModule	string
rrc.registration.binderModule	string	“binder”
rrc.registration.connectionControlModule	string	“^.connectionControl”	The node’s control-plane entry point (see Rrc), told about a multicast group join
rrc.registration.sessionType	string	“”	UE only: the type of the UE’s session (see LteUe): a UE created during the run gets an IPv4 default route through the NIC only on an IP session, and the NIC of an Ethernet session is an Ethernet port; set by the NIC
rrc.bearerManagement.binderModule	string	“binder”	To reach a peer’s BearerManagement on RLF
rrc.bearerManagement.connectionControlModule	string	“^.connectionControl”	The node’s control-plane entry point (see Rrc), which a torn-down bearer’s DRB identity goes back through
rrc.bearerManagement.t311	double	0s	RRC re-establishment cell-selection timer (0 => release-to-IDLE)
rrc.bearerManagement.t301	double	0.1s	RRC re-establishment (request -> complete) timer
rrc.bearerManagement.headerCompressedSize	int	-1B	Removed, an error if set: header compression is configured per bearer (the rohc field of BearerConfigurator’s bearer definitions)
rrc.bearerManagement.pdcpEntityModuleType	string	“simu5g.stack.pdcp.LtePdcpEntity”	PDCP entity types: the full PDCP entity is a compound (PdcpEntityBase, TX+RX sides plus the leg split/join stage of a multi-leg bearer); the instantiable types are its subclasses (LtePdcpEntity, NrPdcpEntity). At a DC secondary a bearer’s PDCP lives at the master, so the secondary installs an PdcpRelayEntity (tunnels PDUs to/from the master) in its place.
rrc.bearerManagement.pdcpRelayEntityModuleType	string	“simu5g.stack.pdcp.PdcpRelayEntity”
rrc.bearerManagement.dualConnectivityEnabled	bool	false	Set by the NIC; two-leg (split-capable) bearers
rrc.bearerManagement.rlcTmEntityModuleType	string	“simu5g.stack.rlc.RlcTmEntity”	RLC entity types (compound modules): lteRlc* = LTE-FI bearers (TS 36.322), nrRlc* = NR bearers (SI/SO wire format, TS 38.322)
rrc.bearerManagement.lteRlcUmEntityModuleType	string	“simu5g.stack.rlc.LteRlcUmEntity”
rrc.bearerManagement.lteRlcAmEntityModuleType	string	“simu5g.stack.rlc.LteRlcAmEntity”
rrc.bearerManagement.nrRlcUmEntityModuleType	string	“simu5g.stack.rlc.NrRlcUmEntity”
rrc.bearerManagement.nrRlcAmEntityModuleType	string	“simu5g.stack.rlc.NrRlcAmEntity”
rrc.bearerManagement.registrationModule	string	“^.registration”	Module references for accessing other stack layers
rrc.bearerManagement.drbTableModule	string	“^.drbTable”
rrc.bearerManagement.ip2nicModule	string	“^.^.ip2nic”
rrc.bearerManagement.handoverPacketHolderModule	string	“^.^.handoverPacketHolder”	Attachment-ledger push target (UE only)
rrc.bearerManagement.pdcpMuxModule	string	“^.^.pdcpMux”
rrc.bearerManagement.pdcpDcMuxModule	string	“^.^.pdcpDcMux”
rrc.bearerManagement.d2dModeControllerModule	string	“^.d2dModeController”
rrc.bearerManagement.rlcMuxModule	string	“^.^.rlcMux”
rrc.bearerManagement.nrRlcMuxModule	string	“^.^.nrRlcMux”
rrc.bearerManagement.macModule	string	“^.^.mac”
rrc.bearerManagement.nrMacModule	string	“^.^.nrMac”
rrc.bearerManagement.sdapModule	string	“^.^.sdap”	Configuration push target; unresolvable (no SDAP on the NIC) = no pushes
rrc.bearerManagement.qosFlowClassifierModule	string	“^.^.qosFlowClassifier”	Uplink QFI rule push target; unresolvable (not a UE stack with SDAP) = no pushes
rrc.connectionControl.binderModule	string	“binder”
rrc.connectionControl.bearerConfiguratorModule	string	“bearerConfigurator”
rrc.connectionControl.coreControlModule	string	“coreControl”
rrc.connectionControl.bearerManagementModule	string	“^.bearerManagement”
rrc.connectionControl.macModule	string	“^.^.mac”
rrc.connectionControl.handoverPacketHolderModule	string	“^.^.handoverPacketHolder”
rrc.connectionControl.gtpUserModule	string	“^.^.^.relay.gtpUser”
rrc.connectionControl.gtpUserX2Module	string	“^.^.^.gtpUserX2”
rrc.connectionControl.macNodeId	int		The base station’s node id; the NIC sets it from the node’s
rrc.connectionControl.gateway	string	“”	The node’s core network gateway, as its gateway parameter names it; ignored at a node not connected to a core network (a secondary node)
rrc.nrConnectionControl.dynamicCellAssociation	bool	false
rrc.nrConnectionControl.enableHandover	bool	false	Allows handovers in the UE
rrc.nrConnectionControl.isNr	bool		Whether this instance is associated with the NR or the LTE stack
rrc.nrConnectionControl.macNodeId	int		MacNodeId of the stack leg this controller belongs to (set by the NIC)
rrc.nrConnectionControl.sessionType	string		The type of the session the UE requests at connection setup (see LteUe), set by the NIC
rrc.nrConnectionControl.handoverLatency	double	50ms	Handover duration
rrc.nrConnectionControl.handoverDetachmentTime	double	handoverLatency > 0s ? handoverLatency/2 : 25ms
rrc.nrConnectionControl.handoverAttachmentTime	double	handoverLatency > 0s ? handoverLatency-handoverDetachmentTime : handoverDetachmentTime
rrc.nrConnectionControl.minRssiDefault	bool	true	Whether minRssi is taken from PhyPisaData instead of the minRssi parameter
rrc.nrConnectionControl.minRssi	double	-99.0dB	Configurable minimum threshold RSSI for attaching to an eNB (meaningful only if minRssiDefault==false)
rrc.nrConnectionControl.hysteresisFactor	double	10
rrc.nrConnectionControl.binderModule	string	“binder”
rrc.nrConnectionControl.macModule	string	“^.^.mac”
rrc.nrConnectionControl.bearerManagementModule	string	“^.bearerManagement”
rrc.nrConnectionControl.handoverPacketHolderModule	string	“^.^.handoverPacketHolder”
rrc.nrConnectionControl.feedbackGeneratorModule	string	“^.^.dlFbGen”	TODO or “^.^.nrDlFbGen”
rrc.nrConnectionControl.otherConnectionControlModule	string	“”
rrc.nrConnectionControl.hasCollector	bool	false	True when node has a collector module (ueCollector/nrUeCollector) for this PHY module
rlcMux.bearerManagementModule	string	“^.rrc.bearerManagement”
phy.isNr	bool	false	True for the NR leg (set by NrNicUe/NrNicEnb on their PHY submodule)
phy.macNodeId	int		MacNodeId of the stack leg this PHY belongs to (set by the NIC)
phy.ueTxPower	double	26dBm
phy.eNodeBTxPower	double	46dBm
phy.microTxPower	double	30dBm
phy.txDirection	string	“OMNI”
phy.txAngle	double	0deg
phy.binderModule	string	“binder”
phy.channelModelModule	string	“^.channelModel[0]”	Set to “^.nrChannelModel[0]” on an NR leg, see NrNicUe
phy.connectionControlModule	string	“^.rrc.connectionControl”
packetFlowObserver.macModule	string	“^.mac”
packetFlowObserver.pdcpModule	string	“^”
packetFlowObserver.rlcModule	string	“^”
packetFlowObserver.isNrObserver	bool	false
packetFlowObserver.pfmType	string	“PacketFlowObserverUe”
dlFbGen.isNr	bool	false	True for the NR leg (set by NrNicUe on the nrDlFbGen submodule)
dlFbGen.macNodeId	int		MacNodeId of the stack leg this generator belongs to (set by the NIC)
dlFbGen.feedbackType	string	“ALLBANDS”	Can be ALLBANDS, PREFERRED, WIDEBAND
dlFbGen.rbAllocationType	string	“localized”	Resource allocation type (“distributed” or “localized”)
dlFbGen.fbPeriod	int	6tti	Period for Periodic feedback in TTI
dlFbGen.fbDelay	int	1tti	Time interval between sensing and transmission in TTI
dlFbGen.usePeriodic	bool	true	Whether periodic feedback is used in addition to aperiodic feedback
dlFbGen.initialTxMode	string	“SINGLE_ANTENNA_PORT0”	Initial txMode (see LteCommon.h)
dlFbGen.binderModule	string	“binder”
dlFbGen.phyModule	string	“^.phy”
qosFlowClassifier.sessionType	string		The type of the UE’s session (see LteUe): an Unstructured session has one QoS flow, the default one, which every packet is classified to without evaluating the rules; an Ethernet session’s frames are classified by the rules (a dscpAsQfi rule does not match a frame)
sdap.nodeRole	string		Node role: “UE” or “gNB” - determines reflective QoS behavior
sdap.connectionControlModule	string	“^.rrc.connectionControl”	The node’s control-plane entry point, the bearer-selection authority on a lookup miss
sdap.establishBearersOnDemand	bool	true	When false, a packet that finds no established bearer raises an error instead of establishing one (static bearers are established up front; see the staticDrbs parameter of BearerConfigurator)
sdap.reflectiveQosTableModule	string	“”	UE only: path to ReflectiveQosTable module (empty = disabled)
sdap.useReflectiveQos	bool	false	UE only
sdap.reflectiveQosOverridesQfi	bool	false	UE only: when a packet has both a classified QFI (QfiReq tag) and a reflective QoS match, true = the reflective QFI wins, false = the classified one; a packet with only one of the two always uses it
reflectiveQosTable.timeout	double	30s	Flow expiration timeout
reflectiveQosTable.cleanupInterval	double	10s	Interval for periodic cleanup of expired flows
reflectiveQosTable.printFinalStats	bool	false	Print final statistics at simulation end
nrRlcMux.bearerManagementModule	string	“^.rrc.bearerManagement”
nrPhy.isNr	bool	false	True for the NR leg (set by NrNicUe/NrNicEnb on their PHY submodule)
nrPhy.macNodeId	int		MacNodeId of the stack leg this PHY belongs to (set by the NIC)
nrPhy.ueTxPower	double	26dBm
nrPhy.eNodeBTxPower	double	46dBm
nrPhy.microTxPower	double	30dBm
nrPhy.txDirection	string	“OMNI”
nrPhy.txAngle	double	0deg
nrPhy.binderModule	string	“binder”
nrPhy.channelModelModule	string	“^.channelModel[0]”	Set to “^.nrChannelModel[0]” on an NR leg, see NrNicUe
nrPhy.connectionControlModule	string	“^.rrc.connectionControl”
nrDlFbGen.isNr	bool	false	True for the NR leg (set by NrNicUe on the nrDlFbGen submodule)
nrDlFbGen.macNodeId	int		MacNodeId of the stack leg this generator belongs to (set by the NIC)
nrDlFbGen.feedbackType	string	“ALLBANDS”	Can be ALLBANDS, PREFERRED, WIDEBAND
nrDlFbGen.rbAllocationType	string	“localized”	Resource allocation type (“distributed” or “localized”)
nrDlFbGen.fbPeriod	int	6tti	Period for Periodic feedback in TTI
nrDlFbGen.fbDelay	int	1tti	Time interval between sensing and transmission in TTI
nrDlFbGen.usePeriodic	bool	true	Whether periodic feedback is used in addition to aperiodic feedback
nrDlFbGen.initialTxMode	string	“SINGLE_ANTENNA_PORT0”	Initial txMode (see LteCommon.h)
nrDlFbGen.binderModule	string	“binder”
nrPacketFlowObserver.pdcpModule	string	“^”
nrPacketFlowObserver.pfmType	string	“NrPacketFlowObserverUe”

Source code¶

//
// Defines a User Equipment (UE) network interface card that
// supports both LTE and NR (New Radio) technologies. It extends the
// LteNicUe module by adding additional submodules and parameters to
// support NR-specific functionalities. D2D support is added by the
// ~NrNicUeD2D subtype.
//
// The PDCP and RLC entities are missing from the submodules on purpose: the RRC
// layer's ~BearerManagement creates them per bearer at run time.
//
module NrNicUe extends LteNicUe
{
    parameters:
        bool hasSdap = default(false);  // Whether the stack has an SDAP layer: true on 5GC (Upf) networks, false on EPC/EN-DC ones; the network sets it per its core
        bool useReflectiveQos = default(false);
        ip2nic.hasSdap = default(this.hasSdap);
        sdap.nodeRole = default("UE");
        sdap.useReflectiveQos = default(this.useReflectiveQos);
        sdap.reflectiveQosTableModule = default(this.useReflectiveQos ? "^.reflectiveQosTable" : "");
        string nrChannelModelType = default("Tr38901ChannelModel");

        packetFlowObserver.typename = default("PacketFlowObserverUe");

        int numNrCarriers = default(1);

        ip2nic.isNr = default(true);
        rrc.bearerManagement.pdcpEntityModuleType = default("simu5g.stack.pdcp.NrPdcpEntity");

        rrc.hasNrConnectionControl = true;
        rrc.nrConnectionControl.isNr = true;
        nrMac.isNr = true;
        nrPhy.isNr = true;
        nrDlFbGen.isNr = true;
        // The NR leg's modules take their MacNodeId from the node's NR id
        rrc.nrConnectionControl.macNodeId = parent.nrMacNodeId;
        rrc.nrConnectionControl.sessionType = this.sessionType;
        qosFlowClassifier.sessionType = this.sessionType;
        nrMac.macNodeId = parent.nrMacNodeId;
        nrPhy.macNodeId = parent.nrMacNodeId;
        nrDlFbGen.macNodeId = parent.nrMacNodeId;
        rrc.nrConnectionControl.otherConnectionControlModule = "^.connectionControl";
        nrPhy.channelModelModule = "^.nrChannelModel[0]";
        nrPhy.feedbackGeneratorModule = "^.nrDlFbGen";
        nrPhy.connectionControlModule = "^.rrc.nrConnectionControl";
        rrc.nrConnectionControl.macModule = "^.^.nrMac";
        rrc.nrConnectionControl.feedbackGeneratorModule = "^.^.nrDlFbGen";
        rrc.connectionControl.otherConnectionControlModule = "^.nrConnectionControl";

    submodules:
        // uplink QoS-flow classification (the TrafficFlowFilter's uplink counterpart),
        // where uplink traffic enters the stack
        qosFlowClassifier: <default("QosFlowClassifier")> like IQosFlowClassifier if hasSdap {
            @display("p=440,150;is=s");
        }
        sdap: <default("NrSdap")> like INrSdap if hasSdap {
            @display("p=310,270");
        }
        reflectiveQosTable: <default("ReflectiveQosTable")> like IReflectiveQosTable if useReflectiveQos && hasSdap {
            @display("p=80,60,col;g=left");
        }
        // NR RLC submodules (flattened from former LteRlc compound)
        nrRlcMux: <default("RlcMux")> like IRlcMux {
            @display("p=570,580;is=s");
        }
        // MAC Layer
        nrMac: <default("NrMacUe")> like ILteMac {
            @display("p=570,660");
        }
        // PHY Layer
        nrPhy: <default("PhyUe")> like IPhy {
            @display("p=570,750");
        }
        // NR Channel Model
        nrChannelModel[numNrCarriers]: <nrChannelModelType> like IChannelModel {
            @display("p=80,60,col;g=left");
        }

        // Feedback generator submodule
        nrDlFbGen: LteDlFeedbackGenerator {
            @display("p=80,60,col;g=left");
            phyModule = "^.nrPhy";
        }

        nrPacketFlowObserver: <default("NrPacketFlowObserverUe")> like IPacketFlowObserver if hasRniSupport {
            @display("p=80,60,col;g=left");
            macModule = "^.nrMac";
            rlcModule = "^";
            isNrObserver = true;
        }

    connections:

        //# NR RLC <-> MAC
        nrRlcMux.macOut --> nrMac.upperLayerIn;
        nrRlcMux.macIn <-- nrMac.upperLayerOut;

        //#
        //# Connections from LTE Stack to radio interface
        //#
        nrMac.phyOut --> nrPhy.upperGateIn;
        nrMac.phyIn <-- nrPhy.upperGateOut;

        //# external: lower connection
        nrRadioIn --> nrPhy.radioIn;

        //# uplink QoS-flow classifier (optional, spliced above ip2nic)
        handoverPacketHolder.stackOut --> { @reconnect; } --> qosFlowClassifier.upperLayerIn if hasSdap;
        qosFlowClassifier.lowerLayerOut --> ip2nic.upperLayerIn if hasSdap;

        //# SDAP layer (optional, spliced between ip2nic and pdcpMux)
        ip2nic.stackOut --> { @reconnect; } --> sdap.upperLayerIn if hasSdap;
        sdap.pdcpOut --> pdcpMux.upperLayerIn if hasSdap;
        pdcpMux.upperLayerOut --> { @reconnect; } --> sdap.pdcpIn if hasSdap;
        sdap.upperLayerOut --> ip2nic.stackIn if hasSdap;
}

File: src/simu5g/stack/NrNicUe.ned