BackgroundScheduler

simple module

This module is responsible for computing the allocation of time-frequency resources for background UEs in a BackgroundCell, taking into account the traffic generated by these UEs and their channel quality.

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"
trafficManagerModule	string	"^.bgTrafficGenerator.manager"
channelModelModule	string	"^.bgChannelModel"
txPower	double	46dBm	transmission power
txDirection	string	"OMNI"	transmission direction
txAngle	double	0deg	transmission angle
isNr	bool	false	flag to indicate whether this is a NR base station
numerologyIndex	int	0	operating carrier
carrierFrequency	double	2GHz	operating carrier
numBands	int	6	carrier bandwidth

Properties

Name	Value	Description
display	i=block/control
class	BackgroundScheduler

Signals

Name	Type	Unit	Description
bgAvgServedBlocksDl			statistics
bgAvgServedBlocksUl

Statistics

Name	Title	Source	Record	Unit	Interpolation Mode	Description
bgAvgServedBlocksDl	Average DL served blocks for background cells	bgAvgServedBlocksDl	mean, vector
bgAvgServedBlocksUl	Average UL served blocks for background cells	bgAvgServedBlocksUl	mean, vector

Source code

//
// This module is responsible for computing the allocation of time-frequency resources
// for background UEs in a ~BackgroundCell, taking into account the traffic generated
// by these UEs and their channel quality.
//
simple BackgroundScheduler
{
    parameters:
        @display("i=block/control");
        @class("BackgroundScheduler");

        string binderModule = default("binder");
        string trafficManagerModule = default("^.bgTrafficGenerator.manager");
        string channelModelModule = default("^.bgChannelModel");

        // transmission power
        double txPower @unit(dBm) = default(46dBm);

        // transmission direction
        string txDirection @enum(ANISOTROPIC,OMNI) = default("OMNI");

        // transmission angle
        double txAngle @unit(deg) = default(0deg);

        // flag to indicate whether this is a NR base station
        bool isNr = default(false);

        // operating carrier
        int numerologyIndex = default(0);

        // operating carrier
        double carrierFrequency @unit(GHz) = default(2GHz);

        // carrier bandwidth
        int numBands = default(6);

        // statistics
        @signal[bgAvgServedBlocksDl];
        @statistic[bgAvgServedBlocksDl](title="Average DL served blocks for background cells"; unit=""; source="bgAvgServedBlocksDl"; record=mean,vector);
        @signal[bgAvgServedBlocksUl];
        @statistic[bgAvgServedBlocksUl](title="Average UL served blocks for background cells"; unit=""; source="bgAvgServedBlocksUl"; record=mean,vector);
}

File: src/nodes/backgroundCell/BackgroundScheduler.ned