NI RFmx WLAN Trigger Attributes - ni/grpc-device GitHub Wiki
- RFMXWLAN_ATTR_TRIGGER_TYPE
- Digital Edge
- IQ Power Edge
- RFMXWLAN_ATTR_TRIGGER_DELAY
- Minimum Quiet Time
- Gating
| Data Type: | int32 |
|---|---|
| Access: | read/write |
| Functions: | RFmxWLAN_SetAttributeI32 RFmxWLAN_GetAttributeI32 |
| Description: | Specifies the trigger type. 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 RFMXWLAN_VAL_TRIGGER_TYPE_IQ_POWER_EDGE. Get Function: RFmxWLAN_GetTriggerType Set Function: RFmxWLAN_SetTriggerType |
| Values: |
| RFMXWLAN_VAL_TRIGGER_TYPE_NONE (0) | No reference trigger is configured. |
|---|---|
| RFMXWLAN_VAL_TRIGGER_TYPE_DIGITAL_EDGE (1) | The reference trigger is not asserted until a digital edge is detected. The source of the digital edge is specified using the RFMXWLAN_ATTR_DIGITAL_EDGE_TRIGGER_SOURCE attribute. |
| RFMXWLAN_VAL_TRIGGER_TYPE_IQ_POWER_EDGE (2) | The reference trigger is asserted when the signal changes past the level specified by the slope (rising or falling), which is configured using the RFMXWLAN_ATTR_IQ_POWER_EDGE_TRIGGER_SLOPE attribute. |
| RFMXWLAN_VAL_TRIGGER_TYPE_SOFTWARE (3) | The reference trigger is not asserted until a software trigger occurs. |
| :- | :- |
| Data Type: | char [] |
|---|---|
| Access: | read/write |
| Functions: | RFmxWLAN_SetAttributeString RFmxWLAN_GetAttributeString |
| Description: | Specifies the source terminal for the digital edge trigger. This attribute is used only when you set the RFMXWLAN_ATTR_TRIGGER_TYPE attribute to RFMXWLAN_VAL_TRIGGER_TYPE_DIGITAL_EDGE. On a MIMO session, this attribute configures the digital edge trigger on the master port. By default, the RFMXWLAN_ATTR_SELECTED_PORTS attribute is configured to 'segment0/chain0' and is considered as the master port. 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 of this attribute is hardware dependent. Get Function: RFmxWLAN_GetDigitalEdgeTriggerSource Set Function: RFmxWLAN_SetDigitalEdgeTriggerSource |
| Values: |
| RFMXWLAN_VAL_PFI0_STR (PFI0) | The trigger is received on PFI 0. |
|---|---|
| RFMXWLAN_VAL_PFI1_STR (PFI1) | The trigger is received on PFI 1. |
| RFMXWLAN_VAL_PXI_TRIG0_STR (PXI_Trig0) | The trigger is received on PXI trigger line 0. |
| RFMXWLAN_VAL_PXI_TRIG1_STR (PXI_Trig1) | The trigger is received on PXI trigger line 1. |
| RFMXWLAN_VAL_PXI_TRIG2_STR (PXI_Trig2) | The trigger is received on PXI trigger line 2. |
| RFMXWLAN_VAL_PXI_TRIG3_STR (PXI_Trig3) | The trigger is received on PXI trigger line 3. |
| RFMXWLAN_VAL_PXI_TRIG4_STR (PXI_Trig4) | The trigger is received on PXI trigger line 4. |
| RFMXWLAN_VAL_PXI_TRIG5_STR (PXI_Trig5) | The trigger is received on PXI trigger line 5. |
| RFMXWLAN_VAL_PXI_TRIG6_STR (PXI_Trig6) | The trigger is received on PXI trigger line 6. |
| RFMXWLAN_VAL_PXI_TRIG7_STR (PXI_Trig7) | The trigger is received on PXI trigger line 7. |
| RFMXWLAN_VAL_PXI_STAR_STR (PXI_STAR) | The trigger is received on the PXI star trigger line. |
| RFMXWLAN_VAL_PXIE_DSTARB_STR (PXIe_DStarB) | The trigger is received on the PXIe DStar B trigger line. |
| RFMXWLAN_VAL_TIMER_EVENT_STR (TimerEvent) | The trigger is received from the timer event. |
| :- | :- |
| Data Type: | int32 |
|---|---|
| Access: | read/write |
| Functions: | RFmxWLAN_SetAttributeI32 RFmxWLAN_GetAttributeI32 |
| Description: | Specifies the active edge for the trigger. This attribute is used only when you set the RFMXWLAN_ATTR_TRIGGER_TYPE attribute to RFMXWLAN_VAL_TRIGGER_TYPE_DIGITAL_EDGE. 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 RFMXWLAN_VAL_DIGITAL_EDGE_RISING_EDGE. Get Function: RFmxWLAN_GetDigitalEdgeTriggerEdge Set Function: RFmxWLAN_SetDigitalEdgeTriggerEdge |
| Values: |
| RFMXWLAN_VAL_DIGITAL_EDGE_RISING_EDGE (0) | The trigger asserts on the rising edge of the signal. |
|---|---|
| RFMXWLAN_VAL_DIGITAL_EDGE_FALLING_EDGE (1) | The trigger asserts on the falling edge of the signal. |
| :- | :- |
| Data Type: | char [] |
|---|---|
| Access: | read/write |
| Functions: | RFmxWLAN_SetAttributeString RFmxWLAN_GetAttributeString |
| Description: | Specifies the channel from which the device monitors the trigger. This attribute is used only when you set the RFMXWLAN_ATTR_TRIGGER_TYPE attribute to RFMXWLAN_VAL_TRIGGER_TYPE_IQ_POWER_EDGE. On a MIMO session, this attribute configures the IQ Power edge trigger on the master port. By default, the RFMXWLAN_ATTR_SELECTED_PORTS attribute is configured to 'segment0/chain0' and is considered as the master port. 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 of this attribute is hardware dependent. Get Function: RFmxWLAN_GetIQPowerEdgeTriggerSource Set Function: RFmxWLAN_SetIQPowerEdgeTriggerSource |
| Data Type: | float64 |
|---|---|
| Access: | read/write |
| Functions: | RFmxWLAN_SetAttributeF64 RFmxWLAN_GetAttributeF64 |
| Description: | Specifies the power level at which the device triggers. This value is expressed in dB when you set the RFMXWLAN_ATTR_IQ_POWER_EDGE_TRIGGER_LEVEL_TYPE attribute to RFMXWLAN_VAL_IQ_POWER_EDGE_TRIGGER_LEVEL_TYPE_RELATIVE and in dBm when you set the RFMXWLAN_ATTR_IQ_POWER_EDGE_TRIGGER_LEVEL_TYPE attribute to RFMXWLAN_VAL_IQ_POWER_EDGE_TRIGGER_LEVEL_TYPE_ABSOLUTE. The device asserts the trigger when the signal exceeds the level specified by the value of this attribute, taking into consideration the specified slope. This attribute is used only when you set the RFMXWLAN_ATTR_TRIGGER_TYPE attribute to RFMXWLAN_VAL_TRIGGER_TYPE_IQ_POWER_EDGE. You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector String topic for information about the string syntax for named signals. The default value of this attribute is hardware dependent. Get Function: RFmxWLAN_GetIQPowerEdgeTriggerLevel Set Function: RFmxWLAN_SetIQPowerEdgeTriggerLevel |
| Data Type: | int32 |
|---|---|
| Access: | read/write |
| Functions: | RFmxWLAN_SetAttributeI32 RFmxWLAN_GetAttributeI32 |
| Description: | Specifies the reference for the RFMXWLAN_ATTR_IQ_POWER_EDGE_TRIGGER_LEVEL attribute. The RFMXWLAN_ATTR_IQ_POWER_EDGE_TRIGGER_LEVEL_TYPE attribute is used only when you set the RFMXWLAN_ATTR_TRIGGER_TYPE attribute to RFMXWLAN_VAL_TRIGGER_TYPE_IQ_POWER_EDGE. You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector String topic for information about the string syntax for named signals. The default value is RFMXWLAN_VAL_IQ_POWER_EDGE_TRIGGER_LEVEL_TYPE_RELATIVE. Get Function: RFmxWLAN_GetIQPowerEdgeTriggerLevelType Set Function: RFmxWLAN_SetIQPowerEdgeTriggerLevelType |
| Values: |
| RFMXWLAN_VAL_IQ_POWER_EDGE_TRIGGER_LEVEL_TYPE_RELATIVE (0) | The IQ Power Edge Level attribute is relative to the value of the RFMXWLAN_ATTR_REFERENCE_LEVEL attribute. |
|---|---|
| RFMXWLAN_VAL_IQ_POWER_EDGE_TRIGGER_LEVEL_TYPE_ABSOLUTE (1) | The IQ Power Edge Level attribute specifies the absolute power. |
| :- | :- |
| Data Type: | int32 |
|---|---|
| Access: | read/write |
| Functions: | RFmxWLAN_SetAttributeI32 RFmxWLAN_GetAttributeI32 |
| Description: | Specifies whether the device asserts the trigger when the signal power is rising or falling. The device asserts the trigger when the signal power exceeds the specified level with the slope you specify. This attribute is used only when you set the RFMXWLAN_ATTR_TRIGGER_TYPE attribute to RFMXWLAN_VAL_TRIGGER_TYPE_IQ_POWER_EDGE. 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 RFMXWLAN_VAL_IQ_POWER_EDGE_RISING_SLOPE. Get Function: RFmxWLAN_GetIQPowerEdgeTriggerSlope Set Function: RFmxWLAN_SetIQPowerEdgeTriggerSlope |
| Values: |
| RFMXWLAN_VAL_IQ_POWER_EDGE_RISING_SLOPE (0) | The trigger asserts when the signal power is rising. |
|---|---|
| RFMXWLAN_VAL_IQ_POWER_EDGE_FALLING_SLOPE (1) | The trigger asserts when the signal power is falling. |
| :- | :- |
| Data Type: | float64 |
|---|---|
| Access: | read/write |
| Functions: | RFmxWLAN_SetAttributeF64 RFmxWLAN_GetAttributeF64 |
| Description: | Specifies the trigger delay time. This value is expressed in seconds. If the delay is negative, the measurement acquires pre-trigger samples. If the delay is positive, the measurement acquires post-trigger samples. 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 RFmxWLAN measurement dependent. Get Function: RFmxWLAN_GetTriggerDelay Set Function: RFmxWLAN_SetTriggerDelay |
| Data Type: | int32 |
|---|---|
| Access: | read/write |
| Functions: | RFmxWLAN_SetAttributeI32 RFmxWLAN_GetAttributeI32 |
| Description: | Specifies whether the measurement computes the minimum quiet time used for triggering. 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 RFMXWLAN_VAL_TRIGGER_MINIMUM_QUIET_TIME_MODE_AUTO. Get Function: RFmxWLAN_GetTriggerMinimumQuietTimeMode Set Function: RFmxWLAN_SetTriggerMinimumQuietTimeMode |
| Values: |
| RFMXWLAN_VAL_TRIGGER_MINIMUM_QUIET_TIME_MODE_MANUAL (0) | The minimum quiet time for triggering is the value of the Trigger Min Quiet Time Duration attribute. |
|---|---|
| RFMXWLAN_VAL_TRIGGER_MINIMUM_QUIET_TIME_MODE_AUTO (1) | The measurement computes the minimum quiet time used for triggering. |
| :- | :- |
| Data Type: | float64 |
|---|---|
| Access: | read/write |
| Functions: | RFmxWLAN_SetAttributeF64 RFmxWLAN_GetAttributeF64 |
| Description: | Specifies the time duration for which the signal must be quiet before the signal analyzer arms the I/Q power edge trigger. This value is expressed in seconds. If you set the RFMXWLAN_ATTR_IQ_POWER_EDGE_TRIGGER_SLOPE attribute to RFMXWLAN_VAL_IQ_POWER_EDGE_RISING_SLOPE, the signal is quiet below the trigger level. If you set the RFMXWLAN_ATTR_IQ_POWER_EDGE_TRIGGER_SLOPE attribute to RFMXWLAN_VAL_IQ_POWER_EDGE_FALLING_SLOPE, the signal is quiet above the trigger level. 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 of this attribute is hardware dependent. Get Function: RFmxWLAN_GetTriggerMinimumQuietTimeDuration Set Function: RFmxWLAN_SetTriggerMinimumQuietTimeDuration |
| Data Type: | int32 |
|---|---|
| Access: | read/write |
| Functions: | RFmxWLAN_SetAttributeI32 RFmxWLAN_GetAttributeI32 |
| Description: | Enables time-domain gating of the acquired signal for SEM measurement. If you set this attribute to True and the required measurement interval exceeds the value you set for the RFMXWLAN_ATTR_TRIGGER_GATE_LENGTH attribute, then the measurement restricts the acquisition duration of each record to RFMXWLAN_ATTR_TRIGGER_GATE_LENGTH attribute and acquires as many additional records as necessary for the required measurement interval. If you want to ignore the idle duration between multiple PPDUs during an SEM measurement, you must set RFMXWLAN_ATTR_TRIGGER_GATE_ENABLED to True and set RFMXWLAN_ATTR_TRIGGER_GATE_LENGTH to a value less than or equal to the length of the PPDU under analysis. 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 RFMXWLAN_VAL_TRIGGER_GATE_ENABLED_FALSE. Get Function: RFmxWLAN_GetTriggerGateEnabled Set Function: RFmxWLAN_SetTriggerGateEnabled |
| Values: |
| RFMXWLAN_VAL_TRIGGER_GATE_ENABLED_FALSE (0) | Gate for SEM measurements is disabled. |
|---|---|
| RFMXWLAN_VAL_TRIGGER_GATE_ENABLED_TRUE (1) | Gate for SEM measurements is enabled. |
| :- | :- |
| Data Type: | float64 |
|---|---|
| Access: | read/write |
| Functions: | RFmxWLAN_SetAttributeF64 RFmxWLAN_GetAttributeF64 |
| Description: | Specifies the maximum duration of time for each record used for computing the spectrum when you are performing an SEM measurement and when you set the RFMXWLAN_ATTR_TRIGGER_GATE_ENABLED attribute to RFMXWLAN_VAL_TRIGGER_GATE_ENABLED_TRUE. If the measurement interval required to perform the measurement exceeds the gate length, the measurement acquires as many additional records as necessary to honor the required measurement interval. 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 millisecond. Get Function: RFmxWLAN_GetTriggerGateLength Set Function: RFmxWLAN_SetTriggerGateLength |