Sounding Reference Signal (SRS) Configurations

This API generates the configurations for sounding reference signal which is used by the BS to acquire channel state information for either uplink communication or reciprocity based downlink communication. The details of these parameters are listed below in input and output interface.

Note

The un-configured parameters are selected randomly from a valid set of possible values.

class toolkit5G.Configurations.SRSConfiguration(purpose=None, nrofSRS_Ports=None, transmissionComb=None, nrofSymbols=None, startPosition=None, repetitionFactor=None, nrOfCyclicShift=None, groupOrSequenceHopping=None, sequenceId=None, combOffset=None, slotIndex=None, systemFrameNumber=None, resourceType=None, subcarrierSpacing=None, bSRS=None, cSRS=None, bHop=None, freqScalingFactor=None, startRBIndex=None, enableStartRBHopping=None, freqDomainShift=None, freqDomainPosition=None, periodicityInSlots=None, offsetInSlots=None, betaSRS=None, resourceGridSizeinRBs=None)[source]

property bHop

bHop. The parameter is denoted by \(\text{b}_\text{Hop} \in \{0,1,2,3\}\) in section 5.2.2 of TS 38.211. It takes integer values.

Type:: Defines frequency hopping parameter

property bSRS: Defines bSRS from table Table 6.4.1.4.3-1: SRS bandwidth configuration of 3GPP TS 38.211. The parameter is denoted by \(\text{B}_\text{SRS} \in \{0,1,2,3\}\) in section 5.2.2 of TS 38.211. It takes integer values.

property betaSRS: Defines SRS Periodicity in slots. The parameter is denoted by \(\text{T}_\text{SRS} \in \{1,2,4,5,8,10,16,20,32,40,64,80,160,320,640,1280,2560\}\) in section 5.2.2 of TS 38.211. It takes integer values.

property cSRS: Defines cSRS from table Table 6.4.1.4.3-1: SRS bandwidth configuration of 3GPP TS 38.211. The parameter is denoted by \(\text{C}_\text{SRS} \in \{0,1,...,36\}\) in section 5.2.2 of TS 38.211. It takes integer values.

property combOffset: Defines comb offset value. The parameter is denoted by \(\bar{k}_\text{TC} \in \{0,1,...,\text{K}_\text{TC}-1\}\) in section 5.2.2 of TS 38.211. It takes integer values.

property enableStartRBHopping: Defines a boolean flag to enable or disbale RB Hoppping.

property freqDomainPosition: Defines the frequency domain position variable. Each value corresponds to 4 RBs of allocation. The parameter is denoted by \({n}_\text{RRC} \in \{0,1,...,67\}\) in section 5.2.2 of TS 38.211. It takes integer values.

property freqDomainShift: Defines the frequency domain shift variable. It adjusts the SRS allocation with respect to the subcarrier-0 in the SRS-Resource Grid. The parameter is denoted by \({n}_\text{shift} \in \{0,1,...,268\}\) in section 5.2.2 of TS 38.211. It takes integer values.

property freqScalingFactor: Defines frequency scaling factor. The parameter is denoted by \({P}_{F} \in \{1,2,4\}\) in section 5.2.2 of TS 38.211. It takes integer values.

Note

The values of \({P}_{F}\), \(\text{B}_\text{SRS}\) and \(\text{C}_\text{SRS}\) must be selected in such a way that \(\frac{12 \times \text{m}_\text{SRS}}{K_{TC} \times P_F}\).

property groupOrSequenceHopping: Defines the type of Hopping being used. It can take string values from the set \(\{\) “neither”, “groupHopping”, “sequenceHopping” \(\}\).

property lengthOfSequence: Defines Number of Resource Blocks. The parameter is denoted by m in section 5.2.2 of TS 38.211. It can be scalar or vector of integers.

property nrOfCyclicShift: Defines Number Of Cyclic Shifts. The parameter is denoted by \(\nu\) in section 5.2.2 of TS 38.211. It takes integer values.

property nrofSRS_Ports: Defines the number of SRS Ports. 5G supports only 1, 2 or 4 ports for SRS. For “positioning”, only 1 SRS port is supported.

property nrofSymbols: Defines symbol Ind(ex)(ices). The parameter is denoted by \(\nu\) in section 5.2.2 of TS 38.211. It takes integer values.

property offsetInSlots: Defines SRS offset in slots. The parameter is denoted by \(\text{T}_\text{offset} \in \{0,1,...,\text{T}_\text{SRS}-1\}\) in section 5.2.2 of TS 38.211. It takes integer values.

property periodicityInSlots: Defines SRS Periodicity in slots. The parameter is denoted by \(\text{T}_\text{SRS} \in \{1,2,4,5,8,10,16,20,32,40,64,80,160,320,640,1280,2560\}\) in section 5.2.2 of TS 38.211. It takes integer values.

property purpose: Defines the type of Hopping being used. It can take string values from the set \(\{\) “neither”, “groupHopping”, “sequenceHopping” \(\}\).

property repetitionFactor: Defines the time domain repetition factor. Each value corresponds to 4 RBs of allocation. The parameter is denoted by \(\text{R} \in \{1,2,4\}\) in section 5.2.2 of TS 38.211. It takes integer values.

Note

nrofSymbols must be an inteer multiple of repetitionFactor when repetion is used.

property resourceGridSizeinRBs: Defines the size of the grid in terms of RBs in which the srs will be loaded. The number of subcarriers = resourceGridSizeinRBs*12. It takes integer values.

property resourceType: Defines the type of SRS Resource. It can take string values from the set \(\{\) “periodic”, “semi-persistent”, “aperiodic” \(\}\).

property sequenceId: Defines symbol Ind(ex)(ices). The parameter is denoted by \(\nu\) in section 5.2.2 of TS 38.211. It takes integer values.

property slotIndex: Defines slot Index/Number value. The parameter is denoted by \({n}_\text{s,f}^{\mu} \in \{0,1,...,\text{N}_\text{slot}^{frame}-1\}\) in section 5.2.2 of TS 38.211. It takes integer values.

property startPosition: Defines symbol Ind(ex)(ices). The parameter is denoted by \(\nu\) in section 5.2.2 of TS 38.211. It can be scalar or vector of integers.

property startRBIndex: Defines start RB Index when time domain repetition is used. The parameter is denoted by \({k}_{F} \in \{0,1,...,{P}_{F}-1\}\) in section 5.2.2 of TS 38.211. It takes integer values.

property symbolIndices: Defines symbol Ind(ex)(ices). The parameter is denoted by \(\nu\) in section 5.2.2 of TS 38.211. It can be scalar or vector of integers.

property systemFrameNumber: Defines system frame number value. The parameter is denoted by \(\text{n}_\text{f} \in \{0,1,...,1023\}\) in section 5.2.2 of TS 38.211. It takes integer values.

property transmissionComb: Defines transmissionComb value. The parameter is denoted by \(\text{K}_\text{TC} \in \{2,4,8\}\) in section 5.2.2 of TS 38.211. It takes integer values.