LteMacUeD2D

simple module

This module extends LTE MAC functionalities at the User Equipment side to support device-to-device (D2D) communications. Specifically, it customizes LteMacUe functionalities to support the transmission and reception of MAC Protocol Data Units (PDUs), Channel Status Information (CSI), and Buffer Status Reports (BSRs) over a D2D link. It supports D2D multicast transmission to nearby UEs belonging to a given multicast group.

Inheritance diagram

The following diagram shows inheritance relationships for this type. Unresolved types are missing from the diagram.

Known subclasses

Name	Type	Description
NRMacUe	simple module	This module provides functionalities for the Medium Access Control (MAC) of the New Radio (NR) protocol stack at the User Equipment (UE) side. In particular, it extends the LteMacUeD2D module by redefining functions to support different numerology parameterizations.

Extends

Name	Type	Description
LteMacUe	simple module	This module extends the LteMacBase(1,2) module by providing specific MAC functions at the User Equipment (UE) side. For uplink connections, this module manages the initiation of the Random Access procedure (RAC) and the sending of Buffer Status Reports (BSRs) to the eNodeBs. Once it receives an uplink scheduling grant from the eNodeB, it is responsible for managing the local connections' scheduler and constructing MAC Protocol Data Units (PDUs) to be transmitted to the physical layer.

Parameters

Name	Type	Default value	Description
binderModule	string	"binder"
packetFlowManagerModule	string	"^.packetFlowManager"	TODO or nrPacketFlowManager
queueSize	int	2MiB
muMimo	bool	true
harqProcesses	int	8
maxHarqRtx	int	3
harqFbEvaluationTimer	int	4	number of slots for sending back HARQ FB
statDisplay	bool	false
collectorModule	string	""
usePreconfiguredTxParams	bool	false
d2dCqi	int	7
rlcUmModule	string	"^.rlc.um"
pdcpRrcModule	string	"^.pdcpRrc"

Properties

Name	Value	Description
display	i=block/mac
class	LteMacUeD2D

Gates

Name	Direction	Description
RLC_to_MAC	input	RLC to MAC
MAC_to_RLC	output	MAC to RLC
PHY_to_MAC	input	PHY to MAC
MAC_to_PHY	output	MAC to PHY

Signals

Name	Type	Unit	Description
harqErrorRate_2nd_D2D
harqErrorRate_4th_D2D
macPacketLossD2D
harqErrorRateD2D
harqErrorRate_3rd_D2D
macThroughputD2D
rcvdD2DModeSwitchNotification
macDelayD2D
harqErrorRate_1st_D2D

Statistics

Name	Title	Source	Record	Unit
harqErrorRate_2nd_D2D	Harq Error Rate D2D (2nd Tx)	harqErrorRate_2nd_D2D	mean, vector
harqErrorRate_4th_D2D	Harq Error Rate D2D (4th Tx)	harqErrorRate_4th_D2D	mean, vector
macPacketLossD2D	Mac Packet Loss D2D	macPacketLossD2D	mean
harqErrorRateD2D	Harq Error Rate D2D	harqErrorRateD2D	mean, vector
harqErrorRate_3rd_D2D	Harq Error Rate D2D (3rd Tx)	harqErrorRate_3rd_D2D	mean, vector
macThroughputD2D	Throughput at the MAC layer D2D	macThroughputD2D	mean	Bps
rcvdD2DModeSwitchNotification	Reception of mode switch notification (tx side)	rcvdD2DModeSwitchNotification	count, vector
macDelayD2D	Delay at the MAC layer D2D	macDelayD2D	mean, vector	s
harqErrorRate_1st_D2D	Harq Error Rate D2D (1st Tx)	harqErrorRate_1st_D2D	mean, vector

Source code

//
// This module extends LTE MAC functionalities at the User Equipment side to support device-to-device (D2D)
// communications. Specifically, it customizes ~LteMacUe functionalities to support the transmission and reception
// of MAC Protocol Data Units (PDUs), Channel Status Information (CSI), and Buffer Status Reports (BSRs) over a
// D2D link. It supports D2D multicast transmission to nearby UEs belonging to a given multicast group.
//
simple LteMacUeD2D extends LteMacUe
{
    parameters:
        @class("LteMacUeD2D");

        bool usePreconfiguredTxParams = default(false);
        int d2dCqi = default(7);
        string rlcUmModule = default("^.rlc.um");
        string pdcpRrcModule = default("^.pdcpRrc");

        @signal[harqErrorRate_1st_D2D];
        @statistic[harqErrorRate_1st_D2D](title="Harq Error Rate D2D (1st Tx)"; unit=""; source="harqErrorRate_1st_D2D"; record=mean,vector);
        @signal[harqErrorRate_2nd_D2D];
        @statistic[harqErrorRate_2nd_D2D](title="Harq Error Rate D2D (2nd Tx)"; unit=""; source="harqErrorRate_2nd_D2D"; record=mean,vector);
        @signal[harqErrorRate_3rd_D2D];
        @statistic[harqErrorRate_3rd_D2D](title="Harq Error Rate D2D (3rd Tx)"; unit=""; source="harqErrorRate_3rd_D2D"; record=mean,vector);
        @signal[harqErrorRate_4th_D2D];
        @statistic[harqErrorRate_4th_D2D](title="Harq Error Rate D2D (4th Tx)"; unit=""; source="harqErrorRate_4th_D2D"; record=mean,vector);
        @signal[harqErrorRateD2D];
        @statistic[harqErrorRateD2D](title="Harq Error Rate D2D"; unit=""; source="harqErrorRateD2D"; record=mean,vector);
        @signal[macPacketLossD2D];
        @statistic[macPacketLossD2D](title="Mac Packet Loss D2D"; unit=""; source="macPacketLossD2D"; record=mean);
        @signal[macDelayD2D];
        @statistic[macDelayD2D](title="Delay at the MAC layer D2D"; unit="s"; source="macDelayD2D"; record=mean,vector);
        @signal[macThroughputD2D];
        @statistic[macThroughputD2D](title="Throughput at the MAC layer D2D"; unit="Bps"; source="macThroughputD2D"; record=mean);

        @signal[rcvdD2DModeSwitchNotification];
        @statistic[rcvdD2DModeSwitchNotification](title="Reception of mode switch notification (tx side)"; unit=""; source="rcvdD2DModeSwitchNotification"; record=count,vector);
}

File: src/stack/mac/LteMacUeD2D.ned