Searching...

No Matches

Schedule the HARQ retransmission. More...

#include "nr-mac-scheduler-harq-rr.h"

Inheritance diagram for ns3::NrMacSchedulerHarqRr:

Collaboration diagram for ns3::NrMacSchedulerHarqRr:

Public Types
using	Ns3Sched = NrMacSchedulerNs3

Public Member Functions
	NrMacSchedulerHarqRr ()
	NrMacSchedulerHarqRr constructor.

virtual	~NrMacSchedulerHarqRr ()=default
	Default deconstructor.

void	InstallDoesFhAllocationFitFn (const std::function< bool(uint16_t bwpId, uint32_t mcs, uint32_t nRegs, uint8_t dlRank)> &fn)
	Install a function to retrieve whether the allocation fits when FH Control is enabled.

void	InstallGetBwInRBG (const std::function< uint16_t()> &fn)
	Install a function to retrieve the bandwidth in RBG.

void	InstallGetBwpIdFn (const std::function< uint16_t()> &fn)
	Install a function to retrieve the bwp id.

void	InstallGetCellIdFn (const std::function< uint16_t()> &fn)
	Install a function to retrieve the cell id.

void	InstallGetDlBitmask (const std::function< std::vector< bool >()> &fn)
	Install a function to the downlink bitmask from the scheduler.

void	InstallGetFhControlMethodFn (const std::function< uint8_t()> &fn)
	Install a function to retrieve the FH Control Method (when enabled)

void	InstallGetUlBitmask (const std::function< std::vector< bool >()> &fn)
	Install a function to the uplink bitmask from the scheduler.

void	InstallReshapeAllocation (const std::function< const std::vector< DciInfoElementTdma >(const std::vector< DciInfoElementTdma > &dcis, uint8_t &startingSymbol, uint8_t &numSymbols, std::vector< bool > &bitmask, const bool isDl)> &fn)
	Install a function to retrieve whether the allocation fits when FH Control is enabled.

virtual uint8_t	ScheduleDlHarq (NrMacSchedulerNs3::PointInFTPlane startingPoint, uint8_t symAvail, const NrMacSchedulerNs3::ActiveHarqMap &activeDlHarq, const std::unordered_map< uint16_t, std::shared_ptr< NrMacSchedulerUeInfo > > &ueMap, std::vector< DlHarqInfo > dlHarqToRetransmit, const std::vector< DlHarqInfo > &dlHarqFeedback, SlotAllocInfo *slotAlloc) const
	Schedule DL HARQ in RR fashion.

virtual uint8_t	ScheduleUlHarq (NrMacSchedulerNs3::PointInFTPlane startingPoint, uint8_t symAvail, const std::unordered_map< uint16_t, std::shared_ptr< NrMacSchedulerUeInfo > > &ueMap, std::vector< UlHarqInfo > ulHarqToRetransmit, const std::vector< UlHarqInfo > &ulHarqFeedback, SlotAllocInfo *slotAlloc) const
	Schedule the UL HARQ.

virtual void	SortDlHarq (NrMacSchedulerNs3::ActiveHarqMap *activeDlHarq) const
	Sort Dl Harq retx based on their symbol requirement.

virtual void	SortUlHarq (NrMacSchedulerNs3::ActiveHarqMap *activeUlHarq) const
	(In theory) sort UL HARQ retx

Static Public Member Functions
static TypeId	GetTypeId ()

Protected Member Functions
void	BufferHARQFeedback (const std::vector< DlHarqInfo > &dlHarqFeedback, std::vector< DlHarqInfo > *dlHarqToRetransmit, uint16_t rnti, uint8_t harqProcess) const
	Find the specified HARQ process and buffer it into a vector.

uint16_t	GetBandwidthInRbg () const
	Get the bandwidth in RBG.

uint16_t	GetBwpId () const
	Get the bwp id of this MAC.

uint16_t	GetCellId () const
	Get the cell id of this MAC.

bool	GetDoesFhAllocationFit (uint16_t bwpId, uint32_t mcs, uint32_t nRegs, uint8_t dlRank) const
	Get from sched if the allocation fits when FH Control is enabled.

uint8_t	GetFromSchedFhControlMethod () const
	Get the FH Control method.

Detailed Description

Schedule the HARQ retransmission.

The class manages, in a round-robin fashion, the retransmission to be performed. It implements ScheduleDlHarq and ScheduleUlHarq that has the same signature of the methods in NrMacSchedulerNs3. For the details about the HARQ scheduling, please refer to the method documentation.

Introspection did not find any typical Config paths.

Attributes

ConsolidateHarqRetx: Consolidate HARQ DCI through reshaping to improve resource utilization
- Set with class: ns3::BooleanValue
- Underlying type: bool
- Initial value: false
- Flags: construct write read

No TraceSources are defined for this type.
Size of this type is 456 bytes (on a 64-bit architecture).

Definition at line 25 of file nr-mac-scheduler-harq-rr.h.

Member Typedef Documentation

◆ Ns3Sched

using ns3::NrMacSchedulerHarqRr::Ns3Sched = NrMacSchedulerNs3

Definition at line 28 of file nr-mac-scheduler-harq-rr.h.

Constructor & Destructor Documentation

◆ NrMacSchedulerHarqRr()

ns3::NrMacSchedulerHarqRr::NrMacSchedulerHarqRr ( )

NrMacSchedulerHarqRr constructor.

Definition at line 39 of file nr-mac-scheduler-harq-rr.cc.

Member Function Documentation

◆ BufferHARQFeedback()

void ns3::NrMacSchedulerHarqRr::BufferHARQFeedback	(	const std::vector< DlHarqInfo > &	dlHarqFeedback,
		std::vector< DlHarqInfo > *	dlHarqToRetransmit,
		uint16_t	rnti,
		uint8_t	harqProcess
	)		const

protected

Find the specified HARQ process and buffer it into a vector.

Parameters

dlHarqFeedback	HARQ not retransmitted list
dlHarqToRetransmit	HARQ buffer list (to retransmit)
rnti	RNTI to find
harqProcess	process ID to find

Definition at line 526 of file nr-mac-scheduler-harq-rr.cc.

Referenced by ScheduleDlHarq().

Here is the caller graph for this function:

◆ GetBandwidthInRbg()

uint16_t ns3::NrMacSchedulerHarqRr::GetBandwidthInRbg ( ) const

protected

Get the bandwidth in RBG.

Returns: the BW in RBG

Definition at line 559 of file nr-mac-scheduler-harq-rr.cc.

Referenced by ScheduleDlHarq(), and ScheduleUlHarq().

Here is the caller graph for this function:

◆ GetBwpId()

uint16_t ns3::NrMacSchedulerHarqRr::GetBwpId ( ) const

protected

Get the bwp id of this MAC.

Returns: the bwp id

Definition at line 547 of file nr-mac-scheduler-harq-rr.cc.

Referenced by ScheduleDlHarq().

Here is the caller graph for this function:

◆ GetCellId()

uint16_t ns3::NrMacSchedulerHarqRr::GetCellId ( ) const

protected

Get the cell id of this MAC.

Returns: the cell id

Definition at line 553 of file nr-mac-scheduler-harq-rr.cc.

◆ GetDoesFhAllocationFit()

bool ns3::NrMacSchedulerHarqRr::GetDoesFhAllocationFit	(	uint16_t	bwpId,
		uint32_t	mcs,
		uint32_t	nRegs,
		uint8_t	dlRank
	)		const

protected

Get from sched if the allocation fits when FH Control is enabled.

Returns: whether the allocation fits

Definition at line 571 of file nr-mac-scheduler-harq-rr.cc.

Referenced by ScheduleDlHarq().

Here is the caller graph for this function:

◆ GetFromSchedFhControlMethod()

uint8_t ns3::NrMacSchedulerHarqRr::GetFromSchedFhControlMethod ( ) const

protected

Get the FH Control method.

Returns: the FH Control Method (uint8_t)

Definition at line 565 of file nr-mac-scheduler-harq-rr.cc.

Referenced by ScheduleDlHarq().

Here is the caller graph for this function:

◆ GetTypeId()

TypeId ns3::NrMacSchedulerHarqRr::GetTypeId ( )

static

Definition at line 26 of file nr-mac-scheduler-harq-rr.cc.

◆ InstallDoesFhAllocationFitFn()

void ns3::NrMacSchedulerHarqRr::InstallDoesFhAllocationFitFn ( const std::function< bool(uint16_t bwpId, uint32_t mcs, uint32_t nRegs, uint8_t dlRank)> & fn )

Install a function to retrieve whether the allocation fits when FH Control is enabled.

Parameters

fn	the function

Definition at line 68 of file nr-mac-scheduler-harq-rr.cc.

◆ InstallGetBwInRBG()

void ns3::NrMacSchedulerHarqRr::InstallGetBwInRBG ( const std::function< uint16_t()> & fn )

Install a function to retrieve the bandwidth in RBG.

Parameters

Definition at line 56 of file nr-mac-scheduler-harq-rr.cc.

◆ InstallGetBwpIdFn()

void ns3::NrMacSchedulerHarqRr::InstallGetBwpIdFn ( const std::function< uint16_t()> & fn )

Install a function to retrieve the bwp id.

Parameters

fn	the function

Definition at line 44 of file nr-mac-scheduler-harq-rr.cc.

◆ InstallGetCellIdFn()

void ns3::NrMacSchedulerHarqRr::InstallGetCellIdFn ( const std::function< uint16_t()> & fn )

Install a function to retrieve the cell id.

Parameters

fn	the function

Definition at line 50 of file nr-mac-scheduler-harq-rr.cc.

◆ InstallGetDlBitmask()

void ns3::NrMacSchedulerHarqRr::InstallGetDlBitmask ( const std::function< std::vector< bool >()> & fn )

Install a function to the downlink bitmask from the scheduler.

Parameters

fn	the function

Definition at line 580 of file nr-mac-scheduler-harq-rr.cc.

◆ InstallGetFhControlMethodFn()

void ns3::NrMacSchedulerHarqRr::InstallGetFhControlMethodFn ( const std::function< uint8_t()> & fn )

Install a function to retrieve the FH Control Method (when enabled)

Parameters

Definition at line 62 of file nr-mac-scheduler-harq-rr.cc.

◆ InstallGetUlBitmask()

void ns3::NrMacSchedulerHarqRr::InstallGetUlBitmask ( const std::function< std::vector< bool >()> & fn )

Install a function to the uplink bitmask from the scheduler.

Parameters

fn	the function

Definition at line 586 of file nr-mac-scheduler-harq-rr.cc.

◆ InstallReshapeAllocation()

void ns3::NrMacSchedulerHarqRr::InstallReshapeAllocation ( const std::function< const std::vector< DciInfoElementTdma >(const std::vector< DciInfoElementTdma > &dcis, uint8_t &startingSymbol, uint8_t &numSymbols, std::vector< bool > &bitmask, const bool isDl)> & fn )

Install a function to retrieve whether the allocation fits when FH Control is enabled.

Parameters

fn	the function

Definition at line 75 of file nr-mac-scheduler-harq-rr.cc.

◆ ScheduleDlHarq()

uint8_t ns3::NrMacSchedulerHarqRr::ScheduleDlHarq	(	NrMacSchedulerNs3::PointInFTPlane *	startingPoint,
		uint8_t	symAvail,
		const NrMacSchedulerNs3::ActiveHarqMap &	activeDlHarq,
		const std::unordered_map< uint16_t, std::shared_ptr< NrMacSchedulerUeInfo > > &	ueMap,
		std::vector< DlHarqInfo > *	dlHarqToRetransmit,
		const std::vector< DlHarqInfo > &	dlHarqFeedback,
		SlotAllocInfo *	slotAlloc
	)		const

virtual

Schedule DL HARQ in RR fashion.

Parameters

startingPoint	starting point of the first retransmission.
symAvail	Available symbols
activeDlHarq	Map of the active HARQ processes
ueMap	Map of the UEs
dlHarqToRetransmit	HARQ feedbacks that could not be transmitted (to fill)
dlHarqFeedback	all the HARQ feedbacks
slotAlloc	Slot allocation info

Returns: the VarTtiSlotAlloc ID to use next

The algorithm is a bit complex, but nothing special. The HARQ should be placed in 2D space as they were before. Probably there is an error in the algorithm.

Definition at line 142 of file nr-mac-scheduler-harq-rr.cc.

References BufferHARQFeedback(), ns3::DciInfoElementTdma::DATA, ns3::DciInfoElementTdma::DL, GetBandwidthInRbg(), GetBwpId(), GetDoesFhAllocationFit(), GetFromSchedFhControlMethod(), ns3::HarqProcess::m_dciElement, ns3::NrMacSchedulerNs3::PointInFTPlane::m_rbg, ns3::HarqProcess::m_rlcPduInfo, ns3::HarqProcess::m_status, ns3::NrMacSchedulerNs3::PointInFTPlane::m_sym, ns3::HarqProcess::m_timer, ns3::SlotAllocInfo::m_varTtiAllocInfo, ns3::NrFhControl::OptimizeMcs, ns3::NrFhControl::OptimizeRBs, ns3::NrFhControl::Postponing, ns3::HarqProcess::RECEIVED_FEEDBACK, and ns3::HarqProcess::WAITING_FEEDBACK.

Here is the call graph for this function:

◆ ScheduleUlHarq()

uint8_t ns3::NrMacSchedulerHarqRr::ScheduleUlHarq	(	NrMacSchedulerNs3::PointInFTPlane *	startingPoint,
		uint8_t	symAvail,
		const std::unordered_map< uint16_t, std::shared_ptr< NrMacSchedulerUeInfo > > &	ueMap,
		std::vector< UlHarqInfo > *	ulHarqToRetransmit,
		const std::vector< UlHarqInfo > &	ulHarqFeedback,
		SlotAllocInfo *	slotAlloc
	)		const

virtual

Schedule the UL HARQ.

Parameters

startingPoint	starting point of the first retransmission. It should be set to the next available starting point
symAvail	Available symbols
ueMap	Map of the UEs
ulHarqToRetransmit	HARQ feedbacks that could not be transmitted (to fill)
ulHarqFeedback	all the HARQ feedbacks
slotAlloc	Slot allocation info

Returns: the VarTtiSlotAlloc ID to use next

The algorithm for scheduling the UL HARQ is straightforward. Since the UL transmission are all TDMA, for each NACKed process a DCI is built, with the exact same specification as the first transmission. If there aren't available symbols to retransmit the data, the feedback is buffered for the next slot.

Definition at line 389 of file nr-mac-scheduler-harq-rr.cc.

References ns3::DciInfoElementTdma::DATA, GetBandwidthInRbg(), ns3::UlHarqInfo::IsReceivedOk(), ns3::HarqProcess::m_dciElement, ns3::HarqInfo::m_harqProcessId, ns3::SlotAllocInfo::m_numSymAlloc, ns3::NrMacSchedulerNs3::PointInFTPlane::m_rbg, ns3::HarqInfo::m_rnti, ns3::HarqProcess::m_status, ns3::NrMacSchedulerNs3::PointInFTPlane::m_sym, ns3::HarqProcess::m_timer, ns3::SlotAllocInfo::m_varTtiAllocInfo, ns3::HarqProcess::RECEIVED_FEEDBACK, ns3::DciInfoElementTdma::UL, and ns3::HarqProcess::WAITING_FEEDBACK.

Here is the call graph for this function:

◆ SortDlHarq()

void ns3::NrMacSchedulerHarqRr::SortDlHarq ( NrMacSchedulerNs3::ActiveHarqMap * activeDlHarq ) const

virtual

Sort Dl Harq retx based on their symbol requirement.

Parameters

activeDlHarq map of the active retx

Definition at line 482 of file nr-mac-scheduler-harq-rr.cc.

◆ SortUlHarq()

void ns3::NrMacSchedulerHarqRr::SortUlHarq ( NrMacSchedulerNs3::ActiveHarqMap * activeUlHarq ) const

virtual

(In theory) sort UL HARQ retx

Parameters

activeUlHarq map of the active retx

Since in the uplink we are still TDMA, there is no need of sorting the HARQ. The HARQ will be picked one by one until there are no available symbol to transmit, and what is not transmitted will be queued for the next slot.

Definition at line 512 of file nr-mac-scheduler-harq-rr.cc.

The documentation for this class was generated from the following files:

Public Types

Public Member Functions

Static Public Member Functions

Protected Member Functions

Detailed Description

Attributes

Member Typedef Documentation

◆ Ns3Sched

Constructor & Destructor Documentation

◆ NrMacSchedulerHarqRr()

Member Function Documentation

◆ BufferHARQFeedback()

◆ GetBandwidthInRbg()

◆ GetBwpId()

◆ GetCellId()

◆ GetDoesFhAllocationFit()

◆ GetFromSchedFhControlMethod()

◆ GetTypeId()

◆ InstallDoesFhAllocationFitFn()

◆ InstallGetBwInRBG()

◆ InstallGetBwpIdFn()

◆ InstallGetCellIdFn()

◆ InstallGetDlBitmask()

◆ InstallGetFhControlMethodFn()

◆ InstallGetUlBitmask()

◆ InstallReshapeAllocation()

◆ ScheduleDlHarq()

◆ ScheduleUlHarq()

◆ SortDlHarq()

◆ SortUlHarq()