Main Content

nrRLCBearerConfig

RLC bearer configuration parameters

Since R2023a

    Description

    The nrRLCBearerConfig object sets the radio link control (RLC) bearer configuration parameters for establishing an RLC bearer between a next-generation Node B (gNB) and a user equipment (UE). This object implements the information element (IE) RLC-BearerConfig, as defined in TS 38.331 Section 6.3.2 [1].

    Creation

    Description

    config = nrRLCBearerConfig creates a default RLC bearer configuration object.

    example

    config = nrRLCBearerConfig(Name=Value) sets properties using one or more optional name-value arguments. For example, nrRLCBearerConfig(LogicalChannelID=5) sets the logical channel identifier to 5.

    example

    Properties

    expand all

    Logical channel identifier, specified as an integer in the range [4, 32].

    Data Types: double

    Type of the RLC entity, specified as one of these values.

    • "UM" — Bidirectional RLC bearer in the unacknowledged mode (UM)

    • "UMUL" — Unidirectional RLC UM bearer in the uplink (UL) direction

    • "UMDL" — Unidirectional RLC UM bearer in the downlink (DL) direction

    • "AM" — RLC bearer in the acknowledged mode (AM) (since R2024a)

    Data Types: char | string

    Number of bits in the sequence number field of the RLC entity, specified as 6, 12, or 18. For "UM", "UMDL", or "UMUL" RLC entity types, the sequence number field length can be 6 or 12 bits. However, for the RLC AM entity, the sequence number field length can be 12 or 18 bits.

    Data Types: double

    RLC transmitter buffer size, specified as a positive integer. This property expresses the buffer size in terms of number of packets.

    Data Types: double

    Since R2024a

    Allowable number of acknowledged mode data (AMD) protocol data unit (PDU) transmissions before requesting the status PDU, specified as one of these options.

    • 4

    • 8

    • 16

    • 32

    • 64

    • 128

    • 256

    • 512

    • 1024

    • 2048

    • 4096

    • 6144

    • 8192

    • 12288

    • 16384

    • 20480

    • 24576

    • 28672

    • 32768

    • 40960

    • 49152

    • 57344

    • 65536

    • Inf

    Dependencies

    To enable this property, set the RLCEntityType property to "AM".

    Data Types: double

    Since R2024a

    Allowable number of service data unit (SDU) byte transmissions before requesting the status PDU, specified as one of these options. Units are in bytes.

    • 1e3

    • 2e3

    • 5e3

    • 8e3

    • 10e3

    • 15e3

    • 25e3

    • 50e3

    • 75e3

    • 100e3

    • 125e3

    • 250e3

    • 375e3

    • 500e3

    • 750e3

    • 1.25e6

    • 1.5e6

    • 2e6

    • 3e6

    • 4e6

    • 4.5e5

    • 5e6

    • 5.5e6

    • 6e6

    • 6.5e6

    • 7e6

    • 7.5e6

    • 8e6

    • 9e6

    • 10e6

    • 11e6

    • 12e6

    • 13e6

    • 14e6

    • 15e6

    • 16e6

    • 17e6

    • 18e6

    • 20e6

    • 25e6

    • 30e6

    • 40e6

    • Inf

    Dependencies

    To enable this property, set the RLCEntityType property to "AM".

    Data Types: double

    Since R2024a

    Maximum number of retransmissions of an AMD PDU, specified as one of these options.

    • 1

    • 2

    • 3

    • 4

    • 6

    • 8

    • 16

    • 32

    Dependencies

    To enable this property, set the RLCEntityType property to "AM".

    Data Types: double

    Since R2024a

    Waiting time before retransmitting the PDU request, specified as one of these options. Units are in milliseconds.

    • 5

    • 10

    • 15

    • 20

    • 25

    • 30

    • 35

    • 40

    • 45

    • 50

    • 55

    • 60

    • 65

    • 70

    • 75

    • 80

    • 85

    • 90

    • 95

    • 100

    • 105

    • 110

    • 115

    • 120

    • 125

    • 130

    • 135

    • 140

    • 145

    • 150

    • 155

    • 160

    • 165

    • 170

    • 175

    • 180

    • 185

    • 190

    • 200

    • 205

    • 210

    • 215

    • 220

    • 225

    • 230

    • 235

    • 240

    • 235

    • 240

    • 245

    • 250

    • 300

    • 350

    • 400

    • 450

    • 500

    • 800

    • 1000

    • 2000

    • 4000

    Dependencies

    To enable this property, set the RLCEntityType property to "AM".

    Data Types: double

    Waiting time before declaring the reassembly failure of SDUs in the reception buffer, specified as one of these options. Units are in milliseconds.

    • 0

    • 5

    • 10

    • 15

    • 20

    • 25

    • 30

    • 35

    • 40

    • 45

    • 50

    • 55

    • 60

    • 65

    • 70

    • 75

    • 80

    • 85

    • 90

    • 95

    • 100

    • 110

    • 120

    • 130

    • 140

    • 150

    • 160

    • 170

    • 180

    • 190

    • 200

    Data Types: double

    Since R2024a

    Waiting time before transmitting the status PDU following the previous status PDU transmission, specified as one of these options. Units are in milliseconds.

    • 0

    • 5

    • 10

    • 15

    • 20

    • 25

    • 30

    • 35

    • 40

    • 45

    • 50

    • 55

    • 60

    • 65

    • 70

    • 75

    • 80

    • 85

    • 90

    • 95

    • 100

    • 105

    • 110

    • 115

    • 120

    • 125

    • 130

    • 135

    • 140

    • 145

    • 150

    • 155

    • 160

    • 165

    • 170

    • 175

    • 180

    • 185

    • 190

    • 200

    • 205

    • 210

    • 215

    • 220

    • 225

    • 230

    • 235

    • 240

    • 235

    • 240

    • 245

    • 250

    • 300

    • 350

    • 400

    • 450

    • 500

    • 800

    • 1000

    • 1200

    • 1600

    • 2000

    • 2400

    Dependencies

    To enable this property, set the RLCEntityType property to "AM".

    Data Types: double

    Logical channel group identifier, specified as an integer in the range [1, 7].

    Data Types: double

    Priority of the logical channel, specified as an integer in the range [1, 16].

    Data Types: double

    Prioritized bit rate of the logical channel, specified as one of these options. Units are in kilobytes per second.

    • 0

    • 8

    • 16

    • 32

    • 64

    • 128

    • 256

    • 512

    • 1024

    • 2048

    • 4096

    • 8192

    • 16384

    • 32768

    • 65536

    • inf

    Data Types: double

    Bucket size duration of the logical channel, specified as one of these options. Units are in milliseconds.

    • 5

    • 10

    • 20

    • 50

    • 100

    • 150

    • 300

    • 500

    • 1000

    • inf

    Data Types: double

    Examples

    collapse all

    Check if the Communications Toolbox™ Wireless Network Simulation Library support package is installed. If the support package is not installed, MATLAB® returns an error with a link to download and install the support package.

    wirelessnetworkSupportPackageCheck;

    Create a default gNB node.

    gNBNode = nrGNB;

    Create a default UE node.

    ueNode = nrUE;

    Create a default RLC bearer configuration object.

    rlcBearerConfig = nrRLCBearerConfig;

    Establish an RLC bearer between the gNB and UE nodes.

    connectUE(gNBNode,ueNode,RLCBearerConfig=rlcBearerConfig)

    Check if the Communications Toolbox™ Wireless Network Simulation Library support package is installed. If the support package is not installed, MATLAB® returns an error with a link to download and install the support package.

    wirelessnetworkSupportPackageCheck;

    Create default gNB and UE nodes.

    gNBNode = nrGNB;
    ueNode = nrUE;

    Create an RLC bearer configuration object with these parameters.

    • Logical channel ID — 5

    • RLC entity type — "UMDL"

    • Priority — 16

    • Logical channel group — 2

    • Prioritized bit rate — 256 kilobits per second

    • Bucket size duration — 300 milliseconds

    cfgRLCBearer = nrRLCBearerConfig( ...
        LogicalChannelID=5, ...
        RLCEntityType="UMDL", ...
        LogicalChannelGroup=2, ...
        Priority=16, ...
        PrioritizedBitRate=256, ...
        BucketSizeDuration=300);

    Establish a unidirectional RLC UM bearer in the DL direction.

    connectUE(gNBNode,ueNode,RLCBearerConfig=cfgRLCBearer)

    References

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

    Version History

    Introduced in R2023a

    expand all