nrRLCBearerConfig
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.
config = nrRLCBearerConfig(
sets
properties using one or more
optional name-value arguments. For example,
Name=Value
)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) | 0
5
| 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 secondBucket 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 R2023aR2024a: 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.
MATLAB Command
You clicked a link that corresponds to this MATLAB command:
Run the command by entering it in the MATLAB Command Window. Web browsers do not support MATLAB commands.
Select a Web Site
Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select: .
You can also select a web site from the following list:
How to Get Best Site Performance
Select the China site (in Chinese or English) for best site performance. Other MathWorks country sites are not optimized for visits from your location.
Americas
- América Latina (Español)
- Canada (English)
- United States (English)
Europe
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)