scheduleNewTransmissionsUL

R2026b

Class: nrScheduler

Schedule New UL Transmissions

Since R2024b

expand all in page

Syntax

ulGrants = scheduleNewTransmissionsUL(newradioscheduler,timeFrequencyResource,schedulingInfo)

Description

ulGrants = scheduleNewTransmissionsUL(newradioscheduler,timeFrequencyResource,schedulingInfo) assigns frequency resources to user equipment (UE) nodes for new uplink (UL) transmissions across one or more carriers in a transmission time interval (TTI). The timeFrequencyResource argument specifies the TTI and available resources for each carrier. For a given TTI, the NR scheduler calls this function once it has met any UL retransmission needs for the UE nodes on each carrier. Thus, the FrequencyResource field in each timeFrequencyResource element indicates which resource blocks or resource block groups remain available for new transmission scheduling on that specific carrier

Input Arguments

expand all

NR scheduler, specified as an object of a subclass of nrScheduler.

Since R2026b

Time-frequency resource, specified as a structure array representing the TTI for one or more carriers, detailing both the time symbols and frequency resources being scheduled by the scheduler. Each element in the array corresponds to a carrier. The structure contains these fields:

  • GNBCarrierIndex — Carrier index at the gNB. The value is a positive integer that identifies the carrier scheduled. This corresponds to the index in the CellConfig array.

  • NFrame — Absolute frame number of the symbols being scheduled. Nonnegative integer scalar representing the frame number in which the scheduling occurs. This follows a zero-based numbering system.

  • NSlot — Slot number within the frame. Nonnegative integer scalar indicating the slot number within the frame NFrame that contains the symbols being scheduled. This follows a zero-based numbering system and ranges from 0 to (NumSlotsFrame - 1).

  • SymbolAllocation — Vector with two elements [StartSym, NumSym] that define the range of symbols being scheduled within the slot NSlot of the frame NFrame.

    • StartSym — Start symbol number within the slot NSlot, marking the beginning of the TTI. This follows a zero-based numbering system and ranges from 0 to 13.

    • NumSym — Number of consecutive symbols being scheduled starting from StartSym. This defines the length of the TTI in terms of symbols and ranges from 1 to 14.

  • FrequencyResource — Frequency resource occupancy bitmap. Vector indicating the occupancy status of resource blocks (RBs) or resource block groups (RBGs) after retransmission assignments have been completed. The interpretation depends on the resource allocation type:

    • When you set the ResourceAllocationType name-value argument of the configureScheduler function to 1 (RAT-1), frequencyResource is a bit array with a length equal to the number of resource blocks (RBs) in the DL bandwidth. Each bit represents an RB. A bit value of 0 indicates that the corresponding RB is available for new transmission scheduling, whereas a value of 1 indicates the RB is unavailable.

    • When you set the ResourceAllocationType name-value argument to 0 (RAT-0), FREQUENCYRESOURCE is a bit array with a length equal to the number of resource block groups (RBGs) in the UL bandwidth. Each bit represents an resource block group (RBG). A bit value of 0 indicates that the corresponding RBG is available for new transmission scheduling, whereas a value of 1 indicates the RBG is unavailable. To determine the size of an RBG, the nrScheduler class uses Configuration 1 as described in TS 38.214, Table 5.1.2.2.1-1 [1].

Scheduling information, specified as a structure or a vector of structures. Each element corresponds to a carrier and contains the information for scheduling decisions within a TTI. The structure contains these fields:

  • EligibleUEs — Array containing the Radio Network Temporary Identifiers (RNTIs) of user equipment (UE) nodes eligible for allocation in the current TTI. This set comprises all UEs connected to the gNB, except those meeting any of these criteria:

    • The UE node has a scheduled retransmission in this TTI.

    • The UE node has no data queued.

    • The UE node has all its hybrid automatic repeat request (HARQ) processes blocked.

    When no UE nodes meet the eligibility criteria due to these conditions, the scheduler does not invoke this function.

  • MaxNumUsersTTI — Maximum number of UE nodes eligible for new transmissions within the TTI, adjusted for retransmissions. It equals the total maximum allowed users in a TTI minus the number of UEs scheduled for retransmissions in that TTI. For more information about the total maximum allowed users in a TTI, see the MaxNumUsersPerTTI name-value argument of the configureScheduler function. The scheduler calls this function if the value of this field is greater than zero.

    In addition to the information in schedulingInfo, the scheduler can use any other context from the scheduler object, newradioscheduler, to decide on resource allocation to UEs.

Note

Starting in R2026b, with carrier aggregation support, schedulingInfo can be a vector of structures or a scalar structures. In R2026a and earlier releases, it is a scalar structure.

Output Arguments

expand all

Physical uplink shared channel (PUSCH) grants, returned as an array of structures. The number of elements in the array must not exceed the MaxNumUsersTTI field of the schedulingInfo argument. Each structure element represents one PUSCH grant for a UE node and contains these fields:

  • GNBCarrierIndex — Carrier index at the gNB node on which the PUSCH is scheduled, returned as a positive integer. (since R2026b)

  • RNTI — Radio network temporary identifier of the UE node. This RNTI must belong to the EligibleUEs field of the schedulingInfo argument.

  • FrequencyAllocation — Frequency allocation for the UE node, returned as one of these options:

    • For RAT-1, it is a vector of two elements indicating the start RB and the number of RBs, with the start RB following a zero-based numbering system.

    • For RAT-0, it is a bit vector with a length equal to frequencyResource. A value of 1 at an index indicates that the scheduler has allocated the corresponding RBG to the UE node.

  • MCSIndex — Selected modulation and coding scheme, represented as a zero-based row index in the MCS table as described in the TS 38.214, Table 5.1.3.1-2 [1]. The value of the MCSIndex field is an integer in the range [0, 27].

  • NumLayers — Number of transmission layers, returned as an integer in the range [1, 4]. The value of this field must be less than or equal to the NumTransmitAntennas property of UEContext with the corresponding RNTI.

  • TPMI — Transmitted precoding matrix indicator, returned as an integer in the range [0, 27]. The valid range of TPMI depends on the specified NumLayers and the assumption that the number of antenna ports equals the NumTransmitAntennas property of UEContext with the corresponding RNTI. For more information about TPMI, see TS 38.211, Tables 6.3.1.5-1 to 6.3.1.5-7.

References

[1] 3GPP TS 38.321. “NR; Medium Access Control (MAC) protocol specification.” 3rd Generation Partnership Project; Technical Specification Group Radio Access Network.

[2] 3GPP TS 38.214. “NR; Physical layer procedures for data.” 3rd Generation Partnership Project; Technical Specification Group Radio Access Network.

Version History

Introduced in R2024b

expand all

See Also

Classes

Functions

Objects

Topics