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

Syntax

config = nrRLCBearerConfig

config = nrRLCBearerConfig(Name=Value)

Description

config = nrRLCBearerConfig creates a default RLC bearer configuration object.

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.

Properties

LogicalChannelID — Logical channel identifier

4 (default) | integer in range [4, 32]

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

Data Types: double

RLCEntityType — Type of RLC entity

"UM" (default) | "UMUL" | "UMDL" | "AM" (since R2024a)

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

SNFieldLength — Number of bits in sequence number field of RLC entity

12 (default) | 6 | 18

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

BufferSize — RLC transmitter buffer size

400 (default) | positive integer

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

Data Types: double

PollPDU — Allowable number of AMD PDU transmissions before requesting status PDU

32 (default) | 4 | 8 | 16 | ...

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

PollByte — Allowable number of SDU byte transmissions before requesting status PDU

Inf (default) | 1e3 | 2e3 | 5e3 | ...

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

MaxRetxThreshold — Maximum number of retransmissions of AMD PDU

4 (default) | 1 | 2 | 3 | ...

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

PollRetransmitTimer — Waiting time before retransmitting PDU request

80 (default) | 5 | 10 | 15 | ...

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

ReassemblyTimer — Waiting time before declaring reassembly failure of SDUs in reception buffer

30 (default) | 0 | 5 | 10 | ...

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

StatusProhibitTimer — Waiting time before transmitting status PDU following previous status PDU transmission

40 (default) | 05 | 10 | 15 | ...

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

LogicalChannelGroup — Logical channel group identifier

1 (default) | integer in range [1, 7]

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

Data Types: double

Priority — Priority of logical channel

1 (default) | integer in the range [1, 16]

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

Data Types: double

PrioritizedBitRate — Prioritized bit rate of logical channel

8 (default) | 0 | 16 | 32 | ...

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

BucketSizeDuration — Bucket size duration of logical channel

1000 (default) | 5 | 10 | 20 | ...

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

Establish RLC Bearer Between gNB and UE

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)

Establish Unidirectional RLC UM Bearer in DL Direction

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

R2024a: Includes support for RLC acknowledged mode

The RLCEntityType property of the nrRLCBearerConfig object now enables you to specify a radio link control (RLC) acknowledged mode (AM) radio bearer between a gNB and UE node. Setting this property to "AM" enables you to configure the AM radio bearer through the PollPDU, PollByte, MaxRetxThreshold, PollRetransmitTimer, and StatusProhibitTimer properties.