BackgroundCellChannelModel

simple module

This module configures the channel parameters associated with a BackgroundCell. It is used to compute the channel quality for background UEs (refer to the BackgroundUe module), which in turn is essential for deriving the correct allocation of time-frequency resources via the Adaptive Modulation and Coding mechanism.

Used in compound modules

Name	Type	Description
BackgroundCell	compound module	This module implements a lightweight model for a 4G eNodeB or 5G gNodeB. It is used to generate configurable inter-cell interference in the simulated network. Compared to the eNodeB and gNodeB modules, this module occupies time-frequency resources in both the uplink and downlink bandwidth without simulating the actual transmission or reception of data packets to or from User Equipments (UEs). Therefore, it is significantly more efficient from a simulation speed perspective. To achieve this, it includes a BackgroundTrafficGenerator to customize the level of background traffic to be simulated, a BackgroundChannelModel to configure channel parameters, and a BackgroundScheduler that manages the allocation of time-frequency resources based on the traffic generator. Note that this module can generate interference on only one Component Carrier, as configured in the BackgroundScheduler module. To produce interference across multiple carriers, it is possible to use multiple instances of this module, each configured with the desired carrier frequency.

Parameters

Name	Type	Default value	Description
binderModule	string	"binder"	modules
shadowing	bool	true	Enable/disable shadowing
scenario	string	"URBAN_MACROCELL"	Pathloss scenario from ITU -->
nodeb_height	double	25m	eNodeB height -->
building_height	double	20m	Building height -->
inside_building	bool	false	determines if the UE is inside a building
street_wide	double	20m	TODO width
ue_height	double	1.5m
tolerateMaxDistViolation	bool	false
correlation_distance	double	50m
antennaGainUe	double	0dBi	Antenna Gain of UE --> wrt an isotropic antenna
antennGainEnB	double	18dBi	Antenna Gain of eNodeB -->
antennGainMicro	double	5dBi	Antenna Gain of Micro node -->
thermalNoise	double	-104.5dBm	Thermal Noise for 10 MHz of Bandwidth -->
ue_noise_figure	double	7dBm	Ue noise figure -->
bs_noise_figure	double	5dBm	eNodeB noise figure -->
cable_loss	double	2dB	Cable Loss -->
dynamic_los	bool	false	If true enable the possibility to switch dinamically the LOS/NLOS pathloss computation -->
fixed_los	bool	false	If dynamic-los is false this parameter, if true, compute LOS pathloss otherwise compute NLOS pathloss -->
fading	bool	true	Enable/disable fading -->
fading_type	string	"JAKES"	Fading type (JAKES or RAYLEIGH) -->
fading_paths	int	6	If jakes fading this parameter specify the number of path (tap channel) -->
delay_rms	double	363ns
bgCell_interference	bool	true	if true, enables the inter-cell interference computation for UL and DL connections from background cells -->
downlink_interference	bool	true	if true, enables the inter-cell interference computation for DL connections -->
uplink_interference	bool	true	if true, enables the interference computation for UL connections -->

Properties

Name	Value	Description
display	i=block/control
class	BackgroundCellChannelModel

Source code

//
// This module configures the channel parameters associated with a ~BackgroundCell. It is used
// to compute the channel quality for background UEs (refer to the ~BackgroundUe module), which in
// turn is essential for deriving the correct allocation of time-frequency resources via the
// Adaptive Modulation and Coding mechanism.
//
simple BackgroundCellChannelModel
{
    parameters:
        @display("i=block/control");
        @class("BackgroundCellChannelModel");

        // modules
        string binderModule = default("binder");

        // Enable/disable shadowing
        bool shadowing = default(true);

        // Pathloss scenario from ITU -->
        string scenario @enum(INDOOR_HOTSPOT,URBAN_MICROCELL,URBAN_MACROCELL,RURAL_MACROCELL,SUBURBAN_MACROCELL,UNKNOW_SCENARIO) = default("URBAN_MACROCELL");

        // eNodeB height -->
        double nodeb_height @unit(m) = default(25m);
        // Building height -->
        double building_height @unit(m) = default(20m);
        // determines if the UE is inside a building
        bool inside_building = default(false);

        double street_wide @unit(m) = default(20m); //TODO width
        double ue_height @unit(m) = default(1.5m);
        bool tolerateMaxDistViolation = default(false);

        double correlation_distance @unit(m) = default(50m);

        // Antenna Gain of UE --> wrt an isotropic antenna
        double antennaGainUe @unit(dBi) = default(0dBi);
        // Antenna Gain of eNodeB -->
        double antennGainEnB @unit(dBi) = default(18dBi);
        // Antenna Gain of Micro node -->
        double antennGainMicro @unit(dBi) = default(5dBi);
        // Thermal Noise for 10 MHz of Bandwidth -->
        double thermalNoise @unit(dBm) = default(-104.5dBm);
        // Ue noise figure -->
        double ue_noise_figure @unit(dBm) = default(7dBm);
        // eNodeB noise figure -->
        double bs_noise_figure @unit(dBm) = default(5dBm);
        // Cable Loss -->
        double cable_loss @unit(dB) = default(2dB);

        // If true enable the possibility to switch dinamically the LOS/NLOS pathloss computation -->
        bool dynamic_los = default(false);
        // If dynamic-los is false this parameter, if true, compute LOS pathloss otherwise compute NLOS pathloss -->
        bool fixed_los = default(false);
        // Enable/disable fading -->
        bool fading = default(true);
        // Fading type (JAKES or RAYLEIGH) -->
        string fading_type @enum(RAYLEIGH,JAKES) = default("JAKES");
        // If jakes fading this parameter specify the number of path (tap channel) -->
        int fading_paths = default(6);
        double delay_rms @unit(s) = default(363ns);

        // if true, enables the inter-cell interference computation for UL and DL connections from background cells -->
        bool bgCell_interference = default(true);
        // if true, enables the inter-cell interference computation for DL connections -->
        bool downlink_interference = default(true);
        // if true, enables the interference computation for UL connections -->
        bool uplink_interference = default(true);
}

File: src/nodes/backgroundCell/BackgroundCellChannelModel.ned