NI RFmx NR SEM Attributes - ni/grpc-device GitHub Wiki

SEM Attributes

RFMXNR_ATTR_SEM_MEASUREMENT_ENABLED

Data Type: int32
Access: read/write
Functions: RFmxNR_SetAttributeI32
RFmxNR_GetAttributeI32
Description: Specifies whether to enable the SEM measurement.

You do not need to use a selector string to configure or read this attribute for the default signal and result instances. Refer to the Selector String topic for information about the string syntax for named signals and named results.

The default value is RFMXNR_VAL_FALSE.

Get Function: RFmxNR_SEMGetMeasurementEnabled
Set Function: RFmxNR_SEMSetMeasurementEnabled

RFMXNR_ATTR_SEM_UPLINK_MASK_TYPE

Data Type: int32
Access: read/write
Functions: RFmxNR_SetAttributeI32
RFmxNR_GetAttributeI32
Description: Specifies the spectrum emission mask used in the measurement for uplink. You must set the mask type to Custom to configure the custom offset masks. Refer to section 6.5.2 of the 3GPP 38.101 specification for more information about standard-defined mask types.

You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector Strings topic for information about the string syntax for named signals.

The default value is RFMXNR_VAL_SEM_UPLINK_MASK_TYPE_GENERAL.

Get Function: RFmxNR_SEMGetUplinkMaskType
Set Function: RFmxNR_SEMSetUplinkMaskType
Values:
RFMXNR_VAL_SEM_UPLINK_MASK_TYPE_GENERAL (0) The measurement selects the offset frequencies and limits for the SEM, as defined in Table 6.5.2.2-1 in section 6.5.2 of the 3GPP TS 38.101-1 specification, Table 6.5.2.1-1 and 6.5A.2.1-1 in section 6.5.2 of the 3GPP TS 38.101-2 specification and Table 6.5B.2.1.1-1 in section 6.5B of the 3GPP TS 38.101-3 specification. In case of non-contiguous EN-DC consisting of at least one subblock with all E-UTRA carriers, for the E-UTRA subblock, the measurement selects the offset frequencies and limits for the SEM, as defined in Table 6.6.2.1.5-1, 6.6.2.1.5-2, 6.6.2.1A.1.5-1, and 6.6.2.1A.1.5-2 in section 6.6.2 of the 3GPP TS 36.521-1 specification.
RFMXNR_VAL_SEM_UPLINK_MASK_TYPE_NS35 (1) The measurement selects the offset frequencies and limits for the SEM, as defined in Table 6.5.2.3.1-1 in section 6.5.2 of the 3GPP TS 38.101-1 specification and Table 6.5B.2.1.2.1-1 in section 6.5B of the 3GPP TS 38.101-3 specification. In case of non-contiguous EN-DC consisting of at least one subblock with all E-UTRA carriers, for the E-UTRA subblock, the measurement selects the offset frequencies and limits for the SEM, as defined in Table 6.6.2.2.5.5-1 in section 6.6.2 of the 3GPP TS 36.521-1 specification.
RFMXNR_VAL_SEM_UPLINK_MASK_TYPE_CUSTOM (2) You need to configure the RFMXNR_ATTR_SEM_NUMBER_OF_OFFSETS, RFMXNR_ATTR_SEM_OFFSET_START_FREQUENCY, RFMXNR_ATTR_SEM_OFFSET_STOP_FREQUENCY, RFMXNR_ATTR_SEM_OFFSET_ABSOLUTE_LIMIT_START, RFMXNR_ATTR_SEM_OFFSET_ABSOLUTE_LIMIT_STOP, RFMXNR_ATTR_SEM_OFFSET_SIDEBAND, RFMXNR_ATTR_SEM_OFFSET_RBW_FILTER_BANDWIDTH, RFMXNR_ATTR_SEM_OFFSET_RBW_FILTER_TYPE, and RFMXNR_ATTR_SEM_OFFSET_BANDWIDTH_INTEGRAL attributes for each offset.
RFMXNR_VAL_SEM_UPLINK_MASK_TYPE_NS03 (3) The measurement selects the offset frequencies and limits for the SEM, as defined in Table 6.5.2.3.3-1 in section 6.5.2 of the 3GPP TS 38.101-1 specification. In case of non-contiguous EN-DC consisting of at least one subblock with all E-UTRA carriers, for the E-UTRA subblock, the measurement selects the offset frequencies and limits for the SEM, as defined in Table 6.6.2.2.5.1-1 and 6.6.2.2.5.1-2 in section 6.6.2 of the 3GPP TS 36.521-1 specification.
RFMXNR_VAL_SEM_UPLINK_MASK_TYPE_NS04 (4) The measurement selects the offset frequencies and limits for the SEM as defined in Table 6.5.2.3.2-3 in section 6.5.2 of the 3GPP TS 38.101-1 specification. Subcarrier spacing can be configured through RFMXNR_ATTR_BANDWIDTH_PART_SUBCARRIER_SPACING attribute. Subcarrier spacing corresponding to first bandwidth part is used for computing mask. Transform precoding can be configured through RFMXNR_ATTR_PUSCH_TRANSFORM_PRECODING_ENABLED attribute. Transform precoding corresponding to first bandwidth part is used for computing mask. In case of non-contiguous EN-DC consisting of at least one subblock with all E-UTRA carriers, for the E-UTRA subblock, the measurement selects the offset frequencies and limits for the SEM, as defined in Table 6.6.2.2.3.2-3 in section 6.6.2 of the 3GPP TS 36.521-1 specification.
RFMXNR_VAL_SEM_UPLINK_MASK_TYPE_NS06 (5) The measurement selects the offset frequencies and limits for the SEM as defined in Table 6.5.2.3.4-1 in section 6.5.2 of the 3GPP TS 38.101-1 specification. In case of non-contiguous EN-DC consisting of at least one subblock with all E-UTRA carriers, for the E-UTRA subblock, the measurement selects the offset frequencies and limits for the SEM, as defined in Table 6.6.2.2.5.3-1 and 6.6.2.2.5.3-2 in section 6.6.2 of the 3GPP TS 36.521-1 specification.
RFMXNR_VAL_SEM_UPLINK_MASK_TYPE_NS21 (6) The measurement selects the offset frequencies and limits for the SEM, as defined in Table 6.5.2.3.3-1 in section 6.5.2 of the 3GPP TS 38.101-1 specification. In case of non-contiguous EN-DC consisting of at least one subblock with all E-UTRA carriers, for the E-UTRA subblock, the measurement selects the offset frequencies and limits for the SEM, as defined in Table 6.6.2.2.5.1-1 and 6.6.2.2.5.1-2 in section 6.6.2 of the 3GPP TS 36.521-1 specification.
RFMXNR_VAL_SEM_UPLINK_MASK_TYPE_NS27 (7) The measurement selects the offset frequencies and limits for the SEM, as defined in Table 6.5.2.3.8-1 in section 6.5.2 of the 3GPP TS 38.101-1 specification. In case of intra-band contiguous CA consisting of at least one subblock with all NR carriers, for the NR subblock, the measurement selects the offset frequencies and limits for the SEM, as defined in Table 6.2A.2.3.2.1-1 in section 6.5A.2.3 of the 3GPP TS 38.101-1 specification. In case of non-contiguous EN-DC consisting of at least one subblock with all E-UTRA carriers, for the E-UTRA subblock, the measurement selects the offset frequencies and limits for the SEM, as defined in Table 6.6.2.2.3.4-1 in section 6.6.2 of the 3GPP TS 36.521-1 specification.
RFMXNR_VAL_SEM_UPLINK_MASK_TYPE_NS07 (8) The measurement selects the offset frequencies and limits for the SEM, as defined in Table 6.5.2.3.4-1 in section 6.5.2 of the 3GPP TS 38.101-1 specification. In case of non-contiguous EN-DC consisting of at least one subblock with all E-UTRA carriers, for the E-UTRA subblock, the measurement selects the offset frequencies and limits for the SEM, as defined in Table 6.6.2.2.5.3-1 and Table 6.6.2.2.5.3-2 in section 6.6.2 of the 3GPP TS 36.521-1 specification.

RFMXNR_ATTR_SEM_DOWNLINK_MASK_TYPE

Data Type: int32
Access: read/write
Functions: RFmxNR_SetAttributeI32
RFmxNR_GetAttributeI32
Description: Specifies the limits to be used in the measurement for Downlink.

You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector Strings topic for information about the string syntax for named signals.

The default value is RFMXNR_VAL_SEM_DOWNLINK_MASK_TYPE_STANDARD.

Get Function: RFmxNR_SEMGetDownlinkMaskType
Set Function: RFmxNR_SEMSetDownlinkMaskType
Values:
RFMXNR_VAL_SEM_DOWNLINK_MASK_TYPE_STANDARD (0) Specifies that standard defined limits are applied. For frequency range 1, set the RFMXNR_ATTR_GNODEB_CATEGORY attribute to desired value. Set the RFMXNR_ATTR_BAND attribute for selecting limits table within a gNodeB category. For frequency range 2, set the RFMXNR_ATTR_BAND attribute for selecting limits table. The measurement selects the offset frequencies and limits for SEM, as defined in Table 6.6.4.2.1-1, Table 6.6.4.2.1-2, Table 6.6.4.2.2.1-1, Table 6.6.4.2.2.1-2, Table 6.6.4.2.2.2-1, Table 6.6.4.2.3-1, Table 6.6.4.2.3-2, and Table 6.6.4.2.4-1 in section 6.6.4 and Table 9.7.4.3.2-1 and Table 9.7.4.3.2-2 in section 9.7.4 of the 3GPP 38.104 Specification. The offset frequencies in Table 9.7.4.3.2-1 and Table 9.7.4.3.2-2 are relative to the contiguous transmission bandwidth edge. The measurement converts these offset frequencies to make them relative to the subblock edge before applying the masks.
RFMXNR_VAL_SEM_DOWNLINK_MASK_TYPE_CUSTOM (2) Specifies that limits are applied based on user-defined offset segments.

RFMXNR_ATTR_SEM_DELTA_F_MAXIMUM

Data Type: float64
Access: read/write
Functions: RFmxNR_SetAttributeF64
RFmxNR_GetAttributeF64
Description: Specifies the stop frequency for 3rd offset segment to be used in the measurement. This attribute is valid only for downlink and when you set the RFMXNR_ATTR_SEM_DOWNLINK_MASK_TYPE attribute to RFMXNR_VAL_SEM_DOWNLINK_MASK_TYPE_STANDARD.

You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector Strings topic for information about the string syntax for named signals.

The default value is 15 MHz. The minimum value is 9.5 MHz.

Get Function: RFmxNR_SEMGetDeltaFMaximum
Set Function: RFmxNR_SEMSetDeltaFMaximum

RFMXNR_ATTR_SEM_SUBBLOCK_INTEGRATION_BANDWIDTH

Data Type: float64
Access: read only
Functions: RFmxNR_GetAttributeF64
Description: Returns the integration bandwidth of a subblock. This value is expressed in Hz. Integration bandwidth is the span from the left edge of the leftmost carrier to the right edge of the rightmost carrier within the subblock.

Use 'subblock(n)' as the Selector Strings to read this result.

The default value is 0.

Get Function: RFmxNR_SEMGetSubblockIntegrationBandwidth

RFMXNR_ATTR_SEM_SUBBLOCK_AGGREGATED_CHANNEL_BANDWIDTH

Data Type: float64
Access: read only
Functions: RFmxNR_GetAttributeF64
Description: Returns the aggregated channel bandwidth of a configured subblock. This value is expressed in Hz. The aggregated channel bandwidth is the sum of the subblock integration bandwidth and the guard bands on either side of the subblock integration bandwidth.

Use 'subblock(n)' as the Selector Strings to read this result.

The default value is 0.

Get Function: RFmxNR_SEMGetSubblockAggregatedChannelBandwidth

SEM Component Carrier

RFMXNR_ATTR_SEM_COMPONENT_CARRIER_INTEGRATION_BANDWIDTH

Data Type: float64
Access: read only
Functions: RFmxNR_GetAttributeF64
Description: Returns the integration bandwidth of a component carrier. This value is expressed in Hz.

Use 'carrier(k)' or 'subblock(n)' or 'subblock(n)/carrier(k)' as the Selector Strings to read this result.

The default value is 9 MHz.

Get Function: RFmxNR_SEMGetComponentCarrierIntegrationBandwidth

RFMXNR_ATTR_SEM_COMPONENT_CARRIER_RATED_OUTPUT_POWER

Data Type: float64
Access: read/write
Functions: RFmxNR_SetAttributeF64
RFmxNR_GetAttributeF64
Description: Specifies the rated output power (Prated, x), which is used only to choose the limit table for medium range base station, RFMXNR_VAL_GNODEB_CATEGORY_FR2_CATEGORY_A and RFMXNR_VAL_GNODEB_CATEGORY_FR2_CATEGORY_B. This value is expressed in dBm.

In the case of FR1, this control is considered when the RFMXNR_ATTR_LINK_DIRECTION attribute is set to RFMXNR_VAL_LINK_DIRECTION_DOWNLINK, RFMXNR_ATTR_SEM_DOWNLINK_MASK_TYPE attribute to RFMXNR_VAL_SEM_DOWNLINK_MASK_TYPE_STANDARD, and RFMXNR_ATTR_GNODEB_CATEGORY attribute to RFMXNR_VAL_GNODEB_CATEGORY_MEDIUM_RANGE_BASE_STATION. For more details please refer to section 6.6.4.2.3 of 3GPP 38.104 specification. In the case of FR2, this control is considered when the RFMXNR_ATTR_LINK_DIRECTION attribute is set to RFMXNR_VAL_LINK_DIRECTION_DOWNLINK and RFMXNR_ATTR_SEM_DOWNLINK_MASK_TYPE attribute to RFMXNR_VAL_SEM_DOWNLINK_MASK_TYPE_STANDARD. For more details please refer to section 9.7.4.3 of 3GPP 38.104 specification.

Use 'carrier(k)' or 'subblock(n)' or 'subblock(n)/carrier(k)' as the Selector Strings to read this result.

The default value is 0.

Get Function: RFmxNR_SEMGetComponentCarrierRatedOutputPower
Set Function: RFmxNR_SEMSetComponentCarrierRatedOutputPower

Offset

RFMXNR_ATTR_SEM_NUMBER_OF_OFFSETS

Data Type: int32
Access: read/write
Functions: RFmxNR_SetAttributeI32
RFmxNR_GetAttributeI32
Description: Specifies the number of SEM offset segments.

Use 'subblock(n)' as the Selector Strings to configure or read this attribute.

The default value is 1.

Get Function: RFmxNR_SEMGetNumberOfOffsets
Set Function: RFmxNR_SEMSetNumberOfOffsets

RFMXNR_ATTR_SEM_OFFSET_START_FREQUENCY

Data Type: float64
Access: read/write
Functions: RFmxNR_SetAttributeF64
RFmxNR_GetAttributeF64
Description: Specifies the start frequency of an offset segment relative to the RFMXNR_ATTR_COMPONENT_CARRIER_BANDWIDTH edge (single carrier) or RFMXNR_ATTR_SEM_SUBBLOCK_AGGREGATED_CHANNEL_BANDWIDTH edge (multi-carrier). This value is expressed in Hz.

Use 'offset(k)' or 'subblock(n)' or 'subblock(n)/offset(k)' as the Selector Strings to configure or read this attribute.

The default value is 0.

Get Function: RFmxNR_SEMGetOffsetStartFrequency
Set Function: RFmxNR_SEMSetOffsetStartFrequency

RFMXNR_ATTR_SEM_OFFSET_STOP_FREQUENCY

Data Type: float64
Access: read/write
Functions: RFmxNR_SetAttributeF64
RFmxNR_GetAttributeF64
Description: Specifies the stop frequency of an offset segment relative to the RFMXNR_ATTR_COMPONENT_CARRIER_BANDWIDTH edge (single carrier) or RFMXNR_ATTR_SEM_SUBBLOCK_AGGREGATED_CHANNEL_BANDWIDTH edge (multi-carrier). This value is expressed in Hz.

Use 'offset(k)' or 'subblock(n)' or 'subblock(n)/offset(k)' as the Selector Strings to configure or read this attribute.

The default value is 1 MHz.

Get Function: RFmxNR_SEMGetOffsetStopFrequency
Set Function: RFmxNR_SEMSetOffsetStopFrequency

RFMXNR_ATTR_SEM_OFFSET_SIDEBAND

Data Type: int32
Access: read/write
Functions: RFmxNR_SetAttributeI32
RFmxNR_GetAttributeI32
Description: Specifies whether the offset segment is present either on one side or on both sides of a carrier.

Use 'offset(k)' or 'subblock(n)' or 'subblock(n)/offset(k)' as the Selector Strings to configure or read this attribute.

The default value is RFMXNR_VAL_SEM_OFFSET_SIDEBAND_BOTH.

Get Function: RFmxNR_SEMGetOffsetSideband
Set Function: RFmxNR_SEMSetOffsetSideband
Values:
RFMXNR_VAL_SEM_OFFSET_SIDEBAND_NEGATIVE (0) Configures a lower offset segment to the left of the leftmost carrier.
RFMXNR_VAL_SEM_OFFSET_SIDEBAND_POSITIVE (1) Configures an upper offset segment to the right of the rightmost carrier.
RFMXNR_VAL_SEM_OFFSET_SIDEBAND_BOTH (2) Configures both the negative and the positive offset segments.

RBW Filter

RFMXNR_ATTR_SEM_OFFSET_RBW_FILTER_BANDWIDTH

Data Type: float64
Access: read/write
Functions: RFmxNR_SetAttributeF64
RFmxNR_GetAttributeF64
Description: Specifies the bandwidth of the resolution bandwidth (RBW) filter used to sweep the acquired offset segment, when you set the SEM Offset RBW Auto attribute to False. This value is expressed in Hz.

Use 'offset(k)' or 'subblock(n)' or 'subblock(n)/offset(k)' as the Selector Strings to configure or read this attribute.

The default value is 30000 Hz.

Get Function: RFmxNR_SEMGetOffsetRBWFilterBandwidth
Set Function: RFmxNR_SEMSetOffsetRBWFilterBandwidth

RFMXNR_ATTR_SEM_OFFSET_RBW_FILTER_TYPE

Data Type: int32
Access: read/write
Functions: RFmxNR_SetAttributeI32
RFmxNR_GetAttributeI32
Description: Specifies the shape of a digital RBW filter.

Use 'offset(k)' or 'subblock(n)' or 'subblock(n)/offset(k)' as the Selector Strings to configure or read this attribute.

The default value is RFMXNR_VAL_SEM_OFFSET_RBW_FILTER_TYPE_GAUSSIAN.

Get Function: RFmxNR_SEMGetOffsetRBWFilterType
Set Function: RFmxNR_SEMSetOffsetRBWFilterType
Values:
RFMXNR_VAL_SEM_OFFSET_RBW_FILTER_TYPE_FFT_BASED (0) No RBW filtering is performed.
RFMXNR_VAL_SEM_OFFSET_RBW_FILTER_TYPE_GAUSSIAN (1) The RBW filter has a Gaussian response.
RFMXNR_VAL_SEM_OFFSET_RBW_FILTER_TYPE_FLAT (2) The RBW filter has a flat response.

RFMXNR_ATTR_SEM_OFFSET_BANDWIDTH_INTEGRAL

Data Type: int32
Access: read/write
Functions: RFmxNR_SetAttributeI32
RFmxNR_GetAttributeI32
Description: Specifies the resolution of a spectrum to compare with the spectral mask limits as an integer multiple of the RBW.

When you set this attribute to a value greater than 1, the measurement acquires the spectrum with a narrow resolution and then processes it digitally to get a wider resolution that is equal to the product of a bandwidth integral and a RBW.

Use 'offset(k)' or 'subblock(n)' or 'subblock(n)/offset(k)' as the Selector Strings to configure or read this attribute.

The default value is 1.

Get Function: RFmxNR_SEMGetOffsetBandwidthIntegral
Set Function: RFmxNR_SEMSetOffsetBandwidthIntegral

RFMXNR_ATTR_SEM_OFFSET_LIMIT_FAIL_MASK

Data Type: int32
Access: read/write
Functions: RFmxNR_SetAttributeI32
RFmxNR_GetAttributeI32
Description: Specifies the criteria to determine the measurement fail status.



The default value is RFMXNR_VAL_SEM_OFFSET_LIMIT_FAIL_MASK_ABSOLUTE.

Get Function: RFmxNR_SEMGetOffsetLimitFailMask
Set Function: RFmxNR_SEMSetOffsetLimitFailMask
Values:
RFMXNR_VAL_SEM_OFFSET_LIMIT_FAIL_MASK_ABS_AND_REL (0) Specifies that the measurement fails if the power in the segment exceeds both the absolute and relative masks.
RFMXNR_VAL_SEM_OFFSET_LIMIT_FAIL_MASK_ABS_OR_REL (1) Specifies that the measurement fails if the power in the segment exceeds either the absolute or relative mask.
RFMXNR_VAL_SEM_OFFSET_LIMIT_FAIL_MASK_ABSOLUTE (2) Specifies that the measurement fails if the power in the segment exceeds the absolute mask.
RFMXNR_VAL_SEM_OFFSET_LIMIT_FAIL_MASK_RELATIVE (3) Specifies that the measurement fails if the power in the segment exceeds the relative mask.

Absolute Limit

RFMXNR_ATTR_SEM_OFFSET_ABSOLUTE_LIMIT_START

Data Type: float64
Access: read/write
Functions: RFmxNR_SetAttributeF64
RFmxNR_GetAttributeF64
Description: Specifies the absolute power limit corresponding to the beginning of an offset segment. This value is expressed in dBm.

Use 'offset(k)' or 'subblock(n)' or 'subblock(n)/offset(k)' as the Selector Strings to configure or read this attribute.

The default value is -21.

Get Function: RFmxNR_SEMGetOffsetAbsoluteLimitStart
Set Function: RFmxNR_SEMSetOffsetAbsoluteLimitStart

RFMXNR_ATTR_SEM_OFFSET_ABSOLUTE_LIMIT_STOP

Data Type: float64
Access: read/write
Functions: RFmxNR_SetAttributeF64
RFmxNR_GetAttributeF64
Description: Specifies the absolute power limit corresponding to the end of an offset segment. This value is expressed in dBm.

Use 'offset(k)' or 'subblock(n)' or 'subblock(n)/offset(k)' as the Selector Strings to configure or read this attribute.

The default value is -21.

Get Function: RFmxNR_SEMGetOffsetAbsoluteLimitStop
Set Function: RFmxNR_SEMSetOffsetAbsoluteLimitStop

Relative Limit

RFMXNR_ATTR_SEM_OFFSET_RELATIVE_LIMIT_START

Data Type: float64
Access: read/write
Functions: RFmxNR_SetAttributeF64
RFmxNR_GetAttributeF64
Description: Specifies the relative power limit corresponding to the beginning of the offset segment. This value is expressed in dB.

Use 'offset(k)' or 'subblock(n)' or 'subblock(n)/offset(k)' as the Selector Strings to configure or read this attribute.

The default value is -53.

Get Function: RFmxNR_SEMGetOffsetRelativeLimitStart
Set Function: RFmxNR_SEMSetOffsetRelativeLimitStart

RFMXNR_ATTR_SEM_OFFSET_RELATIVE_LIMIT_STOP

Data Type: float64
Access: read/write
Functions: RFmxNR_SetAttributeF64
RFmxNR_GetAttributeF64
Description: Specifies the relative power limit corresponding to the end of the offset segment. This value is expressed in dB.

Use 'offset(k)' or 'subblock(n)' or 'subblock(n)/offset(k)' as the Selector Strings to configure or read this attribute.

The default value is -60.

Get Function: RFmxNR_SEMGetOffsetRelativeLimitStop
Set Function: RFmxNR_SEMSetOffsetRelativeLimitStop

Sweep Time

RFMXNR_ATTR_SEM_SWEEP_TIME_AUTO

Data Type: int32
Access: read/write
Functions: RFmxNR_SetAttributeI32
RFmxNR_GetAttributeI32
Description: Specifies whether the measurement sets the sweep time.

You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector Strings topic for information about the string syntax for named signals.

The default value is RFMXNR_VAL_SEM_SWEEP_TIME_AUTO_TRUE.

Get Function: RFmxNR_SEMGetSweepTimeAuto
Set Function: RFmxNR_SEMSetSweepTimeAuto
Values:
RFMXNR_VAL_SEM_SWEEP_TIME_AUTO_FALSE (0) The measurement uses the sweep time that you specify in the RFMXNR_ATTR_SEM_SWEEP_TIME_INTERVAL attribute.
RFMXNR_VAL_SEM_SWEEP_TIME_AUTO_TRUE (1) The measurement uses a sweep time of 1 ms.

RFMXNR_ATTR_SEM_SWEEP_TIME_INTERVAL

Data Type: float64
Access: read/write
Functions: RFmxNR_SetAttributeF64
RFmxNR_GetAttributeF64
Description: Specifies the sweep time when you set the RFMXNR_ATTR_SEM_SWEEP_TIME_AUTO attribute to RFMXNR_VAL_SEM_SWEEP_TIME_AUTO_FALSE. This value is expressed in seconds.

You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector Strings topic for information about the string syntax for named signals.

The default value is 1 ms.

Get Function: RFmxNR_SEMGetSweepTimeInterval
Set Function: RFmxNR_SEMSetSweepTimeInterval

SEM Averaging

RFMXNR_ATTR_SEM_AVERAGING_ENABLED

Data Type: int32
Access: read/write
Functions: RFmxNR_SetAttributeI32
RFmxNR_GetAttributeI32
Description: Specifies whether to enable averaging for the SEM measurement.

You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector Strings topic for information about the string syntax for named signals.

The default value is RFMXNR_VAL_SEM_AVERAGING_ENABLED_FALSE.

Get Function: RFmxNR_SEMGetAveragingEnabled
Set Function: RFmxNR_SEMSetAveragingEnabled
Values:
RFMXNR_VAL_SEM_AVERAGING_ENABLED_FALSE (0) The measurement is performed on a single acquisition.
RFMXNR_VAL_SEM_AVERAGING_ENABLED_TRUE (1) The SEM measurement uses the value of the RFMXNR_ATTR_SEM_AVERAGING_COUNT attribute as the number of acquisitions over which the SEM measurement is averaged.

RFMXNR_ATTR_SEM_AVERAGING_COUNT

Data Type: int32
Access: read/write
Functions: RFmxNR_SetAttributeI32
RFmxNR_GetAttributeI32
Description: Specifies the number of acquisitions used for averaging when you set the RFMXNR_ATTR_SEM_AVERAGING_ENABLED attribute to RFMXNR_VAL_SEM_AVERAGING_ENABLED_TRUE.

You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector Strings topic for information about the string syntax for named signals.

The default value is 10.

Get Function: RFmxNR_SEMGetAveragingCount
Set Function: RFmxNR_SEMSetAveragingCount

RFMXNR_ATTR_SEM_AVERAGING_TYPE

Data Type: int32
Access: read/write
Functions: RFmxNR_SetAttributeI32
RFmxNR_GetAttributeI32
Description: Specifies the averaging type for averaging multiple spectrum acquisitions. The averaged spectrum is used for SEM measurement.

You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector Strings topic for information about the string syntax for named signals.

The default value is RFMXNR_VAL_SEM_AVERAGING_TYPE_RMS.

Get Function: RFmxNR_SEMGetAveragingType
Set Function: RFmxNR_SEMSetAveragingType
Values:
RFMXNR_VAL_SEM_AVERAGING_TYPE_RMS (0) The power spectrum is linearly averaged. RMS averaging reduces signal fluctuations but not the noise floor.
RFMXNR_VAL_SEM_AVERAGING_TYPE_LOG (1) The power spectrum is averaged in a logarithmic scale.
RFMXNR_VAL_SEM_AVERAGING_TYPE_SCALAR (2) The square root of the power spectrum is averaged.
RFMXNR_VAL_SEM_AVERAGING_TYPE_MAXIMUM (3) The peak power in the spectrum at each frequency bin is retained from one acquisition to the next.
RFMXNR_VAL_SEM_AVERAGING_TYPE_MINIMUM (4) The lowest power in the spectrum at each frequency bin is retained from one acquisition to the next.

FFT

RFMXNR_ATTR_SEM_FFT_WINDOW

Data Type: int32
Access: read/write
Functions: RFmxNR_SetAttributeI32
RFmxNR_GetAttributeI32
Description: Specifies the FFT window type to be used to reduce spectral leakage.

You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector Strings topic for information about the string syntax for named signals.

The default value is RFMXNR_VAL_SEM_FFT_WINDOW_FLAT_TOP.

Get Function: RFmxNR_SEMGetFFTWindow
Set Function: RFmxNR_SEMSetFFTWindow
Values:
RFMXNR_VAL_SEM_FFT_WINDOW_NONE (0) No spectral leakage.
RFMXNR_VAL_SEM_FFT_WINDOW_FLAT_TOP (1) Spectral leakage is reduced using flat top window type.
RFMXNR_VAL_SEM_FFT_WINDOW_HANNING (2) Spectral leakage is reduced using Hanning window type.
RFMXNR_VAL_SEM_FFT_WINDOW_HAMMING (3) Spectral leakage is reduced using Hamming window type.
RFMXNR_VAL_SEM_FFT_WINDOW_GAUSSIAN (4) Spectral leakage is reduced using Gaussian window type.
RFMXNR_VAL_SEM_FFT_WINDOW_BLACKMAN (5) Spectral leakage is reduced using Blackman window type.
RFMXNR_VAL_SEM_FFT_WINDOW_BLACKMAN_HARRIS (6) Spectral leakage is reduced using Blackman-Harris window type.
RFMXNR_VAL_SEM_FFT_WINDOW_KAISER_BESSEL (7) Spectral leakage is reduced using Kaiser-Bessel window type.

RFMXNR_ATTR_SEM_AMPLITUDE_CORRECTION_TYPE

Data Type: int32
Access: read/write
Functions: RFmxNR_SetAttributeI32
RFmxNR_GetAttributeI32
Description: Specifies whether the amplitude of the frequency bins, used in measurements, is corrected for external attenuation at the RF center frequency, or at the individual frequency bins. Use the RFmxInstr_CfgExternalAttenuationTable function to configure the external attenuation table.

You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector Strings topic for information about the string syntax for named signals.

The default value is RFMXNR_VAL_SEM_AMPLITUDE_CORRECTION_TYPE_RF_CENTER_FREQUENCY.

Get Function: RFmxNR_SEMGetAmplitudeCorrectionType
Set Function: RFmxNR_SEMSetAmplitudeCorrectionType
Values:
RFMXNR_VAL_SEM_AMPLITUDE_CORRECTION_TYPE_RF_CENTER_FREQUENCY (0) All the frequency bins in the spectrum are compensated with a single external attenuation value that corresponds to the RF center frequency.
RFMXNR_VAL_SEM_AMPLITUDE_CORRECTION_TYPE_SPECTRUM_FREQUENCY_BIN (1) An individual frequency bin in the spectrum is compensated with the external attenuation value corresponding to that frequency.

RFMXNR_ATTR_SEM_ALL_TRACES_ENABLED

Data Type: int32
Access: read/write
Functions: RFmxNR_SetAttributeI32
RFmxNR_GetAttributeI32
Description: Specifies whether to enable the traces to be stored and retrieved after performing the SEM measurement.

You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector Strings topic for information about the string syntax for named signals.

The default value is RFMXNR_VAL_FALSE.

Get Function: RFmxNR_SEMGetAllTracesEnabled
Set Function: RFmxNR_SEMSetAllTracesEnabled

RFMXNR_ATTR_SEM_NUMBER_OF_ANALYSIS_THREADS

Data Type: int32
Access: read/write
Functions: RFmxNR_SetAttributeI32
RFmxNR_GetAttributeI32
Description: Specifies the maximum number of threads used for parallelism for the SEM measurement.

The number of threads can range from 1 to the number of physical cores. The number of threads you set may not be used in calculations. The actual number of threads used depends on the problem size, system resources, data availability, and other considerations.

You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector Strings topic for information about the string syntax for named signals.

The default value is 1.

Get Function: RFmxNR_SEMGetNumberOfAnalysisThreads
Set Function: RFmxNR_SEMSetNumberOfAnalysisThreads

Results

RFMXNR_ATTR_SEM_RESULTS_TOTAL_AGGREGATED_POWER

Data Type: float64
Access: read only
Functions: RFmxNR_GetAttributeF64
Description: Returns the sum of powers of all the subblocks. This value includes the power in the inter-carrier gap within a subblock, but it excludes power in the inter-subblock gaps. This value is expressed in dBm.

You do not need to use a selector string to read this attribute for the default signal instance. Refer to the Selector Strings topic for information about the string syntax for named signals.

Get Function: RFmxNR_SEMGetResultsTotalAggregatedPower

RFMXNR_ATTR_SEM_RESULTS_MEASUREMENT_STATUS

Data Type: int32
Access: read only
Functions: RFmxNR_GetAttributeI32
Description: Returns the overall measurement status based on the standard mask type that you configure in the RFMXNR_ATTR_SEM_UPLINK_MASK_TYPE attribute.

You do not need to use a selector string to read this attribute for the default signal instance. Refer to the Selector Strings topic for information about the string syntax for named signals.

Get Function: RFmxNR_SEMGetResultsMeasurementStatus
Values:
RFMXNR_VAL_SEM_MEASUREMENT_STATUS_FAIL (0) Indicates that the measurement has failed.
RFMXNR_VAL_SEM_MEASUREMENT_STATUS_PASS (1) Indicates that the measurement has passed.

RFMXNR_ATTR_SEM_RESULTS_SUBBLOCK_POWER

Data Type: float64
Access: read only
Functions: RFmxNR_GetAttributeF64
Description: Returns the power measured over the RFMXNR_ATTR_SEM_COMPONENT_CARRIER_INTEGRATION_BANDWIDTH attribute. This value is expressed in dBm.

Use 'subblock(n)' as the Selector Strings to read this result.

Get Function: RFmxNR_SEMGetResultsSubblockPower

SEM Results Component Carrier

RFMXNR_ATTR_SEM_RESULTS_COMPONENT_CARRIER_ABSOLUTE_INTEGRATED_POWER

Data Type: float64
Access: read only
Functions: RFmxNR_GetAttributeF64
Description: Returns the power measured over the RFMXNR_ATTR_SEM_COMPONENT_CARRIER_INTEGRATION_BANDWIDTH attribute. This value is expressed in dBm.

Use 'carrier(k)' or 'subblock(n)' or 'subblock(n)/carrier(k)' as the Selector Strings to read this result.

Get Function: RFmxNR_SEMGetResultsComponentCarrierAbsoluteIntegratedPower

RFMXNR_ATTR_SEM_RESULTS_COMPONENT_CARRIER_RELATIVE_INTEGRATED_POWER

Data Type: float64
Access: read only
Functions: RFmxNR_GetAttributeF64
Description: Returns the component carrier power relative to RFMXNR_ATTR_SEM_RESULTS_SUBBLOCK_POWER. This value is expressed in dB.

Use 'carrier(k)' or 'subblock(n)' or 'subblock(n)/carrier(k)' as the Selector Strings to read this result.

Get Function: RFmxNR_SEMGetResultsComponentCarrierRelativeIntegratedPower

RFMXNR_ATTR_SEM_RESULTS_COMPONENT_CARRIER_ABSOLUTE_PEAK_POWER

Data Type: float64
Access: read only
Functions: RFmxNR_GetAttributeF64
Description: Returns the peak power in the component carrier. This value is expressed in dBm.

Use 'carrier(k)' or 'subblock(n)' or 'subblock(n)/carrier(k)' as the Selector Strings to read this result.

Get Function: RFmxNR_SEMGetResultsComponentCarrierAbsolutePeakPower

RFMXNR_ATTR_SEM_RESULTS_COMPONENT_CARRIER_PEAK_FREQUENCY

Data Type: float64
Access: read only
Functions: RFmxNR_GetAttributeF64
Description: Returns the frequency at which peak power occurs in the component carrier. This value is expressed in Hz.

Use 'carrier(k)' or 'subblock(n)' or 'subblock(n)/carrier(k)' as the Selector Strings to read this result.

Get Function: RFmxNR_SEMGetResultsComponentCarrierPeakFrequency

Lower Offset

RFMXNR_ATTR_SEM_RESULTS_LOWER_OFFSET_MEASUREMENT_STATUS

Data Type: int32
Access: read only
Functions: RFmxNR_GetAttributeI32
Description: Returns the measurement status based on the spectrum emission limits defined by the standard mask type that you configure in the RFMXNR_ATTR_SEM_UPLINK_MASK_TYPE attribute.

Use 'offset(k)' or 'subblock(n)' or 'subblock(n)/offset(k)' as the Selector Strings to read this result.

Get Function: RFmxNR_SEMGetResultsLowerOffsetMeasurementStatus
Values:
RFMXNR_VAL_SEM_LOWER_OFFSET_MEASUREMENT_STATUS_FAIL (0) Indicates that the measurement has failed.
RFMXNR_VAL_SEM_LOWER_OFFSET_MEASUREMENT_STATUS_PASS (1) Indicates that the measurement has passed.

RFMXNR_ATTR_SEM_RESULTS_LOWER_OFFSET_ABSOLUTE_INTEGRATED_POWER

Data Type: float64
Access: read only
Functions: RFmxNR_GetAttributeF64
Description: Returns the lower (negative) offset segment power. This value is expressed in dBm.

Use 'offset(k)' or 'subblock(n)' or 'subblock(n)/offset(k)' as the Selector Strings to read this result.

Get Function: RFmxNR_SEMGetResultsLowerOffsetAbsoluteIntegratedPower

RFMXNR_ATTR_SEM_RESULTS_LOWER_OFFSET_RELATIVE_INTEGRATED_POWER

Data Type: float64
Access: read only
Functions: RFmxNR_GetAttributeF64
Description: Returns the power in the lower (negative) offset segment relative to RFMXNR_ATTR_SEM_RESULTS_TOTAL_AGGREGATED_POWER attribute. This value is expressed in dB.

Use 'offset(k)' or 'subblock(n)' or 'subblock(n)/offset(k)' as the Selector Strings to read this result.

Get Function: RFmxNR_SEMGetResultsLowerOffsetRelativeIntegratedPower

RFMXNR_ATTR_SEM_RESULTS_LOWER_OFFSET_ABSOLUTE_PEAK_POWER

Data Type: float64
Access: read only
Functions: RFmxNR_GetAttributeF64
Description: Returns the peak power in the lower (negative) offset segment. This value is expressed in dBm.

Use 'offset(k)' or 'subblock(n)' or 'subblock(n)/offset(k)' as the Selector Strings to read this result.

Get Function: RFmxNR_SEMGetResultsLowerOffsetAbsolutePeakPower

RFMXNR_ATTR_SEM_RESULTS_LOWER_OFFSET_RELATIVE_PEAK_POWER

Data Type: float64
Access: read only
Functions: RFmxNR_GetAttributeF64
Description: Returns the peak power in the lower (negative) offset segment relative to RFMXNR_ATTR_SEM_RESULTS_TOTAL_AGGREGATED_POWER attribute. This value is expressed in dB.

Use 'offset(k)' or 'subblock(n)' or 'subblock(n)/offset(k)' as the Selector Strings to read this result.

Get Function: RFmxNR_SEMGetResultsLowerOffsetRelativePeakPower

RFMXNR_ATTR_SEM_RESULTS_LOWER_OFFSET_PEAK_FREQUENCY

Data Type: float64
Access: read only
Functions: RFmxNR_GetAttributeF64
Description: Returns the frequency at which the peak power occurs in the lower (negative) offset segment. This value is expressed in Hz.

Use 'offset(k)' or 'subblock(n)' or 'subblock(n)/offset(k)' as the Selector Strings to read this result.

Get Function: RFmxNR_SEMGetResultsLowerOffsetPeakFrequency

RFMXNR_ATTR_SEM_RESULTS_LOWER_OFFSET_MARGIN

Data Type: float64
Access: read only
Functions: RFmxNR_GetAttributeF64
Description: Returns the margin from the absolute limit mask for lower (negative) offset. Margin is defined as the minimum difference between the spectrum and the limit mask. This value is expressed in dB.

Use 'offset(k)' or 'subblock(n)' or 'subblock(n)/offset(k)' as the Selector Strings to read this result.

Get Function: RFmxNR_SEMGetResultsLowerOffsetMargin

RFMXNR_ATTR_SEM_RESULTS_LOWER_OFFSET_MARGIN_ABSOLUTE_POWER

Data Type: float64
Access: read only
Functions: RFmxNR_GetAttributeF64
Description: Returns the power at which the Margin occurs in the lower (negative) offset segment. This value is expressed in dBm.

Use 'offset(k)' or 'subblock(n)' or 'subblock(n)/offset(k)' as the Selector Strings to read this result.

Get Function: RFmxNR_SEMGetResultsLowerOffsetMarginAbsolutePower

RFMXNR_ATTR_SEM_RESULTS_LOWER_OFFSET_MARGIN_RELATIVE_POWER

Data Type: float64
Access: read only
Functions: RFmxNR_GetAttributeF64
Description: Returns the power at which the Margin occurs in the lower (negative) offset segment relative to RFMXNR_ATTR_SEM_RESULTS_TOTAL_AGGREGATED_POWER attribute. This value is expressed in dB.

Use 'offset(k)' or 'subblock(n)' or 'subblock(n)/offset(k)' as the Selector Strings to read this result.

Get Function: RFmxNR_SEMGetResultsLowerOffsetMarginRelativePower

RFMXNR_ATTR_SEM_RESULTS_LOWER_OFFSET_MARGIN_FREQUENCY

Data Type: float64
Access: read only
Functions: RFmxNR_GetAttributeF64
Description: Returns the frequency at which the Margin occurs in the lower (negative) offset. This value is expressed in Hz.

Use 'offset(k)' or 'subblock(n)' or 'subblock(n)/offset(k)' as the Selector Strings to read this result.

Get Function: RFmxNR_SEMGetResultsLowerOffsetMarginFrequency

Upper Offset

RFMXNR_ATTR_SEM_RESULTS_UPPER_OFFSET_MEASUREMENT_STATUS

Data Type: int32
Access: read only
Functions: RFmxNR_GetAttributeI32
Description: Returns the measurement status based on the user-configured standard measurement limits. Spectrum emission limits can be defined by setting RFMXNR_ATTR_SEM_UPLINK_MASK_TYPE attribute.

Use 'offset(k)' or 'subblock(n)' or 'subblock(n)/offset(k)' as the Selector Strings to read this result.

Get Function: RFmxNR_SEMGetResultsUpperOffsetMeasurementStatus
Values:
RFMXNR_VAL_SEM_UPPER_OFFSET_MEASUREMENT_STATUS_FAIL (0) Indicates that the measurement has failed.
RFMXNR_VAL_SEM_UPPER_OFFSET_MEASUREMENT_STATUS_PASS (1) Indicates that the measurement has passed.

RFMXNR_ATTR_SEM_RESULTS_UPPER_OFFSET_ABSOLUTE_INTEGRATED_POWER

Data Type: float64
Access: read only
Functions: RFmxNR_GetAttributeF64
Description: Returns the upper (positive) offset segment power. This value is expressed in dBm.

Use 'offset(k)' or 'subblock(n)' or 'subblock(n)/offset(k)' as the Selector Strings to read this result.

Get Function: RFmxNR_SEMGetResultsUpperOffsetAbsoluteIntegratedPower

RFMXNR_ATTR_SEM_RESULTS_UPPER_OFFSET_RELATIVE_INTEGRATED_POWER

Data Type: float64
Access: read only
Functions: RFmxNR_GetAttributeF64
Description: Returns the power in the upper (positive) offset segment relative to RFMXNR_ATTR_SEM_RESULTS_TOTAL_AGGREGATED_POWER attribute. This value is expressed in dB.

Use 'offset(k)' or 'subblock(n)' or 'subblock(n)/offset(k)' as the selector string to read this result.

Get Function: RFmxNR_SEMGetResultsUpperOffsetRelativeIntegratedPower

RFMXNR_ATTR_SEM_RESULTS_UPPER_OFFSET_ABSOLUTE_PEAK_POWER

Data Type: float64
Access: read only
Functions: RFmxNR_GetAttributeF64
Description: Returns the peak power in the upper (positive) offset segment. This value is expressed in dBm.

Use 'offset(k)' or 'subblock(n)' or 'subblock(n)/offset(k)' as the Selector Strings to read this result.

Get Function: RFmxNR_SEMGetResultsUpperOffsetAbsolutePeakPower

RFMXNR_ATTR_SEM_RESULTS_UPPER_OFFSET_RELATIVE_PEAK_POWER

Data Type: float64
Access: read only
Functions: RFmxNR_GetAttributeF64
Description: Returns the peak power in the upper (positive) offset segment relative to RFMXNR_ATTR_SEM_RESULTS_TOTAL_AGGREGATED_POWER attribute. This value is expressed in dB.

Use 'offset(k)' or 'subblock(n)' or 'subblock(n)/offset(k)' as the Selector Strings to read this result.

Get Function: RFmxNR_SEMGetResultsUpperOffsetRelativePeakPower

RFMXNR_ATTR_SEM_RESULTS_UPPER_OFFSET_PEAK_FREQUENCY

Data Type: float64
Access: read only
Functions: RFmxNR_GetAttributeF64
Description: Returns the frequency at which the peak power occurs in the upper (positive)offset segment. This value is expressed in Hz.

Use 'offset(k)' or 'subblock(n)' or 'subblock(n)/offset(k)' as the Selector Strings to read this result.

Get Function: RFmxNR_SEMGetResultsUpperOffsetPeakFrequency

RFMXNR_ATTR_SEM_RESULTS_UPPER_OFFSET_MARGIN

Data Type: float64
Access: read only
Functions: RFmxNR_GetAttributeF64
Description: Returns the margin from the absolute limit mask for upper (positive) offset. Margin is defined as the minimum difference between the spectrum and the limit mask. This value is expressed in dB.

Use 'offset(k)' or 'subblock(n)' or 'subblock(n)/offset(k)' as the Selector Strings to read this result.

Get Function: RFmxNR_SEMGetResultsUpperOffsetMargin

RFMXNR_ATTR_SEM_RESULTS_UPPER_OFFSET_MARGIN_ABSOLUTE_POWER

Data Type: float64
Access: read only
Functions: RFmxNR_GetAttributeF64
Description: Returns the power at which the Margin occurs in the upper (positive) offset segment. This value is expressed in dBm.

Use 'offset(k)' or 'subblock(n)' or 'subblock(n)/offset(k)' as the Selector Strings to read this result.

Get Function: RFmxNR_SEMGetResultsUpperOffsetMarginAbsolutePower

RFMXNR_ATTR_SEM_RESULTS_UPPER_OFFSET_MARGIN_RELATIVE_POWER

Data Type: float64
Access: read only
Functions: RFmxNR_GetAttributeF64
Description: Returns the power at which the Margin occurs in the upper (positive) offset segment relative to RFMXNR_ATTR_SEM_RESULTS_TOTAL_AGGREGATED_POWER attribute. This value is expressed in dB.

Use 'offset(k)' or 'subblock(n)' or 'subblock(n)/offset(k)' as the Selector Strings to read this result.

Get Function: RFmxNR_SEMGetResultsUpperOffsetMarginRelativePower

RFMXNR_ATTR_SEM_RESULTS_UPPER_OFFSET_MARGIN_FREQUENCY

Data Type: float64
Access: read only
Functions: RFmxNR_GetAttributeF64
Description: Returns the frequency at which the Margin occurs in the upper (positive) offset. This value is expressed in Hz.

Use 'offset(k)' or 'subblock(n)' or 'subblock(n)/offset(k)' as the Selector Strings to read this result.

Get Function: RFmxNR_SEMGetResultsUpperOffsetMarginFrequency
⚠️ **GitHub.com Fallback** ⚠️