NI-RFSG Programming State Model

NI RF Signal Generators Help (NI-RFSG 18.1)


Edition Date: June 2018
Part Number: 371025V-01
View Product Info

Download Help (Windows Only)


NI-RFSG 18.1 Help
NI-RFSG 18.2.1 Help
NI-RFSG 19.1 Help

The NI-RFSG programming model has three main states: Configuration (idle), Committed, and Generation (running). The following diagram depicts the programming state model for the PXI-5670/5671 and PXIe-5672 Vector Signal Generator and NI-RFSG software.



The following diagram depicts the programming state model for the PXIe-5673/5673E Vector Signal Generator and NI-RFSG software.



ConfigurationYou can program all session properties and attributes in the Configuration state. However, when the hardware module is in the Configuration state, the properties or attributes have not yet been applied. Therefore, the module configuration may not match the session property or attribute values. The NI-RFSG device does not generate a signal in the Configuration state.
 Note  When you read a property or attribute, NI-RFSG may analyze many properties in the current configuration in order to return the coerced value for that property or attribute. In general, avoid reading any properties or attributes until you have finished changing all the properties or attributes you would like to change. Otherwise, you may encounter errors if a property or attribute is read while the configuration is in an inconsistent state.
CommittedCalling the niRFSG Commit VI or the niRFSG_Commit function from the Configuration state performs the following actions:
  • Verifies all property or attribute settings
  • Validates the specified configuration
  • Writes all settings to the hardware modules
  • Writes the waveform to the AWG module onboard memory
  • Transitions to the Committed state

If any properties or attributes are changed while in the Committed state, the session implicitly transitions back to the Configuration state and the hardware configuration reflects the previously committed properties or attributes.

* Write waveform has the opposite behavior on the PXIe-5673/5673E. Write waveform transitions the session into the committed state.

GenerationIn the Generation state, session properties or attributes always reflect the current state of the module, and the module is either waiting on a trigger or generating a signal.
 Note  For the PXI-5670/5671 and PXIe-5672 devices, you cannot write any properties or attributes during the Generation state. The PXI/PXIe-5650/5651/5652 devices allow some properties or attributes to be changed during the Generation state. The PXIe-5673/5673E devices allow properties or attributes to be changed during the Generation state.
 Note  The niRFSG Close VI or the niRFSG_close function may be called from any state. Calling this VI or function stops signal generation.

Related Topics

niRFSG Commit VI

niRFSG_Commit Function

niRFSG Close VI

niRFSG_close Function

WAS THIS ARTICLE HELPFUL?

Not Helpful