NI RFmx NR SEM Attributes - ni/grpc-device GitHub Wiki
- RFMXNR_ATTR_SEM_MEASUREMENT_ENABLED
- RFMXNR_ATTR_SEM_UPLINK_MASK_TYPE
- RFMXNR_ATTR_SEM_DOWNLINK_MASK_TYPE
- RFMXNR_ATTR_SEM_DELTA_F_MAXIMUM
- RFMXNR_ATTR_SEM_SUBBLOCK_INTEGRATION_BANDWIDTH
- RFMXNR_ATTR_SEM_SUBBLOCK_AGGREGATED_CHANNEL_BANDWIDTH
- Component Carrier
- Offset
- Sweep Time
- Averaging
- FFT
- RFMXNR_ATTR_SEM_AMPLITUDE_CORRECTION_TYPE
- RFMXNR_ATTR_SEM_ALL_TRACES_ENABLED
- RFMXNR_ATTR_SEM_NUMBER_OF_ANALYSIS_THREADS
-
Results
- RFMXNR_ATTR_SEM_RESULTS_TOTAL_AGGREGATED_POWER
- RFMXNR_ATTR_SEM_RESULTS_MEASUREMENT_STATUS
- RFMXNR_ATTR_SEM_RESULTS_SUBBLOCK_POWER
- Component Carrier
-
Lower Offset
- RFMXNR_ATTR_SEM_RESULTS_LOWER_OFFSET_MEASUREMENT_STATUS
- RFMXNR_ATTR_SEM_RESULTS_LOWER_OFFSET_ABSOLUTE_INTEGRATED_POWER
- RFMXNR_ATTR_SEM_RESULTS_LOWER_OFFSET_RELATIVE_INTEGRATED_POWER
- RFMXNR_ATTR_SEM_RESULTS_LOWER_OFFSET_ABSOLUTE_PEAK_POWER
- RFMXNR_ATTR_SEM_RESULTS_LOWER_OFFSET_RELATIVE_PEAK_POWER
- RFMXNR_ATTR_SEM_RESULTS_LOWER_OFFSET_PEAK_FREQUENCY
- RFMXNR_ATTR_SEM_RESULTS_LOWER_OFFSET_MARGIN
- RFMXNR_ATTR_SEM_RESULTS_LOWER_OFFSET_MARGIN_ABSOLUTE_POWER
- RFMXNR_ATTR_SEM_RESULTS_LOWER_OFFSET_MARGIN_RELATIVE_POWER
- RFMXNR_ATTR_SEM_RESULTS_LOWER_OFFSET_MARGIN_FREQUENCY
-
Upper Offset
- RFMXNR_ATTR_SEM_RESULTS_UPPER_OFFSET_MEASUREMENT_STATUS
- RFMXNR_ATTR_SEM_RESULTS_UPPER_OFFSET_ABSOLUTE_INTEGRATED_POWER
- RFMXNR_ATTR_SEM_RESULTS_UPPER_OFFSET_RELATIVE_INTEGRATED_POWER
- RFMXNR_ATTR_SEM_RESULTS_UPPER_OFFSET_ABSOLUTE_PEAK_POWER
- RFMXNR_ATTR_SEM_RESULTS_UPPER_OFFSET_RELATIVE_PEAK_POWER
- RFMXNR_ATTR_SEM_RESULTS_UPPER_OFFSET_PEAK_FREQUENCY
- RFMXNR_ATTR_SEM_RESULTS_UPPER_OFFSET_MARGIN
- RFMXNR_ATTR_SEM_RESULTS_UPPER_OFFSET_MARGIN_ABSOLUTE_POWER
- RFMXNR_ATTR_SEM_RESULTS_UPPER_OFFSET_MARGIN_RELATIVE_POWER
- RFMXNR_ATTR_SEM_RESULTS_UPPER_OFFSET_MARGIN_FREQUENCY
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 |
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. |
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. |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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. |
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 |
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. |
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 |
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. |
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 |
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 |
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 |
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 |
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. |
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 |
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. |
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 |
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. |
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. |
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. |
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 |
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 |
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 |
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. |
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 |
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 |
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 |
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 |
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 |
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. |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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. |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |