Main Content

pre6GReferenceSignalConfig

R2026b

Pre-6G RS configuration parameters

Since R2026a

Description

Add-On Required: This feature requires the 6G Exploration Library for 5G Toolbox add-on.

The pre6GReferenceSignalConfig object enables you to create reference signal (RS) configuration parameters for 6G research and prototyping. The object defines time-frequency locations, code-division multiplexing (CDM) structure, and ports for resource element (RE) mapping, without 5G-specific restrictions.

Creation

Description

rs = pre6GReferenceSignalConfig creates an RS configuration object with default properties.

example

rs = pre6GReferenceSignalConfig(PropertyName=Value) also specifies writable properties using one or more name-value arguments. For example, FrequencyDomainCDM=8 specifies a frequency-domain orthogonal cover code (OCC) of length 8. Unspecified properties take their default values.

example

Properties

expand all

Physical resource block (PRB) allocation of the RSs, specified as a vector of nonnegative integers.

Data Types: double

Scrambling sequence initialization value, specified as [] or an integer in the range [0, 231 – 1]. When you use the default value, [], the pre6GReferenceSignal function uses this value to initialize the pseudo-random binary sequence (PRBS) generator for scrambling the codeword bits. If you use the default value, [], the function initializes the PRBS generator using the NCellID property of its carrier input object instead. How the function uses this value depends on the Modulation property:

  • "pi/2-BPSK", "BPSK", or "QPSK" — The value initializes the pseudo-random binary sequence (PRBS) generator.

  • "low-papr-type1" — The value modulo 30 is the sequence group number. The function does not apply group hopping or sequence hopping.

  • "low-papr-type2" — The value is the sequence initialization, and the value modulo 30 is the sequence group number.

Since R2026b

RS sequence type, specified as one of these values:

  • "pi/2-BPSK", "BPSK", or "QPSK" — Modulated with the specified modulation scheme.

  • "low-papr-type1" — Type 1 low peak-to-average power ratio (low-PAPR) sequence, as defined in TS 38.211 Section 5.2.2 [1]. 5G uses this sequence type for the PUSCH DM-RS with transform precoding and for the SRS.

  • "low-papr-type2" — Type 2 low-PAPR sequence, as defined in TS 38.211 Section 5.2.3 [1]. 5G uses this sequence type for the PUSCH DM-RS with Release 16 transform precoding.

When you specify this property as "low-papr-type1", the RS ports within each frequency-domain CDM (FD-CDM) group use different cyclic shifts of the same sequence instead of orthogonal cover codes (OCCs). The CyclicShifts property specifies the cyclic shifts. In this case, the TimeDomainCDM property must be 1.

For low-PAPR sequences, when the number of RS subcarriers in each OFDM symbol of an FD-CDM group, NSC, is less than 36 and not a multiple of 6, TS 38.211 does not define a sequence. In this case, the sequence the pre6GReferenceSignal function uses depends on the low-PAPR type:

  • For type 1, the function uses the first NSC elements of the type 1 low-PAPR sequence of length 6⌈NSC/6⌉.

  • For type 2, the function uses the discrete Fourier transform (DFT) of a pi/2-BPSK modulated PRBS of length NSC, normalized by √NSC.

Data Types: char | string

Length of frequency-domain OCC, specified as a positive integer. The value must be a power of 2.

Frequency-domain locations of RS REs, specified as a matrix of nonnegative integers. The size of the matrix is N-by-FG, where:

  • N is an integer multiple of the FrequencyDomainCDM property

  • FG is the number of frequency-domain CDM groups.

The subcarrier locations span the smallest whole number of resource blocks (RBs) that contains them, and this pattern repeats across the carrier. If the PRBSet property includes any RB of a repetition, it must include all RBs of that repetition.

Since R2026b

Frequency-domain CDM weights, specified as [] or an F-by-F matrix, where F is the value of the FrequencyDomainCDM property. Each row of the matrix is the frequency-domain OCC for one port within an FD-CDM group. The elements can be complex.

When you use the default value, [], the object uses built-in OCCs with elements equal to ±1. To view the frequency-domain OCC that each port uses, see the w_f column of the CDMTable property.

This property does not apply when you set Modulation to "low-papr-type1".

Data Types: double | single
Complex Number Support: Yes

Length of time-domain OCC, specified as a positive integer. The value must be a power of 2. When the Modulation property is "low-papr-type1", the value must be 1.

Time-domain locations of RS REs, specified as a matrix of nonnegative integers. The size of the matrix is M-by-TG, where:

  • M is an integer multiple of the TimeDomainCDM property value.

  • TG is the number of time-domain CDM groups.

Since R2026b

Time-domain CDM weights, specified as [] or a T-by-T matrix, where T is the value of the TimeDomainCDM property. Each row of the matrix is the time-domain OCC for one port within a time-domain CDM (TD-CDM) group. The elements can be complex.

When you use the default value, [], the object uses built-in OCCs with elements equal to ±1. To view the time-domain OCC that each port uses, see the w_t column of the CDMTable property.

This property does not apply when you set Modulation to "low-papr-type1".

Data Types: double | single
Complex Number Support: Yes

Since R2026b

Cyclic shift indices for low-PAPR type 1 sequences, specified as [] or an F-by-M matrix of integers in the range [0, F – 1], where:

Element (i, j) is the cyclic shift index nCS for the ith port within an FD-CDM group in the jth OFDM symbol of each TD-CDM group. The elements in each column must be unique. The corresponding cyclic shift is α = 2πnCS/F.

When you use the default value, [], the cyclic shift indices in the first OFDM symbol are 0, 1, …, F – 1. In each subsequent OFDM symbol, the cyclic shift index of each port decreases by 1, modulo F. To view the cyclic shift indices that each port uses, see the CyclicShiftsTable property.

This property applies only when the Modulation property is "low-papr-type1".

Data Types: double | single | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

Set of RS ports to use, specified as a nonnegative integer or a vector of nonnegative integers. The total number of available ports is P=FrequencyDomainCDM×TimeDomainCDM×FG×TG, where FG is the number of frequency-domain CDM groups and TG is the number of time-domain CDM groups. The elements of PortSet must be in the range [0, P–1].

Option to enable frequency-domain spectral shaping (FDSS), specified as one of these values.

  • 0 (false) — The pre6GReferenceSignal function does not apply FDSS to its output symbols.

  • 1 (true) — The pre6GReferenceSignal function applies FDSS using the FDSSCoefficients property.

Data Types: double | logical

FDSS filter coefficients, specified as a row vector of real values. The vector defines time-domain finite impulse response (FIR) filter taps. During RS symbol generation, the pre6GReferenceSignal function converts these taps to a frequency-domain filter and applies spectral shaping across the allocated subcarriers.

This property applies only when you specify the FDSS property as 1 (true).

Data Types: double

This property is read-only.

CDM lengths, represented as a row vector of positive integers. The vector has two elements. The first element represents the frequency domain and is equal to FrequencyDomainCDM, which you can set with a name-value argument. The second element represents the time domain and is equal to TimeDomainCDM, which you can also set with a name-value argument.

Data Types: double

This property is read-only.

Number of CDM groups, represented as a row vector of positive integers. The vector has two elements. The first element represents the frequency domain and is equal to FG, the number of columns in the SubcarrierLocations property, which you can set with a name-value argument. The second element represents the time domain and is equal to TG, the number of columns in the SymbolLocations property, which you can also set with a name-value argument.

Data Types: double

This property is read-only.

CDM parameter table, represented as a table. The size of the table is p-by-5, where p is the total number of RS ports. The five columns are:

  • p — 0-based port index

  • FD-CDM group — 0-based FD-CDM group index

  • TD-CDM group — 0-based TD-CDM group index

  • w_f — Frequency-domain CDM weight vector. The vector length is equal to FrequencyDomainCDM. When the FrequencyWeights property is [], the entries are ±1. Otherwise, the vector is a row of FrequencyWeights and the entries can be complex.

  • w_t — Time-domain CDM weight vector. The vector length is equal to TimeDomainCDM. When the TimeWeights property is [], the entries are ±1. Otherwise, the vector is a row of TimeWeights and the entries can be complex.

When the Modulation property is "low-papr-type1", the RS does not use OCCs, so w_f and w_t are 1 in each row. In this case, the ports within an FD-CDM group use different cyclic shifts instead. For more information, see the CyclicShiftsTable property.

The table is empty if the configuration contains conflicting property values, such as a FrequencyWeights matrix whose size does not match the FrequencyDomainCDM property.

Data Types: table

Since R2026b

This property is read-only.

Cyclic shift parameter table, represented as a table. The size of the table is p-by-5, where p is the total number of RS ports. The five columns are:

  • p — 0-based port index

  • FD-CDM group — 0-based FD-CDM group index

  • TD-CDM group — 0-based TD-CDM group index

  • OFDM symbol — 0-based OFDM symbol indices of the TD-CDM group, represented as a vector of length M, where M is the number of rows of the SymbolLocations property

  • Cyclic shift — Cyclic shift index for each OFDM symbol in the OFDM symbol column, represented as a vector of length M

The table is empty if the configuration contains conflicting property values, such as a CyclicShifts matrix whose size does not match the FrequencyDomainCDM and SymbolLocations properties.

This property applies only when the Modulation property is "low-papr-type1".

Data Types: table

Examples

collapse all

Create a pre-6G carrier configuration object with default parameters.

carrier = pre6GCarrierConfig;

Create a reference signal configuration object. Specify physical resource blocks 10–19.

rs = pre6GReferenceSignalConfig(PRBSet=10:19);

Get 1-based reference signal indices for the reference signal configuration.

rsInd = pre6GReferenceSignalIndices(carrier,rs);

Create a data channel configuration object. Specify the same physical resource blocks as before. Use the reference signal indices as reserved REs in the data channel. You must subtract 1 because the reserved REs are 0-based in accordance with 5G.

ch = pre6GPhysicalChannelConfig(PRBSet=10:19, ...
    ReservedRE = rsInd-1);

Get 0-based data indices for the physical channel configuration.

dataInd = pre6GPhysicalChannelIndices(carrier,ch);

Verify that there is no overlap between the two sets of indices.

intersect(dataInd(:),rsInd(:))
ans =

  0×1 empty uint32 column vector

Low-PAPR Type 1 Sequence with Custom Cyclic Shifts

Create a carrier configuration object and an RS configuration object. Configure the RS to use a type 1 low-PAPR sequence on every second subcarrier in the last four OFDM symbols of the slot. Use a frequency-domain CDM length of 4 so that four ports share the same resource elements (REs).

carrier = pre6GCarrierConfig;
rs = pre6GReferenceSignalConfig;
rs.Modulation = "low-papr-type1";
rs.FrequencyDomainCDM = 4;
rs.SubcarrierLocations = (0:2:10).';
rs.SymbolLocations = (10:13).';
rs.PortSet = 0:3;

Specify the cyclic shift index of each port (rows) in each OFDM symbol (columns).

rs.CyclicShifts = [0 2 1 3; 1 3 2 0; 2 0 3 1; 3 1 0 2];

Display the cyclic shift index that each port uses in each OFDM symbol.

rs.CyclicShiftsTable
ans = 4×5 table
    p    FD-CDM group    TD-CDM group        OFDM symbol           Cyclic shift  
    _    ____________    ____________    ____________________    ________________

    0         0               0          10    11    12    13    0    2    1    3
    1         0               0          10    11    12    13    1    3    2    0
    2         0               0          10    11    12    13    2    0    3    1
    3         0               0          10    11    12    13    3    1    0    2

	Get insights using Copilot

Because the ports use cyclic shifts instead of orthogonal cover codes (OCCs), the frequency-domain and time-domain CDM weights are 1 for every port.

rs.CDMTable
ans = 4×5 table
    p    FD-CDM group    TD-CDM group    w_f    w_t
    _    ____________    ____________    ___    ___

    0         0               0           1      1 
    1         0               0           1      1 
    2         0               0           1      1 
    3         0               0           1      1 

	Get insights using Copilot

Generate the RS symbols. The output contains 1248 symbols (312 subcarriers in each of 4 OFDM symbols) for each port.

sym = pre6GReferenceSignal(carrier,rs);
disp(size(sym))
        1248           4

Confirm that the symbols have constant amplitude.

disp([min(abs(sym(:))) max(abs(sym(:)))])
    1.0000    1.0000

Confirm that the ports are mutually orthogonal.

C = abs(sym'*sym)/size(sym,1);
disp(round(C,6))
     1     0     0     0
     0     1     0     0
     0     0     1     0
     0     0     0     1

Custom Complex Frequency-Domain CDM Weights

Configure an RS with the same port structure as the 5G NR Release 18 enhanced PUSCH DM-RS for configuration type 1 with double-symbol DM-RS. This configuration supports up to 16 ports. Use two FD-CDM groups, each on every second subcarrier, and a pair of adjacent OFDM symbols. Use a frequency-domain CDM length of 4 and a time-domain CDM length of 2.

rs = pre6GReferenceSignalConfig;
rs.FrequencyDomainCDM = 4;
rs.SubcarrierLocations = [(0:2:10).' (1:2:11).'];
rs.TimeDomainCDM = 2;
rs.SymbolLocations = [2; 3];
rs.PortSet = 0:15;

By default, the frequency-domain OCCs have elements equal to 1 or -1. Specify the frequency-domain OCCs that the enhanced PUSCH DM-RS uses instead. Each row of the matrix is the frequency-domain OCC for one port within an FD-CDM group. The last two rows are complex.

rs.FrequencyWeights = [1 1 1 1; 1 -1 1 -1; 1 1j -1 -1j; 1 -1j -1 1j];

Display the CDM weights that each port uses. Ports 8 to 15 use the complex frequency-domain OCCs. The time-domain OCCs use the default values.

rs.CDMTable
ans = 16×5 table
    p     FD-CDM group    TD-CDM group                        w_f                          w_t  
    __    ____________    ____________    ___________________________________________    _______

     0         0               0          1+0i         1+0i         1+0i         1+0i    1     1
     1         0               0          1+0i        -1+0i         1+0i        -1+0i    1     1
     2         1               0          1+0i         1+0i         1+0i         1+0i    1     1
     3         1               0          1+0i        -1+0i         1+0i        -1+0i    1     1
     4         0               0          1+0i         1+0i         1+0i         1+0i    1    -1
     5         0               0          1+0i        -1+0i         1+0i        -1+0i    1    -1
     6         1               0          1+0i         1+0i         1+0i         1+0i    1    -1
     7         1               0          1+0i        -1+0i         1+0i        -1+0i    1    -1
     8         0               0          1+0i         0+1i        -1+0i         0-1i    1     1
     9         0               0          1+0i         0-1i        -1+0i         0+1i    1     1
    10         1               0          1+0i         0+1i        -1+0i         0-1i    1     1
    11         1               0          1+0i         0-1i        -1+0i         0+1i    1     1
    12         0               0          1+0i         0+1i        -1+0i         0-1i    1    -1
    13         0               0          1+0i         0-1i        -1+0i         0+1i    1    -1
    14         1               0          1+0i         0+1i        -1+0i         0-1i    1    -1
    15         1               0          1+0i         0-1i        -1+0i         0+1i    1    -1

	Get insights using Copilot

Generate the RS symbols and indices, and map them to a resource grid. Confirm that the ports are mutually orthogonal.

sym = pre6GReferenceSignal(carrier,rs);
ind = pre6GReferenceSignalIndices(carrier,rs);
grid = pre6GResourceGrid(carrier,numel(rs.PortSet));
grid(ind) = sym;
grid = reshape(grid,[],numel(rs.PortSet));
C = abs(grid'*grid)/size(sym,1);
disp(round(C,6))
     1     0     0     0     0     0     0     0     0     0     0     0     0     0     0     0
     0     1     0     0     0     0     0     0     0     0     0     0     0     0     0     0
     0     0     1     0     0     0     0     0     0     0     0     0     0     0     0     0
     0     0     0     1     0     0     0     0     0     0     0     0     0     0     0     0
     0     0     0     0     1     0     0     0     0     0     0     0     0     0     0     0
     0     0     0     0     0     1     0     0     0     0     0     0     0     0     0     0
     0     0     0     0     0     0     1     0     0     0     0     0     0     0     0     0
     0     0     0     0     0     0     0     1     0     0     0     0     0     0     0     0
     0     0     0     0     0     0     0     0     1     0     0     0     0     0     0     0
     0     0     0     0     0     0     0     0     0     1     0     0     0     0     0     0
     0     0     0     0     0     0     0     0     0     0     1     0     0     0     0     0
     0     0     0     0     0     0     0     0     0     0     0     1     0     0     0     0
     0     0     0     0     0     0     0     0     0     0     0     0     1     0     0     0
     0     0     0     0     0     0     0     0     0     0     0     0     0     1     0     0
     0     0     0     0     0     0     0     0     0     0     0     0     0     0     1     0
     0     0     0     0     0     0     0     0     0     0     0     0     0     0     0     1

References

[1] 3GPP TS 38.211. “NR; Physical channels and modulation.” 3rd Generation Partnership Project; Technical Specification Group Radio Access Network.

Extended Capabilities

expand all

Version History

Introduced in R2026a

expand all