Advanced:Limited Configuration Change Property
- Updated2024-04-10
- 2 minute(s) read
Advanced:Limited Configuration Change Property
Short Name: Limited Configuration Change
Property of RFmxVNA
Specifies the set of properties that are considered by NI-RFmx in the locked signal configuration state.
If your test system performs the same measurement at different selected ports, multiple frequencies and/or power levels repeatedly, enabling this property will help achieve faster measurements. When you set this property to a value other than Disabled, the RFmx driver will use an optimized code path and skip some checks.
You can also use this property to lock a specific instrument configuration for a signal so that every time that you initiate the signal, RFmx applies the RFmxInstr properties from a locked configuration.
NI recommends you use this property in conjunction with named signal configurations. Create named signal configurations for each measurement configuration in your test program and set this property to a value other than Disabled for one or more of the named signal configurations. This allows RFmx to precompute the acquisition settings for your measurement configurations and re-use the precomputed settings each time you initiate the measurement. You do not need to use this property if you create named signals for all the measurement configurations in your test program during test sequence initialization and do not change any RFInstr or personality properties while testing each device under test. RFmx automatically optimizes that use case.
Specify the named signal configuration you are setting this property in the Selector String input. You do not need to use a selector string to configure or read this property for the default signal instance. Refer to the Selector String topic for information about the string syntax for named signals.
The default value is Disabled.
Disabled (0) |
This is the normal mode of RFmx operation. All configuration changes in RFmxInstr properties or in personality properties will be applied during RFmx Commit. |
No Change (1) |
Signal configuration and RFmxInstr configuration are locked after the first Commit or Initiate of the named signal configuration. Any configuration change thereafter either in RFmxInstr properties or personality properties will not be considered by subsequent RFmx Commits or Initiates of this signal. Use No Change if you have created named signal configurations for all measurement configurations but are setting some RFmxInstr properties. Refer to the Limitations of the Limited Configuration Change Property topic for more details about the limitations of using this mode. |
Remarks
The following table lists the characteristics of this property.
Datatype | |
Permissions | Read/Write |
High-level VIs | N/A |
Resettable | Yes |